Metadata-Version: 2.1
Name: ocifs
Version: 0.1.5
Summary: Convenient filesystem interface over Oracle Cloud Infrastructure's Object Storage
Home-page: UNKNOWN
Maintainer: Allen Hosler
Maintainer-email: allen.hosler@oracle.com
License: UPL
Description: 
        ## Oracle Cloud Infrastructure Object Storage fsspec implementation
        ​
        ​
        The [Oracle Cloud Infrastructure Object Storage](https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/objectstorageoverview.htm) service is an internet-scale, high-performance storage platform that offers reliable and cost-efficient data durability. With Object Storage, you can safely and securely store or retrieve data directly from the internet or from within the cloud platform.
        ​
        `ocifs` is part of the `fsspec` [intake/filesystem_spec ecosystem](https://github.com/intake/filesystem_spec)
        ​
        > a template or specification for a file-system interface, that specific implementations should follow, so that applications making use of them can rely on a common interface and not have to worry about the specific internal implementation decisions with any given backend. 
        ​
        `ocifs` joins the list of file systems supported with this package.
        ​
        The `intake/filesystem_spec` project is used by [Pandas](https://pandas.pydata.org/), [Dask](https://dask.org/) and other data libraries in python, this package adds Oracle OCI Object Storage capabilties to these libraries.
        ​
        ## Example Usage:
        ​
        ```python
        import pandas as pd
        import ocifs
        ​
        df = pd.read_csv(
            "oci://my_bucket@my_namespace/myobject.csv",
            storage_options={"config": "~/.oci/config"},
        )
        ```
        ​
        ## Support
        ​
        The built-in filesystems in `fsspec` ([listed here](https://filesystem-spec.readthedocs.io/en/latest/api.html#built-in-implementations)) are maintained by the `intake` project team, where as `ocifs` is an external implementation (similar to `s3fs`, `gcsfs`, `adl/abfs` etc) maintained by Oracle. 
        
Keywords: Oracle Cloud Infrastructure,OCI,Object Storage
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Universal Permissive License (UPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >= 3.6
Description-Content-Type: text/markdown
