friends 0.34 → 0.35

data/lib/friends/introvert.rb

@@ -7,6 +7,7 @@
 require "set"
 
 require "friends/activity"
+require "friends/note"
 require "friends/friend"
 require "friends/graph"
 require "friends/location"
@@ -16,6 +17,7 @@ module Friends
   class Introvert
     DEFAULT_FILENAME = "./friends.md".freeze
     ACTIVITIES_HEADER = "### Activities:".freeze
+    NOTES_HEADER = "### Notes:".freeze
     FRIENDS_HEADER = "### Friends:".freeze
     LOCATIONS_HEADER = "### Locations:".freeze
 
@@ -33,7 +35,10 @@ module Friends
       File.open(@filename, "w") do |file|
         file.puts(ACTIVITIES_HEADER)
         stable_sort(@activities).each { |act| file.puts(act.serialize) }
-        file.puts # Blank line separating activities from friends.
+        file.puts # Blank line separating activities from notes.
+        file.puts(NOTES_HEADER)
+        stable_sort(@notes).each { |note| file.puts(note.serialize) }
+        file.puts # Blank line separating notes from friends.
         file.puts(FRIENDS_HEADER)
         @friends.sort.each { |friend| file.puts(friend.serialize) }
         file.puts # Blank line separating friends from locations.
@@ -64,12 +69,20 @@ module Friends
     # @param serialization [String] the serialized activity
     # @return [Activity] the added activity
     def add_activity(serialization:)
-      activity = Activity.deserialize(serialization)
-
-      activity.highlight_description(introvert: self) if activity.description
-      @activities.unshift(activity)
+      Activity.deserialize(serialization).tap do |activity|
+        activity.highlight_description(introvert: self) if activity.description
+        @activities.unshift(activity)
+      end
+    end
 
-      activity # Return the added activity.
+    # Add a note.
+    # @param serialization [String] the serialized note
+    # @return [Note] the added note
+    def add_note(serialization:)
+      Note.deserialize(serialization).tap do |note|
+        note.highlight_description(introvert: self) if note.description
+        @notes.unshift(note)
+      end
     end
 
     # Add a location.
@@ -226,36 +239,16 @@ module Friends
       list_favorite_things(:location, limit: limit)
     end
 
-    # List all activity details.
-    # @param limit [Integer] the number of activities to return, or nil for no
-    #   limit
-    # @param with [Array<String>] the names of friends to filter by, or empty for
-    #   unfiltered
-    # @param location_name [String] the name of a location to filter by, or
-    #   nil for unfiltered
-    # @param tagged [Array<String>] the names of tags to filter by, or empty for
-    #   unfiltered
-    # @param since_date [Date] a date on or after which to find activities, or nil for unfiltered
-    # @param until_date [Date] a date before or on which to find activities, or nil for unfiltered
-    # @return [Array] a list of all activity text values
-    # @raise [ArgumentError] if limit is present but limit < 1
-    # @raise [FriendsError] if friend, location or tag cannot be found or
-    #   is ambiguous
-    def list_activities(limit:, with:, location_name:, tagged:, since_date:, until_date:)
-      raise ArgumentError, "Limit must be positive" if limit && limit < 1
-
-      acts = filtered_activities(
-        with: with,
-        location_name: location_name,
-        tagged: tagged,
-        since_date: since_date,
-        until_date: until_date
-      )
-
-      # If we need to, trim the list.
-      acts = acts.take(limit) unless limit.nil?
+    # See `list_events` for all of the parameters we can pass.
+    # @return [Array] a list of all activities' text values
+    def list_activities(**args)
+      list_events(events: @activities, **args)
+    end
 
-      acts.map(&:to_s)
+    # See `list_events` for all of the parameters we can pass.
+    # @return [Array] a list of all notes' text values
+    def list_notes(**args)
+      list_events(events: @notes, **args)
     end
 
     # List all location names in the friends file.
@@ -264,20 +257,26 @@ module Friends
       @locations.map(&:name)
     end
 
