========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/python-manilaclient.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
.. Change things from this point on
Python bindings to the OpenStack Manila API
===========================================
.. only: html
.. image:: https://img.shields.io/pypi/v/python-manilaclient.svg
:target: https://pypi.org/project/python-manilaclient/
:alt: Latest Version
This is a client for the OpenStack Manila API. There's a Python API (the
``manilaclient`` module), and a command-line script (``manila``). Each
implements 100% of the OpenStack Manila API.
See the `OpenStack CLI guide`_ for information on how to use the ``manila``
command-line tool. You may also want to look at the
`OpenStack API documentation`_.
.. _OpenStack CLI Guide: https://docs.openstack.org/python-openstackclient/latest/cli/
.. _OpenStack API documentation: https://docs.openstack.org/api/
The project is hosted on `Launchpad`_, where bugs can be filed. The code is
hosted on `Github`_. Patches must be submitted using `Gerrit`_, *not* Github
pull requests.
.. _Github: https://github.com/openstack/python-manilaclient
.. _Launchpad: https://launchpad.net/python-manilaclient
.. _Gerrit: https://docs.openstack.org/infra/manual/developers.html#development-workflow
This code is a fork of `Cinderclient`_ of Grizzly release and then it was
developed separately. Cinderclient code is a fork of
`Jacobian's python-cloudservers`__ If you need API support for the Rackspace
API solely or the BSD license, you should use that repository.
python-manilaclient is licensed under the Apache License like the rest of
OpenStack.
.. _Cinderclient: https://github.com/openstack/python-cinderclient
__ https://github.com/jacobian/python-cloudservers
.. contents:: Contents:
:local:
Command-line API
----------------
Installing this package gets you a shell command, ``manila``, that you
can use to interact with any Rackspace compatible API (including OpenStack).
You'll need to provide your OpenStack username and password. You can do this
with the ``--os-username``, ``--os-password`` and ``--os-tenant-name``
params, but it's easier to just set them as environment variables::
export OS_USERNAME=foouser
export OS_PASSWORD=barpass
export OS_TENANT_NAME=fooproject
You will also need to define the authentication url either with param
``--os-auth-url`` or as an environment variable::
export OS_AUTH_URL=http://example.com:5000/v2.0/
Since Keystone can return multiple regions in the Service Catalog, you
can specify the one you want with ``--os-region-name`` (or
``export OS_REGION_NAME``). It defaults to the first in the list returned.
You'll find complete documentation on the shell by running
``manila help``, see ``manila help COMMAND`` for help on a specific command.
Python API
----------
There's also a complete Python API, but it has not yet been documented.
Quick-start using keystone::
# use v2.0 auth with http://example.com:5000/v2.0/
>>> from manilaclient.v1 import client
>>> nt = client.Client(USER, PASS, TENANT, AUTH_URL, service_type="share")
>>> nt.shares.list()
[...]
* License: Apache License, Version 2.0
* `PyPi`_ - package installation
* `Online Documentation`_
* `Launchpad project`_ - release management
* `Blueprints`_ - feature specifications
* `Bugs`_ - issue tracking
* `Source`_
* `How to Contribute`_
* `Release Notes`_
.. _PyPi: https://pypi.org/project/python-manilaclient
.. _Online Documentation: https://docs.openstack.org/python-manilaclient/latest/
.. _Launchpad project: https://launchpad.net/python-manilaclient
.. _Blueprints: https://blueprints.launchpad.net/python-manilaclient
.. _Bugs: https://bugs.launchpad.net/python-manilaclient
.. _Source: https://opendev.org/openstack/python-manilaclient
.. _How to Contribute: https://docs.openstack.org/infra/manual/developers.html
.. _Release Notes: https://docs.openstack.org/releasenotes/python-manilaclient
Raw data
{
"_id": null,
"home_page": "https://docs.openstack.org/python-manilaclient/latest/",
"name": "python-manilaclient",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/fa/2c/c34cbe50274c4a96a0c3f75d2189c580d09df8e2315d27cd7cd8028fbed3/python-manilaclient-5.1.0.tar.gz",
"platform": null,
"description": "========================\nTeam and repository tags\n========================\n\n.. image:: https://governance.openstack.org/tc/badges/python-manilaclient.svg\n :target: https://governance.openstack.org/tc/reference/tags/index.html\n\n.. Change things from this point on\n\nPython bindings to the OpenStack Manila API\n===========================================\n\n.. only: html\n\n .. image:: https://img.shields.io/pypi/v/python-manilaclient.svg\n :target: https://pypi.org/project/python-manilaclient/\n :alt: Latest Version\n\nThis is a client for the OpenStack Manila API. There's a Python API (the\n``manilaclient`` module), and a command-line script (``manila``). Each\nimplements 100% of the OpenStack Manila API.\n\nSee the `OpenStack CLI guide`_ for information on how to use the ``manila``\ncommand-line tool. You may also want to look at the\n`OpenStack API documentation`_.\n\n.. _OpenStack CLI Guide: https://docs.openstack.org/python-openstackclient/latest/cli/\n.. _OpenStack API documentation: https://docs.openstack.org/api/\n\nThe project is hosted on `Launchpad`_, where bugs can be filed. The code is\nhosted on `Github`_. Patches must be submitted using `Gerrit`_, *not* Github\npull requests.\n\n.. _Github: https://github.com/openstack/python-manilaclient\n.. _Launchpad: https://launchpad.net/python-manilaclient\n.. _Gerrit: https://docs.openstack.org/infra/manual/developers.html#development-workflow\n\nThis code is a fork of `Cinderclient`_ of Grizzly release and then it was\ndeveloped separately. Cinderclient code is a fork of\n`Jacobian's python-cloudservers`__ If you need API support for the Rackspace\nAPI solely or the BSD license, you should use that repository.\npython-manilaclient is licensed under the Apache License like the rest of\nOpenStack.\n\n.. _Cinderclient: https://github.com/openstack/python-cinderclient\n__ https://github.com/jacobian/python-cloudservers\n\n.. contents:: Contents:\n :local:\n\nCommand-line API\n----------------\n\nInstalling this package gets you a shell command, ``manila``, that you\ncan use to interact with any Rackspace compatible API (including OpenStack).\n\nYou'll need to provide your OpenStack username and password. You can do this\nwith the ``--os-username``, ``--os-password`` and ``--os-tenant-name``\nparams, but it's easier to just set them as environment variables::\n\n export OS_USERNAME=foouser\n export OS_PASSWORD=barpass\n export OS_TENANT_NAME=fooproject\n\nYou will also need to define the authentication url either with param\n``--os-auth-url`` or as an environment variable::\n\n export OS_AUTH_URL=http://example.com:5000/v2.0/\n\nSince Keystone can return multiple regions in the Service Catalog, you\ncan specify the one you want with ``--os-region-name`` (or\n``export OS_REGION_NAME``). It defaults to the first in the list returned.\n\nYou'll find complete documentation on the shell by running\n``manila help``, see ``manila help COMMAND`` for help on a specific command.\n\nPython API\n----------\n\nThere's also a complete Python API, but it has not yet been documented.\n\nQuick-start using keystone::\n\n # use v2.0 auth with http://example.com:5000/v2.0/\n >>> from manilaclient.v1 import client\n >>> nt = client.Client(USER, PASS, TENANT, AUTH_URL, service_type=\"share\")\n >>> nt.shares.list()\n [...]\n\n* License: Apache License, Version 2.0\n* `PyPi`_ - package installation\n* `Online Documentation`_\n* `Launchpad project`_ - release management\n* `Blueprints`_ - feature specifications\n* `Bugs`_ - issue tracking\n* `Source`_\n* `How to Contribute`_\n* `Release Notes`_\n\n.. _PyPi: https://pypi.org/project/python-manilaclient\n.. _Online Documentation: https://docs.openstack.org/python-manilaclient/latest/\n.. _Launchpad project: https://launchpad.net/python-manilaclient\n.. _Blueprints: https://blueprints.launchpad.net/python-manilaclient\n.. _Bugs: https://bugs.launchpad.net/python-manilaclient\n.. _Source: https://opendev.org/openstack/python-manilaclient\n.. _How to Contribute: https://docs.openstack.org/infra/manual/developers.html\n.. _Release Notes: https://docs.openstack.org/releasenotes/python-manilaclient\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Client library for OpenStack Manila API.",
"version": "5.1.0",
"project_urls": {
"Homepage": "https://docs.openstack.org/python-manilaclient/latest/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c7c04f26e50c51db23b6a8f315bad218c989ac8808c767d64833944f7855e9e1",
"md5": "bf8c3b3d1a7dd73f0c3e5fb21ba45f4d",
"sha256": "5e23f8f5936008643e9aa6c44136da7b408f2179eaa035845593769ad7d5a269"
},
"downloads": -1,
"filename": "python_manilaclient-5.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bf8c3b3d1a7dd73f0c3e5fb21ba45f4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 517510,
"upload_time": "2024-11-14T10:07:57",
"upload_time_iso_8601": "2024-11-14T10:07:57.424364Z",
"url": "https://files.pythonhosted.org/packages/c7/c0/4f26e50c51db23b6a8f315bad218c989ac8808c767d64833944f7855e9e1/python_manilaclient-5.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa2cc34cbe50274c4a96a0c3f75d2189c580d09df8e2315d27cd7cd8028fbed3",
"md5": "cb8d77ef5c4e51021849510a7f32aa64",
"sha256": "2afdf111807aa6bce51144f321b90b63ae7897d37c19bdd8b05a90453299a48f"
},
"downloads": -1,
"filename": "python-manilaclient-5.1.0.tar.gz",
"has_sig": false,
"md5_digest": "cb8d77ef5c4e51021849510a7f32aa64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 390274,
"upload_time": "2024-11-14T10:07:59",
"upload_time_iso_8601": "2024-11-14T10:07:59.427376Z",
"url": "https://files.pythonhosted.org/packages/fa/2c/c34cbe50274c4a96a0c3f75d2189c580d09df8e2315d27cd7cd8028fbed3/python-manilaclient-5.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-14 10:07:59",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "python-manilaclient"
}