htty 1.1.6 → 1.2.0

data/spec/unit/htty/cli/commands/post_spec.rb

@@ -0,0 +1,64 @@
+require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/post")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/http_post")
+
+describe HTTY::CLI::Commands::Post do
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
+
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == HTTY::CLI::Commands::HttpPost
+    end
+
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
+    end
+
+    it 'should belong to the expected category' do
+      klass.category.should == 'Issuing Requests'
+    end
+
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'pos[t]'
+    end
+
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == nil
+    end
+
+    it 'should have the expected help' do
+      klass.help.should == "Alias for \e[1mhttp-po[st]\e[0m"
+    end
+
+    it 'should have the expected help_extended' do
+      klass.help_extended.should == "Alias for \e[1mhttp-po[st]\e[0m."
+    end
+
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::HttpPost]
+    end
+
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('post', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :the_session
+      end
+
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('pos', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
+end

data/spec/unit/htty/cli/commands/put_spec.rb

@@ -0,0 +1,64 @@
+require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/put")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/http_put")
+
+describe HTTY::CLI::Commands::Put do
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
+
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == HTTY::CLI::Commands::HttpPut
+    end
+
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
+    end
+
+    it 'should belong to the expected category' do
+      klass.category.should == 'Issuing Requests'
+    end
+
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'pu[t]'
+    end
+
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == nil
+    end
+
+    it 'should have the expected help' do
+      klass.help.should == "Alias for \e[1mhttp-pu[t]\e[0m"
+    end
+
+    it 'should have the expected help_extended' do
+      klass.help_extended.should == "Alias for \e[1mhttp-pu[t]\e[0m."
+    end
+
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::HttpPut]
+    end
+
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('put', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :the_session
+      end
+
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('pu', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
+end

data/spec/unit/htty/cli/commands/query_add_spec.rb

@@ -1,51 +1,82 @@
 require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/address")
 require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_add")
-require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/session")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_remove")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_set")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset_all")
 
 describe HTTY::CLI::Commands::QueryAdd do
-  before :each do
-    @session = HTTY::Session.new('')
-  end
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
 
-  describe 'with key argument only' do
-    describe 'without key already present' do
-      it 'should add key' do
-        query_add = create_query_add_and_perform('test')
-        query_add.session.requests.last.uri.query.should == 'test'
-      end
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == nil
     end
 
-    describe 'with key already present' do
-      it 'should add key' do
-        @session.requests.last.uri.query = 'test=true'
-        query_add = create_query_add_and_perform('test')
-        query_add.session.requests.last.uri.query.should == 'test=true&test'
-      end
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
     end
-  end
 
-  describe 'with key and value arguments' do
-    describe 'without key already present' do
-      it 'should add key and value' do
-        query_add = create_query_add_and_perform('test', 'true')
-        query_add.session.requests.last.uri.query.should == 'test=true'
-      end
+    it 'should belong to the expected category' do
+      klass.category.should == 'Navigation'
     end
 
-    describe 'with key already present' do
-      it 'should add key and value' do
-        @session.requests.last.uri.query = 'test=true'
-        query_add = create_query_add_and_perform('test', 'false')
-        query_add.session.requests.last.uri.query.should == 'test=true&test=false'
-      end
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'query-a[dd]'
     end
-  end
 
-  def create_query_add_and_perform(*arguments)
-    query_add = HTTY::CLI::Commands::QueryAdd.new(:session => @session,
-                                                  :arguments => arguments)
-    query_add.perform
-    query_add
-  end
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == 'NAME [VALUE [NAME [VALUE ...]]]'
+    end
+
+    it 'should have the expected help' do
+      klass.help.should == "Adds query-string parameters to the request's " +
+                           'address'
+    end
+
+    it 'should have the expected help_extended' do
+      expected = <<-end_help_extended
+Adds one or more query-string parameters used for the request. Does not communicate with the host.
 
