Revision: 670e2740994f
Branch:   default
Author:   Pekka Klärck
Date:     Mon Jun  9 11:22:48 2014 UTC
Log: UG/Remote: Documented that http://host is turned to http://host/RCP2

Update issue 1693
Status: Review
Tried to explain the problem better in User Guide. How does this look
now to @kormbrek and others?

Also, do you guys think this behavior should change in RF 2.9? I think
it would make sense bu would like to hear other opinions. If we decide
it is a good idea, we can still do this tasks now:
- Add a note User Guide that the behavior will change in RF 2.9.
- Add an issue about actually making the change in RF 2.9.
- Inform users/devs on mailing lists about the planned change.
http://code.google.com/p/robotframework/source/detail?r=670e2740994f

Modified:
 /doc/userguide/src/ExtendingRobotFramework/RemoteLibrary.rst

=======================================
--- /doc/userguide/src/ExtendingRobotFramework/RemoteLibrary.rst Thu Apr 24 21:34:53 2014 UTC +++ /doc/userguide/src/ExtendingRobotFramework/RemoteLibrary.rst Mon Jun 9 11:22:48 2014 UTC
@@ -67,7 +67,7 @@
    =========  ===========  ========================  =========  =========
     Setting      Value               Value             Value      Value
    =========  ===========  ========================  =========  =========
-   Library    Remote       \http://127.0.0.1:8270    WITH NAME  Example1
+   Library    Remote       \http://127.0.0.1:8270/   WITH NAME  Example1
    Library    Remote       \http://example.com:7777  WITH NAME  Example2
    Library    Remote       \http://10.0.0.2/example  WITH NAME  Example3
    =========  ===========  ========================  =========  =========
@@ -83,13 +83,18 @@
           Prior to Robot Framework 2.8.4 the Remote library itself used the
           potentially slow :code:`localhost` by default.

-.. note:: Depending on the remote server, the trailing slash after the server
-          address may or may not be significant. For example, using
-          :code:`http://127.0.0.1:8270` is not always the same as using
-          :code:`http://127.0.0.1:8270/`. If there is a difference, remote
-          servers themselves should document which format to use.
+.. note:: Notice that if the URI contains no path after the server address,
+          `xmlrpclib module`__ used by the Remote library will use
+          :code:`/RPC2` path by default. In practice using
+          :code:`http://127.0.0.1:8270` is thus identical to using
+ :code:`http://127.0.0.1:8270/RPC2`. Depending on the remote server
+          this may or may not be a problem. No extra path is appended if
+          the address has a path even if the path is just :code:`/`. For
+          example, neither :code:`http://127.0.0.1:8270/` nor
+          :code:`http://127.0.0.1:8270/my/path` will be modified.

__ http://stackoverflow.com/questions/14504450/pythons-xmlrpc-extremely-slow-one-second-per-call
+__ https://docs.python.org/2/library/xmlrpclib.html

 Starting and stopping remote servers
 ''''''''''''''''''''''''''''''''''''

--

--- You received this message because you are subscribed to the Google Groups "robotframework-commit" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to robotframework-commit+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to