calendar-assistant 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e7456770368242baeb04b1645ee98ccf2b4d0c1061df5a2d935903c59c3cbe4
-  data.tar.gz: 58c65019e44c91fbe216ff0dd151073cc1113dc73597995553f44f9a5b6bddf6
+  metadata.gz: 0d3530bae8b1e8aac4260f546dd2fb2c3673b09c57d1c98e5f9e91bf91bdf5ed
+  data.tar.gz: e7c80eca297a7aa6ce37abfae434507368c54764c1af4d4175a346e7a4cbf9f4
 SHA512:
-  metadata.gz: 93b5438be7365f06fc0b2cf79258ec491d29dd751d48cbea218a56f505441cf937e1406c7bb8418c6d195ead78ccd0e9453580664a4ebbe4d4a8573ac7bf3bc5
-  data.tar.gz: c490f565590ffdebfb3119833bd8b907a8b457644f8c93d2fc9d9902c7869b325c70dbdd8cc9d84deabb459915cb966bd5261c7a9fb674fdfee14b436d124b80
+  metadata.gz: b7dcd5d6d01422c2ee042f47f0fba9fad1886fa3b2d2d2b65c411289007d5b20d3c262b888d325036c1f4bb79bf4c4d405e47c206f467adcf1a02de77be26afc
+  data.tar.gz: 34a1c905b4c45e5562639001721eacc977a5c3511f8527b986b9de294249e590a0e8ec0cebe689d22d2ffb0a6066f4565532d729a22491240a25d6ee6c4425a6

data/README.md

@@ -1,6 +1,7 @@
-# calendar assistant
+<img src="icons/calendar-assistant.png" align="right" />
 
-A command-line tool to help you manage your Google Calendar.
+# Calendar Assistant
+>A command-line tool to help you manage your Google Calendar.
 
 - easily join the videoconference for your current meeting
 - see yours and others' "availability" suitable for an email response
@@ -20,6 +21,7 @@ A command-line tool to help you manage your Google Calendar.
   * [Pretty Display in Your Terminal](#pretty-display-in-your-terminal)
   * [Human-Friendly Date and Time Specification](#human-friendly-date-and-time-specification)
   * [Human-Friendly Duration Specification](#human-friendly-duration-specification)
+  * [Filter Events by property](#filter-events-by-property)
   * [Preferences](#preferences)
 - [Setup](#setup)
   * [Installation](#installation)
@@ -66,6 +68,43 @@ Also note that every command will adopt an intelligent default, which is general
 
 Some duration-related preferences are interpreted by [ChronicDuration](https://github.com/henrypoydar/chronic_duration) and so can be terms like "10m", "30 minutes", "four hours", etc.
 
+### Filter Events by property
+
+Commands that return events like `show`, `join`, `availability`, `location` or `lint` can be filtered using the option `--must-be` or `--must-not-be`. These options expect a comma separated list of one of the following properties.
+
+* **Response**
+	* `accepted`
+	* `declined`
+	* `awaiting`
+	* `tentative`
+* **Temporal**
+	* `all_day`
+	* `past`
+	* `current`
+	* `future`
+* **Visibility**
+	* `private`
+	* `public`
+	* `explicitly_visible`
+	* `visible_guestlist`
+* **Attributes**
+	* `location_event`
+	* `self`
+	* `one_on_one`
+	* `busy`
+	* `commitment`
+	* `recurring`
+	* `abandoned`
+	* `anyone_can_add_self`
+	* `attendees_omitted`
+	* `end_time_unspecified`
+	* `guests_can_invite_others`
+	* `guests_can_modify`
+	* `guests_can_see_other_guests`
+	* `private_copy`
+	* `locked`
+	* `needs_action`
+
 
 ### Preferences
 
@@ -73,10 +112,32 @@ All tokens and preferences will be stored in `~/.calendar-assistant` which is in
 
 The location of `.calendar-assistant` defaults to the user's home directory. This location may be overridden by setting the environment variable `CA_HOME`
 
+
+#### Nickname
+
+Some commands, like `location-set`, will refer to you by nickname if you configure it (the alternative might be to not specify your name, or use your email id).
+
+Set `nickname` to a string that would uniquely and briefly identify you to others, like "Mike D" or "JK".
+
+
 #### Location Emoji
 
 There is a `[settings]` key called `location-icons` that may be set to an array denoting all emoji that indicate a location event. The first icon in the array will be used as the default. The default emoji included are `["🗺 ", "🌎"]` with the map icon first
 
+
+#### Command-Specific Preferences
+
+If there are user preferences you'd like to set for just a single command (e.g., making public location events created via `location-set`), you can create a nested section in your TOML settings file, like so:
+
+```toml
+[settings]
+visibility = default
+
+[settings.location_set]
+visibility = public
+```
+
+
 ## Setup
 
 ### Installation
@@ -91,10 +152,10 @@ Usage:
   calendar-assistant setup
 
 Options:
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+  -h, -?, [--help], [--no-help]          
+          [--debug], [--no-debug]        # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]  # Enable Text Formatting
+                                         # Default: true
 
 Description:
   This command will walk you through setting up a Google Cloud Project, enabling the Google Calendar
@@ -112,10 +173,10 @@ Usage:
   calendar-assistant authorize PROFILE_NAME
 
 Options:
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+  -h, -?, [--help], [--no-help]          
+          [--debug], [--no-debug]        # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]  # Enable Text Formatting
+                                         # Default: true
 
 Description:
   Create and authorize a named profile (e.g., "work", "home", "flastname@company.tld") to access your
@@ -146,10 +207,10 @@ Commands:
   calendar-assistant version                                      # Display the version of calend...
 
 Options:
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+  -h, -?, [--help], [--no-help]          
+          [--debug], [--no-debug]        # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]  # Enable Text Formatting
+                                         # Default: true
 </pre>
 
 
@@ -160,14 +221,16 @@ Usage:
   calendar-assistant join [TIME]
 
 Options:
-          [--join], [--no-join]              # launch a browser to join the video call URL
-                                             # Default: true
-  -p, [--profile=PROFILE]                    # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]           # Load events from a local file instead of Google Calendar
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+          [--join], [--no-join]                    # launch a browser to join the video call URL
+                                                   # Default: true
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Open the URL for a video call attached to your meeting at time TIME (default 'now')
 </pre>
@@ -201,16 +264,18 @@ Usage:
   calendar-assistant availability [DATE | DATERANGE | TIMERANGE]
 
 Options:
-  -l, [--meeting-length=LENGTH]                  # [default 30m] find chunks of available time at least as long as LENGTH (which is a ChronicDuration string like '30m' or '2h')
-  -s, [--start-of-day=TIME]                      # [default 9am] find chunks of available time after TIME (which is a BusinessTime string like '9am' or '14:30')
-  -e, [--end-of-day=TIME]                        # [default 6pm] find chunks of available time before TIME (which is a BusinessTime string like '9am' or '14:30')
-  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]  # [default 'me'] people (email IDs) to whom this command will be applied
-  -p, [--profile=PROFILE]                        # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]               # Load events from a local file instead of Google Calendar
-  -h, -?, [--help], [--no-help]                  
-          [--debug], [--no-debug]                # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]      # Enable Text Formatting
-                                                 # Default: true
+  -l, [--meeting-length=LENGTH]                    # [default 30m] find chunks of available time at least as long as LENGTH (which is a ChronicDuration string like '30m' or '2h')
+  -s, [--start-of-day=TIME]                        # [default 9am] find chunks of available time after TIME (which is a BusinessTime string like '9am' or '14:30')
+  -e, [--end-of-day=TIME]                          # [default 6pm] find chunks of available time before TIME (which is a BusinessTime string like '9am' or '14:30')
+  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]    # [default 'me'] people (email IDs) to whom this command will be applied
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Show your availability for a date or range of dates (default 'today')
 </pre>
@@ -302,12 +367,15 @@ Usage:
   calendar-assistant location-set LOCATION [DATE | DATERANGE]
 
 Options:
-  -p, [--profile=PROFILE]                    # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]           # Load events from a local file instead of Google Calendar
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+          [--visibility=VISIBILITY]                # [default is 'default'] Set the visbility of the event. Values are 'public', 'private', 'default'.
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Set your location to LOCATION for a date or range of dates (default 'today')
 </pre>
@@ -346,12 +414,14 @@ Usage:
   calendar-assistant location [DATE | DATERANGE]
 
 Options:
-  -p, [--profile=PROFILE]                    # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]           # Load events from a local file instead of Google Calendar
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Show your location for a date or range of dates (default 'today')
 </pre>
@@ -362,8 +432,8 @@ For example:
 <b>$</b> calendar-assistant location "2018-09-24...2018-09-28"
 <i>me@example.com (all times in America/New_York)
 </i>
-2018-09-24 - 2018-09-28  <b> | 🗺  Gondolin</b><i> (not-busy)</i>
-2018-09-28               <b> | 🗺  Rivendell</b><i> (not-busy)</i>
+2018-09-24 - 2018-09-28  <b> | 🌎 Iron Hills</b><i> (not-busy)</i>
+2018-09-28               <b> | 🌎 Country Round</b><i> (not-busy)</i>
 </pre>
 
 
@@ -374,14 +444,16 @@ Usage:
   calendar-assistant show [DATE | DATERANGE | TIMERANGE]
 
 Options:
-  -c, [--commitments], [--no-commitments]        # only show events that you've accepted with another person
-  -p, [--profile=PROFILE]                        # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]               # Load events from a local file instead of Google Calendar
-  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]  # [default 'me'] people (email IDs) to whom this command will be applied
-  -h, -?, [--help], [--no-help]                  
-          [--debug], [--no-debug]                # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]      # Enable Text Formatting
-                                                 # Default: true
+  -c, [--commitments], [--no-commitments]          # only show events that you've accepted with another person
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]    # [default 'me'] people (email IDs) to whom this command will be applied
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Show your events for a date or range of dates (default 'today')
 </pre>
@@ -392,28 +464,28 @@ For example: display all events scheduled for tomorrow:
 <b>$</b> calendar-assistant show 2018-10-01
 <i>me@example.com (all times in America/New_York)
 </i>
-<strike>2018-10-01  03:30 - 05:00 | Repurpose end-to-end convergence</strike>
-<strike>2018-10-01  07:30 - 08:30 | Iterate clicks-and-mortar vortals</strike>
-<strike>2018-10-01  07:30 - 08:30 | Grow viral portals</strike>
-2018-10-01  10:30 - 10:55<b> | Enable rich roi</b><i> (1:1, recurring)</i>
-2018-10-01  11:00 - 11:30<b> | Leverage rich e-services</b><i> (recurring)</i>
-2018-10-01  11:30 - 12:00<b> | Grow leading-edge communities</b><i> (1:1, recurring)</i>
-2018-10-01  11:50 - 12:00<b> | Cultivate revolutionary experiences</b><i> (awaiting)</i>
-2018-10-01  12:00 - 12:30<b> | Incentivize ubiquitous mindshare</b><i> (self)</i>
-<strike>2018-10-01  12:15 - 12:30 | Disintermediate next-generation niches</strike>
-<strike>2018-10-01  12:30 - 13:30 | Drive viral communities</strike>
-2018-10-01  12:30 - 13:30<b> | Synergize integrated supply-chains</b><i> (awaiting, recurring)</i>
-2018-10-01  13:30 - 14:50<b> | Transform revolutionary users</b><i> (self)</i>
-<strike>2018-10-01  13:30 - 14:30 | Enable interactive networks</strike>
-2018-10-01  15:00 - 15:30<b> | Evolve global applications</b><i> (1:1)</i>
-2018-10-01  16:00 - 17:00<b> | Implement b2c architectures</b><i> (1:1, recurring)</i>
-2018-10-01  16:45 - 17:00<b> | Enable rich niches</b><i> (recurring)</i>
-2018-10-01  17:00 - 17:30<b> | Implement frictionless e-markets</b><i> (recurring)</i>
-2018-10-01  17:30 - 17:55<b> | Streamline world-class portals</b><i> (1:1, recurring)</i>
-<strike>2018-10-01  18:00 - 20:30 | Recontextualize rich paradigms</strike>
-<strike>2018-10-01  18:30 - 19:00 | Synergize dot-com functionalities</strike>
-2018-10-01  19:00 - 19:30<b> | Revolutionize transparent e-markets</b><i> (awaiting)</i>
-2018-10-01               <b> | 🗺  Country Round</b><i> (not-busy)</i>
+<strike>2018-10-01  03:30 - 05:00 | Facilitate 24/365 web services</strike>
+<strike>2018-10-01  07:30 - 08:30 | Reintermediate magnetic communities</strike>
+<strike>2018-10-01  07:30 - 08:30 | Revolutionize bricks-and-clicks synergies</strike>
+2018-10-01  10:30 - 10:55<b> | Whiteboard clicks-and-mortar metrics</b><i> (1:1, recurring)</i>
+2018-10-01  11:00 - 11:30<b> | Architect holistic models</b><i> (recurring)</i>
+2018-10-01  11:30 - 12:00<b> | Reinvent bleeding-edge e-services</b><i> (1:1, recurring)</i>
+2018-10-01  11:50 - 12:00<b> | Synergize e-business systems</b><i> (awaiting)</i>
+2018-10-01  12:00 - 12:30<b> | Reinvent e-business e-tailers</b><i> (self)</i>
+<strike>2018-10-01  12:15 - 12:30 | Maximize clicks-and-mortar convergence</strike>
+<strike>2018-10-01  12:30 - 13:30 | Disintermediate end-to-end bandwidth</strike>
+2018-10-01  12:30 - 13:30<b> | Iterate innovative networks</b><i> (awaiting, recurring)</i>
+2018-10-01  13:30 - 14:50<b> | Engage holistic users</b><i> (self)</i>
+<strike>2018-10-01  13:30 - 14:30 | Enable e-business e-services</strike>
+2018-10-01  15:00 - 15:30<b> | Innovate impactful technologies</b><i> (1:1)</i>
+2018-10-01  16:00 - 17:00<b> | Iterate dynamic networks</b><i> (1:1, recurring)</i>
+2018-10-01  16:45 - 17:00<b> | Deploy robust content</b><i> (recurring)</i>
+2018-10-01  17:00 - 17:30<b> | Synthesize viral methodologies</b><i> (recurring)</i>
+2018-10-01  17:30 - 17:55<b> | Scale collaborative methodologies</b><i> (1:1, recurring)</i>
+<strike>2018-10-01  18:00 - 20:30 | Seize rich experiences</strike>
+<strike>2018-10-01  18:30 - 19:00 | Engineer one-to-one e-business</strike>
+2018-10-01  19:00 - 19:30<b> | Recontextualize collaborative content</b><i> (awaiting)</i>
+2018-10-01               <b> | 🌎 Grey Mountains</b><i> (not-busy)</i>
 </pre>
 
 Display _only_ the commitments I have to other people using the `-c` option:
@@ -422,17 +494,17 @@ Display _only_ the commitments I have to other people using the `-c` option:
 <b>$</b> calendar-assistant show -c 2018-10-01
 <i>me@example.com (all times in America/New_York)
 </i>
-2018-10-01  10:30 - 10:55<b> | Enable rich roi</b><i> (1:1, recurring)</i>
-2018-10-01  11:00 - 11:30<b> | Leverage rich e-services</b><i> (recurring)</i>
-2018-10-01  11:30 - 12:00<b> | Grow leading-edge communities</b><i> (1:1, recurring)</i>
-2018-10-01  11:50 - 12:00<b> | Cultivate revolutionary experiences</b><i> (awaiting)</i>
-2018-10-01  12:30 - 13:30<b> | Synergize integrated supply-chains</b><i> (awaiting, recurring)</i>
-2018-10-01  15:00 - 15:30<b> | Evolve global applications</b><i> (1:1)</i>
-2018-10-01  16:00 - 17:00<b> | Implement b2c architectures</b><i> (1:1, recurring)</i>
-2018-10-01  16:45 - 17:00<b> | Enable rich niches</b><i> (recurring)</i>
-2018-10-01  17:00 - 17:30<b> | Implement frictionless e-markets</b><i> (recurring)</i>
-2018-10-01  17:30 - 17:55<b> | Streamline world-class portals</b><i> (1:1, recurring)</i>
-2018-10-01  19:00 - 19:30<b> | Revolutionize transparent e-markets</b><i> (awaiting)</i>
+2018-10-01  10:30 - 10:55<b> | Whiteboard clicks-and-mortar metrics</b><i> (1:1, recurring)</i>
+2018-10-01  11:00 - 11:30<b> | Architect holistic models</b><i> (recurring)</i>
+2018-10-01  11:30 - 12:00<b> | Reinvent bleeding-edge e-services</b><i> (1:1, recurring)</i>
+2018-10-01  11:50 - 12:00<b> | Synergize e-business systems</b><i> (awaiting)</i>
+2018-10-01  12:30 - 13:30<b> | Iterate innovative networks</b><i> (awaiting, recurring)</i>
+2018-10-01  15:00 - 15:30<b> | Innovate impactful technologies</b><i> (1:1)</i>
+2018-10-01  16:00 - 17:00<b> | Iterate dynamic networks</b><i> (1:1, recurring)</i>
+2018-10-01  16:45 - 17:00<b> | Deploy robust content</b><i> (recurring)</i>
+2018-10-01  17:00 - 17:30<b> | Synthesize viral methodologies</b><i> (recurring)</i>
+2018-10-01  17:30 - 17:55<b> | Scale collaborative methodologies</b><i> (1:1, recurring)</i>
+2018-10-01  19:00 - 19:30<b> | Recontextualize collaborative content</b><i> (awaiting)</i>
 </pre>
 
 
@@ -443,13 +515,15 @@ Usage:
   calendar-assistant lint [DATE | DATERANGE | TIMERANGE]
 
 Options:
-  -p, [--profile=PROFILE]                        # the profile you'd like to use (if different from default)
-          [--local-store=FILENAME]               # Load events from a local file instead of Google Calendar
-  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]  # [default 'me'] people (email IDs) to whom this command will be applied
-  -h, -?, [--help], [--no-help]                  
-          [--debug], [--no-debug]                # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]      # Enable Text Formatting
-                                                 # Default: true
+  -p, [--profile=PROFILE]                          # the profile you'd like to use (if different from default)
+  -l, [--local-store=FILENAME]                     # Load events from a local file instead of Google Calendar
+  -a, [--attendees=ATTENDEE1[,ATTENDEE2[,...]]]    # [default 'me'] people (email IDs) to whom this command will be applied
+  -b, [--must-be=PROPERTY1[,PROPERTY2[,...]]]      # Event properties that must be true (see README)
+  -n, [--must-not-be=PROPERTY1[,PROPERTY2[,...]]]  # Event properties that must be false (see README)
+  -h, -?, [--help], [--no-help]                    
+          [--debug], [--no-debug]                  # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]            # Enable Text Formatting
+                                                   # Default: true
 
 Lint your events for a date or range of dates (default 'today')
 </pre>
@@ -462,11 +536,11 @@ me@example.com
 - looking for events that need attention
 - all times in America/New_York
 
-2018-10-01  11:50 - 12:00<b> | Cultivate revolutionary experiences</b><i> (awaiting)</i>
+2018-10-01  11:50 - 12:00<b> | Synergize e-business systems</b><i> (awaiting)</i>
                                     attendees: 👍 three@example.com, 🤷 four@example.com
-2018-10-01  12:30 - 13:30<b> | Synergize integrated supply-chains</b><i> (awaiting, recurring)</i>
+2018-10-01  12:30 - 13:30<b> | Iterate innovative networks</b><i> (awaiting, recurring)</i>
                                     attendees: 👍 three@example.com, 🤷 four@example.com
-2018-10-01  19:00 - 19:30<b> | Revolutionize transparent e-markets</b><i> (awaiting)</i>
+2018-10-01  19:00 - 19:30<b> | Recontextualize collaborative content</b><i> (awaiting)</i>
                                     attendees: 👍 three@example.com, 🤷 four@example.com
 </pre>
 
@@ -480,10 +554,10 @@ Usage:
   calendar-assistant config
 
 Options:
-  -h, -?, [--help], [--no-help]              
-          [--debug], [--no-debug]            # how dare you suggest there are bugs
-          [--formatting], [--no-formatting]  # Enable Text Formatting
-                                             # Default: true
+  -h, -?, [--help], [--no-help]          
+          [--debug], [--no-debug]        # how dare you suggest there are bugs
+  -f, [--formatting], [--no-formatting]  # Enable Text Formatting
+                                         # Default: true
 
 Dump your configuration parameters (merge of defaults and overrides from /home/user/.calendar-assistant)
 </pre>
@@ -495,7 +569,7 @@ The output is TOML, which is suitable for dumping into `~/.calendar-assistant` a
 
 [settings]
 end-of-day = "6pm"
-location-icons = ["🌎","🗺 "]
+location-icon = "🌎"
 meeting-length = "30m"
 profile = "work"
 start-of-day = "9am"

data/Rakefile

@@ -3,25 +3,53 @@ require "rspec/core/rake_task"
 require "concourse"
 require "license_finder"
 
-Concourse.new("calendar-assistant").create_tasks!
+#
+#  concourse
+#
+Concourse.new("calendar-assistant", fly_target: "calendar-assistants").create_tasks!
 
-RSpec::Core::RakeTask.new(:test)
 
-RSpec::Core::RakeTask.new(:spec)  do |t|
+#
+#  spec tasks
+#
+desc "Run unit and feature specs"
+RSpec::Core::RakeTask.new("spec")
+task "test" => "spec" # undocumented alias for 'spec'
+
+desc "Run unit specs"
+RSpec::Core::RakeTask.new("spec:unit")  do |t|
   t.rspec_opts ||= []
   t.rspec_opts << " --tag=~type:aruba"
 end
 
-RSpec::Core::RakeTask.new(:features)  do |t|
+desc "Run feature specs"
+RSpec::Core::RakeTask.new("spec:feature")  do |t|
   t.rspec_opts ||= []
   t.rspec_opts << " --tag=type:aruba"
 end
 
 desc "Ensure all dependencies meet license requirements."
-task :license_finder do
+task "license_finder" do
   LicenseFinder::CLI::Main.start(["report"])
   LicenseFinder::CLI::Main.start([])
 end
 
-desc "Run specs, features and license finder"
-task :default => [:test, :license_finder]
+desc "Run unit specs, feature specs, and license finder"
+task "default" => ["spec", "license_finder"]
+
+
+#
+# docker docker docker
+#
+desc "Build a docker image for testing"
+task "docker:build" do
+  sh "docker build -t flavorjones/calendar-assistant-test -f concourse/images/Dockerfile ."
+end
+
+desc "Push a docker image for testing"
+task "docker:push" do
+  sh "docker push flavorjones/calendar-assistant-test"
+end
+
+desc "Build and push a docker image for testing"
+task "docker" => ["docker:build", "docker:push"]

data/lib/calendar_assistant.rb

@@ -35,6 +35,7 @@ class CalendarAssistant
   autoload :EventSet,               "calendar_assistant/event_set"
   autoload :Scheduler,              "calendar_assistant/scheduler"
   autoload :LocalService,           "calendar_assistant/local_service"
+  autoload :PredicateCollection,    "calendar_assistant/predicate_collection"
 end
 
 require "calendar_assistant/cli"

data/lib/calendar_assistant/calendar_assistant.rb

@@ -37,8 +37,7 @@ class CalendarAssistant
     @calendar = service.get_calendar Config::DEFAULT_CALENDAR_ID
     @event_repository_factory = event_repository_factory
     @event_repositories = {} # calendar_id → event_repository
-
-    @emoji_worldmap = Array(@config.setting(CalendarAssistant::Config::Keys::Settings::LOCATION_ICONS)).first
+    @event_predicates = PredicateCollection.build(config.must_be, config.must_not_be)
   end
 
   def in_env &block
@@ -62,7 +61,7 @@ class CalendarAssistant
       raise BaseException, "CalendarAssistant#lint_events only supports one person (for now)"
     end
 
-    event_repository(calendar_ids.first).find(time_range,  predicates: { needs_action?: true })
+    event_repository(calendar_ids.first).find(time_range,  predicates: @event_predicates.merge({needs_action?: true}))
   end
 
   def find_events time_range
@@ -70,7 +69,7 @@ class CalendarAssistant
     if calendar_ids.length > 1
       raise BaseException, "CalendarAssistant#find_events only supports one person (for now)"
     end
-    event_repository(calendar_ids.first).find(time_range)
+    event_repository(calendar_ids.first).find(time_range, predicates: @event_predicates)
   end
 
   def availability time_range
@@ -78,11 +77,11 @@ class CalendarAssistant
     ers = calendar_ids.map do |calendar_id|
       event_repository calendar_id
     end
-    Scheduler.new(self, ers).available_blocks(time_range)
+    Scheduler.new(self, ers).available_blocks(time_range, predicates: @event_predicates)
   end
 
   def find_location_events time_range
-    event_set = event_repository.find(time_range)
+    event_set = event_repository.find(time_range, predicates: @event_predicates)
     event_set.new event_set.events.select { |e| e.location_event? }
   end
 
@@ -96,7 +95,11 @@ class CalendarAssistant
     deleted_events = []
     modified_events = []
 
-    event = event_repository.create(transparency: CalendarAssistant::Event::Transparency::TRANSPARENT, start: range.first, end: range.last , summary: "#{@emoji_worldmap} #{location}")
+    event = event_repository.create(
+      transparency: CalendarAssistant::Event::Transparency::TRANSPARENT,
+      start: range.first, end: range.last,
+      summary: "#{Event.location_event_prefix(@config)}#{location}"
+    )
 
     existing_event_set.events.each do |existing_event|
       if existing_event.start_date >= event.start_date && existing_event.end_date <= event.end_date

data/lib/calendar_assistant/cli.rb

@@ -1,5 +1,6 @@
 require_relative 'cli/config'
 require_relative 'cli/helpers'
+require_relative 'cli/command_service'
 require_relative 'cli/printer'
 require_relative 'cli/event_presenter'
 require_relative 'cli/event_set_presenter'

data/lib/calendar_assistant/cli/command_service.rb

@@ -0,0 +1,37 @@
+class CalendarAssistant
+  module CLI
+    class CommandService
+      attr_reader :options, :config, :out
+
+      def initialize(context:, options: {})
+        @options = options.dup
+        @options[CalendarAssistant::Config::Keys::Options::CONTEXT] ||= context.to_s
+
+        @config  = CalendarAssistant::CLI::Config.new(options: @options)
+        @authorizer = {}
+        @out = CalendarAssistant::CLI::Printer.new
+      end
+
+      def calendar_assistant(datespec)
+        ca = CalendarAssistant.new(config, service: service)
+        ca.in_env do
+          yield(ca, CalendarAssistant::CLI::Helpers.parse_datespec(datespec), out)
+        end
+      end
+
+      def authorizer(profile_name: config.profile_name, token_store: config.token_store)
+        @authorizer[profile_name] ||= Authorizer.new(profile_name, token_store)
+      end
+
+      def service
+        @service ||= begin
+          if filename = config.setting(Config::Keys::Options::LOCAL_STORE)
+            CalendarAssistant::LocalService.new(file: filename)
+          else
+            authorizer.service
+          end
+        end
+      end
+    end
+  end
+end

data/lib/calendar_assistant/cli/commands.rb

@@ -1,5 +1,3 @@
-require "calendar_assistant/cli/helpers"
-
 class CalendarAssistant
   module CLI
     class Commands < Thor
@@ -12,7 +10,21 @@ class CalendarAssistant
         option CalendarAssistant::Config::Keys::Options::LOCAL_STORE,
                type: :string,
                banner: "FILENAME",
-               desc: "Load events from a local file instead of Google Calendar"
+               desc: "Load events from a local file instead of Google Calendar",
+               aliases: [ "-l" ]
+      end
+
+      def self.has_events
+        option CalendarAssistant::Config::Keys::Options::MUST_BE,
+               type: :string,
+               desc: "Event properties that must be true (see README)",
+               banner: "PROPERTY1[,PROPERTY2[,...]]",
+               aliases: [ "-b" ]
+        option CalendarAssistant::Config::Keys::Options::MUST_NOT_BE,
+               type: :string,
+               desc: "Event properties that must be false (see README)",
+               banner: "PROPERTY1[,PROPERTY2[,...]]",
+               aliases: [ "-n" ]
       end
 
       def self.has_attendees
@@ -35,14 +47,16 @@ class CalendarAssistant
       class_option CalendarAssistant::Config::Keys::Options::FORMATTING,
                    type: :boolean,
                    desc: "Enable Text Formatting",
-                   default: CalendarAssistant::Config::DEFAULT_SETTINGS[CalendarAssistant::Config::Keys::Options::FORMATTING]
+                   default: CalendarAssistant::Config::DEFAULT_SETTINGS[CalendarAssistant::Config::Keys::Options::FORMATTING],
+                   aliases: "-f"
+
 
       desc "version",
            "Display the version of calendar-assistant"
 
       def version
         return if handle_help_args
-        out.puts CalendarAssistant::VERSION
+        command_service.out.puts CalendarAssistant::VERSION
       end
 
 
@@ -52,7 +66,7 @@ class CalendarAssistant
       def config
         return if handle_help_args
         settings = CalendarAssistant::CLI::Config.new.settings
-        out.puts TOML::Generator.new({CalendarAssistant::Config::Keys::SETTINGS => settings}).body
+        command_service.out.puts TOML::Generator.new({CalendarAssistant::Config::Keys::SETTINGS => settings}).body
       end
 
 
@@ -72,14 +86,14 @@ class CalendarAssistant
         # TODO ugh see #34 for advice on how to clean this up
         return if handle_help_args
         if File.exist? CalendarAssistant::CLI::Authorizer::CREDENTIALS_PATH
-          out.puts sprintf("Credentials already exist in %s",
-                           CalendarAssistant::CLI::Authorizer::CREDENTIALS_PATH)
+          command_service.out.puts sprintf("Credentials already exist in %s",
+                                           CalendarAssistant::CLI::Authorizer::CREDENTIALS_PATH)
           return
         end
 
-        out.launch "https://developers.google.com/calendar/quickstart/ruby"
+        command_service.out.launch "https://developers.google.com/calendar/quickstart/ruby"
         sleep 1
-        out.puts <<~EOT
+        command_service.out.puts <<~EOT
         Please click on "ENABLE THE GOOGLE CALENDAR API" and either create a new project or select an existing project.
 
         (If you create a new project, name it something like "yourname-calendar-assistant" so you remember why it exists.)
@@ -89,13 +103,13 @@ class CalendarAssistant
         Finally, paste the contents of the downloaded file here (it should be a complete JSON object):
         EOT
 
-        json = out.prompt "Paste JSON here"
+        json = command_service.out.prompt "Paste JSON here"
         File.open(CalendarAssistant::CLI::Authorizer::CREDENTIALS_PATH, "w") do |f|
           f.write json
         end
         FileUtils.chmod 0600, CalendarAssistant::CLI::Authorizer::CREDENTIALS_PATH
 
-        out.puts "\nOK! Your next step is to run `calendar-assistant authorize`."
+        command_service.out.puts "\nOK! Your next step is to run `calendar-assistant authorize`."
       end
 
 
@@ -117,7 +131,7 @@ class CalendarAssistant
         return if handle_help_args
         return help! if profile_name.nil?
 
-        get_authorizer(profile_name: profile_name).authorize
+        command_service.authorizer(profile_name: profile_name).authorize
 
         puts "\nYou're authorized!\n\n"
       end
@@ -127,13 +141,14 @@ class CalendarAssistant
       will_create_a_service
       has_attendees
 
+      has_events
       def lint datespec = "today"
-        calendar_assistant(datespec) do |ca, date|
+        calendar_assistant(datespec) do |ca, date, out|
           event_set = ca.lint_events date
           out.print_events ca, event_set, presenter_class: CalendarAssistant::CLI::LinterEventSetPresenter
         end
       end
-      
+
       desc "show [DATE | DATERANGE | TIMERANGE]",
            "Show your events for a date or range of dates (default 'today')"
       option CalendarAssistant::Config::Keys::Options::COMMITMENTS,
@@ -143,8 +158,9 @@ class CalendarAssistant
       will_create_a_service
       has_attendees
 
+      has_events
       def show datespec = "today"
-        calendar_assistant(datespec) do |ca, date|
+        calendar_assistant(datespec) do |ca, date, out|
           event_set = ca.find_events date
           out.print_events ca, event_set
         end
@@ -158,18 +174,19 @@ class CalendarAssistant
              desc: "launch a browser to join the video call URL"
       will_create_a_service
 
+      has_events
       def join timespec = "now"
         return if handle_help_args
         set_formatting
-        ca = CalendarAssistant.new get_config, service: service
+        ca = CalendarAssistant.new command_service.config, service: command_service.service
         ca.in_env do
           event_set, url = CalendarAssistant::CLI::Helpers.find_av_uri ca, timespec
           if !event_set.empty?
-            out.print_events ca, event_set
-            out.puts url
-            out.launch url if options[CalendarAssistant::Config::Keys::Options::JOIN]
+            command_service.out.print_events ca, event_set
+            command_service.out.puts url
+            command_service.out.launch url if options[CalendarAssistant::Config::Keys::Options::JOIN]
           else
-            out.puts "Could not find a meeting '#{timespec}' with a video call to join."
+            command_service.out.puts "Could not find a meeting '#{timespec}' with a video call to join."
           end
         end
       end
@@ -179,8 +196,9 @@ class CalendarAssistant
            "Show your location for a date or range of dates (default 'today')"
       will_create_a_service
 
+      has_events
       def location datespec = "today"
-        calendar_assistant(datespec) do |ca, date|
+        calendar_assistant(datespec) do |ca, date, out|
           event_set = ca.find_location_events date
           out.print_events ca, event_set
         end
@@ -189,12 +207,16 @@ class CalendarAssistant
 
       desc "location-set LOCATION [DATE | DATERANGE]",
            "Set your location to LOCATION for a date or range of dates (default 'today')"
+      option CalendarAssistant::Config::Keys::Settings::VISIBILITY,
+             type: :string,
+             banner: "VISIBILITY",
+             desc: "[default is 'default'] Set the visbility of the event. Values are 'public', 'private', 'default'."
       will_create_a_service
-
+      has_events
       def location_set location = nil, datespec = "today"
         return help! if location.nil?
 
-        calendar_assistant(datespec) do |ca, date|
+        calendar_assistant(datespec) do |ca, date, out|
           event_set = ca.create_location_event date, location
           out.print_events ca, event_set
         end
@@ -223,9 +245,9 @@ class CalendarAssistant
              aliases: ["-e"]
       has_attendees
       will_create_a_service
-
+      has_events
       def availability datespec = "today"
-        calendar_assistant(datespec) do |ca, date|
+        calendar_assistant(datespec) do |ca, date, out|
           event_set = ca.availability date
           out.print_available_blocks ca, event_set
         end
@@ -237,36 +259,14 @@ class CalendarAssistant
         Rainbow.enabled = !!options[:formatting]
       end
 
-      def service
-        @service ||= begin
-          if filename = get_config.setting(Config::Keys::Options::LOCAL_STORE)
-            CalendarAssistant::LocalService.new(file: filename)
-          else
-            get_authorizer.service
-          end
-        end
+      def command_service
+        @command_service ||= CommandService.new(context: current_command_chain.first, options: options)
       end
 
-      def get_authorizer(profile_name: get_config.profile_name, token_store: get_config.token_store)
-        @authorizer ||= {}
-        @authorizer[profile_name] ||= Authorizer.new(profile_name, token_store)
-      end
-
-      def calendar_assistant datespec = "today"
+      def calendar_assistant datespec = "today", &block
         return if handle_help_args
         set_formatting
-        ca = CalendarAssistant.new(get_config, service: service)
-        ca.in_env do
-          yield(ca, CalendarAssistant::CLI::Helpers.parse_datespec(datespec))
-        end
-      end
-
-      def get_config
-        @config ||= CalendarAssistant::CLI::Config.new(options: options)
-      end
-
-      def out
-        @out ||= CalendarAssistant::CLI::Printer.new
+        command_service.calendar_assistant(datespec, &block)
       end
 
       def help!

data/lib/calendar_assistant/config.rb

@@ -1,3 +1,4 @@
+# coding: utf-8
 class CalendarAssistant
   class Config
     autoload :TokenStore, "calendar_assistant/config/token_store"
@@ -16,11 +17,13 @@ class CalendarAssistant
       #  and which can be overridden by entries in the user config file
       #
       module Settings
-        PROFILE = "profile"               # string
-        MEETING_LENGTH = "meeting-length" # ChronicDuration
-        START_OF_DAY = "start-of-day"     # BusinessTime
-        END_OF_DAY = "end-of-day"         # BusinessTime
-        LOCATION_ICONS = "location-icons" # Location Icons
+        PROFILE = "profile"                 # string
+        MEETING_LENGTH = "meeting-length"   # ChronicDuration
+        START_OF_DAY = "start-of-day"       # BusinessTime
+        END_OF_DAY = "end-of-day"           # BusinessTime
+        LOCATION_ICON = "location-icon"     # string emoji
+        NICKNAME = "nickname"               # string
+        VISIBILITY = "visibility"           # Event Visibility
       end
 
       #
@@ -34,13 +37,16 @@ class CalendarAssistant
         LOCAL_STORE = "local-store" # filename
         DEBUG = "debug"             # bool
         FORMATTING = "formatting"   # Rainbow
+        MUST_BE = "must-be"         # array of event predicates (comma-delimited)
+        MUST_NOT_BE = "must-not-be" # array of event predicates (comma-delimited)
+        CONTEXT = "context"         # symbol referring to command context
       end
     end
 
     DEFAULT_CALENDAR_ID = "primary"
 
     DEFAULT_SETTINGS = {
-      Keys::Settings::LOCATION_ICONS => ["🗺 ", "🌎"],    # Location Icons
+      Keys::Settings::LOCATION_ICON => "🌎",              # string emoji
       Keys::Settings::MEETING_LENGTH => "30m",            # ChronicDuration
       Keys::Settings::START_OF_DAY => "9am",              # BusinessTime
       Keys::Settings::END_OF_DAY => "6pm",                # BusinessTime
@@ -110,7 +116,9 @@ class CalendarAssistant
     #  and settings
     #
     def setting setting_name
+      context = Config.find_in_hash(options, Keys::Options::CONTEXT)
       Config.find_in_hash(options, setting_name) ||
+        Config.find_in_hash(user_config, [Keys::SETTINGS, context, setting_name]) ||
         Config.find_in_hash(user_config, [Keys::SETTINGS, setting_name]) ||
         Config.find_in_hash(defaults, setting_name)
     end
@@ -140,11 +148,15 @@ class CalendarAssistant
     #  helper method for Keys::Options::ATTENDEES
     #
     def attendees
-      a = setting(Keys::Options::ATTENDEES)
-      if a.is_a?(String)
-        a = a.split(",")
-      end
-      a
+      split_if_array(Keys::Options::ATTENDEES)
+    end
+
+    def must_be
+      split_if_array(Keys::Options::MUST_BE)
+    end
+
+    def must_not_be
+      split_if_array(Keys::Options::MUST_NOT_BE)
     end
 
     def debug?
@@ -155,8 +167,28 @@ class CalendarAssistant
       #noop
     end
 
+    def event_visibility
+      value = setting(Keys::Settings::VISIBILITY)
+      case value
+      when CalendarAssistant::Event::Visibility::PUBLIC
+        CalendarAssistant::Event::Visibility::PUBLIC
+      when CalendarAssistant::Event::Visibility::PRIVATE
+        CalendarAssistant::Event::Visibility::PRIVATE
+      else
+        CalendarAssistant::Event::Visibility::DEFAULT
+      end
+    end
+
     private
 
+    def split_if_array(key)
+      a = setting(key)
+      if a.is_a?(String)
+        a = a.split(",")
+      end
+      a
+    end
+
     def self.find_in_hash hash, keypath
       current_val = hash
       keypath = keypath.split(".") unless keypath.is_a?(Array)

data/lib/calendar_assistant/event.rb

@@ -27,6 +27,45 @@ class CalendarAssistant
       PRIVATE = "private"
     end
 
+    PREDICATES = {
+        "response": %I[
+          accepted?
+          declined?
+          awaiting?
+          tentative?
+        ],
+        "temporal": %I[
+          all_day?
+          past?
+          current?
+          future?
+        ],
+        "visibility": %I[
+          private?
+          public?
+          explicitly_visible?
+          visible_guestlist?
+        ],
+        "attributes": %I[
+          location_event?
+          self?
+          one_on_one?
+          busy?
+          commitment?
+          recurring?
+          abandoned?
+          anyone_can_add_self?
+          attendees_omitted?
+          end_time_unspecified?
+          guests_can_invite_others?
+          guests_can_modify?
+          guests_can_see_other_guests?
+          private_copy?
+          locked?
+          needs_action?
+      ]
+    }
+
     #
     #  class methods
     #
@@ -34,17 +73,20 @@ class CalendarAssistant
       (end_time.to_datetime - start_time.to_datetime).days.to_i
     end
 
+    def self.location_event_prefix config
+      icon = config[CalendarAssistant::Config::Keys::Settings::LOCATION_ICON]
+      if nickname = config[CalendarAssistant::Config::Keys::Settings::NICKNAME]
+        return "#{icon} #{nickname} @ "
+      end
+      "#{icon} "
+    end
+
     #
     #  instance methods
     #
-    attr_reader :location_event_regex
-
     def initialize(obj, config: CalendarAssistant::Config.new)
-
       super(obj)
-      @location_icons = config[CalendarAssistant::Config::Keys::Settings::LOCATION_ICONS]
-
-      @location_event_regex = /^#{@location_icons.join("|")}/
+      @config = config
     end
 
     def update **args
@@ -53,7 +95,7 @@ class CalendarAssistant
     end
 
     def location_event?
-      !! (summary =~ location_event_regex)
+      !! summary.try(:starts_with?, Event.location_event_prefix(@config))
     end
 
     def all_day?
@@ -240,5 +282,6 @@ class CalendarAssistant
     def contains? time
       start_time <= time && time < end_time
     end
+
   end
 end

data/lib/calendar_assistant/event_repository.rb

@@ -28,17 +28,13 @@ class CalendarAssistant
                                    )
       events = events.items.map { |e| CalendarAssistant::Event.new(e, config: config) }
 
-      unless predicates.empty?
-        events = events.select do |event|
-          predicates.all? { |predicate, value| event.public_send(predicate) == value }
-        end
-      end
-
+      events = filter_by_predicates(events, predicates) unless predicates.empty?
       CalendarAssistant::EventSet.new self, events
     end
 
     def new event_attributes
       event = Google::Apis::CalendarV3::Event.new DateHelpers.cast_dates(event_attributes)
+      event.visibility ||= config.event_visibility
       CalendarAssistant::Event.new(event, config: config)
     end
 
@@ -66,5 +62,18 @@ class CalendarAssistant
       )
       CalendarAssistant::Event.new e, config: config
     end
+
+    private
+
+    def filter_by_predicates(events, predicates)
+      valid_predicates = CalendarAssistant::Event::PREDICATES.values.flatten
+
+      events.select do |event|
+        predicates.all? do |predicate, value|
+          raise BaseException, "Invalid event predicate" unless valid_predicates.include?(predicate)
+          event.public_send(predicate) == value
+        end
+      end
+    end
   end
 end

data/lib/calendar_assistant/predicate_collection.rb

@@ -0,0 +1,21 @@
+class CalendarAssistant
+  module PredicateCollection
+
+    def self.build(must_be, must_not_be)
+      predicates = {}
+      Array(must_be).each do |predicate|
+        predicates[predicate_symbol(predicate)] = true
+      end
+
+      Array(must_not_be).each do |predicate|
+        predicates[predicate_symbol(predicate)] = false
+      end
+
+      predicates
+    end
+
+    def self.predicate_symbol(str)
+      str.to_s.gsub(/(.*[^?])$/, "\\1?").to_sym
+    end
+  end
+end

data/lib/calendar_assistant/scheduler.rb

@@ -26,10 +26,10 @@ class CalendarAssistant
       @ers = Array(event_repositories)
     end
 
-    def available_blocks time_range
+    def available_blocks time_range, predicates: {}
       avail = nil
       ers.each do |er|
-        event_set = er.find time_range # array
+        event_set = er.find time_range, predicates: predicates # array
         event_set = Scheduler.select_busy_events event_set # hash
         event_set.ensure_keys time_range.first.to_date .. time_range.last.to_date, only: true
 

data/lib/calendar_assistant/version.rb

@@ -1,3 +1,3 @@
 class CalendarAssistant
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: calendar-assistant
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Mike Dalessio
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-16 00:00:00.000000000 Z
+date: 2019-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -76,7 +76,7 @@ dependencies:
         version: '0.24'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.28'
+        version: '0.29'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -86,7 +86,7 @@ dependencies:
         version: '0.24'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.28'
+        version: '0.29'
 - !ruby/object:Gem::Dependency
   name: launchy
   requirement: !ruby/object:Gem::Requirement
@@ -288,6 +288,7 @@ files:
 - lib/calendar_assistant/calendar_assistant.rb
 - lib/calendar_assistant/cli.rb
 - lib/calendar_assistant/cli/authorizer.rb
+- lib/calendar_assistant/cli/command_service.rb
 - lib/calendar_assistant/cli/commands.rb
 - lib/calendar_assistant/cli/config.rb
 - lib/calendar_assistant/cli/event_presenter.rb
@@ -306,6 +307,7 @@ files:
 - lib/calendar_assistant/extensions/google_apis_extensions.rb
 - lib/calendar_assistant/extensions/rainbow_extensions.rb
 - lib/calendar_assistant/local_service.rb
+- lib/calendar_assistant/predicate_collection.rb
 - lib/calendar_assistant/scheduler.rb
 - lib/calendar_assistant/string_helpers.rb
 - lib/calendar_assistant/version.rb