{ "info": { "author": "Jacob Kaplan-Moss", "author_email": "jacob@jacobian.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "Python bindings to the Rackspace Cloud Servers API\r\n ==================================================\r\n\t- This Package was modified by Kevin Carter, to be compatible with the UK API. \r\n\t- python-cloudservers was completely changed so that it is now python-ukcloudservers which will create a command ukcloudservers\r\n \r\n This is a client for Rackspace's Cloud Servers API. There's a Python API (the\r\n ``ukcloudservers`` module), and a command-line script (``ukcloudservers``). Each\r\n implements 100% of the Rackspace API.\r\n \r\n `Full documentation is available`__.\r\n \r\n __ http://packages.python.org/python-ukcloudservers/\r\n \r\n You'll also probably want to read `Rackspace's API guide`__ (PDF) -- the first\r\n bit, at least -- to get an idea of the concepts. Rackspace is doing the cloud\r\n hosting thing a bit differently from Amazon, and if you get the concepts this\r\n library should make more sense.\r\n \r\n __ http://docs.rackspacecloud.com/servers/api/cs-devguide-latest.pdf\r\n \r\n Development takes place on GitHub__. Bug reports and patches may be filed there.\r\n \r\n __ http://github.com/jacobian/python-ukcloudservers\r\n \r\n .. contents:: Contents:\r\n :local:\r\n \r\n Command-line API\r\n ----------------\r\n \r\n Installing this package gets you a shell command, ``ukcloudservers``, that you\r\n can use to interact with Rackspace.\r\n \r\n You'll need to provide your Rackspace username and API key. You can do this\r\n with the ``--username`` and ``--apikey`` params, but it's easier to just set\r\n them as environment variables::\r\n \r\n export CLOUD_SERVERS_USERNAME=jacobian\r\n export CLOUD_SERVERS_API_KEY=yadayada\r\n \r\n You'll find complete documentation on the shell by running\r\n ``ukcloudservers help``::\r\n \r\n usage: ukcloudservers [--username USERNAME] [--apikey APIKEY] ...\r\n \r\n Command-line interface to the Cloud Servers API.\r\n \r\n Positional arguments:\r\n \r\n backup-schedule Show or edit the backup schedule for a server.\r\n backup-schedule-delete\r\n Delete the backup schedule for a server.\r\n boot Boot a new server.\r\n delete Immediately shut down and delete a server.\r\n flavor-list Print a list of available 'flavors' (sizes of\r\n servers).\r\n help Display help about this program or one of its\r\n subcommands.\r\n image-create Create a new image by taking a snapshot of a running\r\n server.\r\n image-delete Delete an image.\r\n image-list Print a list of available images to boot from.\r\n ip-share Share an IP address from the given IP group onto a\r\n server.\r\n ip-unshare Stop sharing an given address with a server.\r\n ipgroup-create Create a new IP group.\r\n ipgroup-delete Delete an IP group.\r\n ipgroup-list Show IP groups.\r\n ipgroup-show Show details about a particular IP group.\r\n list List active servers.\r\n reboot Reboot a server.\r\n rebuild Shutdown, re-image, and re-boot a server.\r\n rename Rename a server.\r\n resize Resize a server.\r\n resize-confirm Confirm a previous resize.\r\n resize-revert Revert a previous resize (and return to the previous\r\n VM).\r\n root-password Change the root password for a server.\r\n show Show details about the given server.\r\n \r\n Optional arguments:\r\n --username USERNAME Defaults to env[CLOUD_SERVERS_USERNAME].\r\n --apikey APIKEY Defaults to env[CLOUD_SERVERS_API_KEY].\r\n \r\n See \"ukcloudservers help COMMAND\" for help on a specific command.\r\n \r\n Python API\r\n ----------\r\n \r\n There's also a `complete Python API`__.\r\n \r\n __ http://packages.python.org/python-ukcloudservers/\r\n \r\n By way of a quick-start::\r\n \r\n >>> import ukcloudservers\r\n >>> cs = ukcloudservers.CloudServers(USERNAME, API_KEY)\r\n >>> cs.flavors.list()\r\n [...]\r\n >>> cs.servers.list()\r\n [...]\r\n >>> s = cs.servers.create(image=2, flavor=1, name='myserver')\r\n \r\n ... time passes ...\r\n \r\n >>> s.reboot()\r\n \r\n ... time passes ...\r\n \r\n >>> s.delete()\r\n \r\n FAQ\r\n ---\r\n \r\n What's wrong with libcloud?\r\n \r\n Nothing! However, as a cross-service binding it's by definition lowest\r\n common denominator; I needed access to the Rackspace-specific APIs (shared\r\n IP groups, image snapshots, resizing, etc.). I also wanted a command-line\r\n utility.\r\n \r\n What's new?\r\n -----------\r\n \r\n New in ``python-ukcloudservers`` 1.2\r\n ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r\n \r\n * Support for Python 2.4 - 2.7.\r\n * Improved output of ``ipgroup-list``.\r\n * Made ``boot --ipgroup `` work (as well as ``--ipgroup ``).\r\n \r\n New in ``python-ukcloudservers`` 1.1\r\n ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r\n \r\n * Added support for uploading files to the shell ``boot`` command (via the\r\n ``--files`` flag).\r\n * Added a shortcut ``--key`` for quickly adding an SSH key on boot.\r\n * Changed the default server image for the ``boot`` shell command to Ubuntu\r\n 10.04.", "description_content_type": null, "docs_url": "https://pythonhosted.org/python-ukcloudservers/", "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://packages.python.org/python-ukcloudservers", "keywords": "", "license": "BSD", "maintainer": "Kevin Carter", "maintainer_email": "kevin@bkintegrtion.com", "name": "python-ukcloudservers", "package_url": "https://pypi.org/project/python-ukcloudservers/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/python-ukcloudservers/", "project_urls": { "Homepage": "http://packages.python.org/python-ukcloudservers" }, "release_url": "https://pypi.org/project/python-ukcloudservers/1.2/", "requires_dist": null, "requires_python": null, "summary": "Client library for Rackspace's Cloud Servers API", "version": "1.2" }, "last_serial": 798115, "releases": { "1.2": [ { "comment_text": "", "digests": { "md5": "d422b44614a915cdd48ff2cfb9ce2686", "sha256": "48167a2d6c6f26923d4e3da81d667b0ad9022da5a21f41384e1b511e052ad32b" }, "downloads": -1, "filename": "python-ukcloudservers-1.2.tar.gz", "has_sig": false, "md5_digest": "d422b44614a915cdd48ff2cfb9ce2686", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 609987, "upload_time": "2011-11-17T16:09:28", "url": "https://files.pythonhosted.org/packages/21/21/cf27f44783ab1b74a5493541a14677d3dd4ec9a012a3c06fe08293eadba5/python-ukcloudservers-1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d422b44614a915cdd48ff2cfb9ce2686", "sha256": "48167a2d6c6f26923d4e3da81d667b0ad9022da5a21f41384e1b511e052ad32b" }, "downloads": -1, "filename": "python-ukcloudservers-1.2.tar.gz", "has_sig": false, "md5_digest": "d422b44614a915cdd48ff2cfb9ce2686", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 609987, "upload_time": "2011-11-17T16:09:28", "url": "https://files.pythonhosted.org/packages/21/21/cf27f44783ab1b74a5493541a14677d3dd4ec9a012a3c06fe08293eadba5/python-ukcloudservers-1.2.tar.gz" } ] }