{ "info": { "author": "GTXStorage, Inc.", "author_email": "dev@gtxstorage.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "GTXStorage Python Library for Amazon S3 Compatible Cloud Storage |Gitter|\n========\n\nThe GTXStorage Python Client SDK provides simple APIs to access any Amazon S3\ncompatible object storage server.\n\nThis quickstart guide will show you how to install the client SDK and\nexecute an example python program. For a complete list of APIs and\nexamples, please take a look at the `Python Client API\nReference `__\ndocumentation.\n\nThis document assumes that you have a working\n`Python `__ setup in place.\n\nDownload from pip\n-----------------\n\n.. code:: sh\n\n $ pip install gtxstorage\n\nDownload from source\n--------------------\n\n.. code:: sh\n\n $ git clone https://github.com/gtxstorage/gtxstorage-py\n $ cd gtxstorage-py\n $ python setup.py install\n\nInitialize GTXStorage Client\n-----------------------\n\nYou need four items in order to connect to GTXStorage object storage server.\n\n.. csv-table::\n :header: \"Params\", \"Description\"\n :widths: 15, 30\n\n \"endpoint\", \"URL to object storage service.\"\n \"access_key\", \"Access key is like user ID that uniquely identifies your account.\"\n \"secret_key\", \"Secret key is the password to your account.\"\n \"secure\", \"Set this value to 'True' to enable secure (HTTPS) access.\"\n\n\n.. code:: python\n\n from gtxstorage import GTXStorage\n from gtxstorage.error import ResponseError\n\n gtxstorageClient = GTXStorage('play.gtxstorage.io:9000',\n access_key='Q3AM3UQ867SPQQA43P2F',\n secret_key='zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG',\n secure=True)\n\nQuick Start Example - File Uploader\n-----------------------------------\n\nThis example program connects to a GTXStorage object storage server, makes a\nbucket on the server and then uploads a file to the bucket.\n\nWe will use the GTXStorage server running at https://play.gtxstorage.io:9000 in\nthis example. Feel free to use this service for testing and development.\nAccess credentials shown in this example are open to the public.\n\nfile-uploader.py\n~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n # Import GTXStorage library.\n from gtxstorage import GTXStorage\n from gtxstorage.error import ResponseError\n\n # Initialize gtxstorageClient with an endpoint and access/secret keys.\n gtxstorageClient = GTXStorage('play.gtxstorage.io:9000',\n access_key='Q3AM3UQ867SPQQA43P2F',\n secret_key='zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG',\n secure=True)\n\n # Make a bucket with the make_bucket API call.\n try:\n gtxstorageClient.make_bucket(\"maylogs\", location=\"us-east-1\")\n except BucketAlreadyOwnedByYou as err:\n pass\n except BucketAlreadyExists as err:\n pass\n except ResponseError as err:\n raise\n else:\n # Put an object 'pumaserver_debug.log' with contents from 'pumaserver_debug.log'.\n try:\n gtxstorageClient.fput_object('maylogs', 'pumaserver_debug.log', '/tmp/pumaserver_debug.log')\n except ResponseError as err:\n print(err)\n\n\nRun file-uploader\n~~~~~~~~~~~~~~~~~\n\n.. code:: bash\n\n $ python file_uploader.py\n\n $ mc ls play/maylogs/\n [2016-05-27 16:41:37 PDT] 12MiB pumaserver_debug.log\n\nAPI Reference\n-------------\n\nThe full API Reference is available here. `Complete API\nReference `__\n\nAPI Reference : Bucket Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `make\\_bucket `__\n- `list\\_buckets `__\n- `bucket\\_exists `__\n- `remove\\_bucket `__\n- `list\\_objects `__\n- `list\\_incomplete\\_uploads `__\n- `get\\_bucket\\_policy `__\n- `set\\_bucket\\_policy `__\n\nAPI Reference : File Object Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `fput\\_object `__\n- `fget\\_object `__\n\nAPI Reference : Object Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `get\\_object `__\n- `get\\_partial\\_object `__\n- `put\\_object `__\n- `stat\\_object `__\n- `remove\\_object `__\n- `remove\\_incomplete\\_upload `__\n\nAPI Reference : Presigned Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `presigned\\_get\\_object `__\n- `presigned\\_put_object `__\n- `presigned\\_post\\_policy `__\n\nFull Examples\n-------------\n\nFull Examples : Bucket Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `list\\_buckets.py `__\n- `list\\_objects.py `__\n- `bucket\\_exists.py `__\n- `make\\_bucket.py `__\n- `remove\\_bucket.py `__\n- `list\\_incomplete\\_uploads.py `__\n- `remove\\_incomplete\\_upload.py `__\n\nFull Examples : File Object Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `fput\\_object.py `__\n- `fget\\_object.py `__\n\nFull Examples : Object Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `put\\_object.py `__\n- `get\\_object.py `__\n- `get\\_partial\\_object.py `__\n- `remove\\_object.py `__\n- `stat\\_object.py `__\n\nFull Examples : Presigned Operations\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- `presigned\\_get\\_object.py `__\n- `presigned\\_put\\_object.py `__\n- `presigned\\_post\\_policy.py `__\n\nExplore Further\n---------------\n\n- `Complete Documentation `__\n- `GTXStorage Python SDK API\n Reference `__\n\nContribute\n----------\n\n`Contributors Guide <./CONTRIBUTING.md>`__\n\n|PYPI| |Build Status| |Build status|\n\n.. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg\n :target: https://gitter.im/GTXStorage/gtxstorage?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge\n.. |PYPI| image:: https://img.shields.io/pypi/v/gtxstorage.svg\n :target: https://pypi.python.org/pypi/gtxstorage\n.. |Build Status| image:: https://travis-ci.org/gtxstorage/gtxstorage-py.svg\n :target: https://travis-ci.org/gtxstorage/gtxstorage-py\n.. |Build status| image:: https://ci.appveyor.com/api/projects/status/1d05e6nvxcelmrak?svg=true\n :target: https://ci.appveyor.com/project/harshavardhana/gtxstorage-py", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/Genetalks/gtxstorage-py", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Genetalks/gtxstorage-py", "keywords": "", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "gtxstorage", "package_url": "https://pypi.org/project/gtxstorage/", "platform": "", "project_url": "https://pypi.org/project/gtxstorage/", "project_urls": { "Download": "https://github.com/Genetalks/gtxstorage-py", "Homepage": "https://github.com/Genetalks/gtxstorage-py" }, "release_url": "https://pypi.org/project/gtxstorage/1.1.0/", "requires_dist": null, "requires_python": "", "summary": "GTXStorage Python Library for Amazon S3 Compatible Cloud Storage for Python", "version": "1.1.0" }, "last_serial": 3258509, "releases": { "1.1.0": [ { "comment_text": "", "digests": { "md5": "d2e78734f0732d0707d1a5ed50fca2c6", "sha256": "5d3442e5105b8fa2180d317411da0e9a1ee27a6a74804e7ba1318f39ebbc8fc3" }, "downloads": -1, "filename": "gtxstorage-1.1.0.tar.gz", "has_sig": false, "md5_digest": "d2e78734f0732d0707d1a5ed50fca2c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42327, "upload_time": "2017-10-18T01:46:28", "url": "https://files.pythonhosted.org/packages/5d/58/3dfd8dcf6e0ec65e83b39110a5795d4dc7b07db8db7318671acaa12041eb/gtxstorage-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d2e78734f0732d0707d1a5ed50fca2c6", "sha256": "5d3442e5105b8fa2180d317411da0e9a1ee27a6a74804e7ba1318f39ebbc8fc3" }, "downloads": -1, "filename": "gtxstorage-1.1.0.tar.gz", "has_sig": false, "md5_digest": "d2e78734f0732d0707d1a5ed50fca2c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42327, "upload_time": "2017-10-18T01:46:28", "url": "https://files.pythonhosted.org/packages/5d/58/3dfd8dcf6e0ec65e83b39110a5795d4dc7b07db8db7318671acaa12041eb/gtxstorage-1.1.0.tar.gz" } ] }