WIP: CLI enhancements

README.md

@@ -35,7 +35,9 @@ positional arguments:
 
     list                List contents using the path as a prefix.
     ls                  List path as a directory.
-    cp                  Alias for copy.
+    cp                  Copy a source to a destination path.
+    cpto                Copy a source to a destination path. Note that here
+                        DEST comes before SOURCE(s).
     rm                  Remove file at a path.
     walkfiles           List all files under a path that match an optional
                         pattern.
@@ -44,6 +46,7 @@ positional arguments:
     pwd                 Get the present working directory of a service or all
                         current directories.
     clear               Clear current directories of a specified service.
+    swift               Get Swift-specific information.
 ```
 
 You can `ls` local and remote directories

docs/contributing.rst

@@ -8,9 +8,9 @@ To run all tests, type::
 
     make test
 
-In order to run swift integration tests, create a swift tenant called ``AUTH_swft_test`` and provide environment variables for a user that has permissions to write to that tenant (``SWIFT_TEST_USERNAME`` and ``SWIFT_TEST_PASSWORD``). Also set the swift auth url environment variable (``OS_AUTH_URL``)
+In order to run swift integration tests, create a swift tenant called ``AUTH_swft_test`` (override with the ``SWIFT_TEST_TENANT`` environment variable) and provide environment variables for a user that has permissions to write to that tenant (``SWIFT_TEST_USERNAME`` and ``SWIFT_TEST_PASSWORD``). Also set the swift auth url environment variable (``OS_AUTH_URL``). You can set the prefix of the temporary test container via the ``SWIFT_TEST_CONTAINER_PREFIX`` environment variable.
 
-In order to run S3 integration tests, create a ``stor-test-bucket`` S3 bucket and provide environment variables for an AWS user that has permissions to write to it (``AWS_TEST_ACCESS_KEY_ID`` and ``AWS_ACCESS_KEY_ID``).
+In order to run S3 integration tests, create a ``stor-test-bucket`` S3 bucket and provide environment variables for an AWS user that has permissions to write to it (``AWS_TEST_ACCESS_KEY_ID`` and ``AWS_TEST_SECRET_ACCESS_KEY``).
 
 Code Quality
 ------------

stor/__init__.py

@@ -23,7 +23,11 @@
 import pkg_resources
 
 from stor.utils import copy
+from stor.utils import copy_multiple
 from stor.utils import copytree
+from stor.utils import copytree_multiple
+from stor.utils import remove_multiple
+from stor.utils import rmtree_multiple
 from stor.utils import is_filesystem_path
 from stor.utils import is_swift_path
 from stor.utils import NamedTemporaryDirectory
@@ -132,9 +136,13 @@ def path(pth):  # pragma: no cover
     'ismount',
     'getsize',
     'copy',
+    'copy_multiple',
     'copytree',
+    'copytree_multiple',
     'remove',
+    'remove_multiple',
     'rmtree',
+    'rmtree_multiple',
     'walkfiles',
     'is_filesystem_path',
     'is_swift_path',