Added info for this feature in the readme. Replaced "_" with "-" in t…

…he arguments names

phockup.py

@@ -298,24 +298,22 @@ def parse_args(args=sys.argv[1:]):
     )
 
     parser.add_argument(
-        '--from_date',
+        '--from-date',
         type=str,
         default=None,
         help="""\
-Limit the operations to the files that are older than from_date (inclusive).
-The date must be specified in format YYYY-MM-DD
-Files with unknown date won't be skipped.
+Limit the operations to the files that are newer than --from-date (inclusive).
+The date must be specified in format YYYY-MM-DD. Files with unknown date won't be skipped.
 """
     )
 
     parser.add_argument(
-        '--to_date',
+        '--to-date',
         type=str,
         default=None,
         help="""\
-Limit the operations to the files that are newer than from_date (inclusive).
-The date must be specified in format YYYY-MM-DD
-Files with unknown date won't be skipped.
+Limit the operations to the files that are older than --to-date (inclusive).
+The date must be specified in format YYYY-MM-DD. Files with unknown date won't be skipped.
 """
     )
 

readme.md

@@ -220,6 +220,29 @@ saving to the same central respository.
 
 The two options above can be used to help sort/store images
 
+#### Limit files processed by date
+`--from-date` flag can be used to limit the operations to the files that are newer than the provided date (inclusive).
+The date must be specified in format YYYY-MM-DD. Files with unknown date won't be skipped.
+
+For example:
+```
+phockup ~/Pictures/DCIM/NIKOND40 ~/Pictures/sorted --from-date="2017-01-02"
+```
+`--to-date` flag can be used to limit the operations to the files that are older than the provided date (inclusive).
+The date must be specified in format YYYY-MM-DD. Files with unknown date won't be skipped.
+
+For example:
+```
+phockup ~/Pictures/DCIM/NIKOND40 ~/Pictures/sorted --to-date="2017-01-02"
+```  
+
+`--from-date` and `--to-date` can be combined for better control over the files that are processed.
+
+For example:
+```
+phockup ~/Pictures/DCIM/NIKOND40 ~/Pictures/sorted --from-date="2017-01-02" --to-date="2017-01-03"
+``` 
+
 ### Missing date information in EXIF
 If any of the photos does not have date information you can use the `-r | --regex` option to specify date format for date extraction from filenames:
 ```

src/phockup.py

@@ -284,10 +284,10 @@ def process_file(self, filename):
                 if type(file_date) is dict:
                     file_date = file_date["date"]
                 if self.from_date is not None and file_date < self.from_date:
-                    progress = f"{progress} => {filename} skipped: date {file_date} is older than from_date {self.from_date}"
+                    progress = f"{progress} => {filename} skipped: date {file_date} is older than --from-date {self.from_date}"
                     skip = True
                 if self.to_date is not None and file_date > self.to_date:
-                    progress = f"{progress} => {filename} skipped: date {file_date} is newer than to_date {self.to_date}"
+                    progress = f"{progress} => {filename} skipped: date {file_date} is newer than --to-date {self.to_date}"
                     skip = True
                 if skip:
                     if self.progress: