nora 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e715c379310ef757bb3966ac8ad8e7acfdaea0b3
+  data.tar.gz: 3ab1d31c524fbd4a5ca36b1cd6dba635e76f3c78
+SHA512:
+  metadata.gz: 50db09d25467fa6932c0f83f3af3b37863f000bde246dc9618645c8b8c85fa6aff72fa9e2ab0abe3c0f347f9a35b7d6b7268cb2429f25d1174e2af8e55b5dad6
+  data.tar.gz: bd4095e283356bf8229ff51e510dd0822e8c9498c6bd98b438afcf64654b19f9c74f0ce1012cc62298382ff0a38e5acaf5648e6b11613724a33e26255c02fdc2

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.DS_Store
+nora_client_secret.json
+nora_configuration.json
+past_pairings.txt
+calendar-ruby-quickstart.yaml
+*.gem

data/.overcommit.yml

@@ -0,0 +1,57 @@
+verify_signatures: false
+CommitMsg:
+  CapitalizedSubject:
+    enabled: true
+  HardTabs:
+    enabled: true
+  RussianNovel:
+    enabled: true
+  SingleLineSubject:
+    enabled: true
+  TextWidth:
+    enabled: true
+  TrailingPeriod:
+    enabled: true
+PreCommit:
+  ALL:
+    problem_on_unmodified_line: "warn"
+  AuthorEmail:
+    enabled: true
+  AuthorName:
+    enabled: true
+  Brakeman: # Performs static code security checking.
+    enabled: true
+  BrokenSymlinks:
+    enabled: true
+  BundleCheck:
+    enabled: false
+  CssLint:
+    enabled: true
+  HamlLint:
+    enabled: true
+  HardTabs:
+    enabled: true
+  HtmlTidy: # Uses the `tidy` executable (installed on OS X by default).
+    enabled: true
+  JsonSyntax:
+    enabled: true
+  LocalPathsInGemfile:
+    enabled: false
+  MergeConflicts:
+    enabled: true
+  PryBinding:
+    enabled: true
+  Reek:
+    enabled: false
+  RuboCop:
+    enabled: true
+    problem_on_unmodified_line: warn
+  ScssLint:
+    enabled: true
+  TrailingWhitespace:
+    enabled: true
+  TravisLint: # Checks Travis CI configurations. We use Travis for our open-
+              # source repositories.
+    enabled: true
+  YamlSyntax:
+    enabled: true

data/.rubocop.yml

@@ -0,0 +1,284 @@
+require:
+  - rubocop/rspec/focused
+
+# This (http://c2.com/cgi/wiki?AbcMetric) is super obnoxious
+AbcSize:
+  Enabled: false
+
+AccessorMethodName:
+  Enabled: false
+
+Alias:
+  Enabled: false
+
+AllCops:
+  Exclude:
+    - !ruby/regexp /vendor\/(?!panoramaed).*$/
+    - "spec/dummy/**/*"
+    - "db/schema.rb"
+    - "db/migrate/**/*"
+  TargetRubyVersion: 2.3
+
+AmbiguousOperator:
+  Enabled: false
+
+AmbiguousRegexpLiteral:
+  Enabled: false
+
+ArrayJoin:
+  Enabled: false
+
+AsciiComments:
+  Enabled: false
+
+AsciiIdentifiers:
+  Enabled: false
+
+AssignmentInCondition:
+  Enabled: true
+
+Attr:
+  Enabled: false
+
+BlockNesting:
+  Enabled: false
+
+BracesAroundHashParameters:
+  Enabled: false
+
+CaseEquality:
+  Enabled: false
+
+CharacterLiteral:
+  Enabled: false
+
+ClassLength:
+  Enabled: false
+
+ClassVars:
+  Enabled: false
+
+CollectionMethods:
+  PreferredMethods:
+    find: detect
+    reduce: inject
+    collect: map
+    find_all: select
+
+ColonMethodCall:
+  Enabled: false
+
+CommentAnnotation:
+  Enabled: false
+
+ConditionPosition:
+  Enabled: false
+
+CyclomaticComplexity:
+  Enabled: false
+
+Debugger:
+  Enabled: true
+  Severity: error
+
+Delegate:
+  Enabled: false
+
+DeprecatedClassMethods:
+  Enabled: false
+
+Documentation:
+  Enabled: false
+
+DotPosition:
+  EnforcedStyle: trailing
+
+DoubleNegation:
+  Enabled: false
+
+ElseLayout:
+  Enabled: false
+
+EmptyLiteral:
+  Enabled: false
+
+EmptyElse:
+  Enabled: false
+
+Encoding:
+  Enabled: false
+
+EvenOdd:
+  Enabled: false
+
+FileName:
+  Enabled: false
+
+FlipFlop:
+  Enabled: false
+
+FormatString:
+  Enabled: false
+
+FrozenStringLiteralComment:
+  Enabled: false
+
+GlobalVars:
+  Enabled: false
+
+GuardClause:
+  Enabled: false
+
+HandleExceptions:
+  Enabled: false
+
+IfUnlessModifier:
+  Enabled: false
+
+IfWithSemicolon:
+  Enabled: false
+
+InvalidCharacterLiteral:
+  Enabled: false
+
+Lambda:
+  Enabled: false
+
+LambdaCall:
+  Enabled: false
+
+LineEndConcatenation:
+  Enabled: false
+
+LineLength:
+  Max: 80
+
+LiteralInCondition:
+  Enabled: false
+
+LiteralInInterpolation:
+  Enabled: false
+
+Loop:
+  Enabled: false
+
+MethodLength:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+ModuleFunction:
+  Enabled: false
+
+NegatedIf:
+  Enabled: false
+
+NegatedWhile:
+  Enabled: false
+
+Next:
+  Enabled: false
+
+NilComparison:
+  Enabled: false
+
+Not:
+  Enabled: false
+
+NumericLiterals:
+  Enabled: false
+
+OneLineConditional:
+  Enabled: false
+
+OpMethod:
+  Enabled: false
+
+ParameterLists:
+  Enabled: false
+
+ParenthesesAsGroupedExpression:
+  Enabled: false
+
+PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%': '{}'
+
+PerceivedComplexity:
+  Enabled: false
+
+PerlBackrefs:
+  Enabled: false
+
+PredicateName:
+  Enabled: false
+
+PreferredHashMethods:
+  Enabled: false
+
+Proc:
+  Enabled: false
+
+RaiseArgs:
+  Enabled: false
+
+RedundantReturn:
+  AllowMultipleReturnValues: true
+
+RegexpLiteral:
+  Enabled: false
+
+RequireParentheses:
+  Enabled: false
+
+RSpec/Focused:
+  Enabled: true
+
+SelfAssignment:
+  Enabled: false
+
+SignalException:
+  EnforcedStyle: only_raise
+
+SingleLineBlockParams:
+  Enabled: false
+
+SingleLineMethods:
+  Enabled: false
+
+SpecialGlobalVars:
+  Enabled: false
+
+StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/TrailingCommaInArguments:
+  Enabled: false
+
+Style/TrailingCommaInLiteral:
+  Enabled: false
+
+Style/VariableInterpolation:
+  Enabled: true
+
+TrivialAccessors:
+  Enabled: false
+
+UnderscorePrefixedVariableName:
+  Enabled: false
+
+Void:
+  Enabled: false
+
+WhenThen:
+  Enabled: false
+
+WhileUntilModifier:
+  Enabled: false
+
+WordArray:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.3.0

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.6

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in nora.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Panorama Education
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,112 @@
+# NORA
+
+NORA (named because she "brings P-A-NORA-M-A together") is a Ruby gem that
+schedules meetings between coworkers and adds them to Google Calendar without
+any work on the part of the coworkers.
+
+We use these meetings (we call them "NORAs") to get to know one another better,
+grab coffee, brainstorm new ideas... whatever tickles our fancy
+at the time. But you can choose to be as strict or as loose about your
+organization's NORAs as you like.
+
+**NOTE: This code is experimental. It works for us, but if it doesn't work for
+you we'd love to hear about it so we can make it better.**
+
+## Installation
+
+1. `gem install nora`
+2. Use [Google's Developer Console](https://console.developers.google.com/projectselector/apis/credentials)
+to create a new project and a new OAuth 2.0 client ID for NORA to use. Download
+that file and rename it `nora_client_secret.json`.
+3. Obtain a [SendGrid](https://sendgrid.com) username and password. (This is
+used for sending emails when scheduling.) If you use Heroku, you can obtain a
+username and password easily by adding the free SendGrid add-on and then using
+the username and password that are set automatically in config variables.
+4. Copy the [`examples/nora_configuration.json`](https://github.com/panorama-ed/nora/blob/master/examples/nora_configuration.json) file from this repo into the folder from
+which you intend to run the `nora` program. Edit the file to include the names
+and email addresses you want, your SendGrid credentials, and any other changes
+you like.
+5. While logged in to Google Calendar (as the user you intend to run NORA as,
+which is most likely yourself), use the "Add a friend's/coworker's calendar"
+box to add the calendars for everyone you added to your
+`nora_configuration.json` file. *Note that this step may not be necessary but
+not doing it can occasionally cause people to get skipped when scheduling.*
+
+## Usage
+
+Once you've gone through the installation steps above, you can schedule meetings
+by running this command in your shell/terminal/console from the directory that
+contains your `nora_configuration.json` and `nora_client_secret.json` files:
+
+```bash
+nora --weeks-ahead <how many weeks ahead to schedule>
+```
+
+For example:
+
+```bash
+nora --weeks-ahead 2
+```
+
+NORA automatically keeps track of who's been scheduled together in the past via
+the `past_pairings.txt` file, so that the same folks don't get scheduled
+together often.
+
+#### Adding/Removing People
+
+To add someone for future scheduling, simply add their name and email address
+to `nora_configuration.json`, and add them to your Google Calendar as you did in
+installation step 5.
+
+To remove someone, just remove them from `nora_configuration.json`.
+
+## Troubleshooting
+
+#### NORA isn't scheduling someone!
+
+Make sure that they're in the `nora_configuration.json` file with the correct
+email address, and that you've also added their email to the Google Calendar of
+the user running NORA (see installation step 5).
+
+#### NORA is scheduling events at the same time as full-day events!
+
+Unfortunately this is due to a bug in how Google Calendar calculates when
+someone is "busy." See
+[here](https://productforums.google.com/forum/#!topic/calendar/qAOwI540nu4) for
+more details.
+
+#### I'm seeing "Authorization failed" errors!
+
+NOTE: If you consistently get errors that look like this:
+
+```
+/Users/jacobevelyn/.gem/ruby/2.2.0/gems/signet-0.7.2/lib/signet/oauth_2/client.rb:981:in `fetch_access_token': Authorization failed.  Server message: (Signet::AuthorizationError)
+{
+  "error": "invalid_grant",
+  "error_description": "Bad Request"
+}
+    from /Users/jacobevelyn/.gem/ruby/2.2.0/gems/signet-0.7.2/lib/signet/oauth_2/client.rb:998:in `fetch_access_token!'
+    ...
+```
+
+then all you need to do is delete the credentials file and re-run the program.
+This will create a new credentials file.
+
+#### I have another question or issue!
+
+No problem! Simply create a GitHub Issue and we'll get you straightened out.
+
+## Contributing
+
+1. Fork it (https://github.com/panorama-ed/nora/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+**Make sure your changes conform to the Rubocop style specified.** We use
+[overcommit](https://github.com/causes/overcommit) to enforce consistent code.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://github.com/panorama-ed/nora/blob/master/LICENSE.txt).

data/exe/nora

@@ -0,0 +1,50 @@
+#! /usr/bin/env ruby
+
+require "optparse"
+
+require_relative "../lib/nora.rb"
+
+# @return [Hash] A hash of command line options:
+#   :weeks_ahead => How many weeks ahead to schedule
+#   :test => True iff we're testing the script (default: false)
+def parsed_options
+  options = {}
+
+  parser = OptionParser.new do |opts|
+    opts.banner = "Usage: nora --weeks-ahead <weeks>"
+
+    opts.on(
+      "--weeks-ahead <weeks>",
+      "(required) How many weeks ahead to schedule"
+    ) do |weeks|
+      options[:weeks_ahead] = weeks.to_i
+    end
+
+    # Default to not using test mode
+    options[:test] = false
+
+    opts.on(
+      "--test",
+      "Testing mode. Does not actually schedule anything or send any emails."
+    ) do |test|
+      options[:test] = test
+    end
+
+    opts.on_tail("-h", "--help", "Show this message") do
+      puts opts
+      exit
+    end
+  end
+
+  parser.parse!
+
+  if !options[:weeks_ahead] || options[:weeks_ahead] < 1
+    puts "Missing argument: weeks-ahead"
+    puts parser
+    exit
+  end
+
+  options
+end
+
+Nora::Core.new(parsed_options).run!

data/lib/nora.rb

@@ -0,0 +1,5 @@
+require "nora/core"
+require "nora/version"
+
+module Nora
+end

data/lib/nora/core.rb

@@ -0,0 +1,380 @@
+require "google/apis/calendar_v3"
+require "googleauth"
+require "googleauth/stores/file_token_store"
+
+require "fileutils"
+
+require "active_support"
+require "active_support/core_ext/time/zones"
+require "active_support/core_ext/numeric/time"
+require "active_support/duration"
+require "chronic"
+require "pony"
+
+module Nora
+  class Core
+    extend Memoist
+
+    PAIRINGS_FILE = "past_pairings.txt".freeze
+    PAIRINGS_FILE_SEPARATOR = " ".freeze
+
+    OOB_URI = "urn:ietf:wg:oauth:2.0:oob".freeze
+    CLIENT_SECRETS_PATH = "nora_client_secret.json".freeze
+    CREDENTIALS_PATH = "calendar-ruby-quickstart.yaml".freeze
+    SCOPE = Google::Apis::CalendarV3::AUTH_CALENDAR
+
+    FREE_BUSY_QUERY_BATCH_SIZE = 5
+
+    CONFIGURATION = JSON.parse(File.read("nora_configuration.json"))
+
+    Pony.options = {
+      via: :smtp,
+      via_options: {
+        address: "smtp.sendgrid.net",
+        port: "587",
+        domain: CONFIGURATION["email"]["domain"],
+        authentication: :plain,
+        enable_starttls_auto: true,
+
+        # These Sendgrid credentials come from the Heroku addon.
+        user_name:
+          CONFIGURATION["email"]["sendgrid_configuration"]["user_name"],
+        password: CONFIGURATION["email"]["sendgrid_configuration"]["password"],
+      }
+    }
+
+    def initialize(weeks_ahead:, test:)
+      puts
+
+      @weeks_ahead = weeks_ahead
+      @test = test
+
+      FileUtils.touch(PAIRINGS_FILE) # Make sure pairings file exists.
+
+      # Set global Chronic parsing time zone.
+      Time.zone = "UTC"
+      Chronic.time_class = Time.zone
+
+      # Initialize the API
+      @service = Google::Apis::CalendarV3::CalendarService.new
+      @service.client_options.application_name =
+        CONFIGURATION["calendar"]["application_name"]
+      @service.authorization = authorize
+    end
+
+    def run!
+      begin
+        load_history!
+        puts "Creating groups..."
+        create_groups!
+      rescue SystemStackError
+        remove_oldest_pair!
+
+        retry
+      end
+
+      send_emails(
+        template_emails_for(
+          schedule_meetings!
+        )
+      )
+
+      puts "Done."
+    end
+
+    private
+
+    def remove_oldest_pair!
+      puts "Removing oldest pair and retrying..."
+      File.open("past_pairings_tmp.txt", "w") do |file|
+        File.open(PAIRINGS_FILE).each.with_index(1) do |line, line_num|
+          file.puts(line) unless line_num == 1
+        end
+      end
+      FileUtils.mv("past_pairings_tmp.txt", PAIRINGS_FILE)
+    end
+
+    def load_history!
+      puts "Loading history..."
+      @history = Set.new
+      File.open(PAIRINGS_FILE).each do |line|
+        line.split(PAIRINGS_FILE_SEPARATOR).permutation.each do |emails|
+          @history << emails
+        end
+      end
+    end
+
+    def create_groups!
+      @emails = CONFIGURATION["people"].map { |p| p["email"] }.shuffle
+      @emails.each_slice(group_size).each do |emails|
+        return create_groups! unless (@history & emails.combination(2)).empty?
+      end
+    end
+
+    # @return [Array<Hash>] list of meetings, of the format:
+    #   { on: <Time>, who: [{ email: ..., name: ... }, ...] }
+    def schedule_meetings!
+      puts "Scheduling meetings..."
+
+      meetings = []
+
+      @emails.each_slice(group_size) do |emails|
+        if emails.size < group_size
+          puts "\nNot enough people in group: #{emails}\n"
+          meetings << {
+            on: :no_group,
+            week_of: availability_schedule.keys.first,
+            who: emails.map do |email|
+              { email: email, name: email_name(email) }
+            end
+          }
+          next
+        end
+
+        time = availability_schedule.select do |_, ids|
+          ids.superset? Set.new(emails)
+        end.keys.sample
+
+        if time.nil?
+          puts "\nNo time found for #{emails}\n"
+          meetings << {
+            on: :no_time,
+            week_of: availability_schedule.keys.first,
+            who: emails.map do |email|
+              { email: email, name: email_name(email) }
+            end
+          }
+        else
+          puts "#{time} => #{emails}"
+          add_meeting(time: time, attendee_ids: emails)
+
+          unless @test
+            File.open(PAIRINGS_FILE, "a") do |file|
+              emails.combination(2) do |email_pair|
+                file.puts email_pair.join(PAIRINGS_FILE_SEPARATOR)
+              end
+            end
+          end
+
+          meetings << {
+            on: time,
+            who: emails.map do |email|
+              { email: email, name: email_name(email) }
+            end
+          }
+        end
+      end
+
+      meetings
+    end
+
+    def template_emails_for(appointments)
+      appointments.map do |appt|
+        names = appt[:who].map { |w| w[:name] }.join(" and ")
+
+        # rubocop:disable Style/MultilineMethodCallIndentation
+        message =
+          case appt[:on]
+          when :no_time
+            num_weeks = @weeks_ahead + 1
+            CONFIGURATION["email"]["templates"]["no_time"].
+              gsub("NAMES", names).
+              gsub("WEEKS_AHEAD", "#{num_weeks} #{'week'.pluralize(num_weeks)}")
+          when :no_group
+            num_weeks = @weeks_ahead + 1
+            CONFIGURATION["email"]["templates"]["no_group"].
+              gsub("WEEKS_AHEAD", "#{num_weeks} #{'week'.pluralize(num_weeks)}")
+          else
+            datetime = appt[:on].in_time_zone("Eastern Time (US & Canada)")
+            day = datetime.strftime("%B %-d")
+            military_time = datetime.strftime("%H%M")
+
+            CONFIGURATION["email"]["templates"]["default"].
+              gsub("NAMES", names).
+              gsub("DAY", day).
+              gsub("MILITARY_TIME", military_time).
+              gsub("ICEBREAKER", icebreaker)
+          end
+        # rubocop:enable Style/MultilineMethodCallIndentation
+
+        {
+          to: appt[:who],
+          subject: "NORA: Mission Briefing",
+          body: message
+        }
+      end
+    end
+
+    def send_emails(email_messages)
+      return if @test
+
+      puts "Sending emails..."
+
+      email_messages.each do |msg|
+        msg[:to].each do |to|
+          begin
+            Pony.mail(
+              to: to[:email],
+              from: CONFIGURATION["email"]["from_address"],
+              subject: msg[:subject],
+              body: msg[:body],
+              via: :smtp,
+              charset: "UTF-8"
+            )
+          rescue => e
+            puts e
+          end
+        end
+      end
+    end
+
+    def add_meeting(time:, attendee_ids:)
+      return if @test
+
+      @service.insert_event(
+        CONFIGURATION["calendar"]["id"],
+        Google::Apis::CalendarV3::Event.new(
+          summary:
+            "NORA: #{attendee_ids.map { |id| email_name(id) }.join('/')}",
+          description: "Icebreaker question: #{icebreaker}",
+          start: Google::Apis::CalendarV3::EventDateTime.new(
+            date_time: time.to_datetime
+          ),
+          end: Google::Apis::CalendarV3::EventDateTime.new(
+            date_time: (
+              time + CONFIGURATION["calendar"]["duration_in_minutes"]
+            ).to_datetime
+          ),
+          attendees: attendee_ids.map do |id|
+            Google::Apis::CalendarV3::EventAttendee.new(email: id)
+          end,
+          guests_can_modify: true
+        )
+      )
+    end
+
+    def availability_schedule
+      # Compute Hash of all possible times to set of all user IDs.
+      # rubocop:disable Metrics/LineLength
+      all_availabilities = CONFIGURATION["calendar"]["days_of_week"].flat_map do |day|
+        # rubocop:enable Metrics/LineLength
+        CONFIGURATION["calendar"]["start_times"].map do |time|
+          Chronic.parse("#{@weeks_ahead} weeks from next #{day} #{time}").utc
+        end
+      end.each_with_object({}) do |time, h|
+        h[time] = Set.new(calendars.map(&:id))
+      end
+
+      # Remove user IDs due to business constraints.
+      calendars.each_slice(FREE_BUSY_QUERY_BATCH_SIZE) do |cals|
+        @service.query_freebusy(
+          Google::Apis::CalendarV3::FreeBusyRequest.new(
+            time_min: start_of_week.iso8601,
+            time_max: end_of_week.iso8601,
+            time_zone: "UTC",
+            items: cals.map { |cal| { id: cal.id } }
+          )
+        ).calendars.each do |id, free_busy|
+          free_busy.busy.each do |busy_period|
+            all_availabilities.each do |time, ids|
+              if (busy_period.start.to_time <= (
+                time + CONFIGURATION["calendar"]["duration_in_minutes"] -
+                1.minute
+              )) && (busy_period.end.to_time >= (time + 1.minute))
+                ids.delete(id)
+              end
+            end
+          end
+        end
+      end
+
+      # Now remove hash values that have <2 IDs in their set.
+      all_availabilities.select { |_, ids| ids.size > 1 }
+    end
+    memoize :availability_schedule
+
+    def icebreaker
+      CONFIGURATION["icebreakers"].sample
+    end
+    memoize :icebreaker
+
+    def email_name(email)
+      email_name_map[email]
+    end
+
+    def email_name_map
+      CONFIGURATION["people"].each_with_object({}) do |data, h|
+        h[data["email"]] = data["name"]
+      end
+    end
+    memoize :email_name_map
+
+    def calendars
+      @service.list_calendar_lists.items.select do |calendar|
+        @emails.include? calendar.id
+      end
+    end
+    memoize :calendars
+
+    def start_of_week
+      Chronic.parse(
+        # rubocop:disable Metrics/LineLength
+        "#{@weeks_ahead} weeks from next #{CONFIGURATION['calendar']['days_of_week'].first} "\
+        "#{CONFIGURATION['calendar']['start_times'].first}"
+        # rubocop:enable Metrics/LineLength
+      )
+    end
+    memoize :start_of_week
+
+    def end_of_week
+      date_time = (
+        Chronic.parse(
+          # rubocop:disable Metrics/LineLength
+          "#{@weeks_ahead} weeks from next #{CONFIGURATION['calendar']['days_of_week'].last} "\
+          "#{CONFIGURATION['calendar']['start_times'].last}"
+          # rubocop:enable Metrics/LineLength
+        ) + CONFIGURATION["calendar"]["duration_in_minutes"].minutes
+      )
+
+      if date_time > start_of_week
+        date_time
+      else
+        date_time + 7.days
+      end
+    end
+    memoize :end_of_week
+
+    # Ensure valid credentials, either by restoring from the saved credentials
+    # files or intitiating an OAuth2 authorization. If authorization is
+    # required, the user will be instructed appropriately.
+    # @return [Google::Auth::UserRefreshCredentials] OAuth2 credentials
+    def authorize
+      FileUtils.mkdir_p(File.dirname(CREDENTIALS_PATH))
+
+      client_id = Google::Auth::ClientId.from_file(CLIENT_SECRETS_PATH)
+      token_store = Google::Auth::Stores::FileTokenStore.
+                    new(file: CREDENTIALS_PATH)
+      authorizer = Google::Auth::UserAuthorizer.
+                   new(client_id, SCOPE, token_store)
+      credentials = authorizer.
+                    get_credentials(CONFIGURATION["calendar"]["user_id"])
+      if credentials.nil?
+        url = authorizer.get_authorization_url(base_url: OOB_URI)
+        puts "Open the following URL in the browser and enter the " +
+             "resulting code after authorization"
+        puts url
+        code = gets
+        credentials = authorizer.get_and_store_credentials_from_code(
+          user_id: CONFIGURATION["calendar"]["user_id"],
+          code: code,
+          base_url: OOB_URI
+        )
+      end
+      credentials
+    end
+
+    def group_size
+      CONFIGURATION["group_size"]
+    end
+  end
+end

data/lib/nora/version.rb

@@ -0,0 +1,3 @@
+module Nora
+  VERSION = "0.1".freeze
+end

data/nora.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "nora/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "nora"
+  spec.version       = Nora::VERSION
+  spec.authors       = ["Jacob Evelyn"]
+  spec.email         = ["jevelyn@panoramaed.com"]
+
+  spec.summary       = "Bringing P-A-NORA-M-A together."
+  spec.description   = "Automatically schedule coffee dates with coworkers."
+  spec.homepage      = "https://github.com/panorama-ed/nora"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "overcommit", "~> 0.38"
+  spec.add_development_dependency "rubocop", "~> 0.47"
+
+  spec.add_dependency "pony", "~> 1.11"
+  spec.add_dependency "activesupport", "~> 5.0"
+  spec.add_dependency "chronic", "~> 0.10"
+  spec.add_dependency "google-api-client", "~> 0.10"
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: nora
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Jacob Evelyn
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-03-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: overcommit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.38'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.38'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+- !ruby/object:Gem::Dependency
+  name: pony
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: chronic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: google-api-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: Automatically schedule coffee dates with coworkers.
+email:
+- jevelyn@panoramaed.com
+executables:
+- nora
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".overcommit.yml"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- exe/nora
+- lib/nora.rb
+- lib/nora/core.rb
+- lib/nora/version.rb
+- nora.gemspec
+homepage: https://github.com/panorama-ed/nora
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Bringing P-A-NORA-M-A together.
+test_files: []