Metadata-Version: 1.1
Name: fs-s3fs
Version: 0.1.7
Summary: Amazon S3 filesystem for PyFilesystem2
Home-page: https://github.com/PyFilesystem/s3fs
Author: Will McGugan
Author-email: willmcgugan@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Description: S3FS
        ====
        
        S3FS is a `PyFilesystem <https://www.pyfilesystem.org/>`__ interface to
        Amazon S3 cloud storage.
        
        As a PyFilesystem concrete class,
        `S3FS <http://fs-s3fs.readthedocs.io/en/latest/>`__ allows you to work
        with S3 in the same way as any other supported filesystem.
        
        Installing
        ----------
        
        You can install S3FS from pip as follows:
        
        ::
        
            pip install fs-s3fs
        
        Opening a S3FS
        --------------
        
        Open an S3FS by explicitly using the constructor:
        
        .. code:: python
        
            from s3_s3fs import S3FS
            s3fs = S3FS('mybucket')
        
        Or with a FS URL:
        
        .. code:: python
        
              from fs import open_fs
              s3fs = open_fs('s3://mybucket')
        
        Downloading Files
        -----------------
        
        To *download* files from an S3 bucket, open a file on the S3 filesystem
        for reading, then write the data to a file on the local filesystem.
        Here's an example that copies a file ``example.mov`` from S3 to your HD:
        
        .. code:: python
        
            from fs.tools import copy_file_data
            with s3fs.open('example.mov', 'rb') as remote_file:
                with open('example.mov', 'wb') as local_file:
                    copy_file_data(remote_file, local_file)
        
        Although it is preferable to use the higher-level functionality in the
        ``fs.copy`` module. Here's an example:
        
        .. code:: python
        
            from fs.copy import copy_file
            copy_file(s3fs, 'example.mov', './', 'example.mov')
        
        Uploading Files
        ---------------
        
        You can *upload* files in the same way. Simply copy a file from a source
        filesystem to the S3 filesystem. See `Moving and
        Copying <https://docs.pyfilesystem.org/en/latest/guide.html#moving-and-copying>`__
        for more information.
        
        S3 URLs
        -------
        
        You can get a public URL to a file on a S3 bucket as follows:
        
        .. code:: python
        
            movie_url = s3fs.geturl('example.mov')
        
        Documentation
        -------------
        
        -  `PyFilesystem Wiki <https://www.pyfilesystem.org>`__
        -  `S3FS Reference <http://fs-s3fs.readthedocs.io/en/latest/>`__
        -  `PyFilesystem
           Reference <https://docs.pyfilesystem.org/en/latest/reference/base.html>`__
        
Keywords: pyfilesystem,Amazon,s3
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Filesystems