-    # @param from [String] one of: ["activities", "friends", nil]
-    #   If not nil, limits the tags returned to only those from either
-    #   activities or friends.
+    # @param from [Array] containing any of: ["activities", "friends", "notes"]
+    #   If not empty, limits the tags returned to only those from either
+    #   activities, notes, or friends.
     # @return [Array] a sorted list of all tags in activity descriptions
     def list_tags(from:)
       output = Set.new
 
-      unless from == "friends" # If from is "activities" or nil.
+      if from.empty? || from.include?("activities")
         @activities.each_with_object(output) do |activity, set|
           set.merge(activity.tags)
         end
       end
 
-      unless from == "activities" # If from is "friends" or nil.
+      if from.empty? || from.include?("notes")
+        @notes.each_with_object(output) do |note, set|
+          set.merge(note.tags)
+        end
+      end
+
+      if from.empty? || from.include?("friends")
         @friends.each_with_object(output) do |friend, set|
           set.merge(friend.tags)
         end
@@ -310,7 +309,8 @@ module Friends
     # @raise [FriendsError] if friend, location or tag cannot be found or
     #   is ambiguous
     def graph(with:, location_name:, tagged:, since_date:, until_date:)
-      filtered_activities_to_graph = filtered_activities(
+      filtered_activities_to_graph = filtered_events(
+        events: @activities,
         with: with,
         location_name: location_name,
         tagged: tagged,
@@ -324,7 +324,8 @@ module Friends
       # activities might not include others in the full range (for instance,
       # if only one filtered activity matches a query, we don't want to only
       # show unfiltered activities that occurred on that specific day).
-      all_activities_to_graph = filtered_activities(
+      all_activities_to_graph = filtered_events(
+        events: @activities,
         with: [],
         location_name: nil,
         tagged: [],
@@ -461,16 +462,66 @@ module Friends
       @activities.size
     end
 
+    # @return [Integer] the total number of locations
+    def total_locations
+      @locations.size
+    end
+
+    # @return [Integer] the total number of notes
+    def total_notes
+      @notes.size
+    end
+
+    # @return [Integer] the total number of tags
+    def total_tags
+      list_tags(from: []).size
+    end
+
     # @return [Integer] the number of days elapsed between
     #   the first and last activity
     def elapsed_days
-      return 0 if @activities.size < 2
-      sorted_activities = @activities.sort
-      (sorted_activities.first.date - sorted_activities.last.date).to_i
+      events = @activities + @notes
+      return 0 if events.size < 2
+      sorted_events = events.sort
+      (sorted_events.first.date - sorted_events.last.date).to_i
     end
 
     private
 
+    # List all event details.
+    # @param events [Array<Event>] the base events to list, either @activities or @notes
+    # @param limit [Integer] the number of events to return, or nil for no
+    #   limit
+    # @param with [Array<String>] the names of friends to filter by, or empty for
+    #   unfiltered
+    # @param location_name [String] the name of a location to filter by, or
+    #   nil for unfiltered
+    # @param tagged [Array<String>] the names of tags to filter by, or empty for
+    #   unfiltered
+    # @param since_date [Date] a date on or after which to find events, or nil for unfiltered
+    # @param until_date [Date] a date before or on which to find events, or nil for unfiltered
+    # @return [Array] a list of all event (activity or note) text values
+    # @raise [ArgumentError] if limit is present but limit < 1
+    # @raise [FriendsError] if friend, location or tag cannot be found or
+    #   is ambiguous
+    def list_events(events:, limit:, with:, location_name:, tagged:, since_date:, until_date:)
+      raise ArgumentError, "Limit must be positive" if limit && limit < 1
+
+      events = filtered_events(
+        events: events,
+        with: with,
+        location_name: location_name,
+        tagged: tagged,
+        since_date: since_date,
+        until_date: until_date
+      )
+
+      # If we need to, trim the list.
+      events = events.take(limit) unless limit.nil?
+
+      events.map(&:to_s)
+    end
+
     # @param arr [Array] an unsorted array
     # @return [Array] a stably-sorted array
     def stable_sort(arr)
@@ -478,6 +529,7 @@ module Friends
     end
 
     # Filter activities by friend, location and tag
+    # @param events [Array<Event>] the base events to list, either @activities or @notes
     # @param with [Array<String>] the names of friends to filter by, or empty for
     #   unfiltered
     # @param location_name [String] the name of a location to filter by, or
@@ -489,35 +541,33 @@ module Friends
     # @return [Array] an array of activities
     # @raise [FriendsError] if friend, location or tag cannot be found or
     #   is ambiguous
-    def filtered_activities(with:, location_name:, tagged:, since_date:, until_date:)
-      acts = @activities
-
+    def filtered_events(events:, with:, location_name:, tagged:, since_date:, until_date:)
       # Filter by friend name if argument is passed.
       unless with.empty?
         friends = with.map { |name| thing_with_name_in(:friend, name) }
-        acts = acts.select do |act|
-          friends.all? { |friend| act.includes_friend?(friend) }
+        events = events.select do |event|
+          friends.all? { |friend| event.includes_friend?(friend) }
         end
       end
 
       # Filter by location name if argument is passed.
       unless location_name.nil?
         location = thing_with_name_in(:location, location_name)
-        acts = acts.select { |act| act.includes_location?(location) }
+        events = events.select { |event| event.includes_location?(location) }
       end
 
       # Filter by tag if argument is passed.
       unless tagged.empty?
-        acts = acts.select do |act|
-          tagged.all? { |tag| act.includes_tag?(tag) }
+        events = events.select do |event|
+          tagged.all? { |tag| event.includes_tag?(tag) }
         end
       end
 
       # Filter by date if arguments are passed.
-      acts = acts.select { |act| act.date >= since_date } unless since_date.nil?
-      acts = acts.select { |act| act.date <= until_date } unless until_date.nil?
+      events = events.select { |event| event.date >= since_date } unless since_date.nil?
+      events = events.select { |event| event.date <= until_date } unless until_date.nil?
 
-      acts
+      events
     end
 
     # @param type [Symbol] one of: [:friend, :location]
@@ -612,6 +662,7 @@ module Friends
     def read_file
       @friends = []
       @activities = []
+      @notes = []
       @locations = []
 
       return unless File.exist?(@filename)
@@ -650,7 +701,7 @@ module Friends
         end
 
         # If we made it here, we couldn't recognize a header.
-        bad_line("Couldn't parse line.", line_num)
+        bad_line("a valid header", line_num)
       end
 
       # If we made it this far, we're parsing objects in a class.
@@ -670,6 +721,7 @@ module Friends
     ParsingStage = Struct.new(:id, :klass)
     PARSING_STAGES = [
       ParsingStage.new(:activities, Activity),
+      ParsingStage.new(:notes, Note),
       ParsingStage.new(:friends, Friend),
       ParsingStage.new(:locations, Location)
     ].freeze

data/lib/friends/note.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Note represents a note--a dated record of something
+# about friends or locations that isn't an activity
+# you did. Notes are a good way to remember things big
+# and small, like when your friends move, change jobs,
+# get engaged, or just what food allergies they have
+# for the next time you have them over for dinner.
+
+require "friends/event"
+
+module Friends
+  class Note < Event
+    # @return [Regexp] the string of what we expected during deserialization
+    def self.deserialization_expectation
+      "[YYYY-MM-DD]: [Note]"
+    end
+  end
+end

data/lib/friends/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Friends
-  VERSION = "0.34".freeze
+  VERSION = "0.35".freeze
 end

data/test/add_event_helper.rb

@@ -0,0 +1,410 @@
+def date_parsing_specs(test_stdout: true)
+  describe "date parsing" do
+    let(:description) { "Test." }
+
+    describe "when date is in YYYY-MM-DD" do
+      let(:date) { "2017-01-01" }
+
+      it { line_added "- #{date}: #{description}" }
+      it { stdout_only "#{capitalized_event} added: \"#{date}: #{description}\"" } if test_stdout
+    end
+
+    describe "when date is in MM-DD-YYYY" do
+      let(:date) { "01-02-2017" }
+
+      it { line_added "- 2017-01-02: #{description}" }
+      it { stdout_only "#{capitalized_event} added: \"2017-01-02: #{description}\"" } if test_stdout
+    end
+
+    describe "when date is invalid" do
+      let(:date) { "2017-02-30" }
+
+      it { line_added "- 2017-03-02: #{description}" }
+      it { stdout_only "#{capitalized_event} added: \"2017-03-02: #{description}\"" } if test_stdout
+    end
+
+    describe "when date is natural language and in full" do
+      let(:date) { "February 23rd, 2017" }
+
+      it { line_added "- 2017-02-23: #{description}" }
+      it { stdout_only "#{capitalized_event} added: \"2017-02-23: #{description}\"" } if test_stdout
+    end
+
+    describe "when date is natural language and only month and day" do
+      # We use two days rather than just one to avoid strange behavior around
+      # edge cases when the test is being run right around midnight.
+      let(:two_days_in_seconds) { 2 * 24 * 60 * 60 }
+      let(:raw_date) { Time.now + two_days_in_seconds }
+      let(:date) { raw_date.strftime("%B %d") }
+      let(:expected_year) { raw_date.strftime("%Y").to_i - 1 }
+      let(:expected_date_str) { "#{expected_year}-#{raw_date.strftime('%m-%d')}" }
+
+      it { line_added "- #{expected_date_str}: #{description}" }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{expected_date_str}: #{description}\"" }
+      end
+    end
+  end
+end
+
+def description_parsing_specs(test_stdout: true)
+  describe "description parsing" do
+    let(:date) { Date.today.strftime }
+
+    describe "when description includes a friend's full name (case insensitive)" do
+      let(:description) { "Lunch with grace hopper." }
+
+      it { line_added "- #{date}: Lunch with **Grace Hopper**." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper.\"" }
+      end
+    end
+
+    describe "when description includes a friend's first name (case insensitive)" do
+      let(:description) { "Lunch with grace." }
+
+      it { line_added "- #{date}: Lunch with **Grace Hopper**." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper.\"" }
+      end
+    end
+
+    describe "when description has a friend's first name and last initial (case insensitive)" do
+      describe "when followed by no period" do
+        let(:description) { "Lunch with grace h" }
+
+        it { line_added "- #{date}: Lunch with **Grace Hopper**" }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper\"" }
+        end
+      end
+
+      describe "when followed by a period at the end of a sentence" do
+        let(:description) { "Met grace h. So fun!" }
+
+        it { line_added "- #{date}: Met **Grace Hopper**. So fun!" }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Met Grace Hopper. So fun!\"" }
+        end
+      end
+
+      describe "when followed by a period at the end of the description" do
+        let(:description) { "Lunch with grace h." }
+
+        it { line_added "- #{date}: Lunch with **Grace Hopper**." }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper.\"" }
+        end
+      end
+
+      describe "when followed by a period in the middle of a sentence" do
+        let(:description) { "Met grace h. at 12." }
+
+        it { line_added "- #{date}: Met **Grace Hopper** at 12." }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Met Grace Hopper at 12.\"" }
+        end
+      end
+    end
+
+    describe "when description includes a friend's nickname (case insensitive)" do
+      let(:description) { "Lunch with the admiral." }
+
+      it { line_added "- #{date}: Lunch with **Grace Hopper**." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper.\"" }
+      end
+    end
+
+    describe "when description includes a friend's nickname which contains a name" do
+      let(:description) { "Lunch with Amazing Grace." }
+
+      it { line_added "- #{date}: Lunch with **Grace Hopper**." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace Hopper.\"" }
+      end
+    end
+
+    describe "when description includes a friend's name at the beginning of a word" do
+      # Capitalization reduces chance of a false positive.
+      let(:description) { "Gracefully strolled." }
+
+      it { line_added "- #{date}: Gracefully strolled." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Gracefully strolled.\"" }
+      end
+    end
+
+    describe "when description includes a friend's name at the end of a word" do
+      # Capitalization reduces chance of a false positive.
+      let(:description) { "The service was a disGrace." }
+
+      it { line_added "- #{date}: The service was a disGrace." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: The service was a disGrace.\"" }
+      end
+    end
+
+    describe "when description includes a friend's name in the middle of a word" do
+      # Capitalization reduces chance of a false positive.
+      let(:description) { "The service was disGraceful." }
+
+      it { line_added "- #{date}: The service was disGraceful." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: The service was disGraceful.\"" }
+      end
+    end
+
+    describe "when a friend's name is escaped with a backslash" do
+      # We have to use four backslashes here because of Ruby's backslash escaping; when this
+      # goes through all of the layers of this test it emerges on the other side as a single one.
+      let(:description) { "Dinner with \\\\Grace Kelly." }
+
+      it { line_added "- #{date}: Dinner with Grace Kelly." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Dinner with Grace Kelly.\"" }
+      end
+    end
+
+    describe "hyphenated name edge cases" do
+      describe "when one name precedes another before a hyphen" do
+        let(:description) { "Shopped w/ Mary-Kate." }
+
+        # Make sure "Mary" is a closer friend than "Mary-Kate" so we know our
+        # test result isn't due to chance.
+        let(:content) do
+          <<-FILE
+### Activities:
+- 2017-01-01: Singing with **Mary Poppins**.
+
+### Notes:
+
+### Friends:
+- Mary Poppins
+- Mary-Kate Olsen
+
+### Locations:
+FILE
+        end
+
+        it { line_added "- #{date}: Shopped w/ **Mary-Kate Olsen**." }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Shopped w/ Mary-Kate Olsen.\"" }
+        end
+      end
+
+      describe "when one name follows another after a hyphen" do
+        let(:description) { "Shopped w/ Mary-Kate." }
+
+        # Make sure "Kate" is a closer friend than "Mary-Kate" so we know our
+        # test result isn't due to chance.
+        let(:content) do
+          <<-FILE
+### Activities:
+- 2017-01-01: Improv with **Kate Winslet**.
+
+### Notes:
+
+### Friends:
+- Kate Winslet
+- Mary-Kate Olsen
+
+### Locations:
+FILE
+        end
+
+        it { line_added "- #{date}: Shopped w/ **Mary-Kate Olsen**." }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Shopped w/ Mary-Kate Olsen.\"" }
+        end
+      end
+
+      describe "when one name is contained within another via hyphens" do
+        let(:description) { "Met Mary-Jo-Kate." }
+
+        # Make sure "Jo" is a closer friend than "Mary-Jo-Kate" so we know our
+        # test result isn't due to chance.
+        let(:content) do
+          <<-FILE
+### Activities:
+- 2017-01-01: Singing with **Jo Stafford**.
+
+### Notes:
+
+### Friends:
+- Jo Stafford
+- Mary-Jo-Kate Olsen
+
+### Locations:
+FILE
+        end
+
+        it { line_added "- #{date}: Met **Mary-Jo-Kate Olsen**." }
+        if test_stdout
+          it { stdout_only "#{capitalized_event} added: \"#{date}: Met Mary-Jo-Kate Olsen.\"" }
+        end
+      end
+    end
+
+    describe "when description has a friend's name with leading asterisks" do
+      let(:description) { "Lunch with **Grace Hopper." }
+
+      it { line_added "- #{date}: Lunch with **Grace Hopper." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with **Grace Hopper.\"" }
+      end
+    end
+
+    describe "when description has a friend's name with trailing asterisks" do
+      # Note: We can't guarantee that "Grace Hopper**" doesn't match because the "Grace" isn't
+      # surrounded by asterisks.
+      let(:description) { "Lunch with Grace**." }
+
+      it { line_added "- #{date}: Lunch with Grace**." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch with Grace**.\"" }
+      end
+    end
+
+    describe "when description has a friend's name multiple times" do
+      let(:description) { "Grace! Grace!!!" }
+
+      it { line_added "- #{date}: **Grace Hopper**! **Grace Hopper**!!!" }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Grace Hopper! Grace Hopper!!!\"" }
+      end
+    end
+
+    describe "when description has a name with multiple friend matches" do
+      describe "when there is useful context from past activities" do
+        let(:description) { "Met John + Elizabeth." }
+
+        # Create a past activity in which Elizabeth Cady Stanton did something
+        # with John Cage. Then, create past activities to make Elizabeth II a
+        # better friend than Elizabeth Cady Stanton.
+        let(:content) do
+          <<-FILE
+### Activities:
+- 2017-01-05: Picnic with **Elizabeth Cady Stanton** and **John Cage**.
+- 2017-01-04: Got lunch with **Elizabeth II**.
+- 2017-01-03: Ice skated with **Elizabeth II**.
+
+### Notes:
+
+### Friends:
+- Elizabeth Cady Stanton
+- Elizabeth II
+- John Cage
+
+### Locations:
+FILE
+        end
+
+        # Elizabeth II is the better friend, but historical activities have
+        # had Elizabeth Cady Stanton and John Cage together. Thus, we should
+        # interpret "Elizabeth" as Elizabeth Cady Stanton.
+        it { line_added "- #{date}: Met **John Cage** + **Elizabeth Cady Stanton**." }
+        if test_stdout
+          it do
+            stdout_only "#{capitalized_event} added: "\
+                        "\"#{date}: Met John Cage + Elizabeth Cady Stanton.\""
+          end
+        end
+      end
+
+      describe "when there is no useful context from past activities" do
+        let(:description) { "Dinner with John and Elizabeth." }
+
+        # Create a past activity in which Elizabeth Cady Stanton did something
+        # with John Cage. Then, create past activities to make Elizabeth II a
+        # better friend than Elizabeth Cady Stanton.
+        let(:content) do
+          <<-FILE
+### Activities:
+- 2017-01-03: Ice skated with **Elizabeth II**.
+
+### Notes:
+
+### Friends:
+- Elizabeth Cady Stanton
+- Elizabeth II
+- John Cage
+
+### Locations:
+FILE
+        end
+
+        # Pick the "Elizabeth" with more activities.
+        it { line_added "- #{date}: Dinner with **John Cage** and **Elizabeth II**." }
+        if test_stdout
+          it do
+            stdout_only "#{capitalized_event} added: "\
+                        "\"#{date}: Dinner with John Cage and Elizabeth II.\""
+          end
+        end
+      end
+    end
+
+    describe "when description contains a location name (case insensitive)" do
+      let(:description) { "Lunch at a cafe in paris." }
+
+      it { line_added "- #{date}: Lunch at a cafe in _Paris_." }
+      if test_stdout
+        it { stdout_only "#{capitalized_event} added: \"#{date}: Lunch at a cafe in Paris.\"" }
+      end
+    end
+
+    describe "when description contains both names and locations" do
+      let(:description) { "Grace and I went to Atlantis and then Paris for lunch with George." }
+
+      it do
+        line_added "- #{date}: **Grace Hopper** and I went to _Atlantis_ and then _Paris_ for "\
+                   "lunch with **George Washington Carver**."
+      end
+      if test_stdout
+        it do
+          stdout_only "#{capitalized_event} added: \"#{date}: Grace Hopper and I went to "\
+                      "Atlantis and then Paris for lunch with George Washington Carver.\""
+        end
+      end
+    end
+  end
+end
+
+def parsing_specs(event:)
+  let(:capitalized_event) { event.to_s.capitalize }
+
+  describe "when given a date and a description in the command" do
+    subject { run_cmd("add #{event} #{date}: #{description}") }
+
+    date_parsing_specs
+    description_parsing_specs
+  end
+
+  describe "when given only a date in the command" do
+    subject { run_cmd("add #{event} #{date}", stdin_data: description) }
+
+    # We don't try to test the STDOUT here because our command prompt produces other STDOUT that's
+    # hard to test.
+    date_parsing_specs(test_stdout: false)
+    description_parsing_specs(test_stdout: false)
+  end
+
+  describe "when given only a description in the command" do
+    subject { run_cmd("add #{event} #{description}") }
+
+    # We don't test date parsing since in this case the date is always inferred to be today.
+
+    description_parsing_specs
+  end
+
+  describe "when given neither a date nor a description in the command" do
+    subject { run_cmd("add #{event}", stdin_data: description) }
+
+    # We don't test date parsing since in this case the date is always inferred to be today.
+
+    # We don't try to test the STDOUT here because our command prompt produces other STDOUT that's
+    # hard to test.
+    description_parsing_specs(test_stdout: false)
+  end
+end