semvec/pypi-packages huggingface dataset:
uriutils 0.1.16
Easily read and write to different storage platforms in Python.
License: Apache License 2.0
Keywords: boto3 s3 google cloud filesystem file uri url http ftp

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!