Package: pypicloud-tools
pypicloud-tools===============`View this on GitHubPages <http://ccpgames.github.io/pypicloud-tools/>`__|Build Status| |Coverage Status| |Version| |Download format| |Downloadsthis month| |Development Status| |License|Tools to bypass a PyPICloud installation and communicate directly withS3Utilities---------Upload~~~~~~Uploads file(s) to the PyPICloud S3 bucket directly and performs anadmin API call to rebuild the PyPICloud index after.Example:.. code:: bash$ upload dist/*Uploading example-project/example-project-0.0.1.tar.gz ..... done!Uploading example-project/example_project-0.0.1-py2-none-any.whl ..... done!Uploading example-project/example_project-0.0.1-py2.7.egg ...... done!PyPICloud server at http://your.pypicloud.server/pypi updatedIt's fine if the file names use altering hypens/underscores per release typelike you see above, they only need to match the initial part of the key beforethe ``/`` to be considered the same package.Download~~~~~~~~Downloads the latest or a specific version directly from S3. Does nottalk to PyPICloud and does not install the downloaded package. You canuse pip to do either/both of those things.Also possible with the download command is the ``--url`` flag to onlyprint a download URL (usable for 5 minutes).By default, if there are multiple releases of the same package+release,download will prefer wheels, then eggs, then source distributions. Youcan override that behavior with the ``--egg`` and ``--src`` flags.Examples:.. code:: bash$ download example_project==0.0.1example_project-0.0.1-py2-none-any.whl.. code:: bash$ download example-project --eggexample_project-0.0.1-py2.7.eggPipes and redirects work like you'd expect:.. code:: bash$ download example_project --src | tar -xzf -List~~~~Lists a package's releases, or releases of a package at a specificversion. Again, talks straight to S3 and bypasses the PyPICloudinstallation.Example:.. code:: bash$ list example_projectexample-project==0.0.1 : example-project-0.0.1.tar.gzexample-project==0.0.1 : example_project-0.0.1-py2.7.eggexample-project==0.0.1 : example_project-0.0.1-py2-none-any.whlListing multiple packages or packages with a version specifier is alsosupported.When called without any arguments, ``list`` will display all knownpackages.Rehost~~~~~~Rehosts an upstream package from PyPI into the pypicloud installation.This can be handy if you have pypicloud clients which only have accessto it and s3 but not the rest of the internet.Example:.. code:: bash$ rehost requests==1.0.0Collecting requests==1.0.0Downloading requests-1.0.0.tar.gz (335kB)100% |████████████████████████████████| 335kB 929kB/sSaved /var/folders/53/kl4v4_9509ng148kp_pwmc5h0000gn/T/tmpuj5JUJ/requests-1.0.0.tar.gzSuccessfully downloaded requestsUploading requests/requests-1.0.0.tar.gz ............ done!PyPICloud server at http://your_pypicloud_server/pypi updatedIf a specific version is not provided, the latest will be used. Multiplepackages can be used in the same command.Installation------------Simple~~~~~~.. code:: bash$ pip install pypicloud-tools>From source~~~~~~~~~~~.. code:: bash$ git clone https://github.com/ccpgames/pypicloud-tools.git$ cd pypicloud-tools$ python setup.py installConfiguration-------------Configuration for pypicloud-tools piggybacks on your ``~/.pypirc`` file.You can specify an alternate config file with the ``--config`` flag, butit must be in the same syntax. That syntax is:.. code:: text[pypicloud]repository:http://your.pypicloud.server/pypiusername:adminpassword:hunter7bucket:your_bucketaccess:some_keysecret:other_keyacl:optional_aclregion:optional_regionThe key **must** be ``pypicloud``, it is the only key pypicloud-toolswill look at. The username/password combination should have admincredentials on the PyPICloud installation as it needs to call``/admin/rebuild`` after a succesful upload.Copyright and License=====================pypicloud-tools was written by Adam TalsmaCopyright (c) 2015 CCP hf.Permission is hereby granted, free of charge, to any person obtaining acopy of this software and associated documentation files (the"Software"), to deal in the Software without restriction, includingwithout limitation the rights to use, copy, modify, merge, publish,distribute, sublicense, and/or sell copies of the Software, and topermit persons to whom the Software is furnished to do so, subject tothe following conditions:The above copyright notice and this permission notice shall be includedin all copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESSOR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANYCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THESOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE... |Build Status| image:: https://travis-ci.org/ccpgames/pypicloud-tools.png?branch=master:target: https://travis-ci.org/ccpgames/pypicloud-tools.. |Coverage Status| image:: https://coveralls.io/repos/ccpgames/pypicloud-tools/badge.svg?branch=master:target: https://coveralls.io/r/ccpgames/pypicloud-tools?branch=master.. |Version| image:: https://img.shields.io/pypi/v/pypicloud-tools.svg:target: https://pypi.python.org/pypi/pypicloud-tools/.. |Download format| image:: https://img.shields.io/badge/format-wheel-green.svg?:target: https://pypi.python.org/pypi/pypicloud-tools/.. |Downloads this month| image:: https://img.shields.io/pypi/dm/pypicloud-tools.svg:target: https://pypi.python.org/pypi/pypicloud-tools/.. |Development Status| image:: https://img.shields.io/badge/status-beta-orange.svg:target: https://pypi.python.org/pypi/pypicloud-tools/.. |License| image:: https://img.shields.io/github/license/ccpgames/pypicloud-tools.svg:target: https://pypi.python.org/pypi/pypicloud-tools/