Deprecate 'Set HTTP Host'. Use 'Create HTTP Context'.

Author: peritus

README.rst

@@ -39,7 +39,7 @@ Library       HttpLibrary.HTTP
 ============  =================================  ===================================
 Example
 \             [Documentation]                    Follows a Redirect
-\             Set HTTP Host                      `httpstat.us <http://httpstat.us>`_
+\             Create HTTP Context                `httpstat.us <http://httpstat.us>`_
 \             GET                                /302
 \             Response Status Code Should Equal  302
 \             Follow Response

src/HttpLibrary/__init__.py

@@ -119,7 +119,7 @@ def context(self):
     @property
     def app(self):
         if not self.context.app:
-            raise Exception('Not connected to any HTTP Host. Use "Set HTTP Host" keyword first.')
+            raise Exception('Not connected to any HTTP Host. Use "Create HTTP Context" keyword first.')
         return self.context.app
 
     @property
@@ -145,10 +145,7 @@ def _path_from_url_or_path(self, url_or_path):
 
     def set_http_host(self, host):
         """
-        (deprecated) Sets the HTTP host to use for future requests. You must call this
-        before issuing any HTTP requests.
-
-        `host` is the name of the host, optionally with port (e.g. 'google.com' or 'localhost:5984')
+        *DEPRECATED* Use `Create HTTP Context` instead.
         """
         self.create_http_context(host)
 

tests/http/__init__.txt

@@ -15,6 +15,6 @@ Start Mockserver
     Sleep  0.2
 
 Stop Mockserver
-    Set HTTP Host  ${HOST}
+    Create HTTP Context    ${HOST}
     POST           /kill
 

tests/http/scoping/simplescope.txt

@@ -2,7 +2,7 @@
 
 Resource        ../../variables.txt
 Library         HttpLibrary.HTTP
-Suite Setup     Set HTTP Host     ${HOST}
+Suite Setup     Create HTTP Context    ${HOST}
 
 *** Test Cases ***
 

tests/http/scoping/suite_setup.txt

@@ -2,7 +2,7 @@
 
 Resource        ../../variables.txt
 Library         HttpLibrary.HTTP
-Suite Setup     Set HTTP Host     ${HOST}
+Suite Setup     Create HTTP Context   ${HOST}
 
 *** Test Cases ***
 

tests/http/simple.txt

@@ -2,14 +2,14 @@
 
 Resource        ../variables.txt
 Library         HttpLibrary.HTTP
-Test Setup      Set HTTP Host     ${HOST}
+Test Setup      Create HTTP Context     ${HOST}
 
 *** Test Cases ***
 
 Error if GET before connect
     [Setup]  No Operation
     Run Keyword And Expect Error
-    ...  Not connected to any HTTP Host. Use "Set HTTP Host" keyword first.
+    ...  Not connected to any HTTP Host. Use "Create HTTP Context" keyword first.
     ...  GET   /
 
 Error if invalid URL
@@ -235,7 +235,7 @@ Name-based virtual hosting is supported
     # "Host" request header set to "www.example.com"
     # See https://en.wikipedia.org/wiki/Virtual_hosting#Name-based
 
-    Set HTTP Host                 ${HOST}
+    Create HTTP Context           ${HOST}
     Set Request Header            Host           www.example.com
     GET                           /hostname