Metadata-Version: 1.1
Name: uriutils
Version: 0.1.15
Summary: Easily read and write to different storage platforms in Python.
Home-page: http://github.com/skylander86/uriutils
Author: Yanchuan Sim
Author-email: yanchuan@outlook.com
License: Apache License 2.0
Description: uriutils 0.1
        ============
        
        .. image:: https://img.shields.io/pypi/v/uriutils.svg
            :target: https://pypi.python.org/pypi/uriutils
        
        .. image:: https://readthedocs.org/projects/uriutils/badge/?version=latest
            :target: http://uriutils.readthedocs.io/en/latest/?badge=latest
        
        Working with multiple storage platforms (i.e., local filesystem, S3, Google Cloud, etc.) can be quite a hassle.
        This package aims to make it transparent to the user and the developer the underlying storage system by wrapping the different protocols in a common interface.
        
        Documentation available at http://uriutils.readthedocs.io/
        
        Usage
        -----
        
        Example::
        
            with uri_open('http://www.example.com', mode='r') as f:
                contents = f.read()
        
        Example with argument parser::
        
            parser = ArgumentParser(description='Read text file from URI.')
            parser.add_argument('-i', '--input', type=URIFileType('r'), metavar='<input>', help='Input file URI.')
            A = parser.parse_args()
        
            contents = A.input.read()
            print(contents)
        
        Or, writing to a file with argument parser is as easy as::
        
            parser = ArgumentParser(description='Write text file to URI.')
            parser.add_argument('-o', '--output', type=URIFileType('w'), metavar='<output>', help='Output file URI.')
            A = parser.parse_args()
        
            A.output.write('Hello world!\n')
            A.output.close()
        
        
        And you can run ``python uri.py --output s3://example-bucket/output.txt``.
        
        For complete documentation, please see `uriutils-0.1 documentation <http://uriutils.readthedocs.io>`_.
        
        Contribution
        ------------
        
        For bugs and issues, please file them on the `issues <https://github.com/skylander86/uriutils/issues>`_ page.
        Thanks!
        
Keywords: boto3 s3 google cloud filesystem file uri url http ftp
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet
Classifier: Topic :: System :: Filesystems
