{ "info": { "author": "George Cushen", "author_email": "mezzanine-users@googlegroups.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: ISC License (ISCL)", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Site Management", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "# Mezzanine API Client\n\n[![Download from PyPI](https://img.shields.io/pypi/v/mezzanine-client.svg)](https://pypi.python.org/pypi/mezzanine-client)\n[![License](https://img.shields.io/pypi/l/mezzanine-client.svg)](https://pypi.python.org/pypi/mezzanine-client)\n[![Join the chat](https://badges.gitter.im/gcushen/mezzanine-api.svg)](https://gitter.im/gcushen/mezzanine-api?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)\n\nA remote CLI and Python client SDK for [Mezzanine API](http://gcushen.github.io/mezzanine-api/).\n\nIt enables a user or service to remotely read or write to [Mezzanine CMS](http://mezzanine.jupo.org/) using Python or the command line. For example, you can write an article in Markdown on your laptop and type a simple command to automatically upload it and create a new blog post from it on your website.\n\n\n# Installation\n\n $ pip install -U mezzanine-client\n\n# Prerequisites\n\nInstall [Mezzanine API](http://gcushen.github.io/mezzanine-api/) either locally (for development) or remotely (for production), as we need an API to connect to.\n\nOnce Mezzanine API is installed,\n\n1. Login to your Mezzanine CMS Admin Panel (e.g. [http://127.0.0.1:8000/admin/](http://127.0.0.1:8000/admin/))\n2. In the menu, click *OAuth* > *Applications*\n3. Create a new application with the following details:\n\n App Name: Mezzanine Python Client\n App ID: id\n App Secret: secret\n Client Type: Confidential\n Grant Type: Code\n Redirect URI: https://httpbin.org/get\n\nFor development purposes, you can define the simple app ID and secret above, otherwise use the automatically generated ones.\n\n# CLI Documentation\n\n[CLI Documentation Website](http://gcushen.github.io/mezzanine-api/cli/)\n\n## Configuration\n\nGenerally, you must set at least three configuration options: API URL, OAuth App ID, and OAuth App Secret. These settings correspond to the location of your Mezzanine API instance and your OAuth credentials to authenticate with it (as was discussed further in the above *Prerequisites* section).\n\n```\n$ mezzanine-cli config api_url http://127.0.0.1:8000/api\n$ mezzanine-cli config client_id id\n$ mezzanine-cli config client_secret secret\n```\n\nYou can also see your current configuration and available options by issuing the `mezzanine-cli config` command without any arguments. Note that the `refresh_token` setting should not be altered.\n\n## Getting started\n\nSome examples:\n\n```\n# List all posts (most recent first).\n$ mezzanine-cli posts list\n\n# Get the post with the ID of 2.\n$ mezzanine-cli posts get 2\n\n# Create a post from a Markdown file.\n$ mezzanine-cli posts create \\\n --title='Test Post from API Client' \\\n --content-file=~/Desktop/test.md \\\n --categories='Test,Fun' \\\n --markdown\n```\n\nJust add `--help` to any command in order to get help on the command line:\n\n```\n# General help.\n$ mezzanine-cli\n\n# View available options for creating posts.\n$ mezzanine-cli posts create --help\n```\n\nFinally, if you wish to clear the credentials and reset CLI configuration, you can do so by running:\n\n $ mezzanine-cli logout\n\n# SDK Documentation\n\n[SDK Documentation Website](http://gcushen.github.io/mezzanine-api/client/)\n\nExample code to display recent blog posts:\n\n```python\nfrom mezzanine_client import Mezzanine\napi = Mezzanine( 'app_id', 'app_secret' )\n\n# Recent posts\npublished_posts = api.get_posts(offset=0, limit=10)\nfor post in published_posts:\n print('{} (ID: {})'.format(post['title'], post['id']))\n```\n\nFurther examples, such as for creating, listing, and retrieving blog posts, can be found in the [*examples*](https://github.com/gcushen/mezzanine-client-python/tree/master/examples) directory.\n\n# Community\n\nJoin us in the [Mezzanine API chat room](https://gitter.im/gcushen/mezzanine-api?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) or leave a message and we will try to get back to you.\n\nFeel free to [star](https://github.com/gcushen/mezzanine-client-python/) Mezzanine Client on Github to show your support and monitor updates.\n\nPlease file a [ticket](https://github.com/gcushen/mezzanine-client-python/issues) or contribute a pull request on GitHub for bugs or feature requests.\n\n# License\n\nLicensed under the [ISC License](https://github.com/gcushen/mezzanine-client-python/blob/master/LICENSE).\n\nCreated by [George Cushen](https://twitter.com/GeorgeCushen).\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://gcushen.github.io/mezzanine-api/client/", "keywords": "mezzanine cms api client sdk library rest restful", "license": "ISC", "maintainer": "", "maintainer_email": "", "name": "mezzanine-client", "package_url": "https://pypi.org/project/mezzanine-client/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/mezzanine-client/", "project_urls": { "Homepage": "http://gcushen.github.io/mezzanine-api/client/" }, "release_url": "https://pypi.org/project/mezzanine-client/0.2.2/", "requires_dist": [ "click", "future", "markdown2", "requests (>=2.9.1)", "requests-oauthlib (>=0.6.1)" ], "requires_python": "", "summary": "A remote CLI and Python client SDK for Mezzanine REST API.", "version": "0.2.2" }, "last_serial": 2385780, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "e6f4e47837e191ded19a9a183164bbfd", "sha256": "ce1a91e3a9191c0ca9bb607c321bd92dfb5516913d0199061d56b031b2600082" }, "downloads": -1, "filename": "mezzanine_client-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e6f4e47837e191ded19a9a183164bbfd", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 6319, "upload_time": "2016-03-26T12:59:46", "url": "https://files.pythonhosted.org/packages/1b/fa/90b0b16893333bd593db2a1212ebcf657c01e61f8864121c70b08ef79004/mezzanine_client-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4eeaa2031345fb7da11f9c6daf395888", "sha256": "cb7c4a9be47fc6a3c82a7a8f862bfb1c5690b53a848ea9b7f42d856365ca70fd" }, "downloads": -1, "filename": "mezzanine-client-0.1.1.tar.gz", "has_sig": false, "md5_digest": "4eeaa2031345fb7da11f9c6daf395888", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5530, "upload_time": "2016-03-26T12:59:53", "url": "https://files.pythonhosted.org/packages/43/42/10939b3fcdab64ea2e124acf6fe5e553476434f154b96489eef0225d772c/mezzanine-client-0.1.1.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "3f2ba0628fa5ad2103f141c4e23537b9", "sha256": "e95a819b3e32aac12a668c35038a843b6af5abb0e46baebd1cbc0c23438b7549" }, "downloads": -1, "filename": "mezzanine_client-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3f2ba0628fa5ad2103f141c4e23537b9", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 10769, "upload_time": "2016-05-09T01:23:31", "url": "https://files.pythonhosted.org/packages/53/54/ad8d7f7a5b64cb38f87d091ba99ecfc3eb6f18aca0ec4e3c708fd3e046b2/mezzanine_client-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ee52da7b396745507a45e95acd140149", "sha256": "7e12eb03ef94f76bc1f391dde43a89bf2aab77f1bf5659b9c40f991127792915" }, "downloads": -1, "filename": "mezzanine-client-0.2.1.tar.gz", "has_sig": false, "md5_digest": "ee52da7b396745507a45e95acd140149", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10399, "upload_time": "2016-05-09T01:23:49", "url": "https://files.pythonhosted.org/packages/ba/e8/5e80d07080419f7c3e441da063390b6e2c3f6ecb0ff4c5ae9319e7dc7298/mezzanine-client-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "fed0483c942c1afa970cf98ade181a48", "sha256": "fa45922b7c3f14a60dd2ba2027391532278d7d3d4134336f29cddb98d5c4e530" }, "downloads": -1, "filename": "mezzanine_client-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "fed0483c942c1afa970cf98ade181a48", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 10771, "upload_time": "2016-10-07T01:08:44", "url": "https://files.pythonhosted.org/packages/d5/4c/7f963d5b8fda6be0792057d45c08eacef263d8f2eab4caa418c31f93c3dd/mezzanine_client-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "636b39d1e92c5a45a0aa9cf117168f12", "sha256": "b7da3c93a77e5b01094e46519ed390c58b76cf1728f9eb054ae251aeebd1fe16" }, "downloads": -1, "filename": "mezzanine-client-0.2.2.tar.gz", "has_sig": false, "md5_digest": "636b39d1e92c5a45a0aa9cf117168f12", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10404, "upload_time": "2016-10-07T01:08:46", "url": "https://files.pythonhosted.org/packages/44/9a/48a8984c51d1180ce16a5bb1d32461bd419f4e77805b386a05d67dd93412/mezzanine-client-0.2.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "fed0483c942c1afa970cf98ade181a48", "sha256": "fa45922b7c3f14a60dd2ba2027391532278d7d3d4134336f29cddb98d5c4e530" }, "downloads": -1, "filename": "mezzanine_client-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "fed0483c942c1afa970cf98ade181a48", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 10771, "upload_time": "2016-10-07T01:08:44", "url": "https://files.pythonhosted.org/packages/d5/4c/7f963d5b8fda6be0792057d45c08eacef263d8f2eab4caa418c31f93c3dd/mezzanine_client-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "636b39d1e92c5a45a0aa9cf117168f12", "sha256": "b7da3c93a77e5b01094e46519ed390c58b76cf1728f9eb054ae251aeebd1fe16" }, "downloads": -1, "filename": "mezzanine-client-0.2.2.tar.gz", "has_sig": false, "md5_digest": "636b39d1e92c5a45a0aa9cf117168f12", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10404, "upload_time": "2016-10-07T01:08:46", "url": "https://files.pythonhosted.org/packages/44/9a/48a8984c51d1180ce16a5bb1d32461bd419f4e77805b386a05d67dd93412/mezzanine-client-0.2.2.tar.gz" } ] }