Microsoft Azure Storage Library for Python
Перейти к файлу
Emily Gerner b6e526100b Merge pull request #130 from emgerner-msft/dev
merge
2016-02-17 13:28:56 -08:00
azure Correctly populate blob propeties in list_blobs 2016-02-17 11:19:31 -08:00
doc Merge branch 'master' into dev 2016-02-17 13:22:40 -08:00
samples sample doc updates 2016-02-17 13:14:40 -08:00
tests update recordings 2016-02-17 13:14:49 -08:00
.gitignore Rename APIs and params for the blob, queue, and file services. 2015-10-22 14:39:28 -07:00
BreakingChanges.md Update ChangeLogs and inline docs 2016-02-17 09:13:27 -08:00
ChangeLog.md Update ChangeLogs and inline docs 2016-02-17 09:13:27 -08:00
LICENSE.txt Imported code from the azure-sdk-for-python repository. 2015-08-13 15:22:36 -07:00
MANIFEST.in Imported code from the azure-sdk-for-python repository. 2015-08-13 15:22:36 -07:00
README.rst version and upgrade doc 2016-02-16 10:23:29 -08:00
azure-storage-python.pyproj version and upgrade doc 2016-02-16 10:23:29 -08:00
azure-storage-python.sln Imported code from the azure-sdk-for-python repository. 2015-08-13 15:22:36 -07:00
requirements.txt Remove wheelhouse now that the dependencies are all on PyPI. 2015-08-24 13:56:17 -07:00
setup.cfg Do not mark the wheel as universal, because the requirements are different on Python 2 and 3. 2015-09-10 17:16:22 -07:00
setup.py version and upgrade doc 2016-02-16 10:23:29 -08:00

README.rst

Microsoft Azure Storage SDK for Python
======================================

This project provides a client library in Python that makes it easy to
consume Microsoft Azure Storage services. For documentation please see
the Microsoft Azure `Python Developer Center`_ and our `ReadTheDocs`_ page.

    If you are looking for the Service Bus or Azure Management
    libraries, please visit
    https://github.com/Azure/azure-sdk-for-python.


Compatibility
=============

**IMPORTANT**: If you have an earlier version of the azure package
(version < 1.0), you should uninstall it before installing this package.

You can check the version using pip:

.. code:: shell

    pip freeze

If you see azure==0.11.0 (or any version below 1.0), uninstall it first:

.. code:: shell

    pip uninstall azure

If you are upgrading from a version older than 0.30.0, see the upgrade doc, the 
usage samples in the samples directory, and the ChangeLog and BreakingChanges.

Features
========

-  Blob

   -  Create/Read/Update/Delete containers
   -  Create/Read/Update/Delete blobs
   -  Advanced Blob Operations

-  Queue

   -  Create/Delete Queues
   -  Insert/Peek Queue Messages
   -  Advanced Queue Operations

-  Table

   -  Create/Read/Update/Delete tables
   -  Create/Read/Update/Delete entities
   -  Batch operations
   -  Advanced Table Operations

-  Files

   -  Create/Update/Delete Directories
   -  Create/Read/Update/Delete Files
   -  Advanced File Operations

Getting Started
===============

Download
--------

Option 1: Via PyPi
~~~~~~~~~~~~~~~~~~

To install via the Python Package Index (PyPI), type:
::

    pip install azure-storage

Option 2: Source Via Git
~~~~~~~~~~~~~~~~~~~~~~~~

To get the source code of the SDK via git just type:

::

    git clone git://github.com/Azure/azure-storage-python.git
    cd ./azure-storage-python
    python setup.py install

Option 3: Source Zip
~~~~~~~~~~~~~~~~~~~~

Download a zip of the code via GitHub or PyPi. Then, type:

::

    cd ./azure-storage-python
    python setup.py install

Minimum Requirements
--------------------

-  Python 2.7, 3.3, or 3.4.
-  See setup.py for dependencies

Usage
-----

To use this SDK to call Microsoft Azure storage services, you need to
first `create an account`_.

Code Sample
-----------

See the samples directory for blob, queue, table, and file usage samples.

Need Help?
==========

Be sure to check out the Microsoft Azure `Developer Forums on MSDN`_ or
the `Developer Forums on Stack Overflow`_ if you have trouble with the
provided code.

Contribute Code or Provide Feedback
===================================

If you would like to become an active contributor to this project please
follow the instructions provided in `Azure Projects Contribution
Guidelines`_.

If you encounter any bugs with the library please file an issue in the
`Issues`_ section of the project.

Learn More
==========

-  `Python Developer Center`_
-  `Azure Storage Service`_
-  `Azure Storage Team Blog`_
-  `ReadTheDocs`_

.. _Python Developer Center: http://azure.microsoft.com/en-us/develop/python/
.. _ReadTheDocs: http://azure-storage.readthedocs.org/en/latest/
.. _here: https://github.com/Azure/azure-storage-python/archive/master.zip
.. _create an account: https://account.windowsazure.com/signup
.. _Developer Forums on MSDN: http://social.msdn.microsoft.com/Forums/windowsazure/en-US/home?forum=windowsazuredata
.. _Developer Forums on Stack Overflow: http://stackoverflow.com/questions/tagged/azure+windows-azure-storage
.. _Azure Projects Contribution Guidelines: http://azure.github.io/guidelines.html
.. _Issues: https://github.com/Azure/azure-storage-python/issues
.. _Azure Storage Service: http://azure.microsoft.com/en-us/documentation/services/storage/
.. _Azure Storage Team Blog: http://blogs.msdn.com/b/windowsazurestorage/