Added the --for-person option to ronin-db emails (closes #68).

lib/ronin/db/cli/commands/emails.rb

@@ -45,6 +45,7 @@ module Commands
         #     -H, --with-host [HOST [...]]
         #     -I, --with-ip [IP [...]]
         #     -u, --with-user [NAME [...]]
+        #     -P, --for-person FULL_NAME       Searches for the associated person
         #
         class Emails < ModelCommand
 
@@ -80,6 +81,15 @@ class Emails < ModelCommand
                                @query_method_calls << [:with_user_name, [user]]
                              end
 
+          option :for_person, short: '-P',
+                              value: {
+                                type:  String,
+                                usage: 'FULL_NAME'
+                              },
+                              desc: 'Searches for the associated person' do |full_name|
+                                @query_method_calls << [:for_person, [full_name]]
+                              end
+
           description 'Manages all email addresses in the database'
 
           man_page 'ronin-db-emails.1'

man/ronin-db-emails.1.md

@@ -51,6 +51,9 @@ Manages email addresses.
 `-u`, `--with-users` *NAME* [...]
 : Searches for email addresses associated with the user NAME(s).
 
+`-P`, `--for-person` *FULL_NAME*
+: Searches for email addresses associated with the person's full name.
+
 `-h`, `--help`
 : Print help information.
 

spec/cli/commands/emails_spec.rb

@@ -56,5 +56,20 @@
         expect(Ronin::DB::EmailAddress).to respond_to(:with_user_name)
       end
     end
+
+    describe "--for-person FULL_NAME" do
+      let(:full_name) { 'John Smith' }
+      let(:argv)      { ['--for-person', full_name] }
+
+      it "must append :for_person and the full name to #query_method_calls" do
+        expect(subject.query_method_calls[-1]).to eq(
+          [:for_person, [full_name]]
+        )
+      end
+
+      it "and .for_person must be a class method on Ronin::DB::EmailAddress" do
+        expect(Ronin::DB::EmailAddress).to respond_to(:for_person)
+      end
+    end
   end
 end