+The difference between this command and \e[1mquery-s[et]\e[0m is that this command adds duplicate parameters instead of replacing any of them.
+
+The name(s) and value(s) of the query-string parameter(s) will be URL-encoded if necessary.
+
+The console prompt shows the address for the current request.
+      end_help_extended
+      klass.help_extended.should == expected.chomp
+    end
+
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::QueryRemove,
+                                         HTTY::CLI::Commands::QuerySet,
+                                         HTTY::CLI::Commands::QueryUnset,
+                                         HTTY::CLI::Commands::QueryUnsetAll,
+                                         HTTY::CLI::Commands::Address]
+    end
+
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('query-add foo bar', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == %w(foo bar)
+        built.session.should   == :the_session
+      end
+
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('query-a baz', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == ['baz']
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x qux', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
 end

data/spec/unit/htty/cli/commands/query_clear_spec.rb

@@ -0,0 +1,64 @@
+require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_clear")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset_all")
+
+describe HTTY::CLI::Commands::QueryClear do
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
+
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == HTTY::CLI::Commands::QueryUnsetAll
+    end
+
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
+    end
+
+    it 'should belong to the expected category' do
+      klass.category.should == 'Navigation'
+    end
+
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'query-c[lear]'
+    end
+
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == nil
+    end
+
+    it 'should have the expected help' do
+      klass.help.should == "Alias for \e[1mquery-unset-[all]\e[0m"
+    end
+
+    it 'should have the expected help_extended' do
+      klass.help_extended.should == "Alias for \e[1mquery-unset-[all]\e[0m."
+    end
+
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::QueryUnsetAll]
+    end
+
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('query-clear', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :the_session
+      end
+
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('query-c', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == []
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
+end

data/spec/unit/htty/cli/commands/query_remove_spec.rb

@@ -1,37 +1,82 @@
 require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/address")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_add")
 require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_remove")
-require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/session")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_set")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset_all")
 
 describe HTTY::CLI::Commands::QueryRemove do
-  before :each do
-    @session = HTTY::Session.new('')
-  end
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
 
-  describe 'with existing query string with duplicate keys set' do
-    before :each do
-      @session.requests.last.uri.query = 'test=true&test=false'
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == nil
     end
 
-    describe 'with only key specified' do
-      it 'should remove last entry' do
-        query_remove = create_query_remove_and_perform('test')
-        query_remove.session.requests.last.uri.query.should == 'test=true'
-      end
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
     end
 
-    describe 'with key and value specified' do
-      it 'should remove matching entry only' do
-        query_remove = create_query_remove_and_perform('test', 'true')
-        query_remove.session.requests.last.uri.query.should == 'test=false'
-      end
+    it 'should belong to the expected category' do
+      klass.category.should == 'Navigation'
     end
-  end
 
-  def create_query_remove_and_perform(*arguments)
-    query_remove = HTTY::CLI::Commands::QueryRemove.new(:session => @session,
-                                                        :arguments => arguments)
-    query_remove.perform
-    query_remove
-  end
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'query-r[emove]'
+    end
+
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == 'NAME [VALUE]'
+    end
+
+    it 'should have the expected help' do
+      klass.help.should == 'Removes query-string parameters from the end of ' +
+                           "the request's address"
+    end
+
+    it 'should have the expected help_extended' do
+      expected = <<-end_help_extended
+Removes one or more a query-string parameters used for the request. Does not communicate with the host.
+
+The difference between this command and \e[1mquery-unset\e[0m is that this command removes matching parameters one at a time from the end of the address instead of removing all matches.
 
+The name and value of the query-string parameter will be URL-encoded if necessary.
+
+The console prompt shows the address for the current request.
+      end_help_extended
+      klass.help_extended.should == expected.chomp
+    end
+
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::QueryAdd,
+                                         HTTY::CLI::Commands::QuerySet,
+                                         HTTY::CLI::Commands::QueryUnset,
+                                         HTTY::CLI::Commands::QueryUnsetAll,
+                                         HTTY::CLI::Commands::Address]
+    end
+
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('query-remove foo bar', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == %w(foo bar)
+        built.session.should   == :the_session
+      end
+
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('query-r baz', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == ['baz']
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x qux', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
 end

data/spec/unit/htty/cli/commands/query_set_spec.rb

@@ -1,72 +1,82 @@
 require 'rspec'
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/address")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_add")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_remove")
 require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_set")
-require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/session")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset")
+require File.expand_path("#{File.dirname __FILE__}/../../../../../lib/htty/cli/commands/query_unset_all")
 
 describe HTTY::CLI::Commands::QuerySet do
-  before :all do
-    @session = HTTY::Session.new('')
-  end
+  describe 'class' do
+    let :klass do
+      subject.class
+    end
 
-  describe 'with one argument' do
-    it 'should assign a single key' do
-      query_set = create_query_set_and_perform('test')
-      query_set.session.requests.last.uri.query.should == 'test'
+    it 'should be an alias_for the expected command' do
+      klass.alias_for.should == nil
     end
-  end
 
-  describe 'with two arguments' do
-    it 'should assign a key-value pair' do
-      query_set = create_query_set_and_perform('test', 'true')
-      query_set.session.requests.last.uri.query.should == 'test=true'
+    it 'should have the expected aliases' do
+      klass.aliases.should == []
     end
-  end
 
-  describe 'with three arguments' do
-    it 'should assign a key-value pair and a valueless key' do
-      query_set = create_query_set_and_perform('test', 'true', 'more')
-      query_set.session.requests.last.uri.query.should == 'test=true&more'
+    it 'should belong to the expected category' do
+      klass.category.should == 'Navigation'
     end
-  end
 
-  describe 'with four arguments' do
-    it 'should assign two key-value pairs' do
-      query_set = create_query_set_and_perform('test', 'true', 'more', 'false')
-      query_set.session.requests.last.uri.query.should == 'test=true&more=false'
+    it 'should have the expected command_line' do
+      klass.command_line.should == 'query-s[et]'
     end
-  end
 
-  describe 'with duplicate keys' do
-    it 'should replace existing key' do
-      @session.requests.last.uri.query = 'test=true'
-      query_set = create_query_set_and_perform('test', 'false')
-      query_set.session.requests.last.uri.query.should == 'test=false'
+    it 'should have the expected command_line_arguments' do
+      klass.command_line_arguments.should == 'NAME [VALUE [NAME [VALUE ...]]]'
     end
 
-    it 'should maintain field location' do
-      @session.requests.last.uri.query = 'test=true&more=true'
-      query_set = create_query_set_and_perform('test', 'false')
-      query_set.session.requests.last.uri.query.should == 'test=false&more=true'
+    it 'should have the expected help' do
+      klass.help.should == "Sets query-string parameters in the request's " +
+                           'address'
     end
 
-    it 'should replace multiple instances with one' do
-      @session.requests.last.uri.query = 'test=true&more=true&test=true'
-      query_set = create_query_set_and_perform('test', 'false')
-      query_set.session.requests.last.uri.query.should == 'test=false&more=true'
+    it 'should have the expected help_extended' do
+      expected = <<-end_help_extended
+Sets one or more query-string parameters used for the request. Does not communicate with the host.
+
+The difference between this command and \e[1mquery-a[dd]\e[0m is that this command replaces any duplicate parameters instead of adding more.
+
+The name(s) and value(s) of the query-string parameter(s) will be URL-encoded if necessary.
+
+The console prompt shows the address for the current request.
+      end_help_extended
+      klass.help_extended.should == expected.chomp
     end
 
-    it 'should play nice with nested fields' do
-      @session.requests.last.uri.query = 'test[my][]=1'
-      query_set = create_query_set_and_perform('test[my][]', '2')
-      query_set = create_query_set_and_perform('test', '3')
-      query_set.session.requests.last.uri.query.should == 'test[my][]=2&test=3'
+    it 'should have the expected see_also_commands' do
+      klass.see_also_commands.should == [HTTY::CLI::Commands::QueryUnset,
+                                         HTTY::CLI::Commands::QueryUnsetAll,
+                                         HTTY::CLI::Commands::QueryAdd,
+                                         HTTY::CLI::Commands::QueryRemove,
+                                         HTTY::CLI::Commands::Address]
     end
-  end
 
-  def create_query_set_and_perform(*arguments)
-    query_set = HTTY::CLI::Commands::QuerySet.new(:session => @session,
-                                                  :arguments => arguments)
-    query_set.perform
-    query_set
-  end
+    describe 'build_for' do
+      it 'should correctly handle a valid, unabbreviated command line' do
+        built = klass.build_for('query-set foo bar', :session => :the_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == %w(foo bar)
+        built.session.should   == :the_session
+      end
 
+      it 'should correctly handle a valid, abbreviated command line' do
+        built = klass.build_for('query-s baz', :session => :a_session)
+        built.should be_instance_of(klass)
+        built.arguments.should == ['baz']
+        built.session.should   == :a_session
+      end
+
+      it 'should correctly handle a command line with a bad command' do
+        built = klass.build_for('x qux', :session => :another_session)
+        built.should == nil
+      end
+    end
+  end
 end