Add verbosity arguments

README.md

@@ -3,10 +3,12 @@
 A python script that will generate an iCal (`.ics`) feed of your checkins on [Foursquare][4sq]/[Swarm][swarm]. If you set it up to save this file to a publicly-visible location on a webserver, and run the script regularly, you can subscribe to the feed in your favourite calendar application.
 
 Foursquare [used to have such feeds][feeds] but they've stopped working for me.
+[I wrote a bit about this.][blog]
 
 [4sq]: https://foursquare.com
 [swarm]: https://www.swarmapp.com
 [feeds]: https://foursquare.com/feeds/
+[blog]: https://www.gyford.com/phil/writing/2019/05/13/foursquare-swarm-ical-feed/
 
 
 ## Installation
@@ -19,11 +21,11 @@ Go to https://foursquare.com/developers/apps and create a new App.
 
 ### 2. Install python requirements
 
-Either:
+Either using [pipenv](https://pipenv.readthedocs.io/en/latest/):
 
     $ pipenv install
 
-or:
+or [pip](https://pip.pypa.io/en/stable/):
 
     $ pip install -r requirements.txt
 
@@ -80,18 +82,51 @@ You're ready to go:
 
     $ ./generate_feeds.py
 
-This should create an `.ics` file.
-
-By default it only fetches the most recent 250 checkins. To fetch ALL of your
-checkins add the `--all` flag:
-
-    $ ./generate_feeds.py --all
+This should create an `.ics` file containing up to 250 of your most recent
+checkins (see `--all` argument below to get more).
 
 If the file is generated in a location on your website that's publicly-visible, you should be able to subscribe to it from a calendar application. Then run the script periodically to have it update.
 
+Note that the file might contain private checkins or information you don't want to be public. In which case, it's probably best to make the name of any such publicly-readable file very obscure.
+
+### `--all`
+
+By default the script only fetches the most recent 250 checkins. To fetch ALL checkins add the `--all` flag:
+
+    $ ./generate_feeds.py --all
+
 Depending on how many checkins you have you might only want to run it with
 `--all` the first time and, once that's imported into a calendar application,
 subsequently only fetch recent checkins.
 
-Note that the file might contain private checkins or information you don't want to be public. In which case, it's probably best to make the name of any such publicly-readable file very obscure.
+### `-v` or `--verbose`
+
+By default the script will only output text if something goes wrong. To get
+brief output use `-v` or `--verbose`:
+
+    $ ./generate_feeds.py -v
+    Fetched 250 checkins from the API
+    Generated calendar file ./mycalendar.ics
+
+If fetching `--all` checkins then increasing the verbosity with another `-v`
+will show more info than the above:
+
+    $ ./generate_feeds.py -vv --all
+    5746 checkins to fetch
+    Fetched checkins 1-250
+    Fetched checkins 251-500
+    [etc]
+    Fetched checkins 5501-5750
+    Fetched 5744 checkins from the API
+    Generated calendar file ./mycalendar.ics
+
+(No I don't know why it fetched 2 fewer checkins than I have.)
+
+
+## About
+
+By Phil Gyford  
+phil@gyford.com  
+https://www.gyford.com  
+https://github.com/philgyford/foursquare-feeds