Metadata-Version: 2.1
Name: swh.objstorage
Version: 0.2.2
Summary: Software Heritage Object Storage
Home-page: https://forge.softwareheritage.org/diffusion/DOBJS
Author: Software Heritage developers
Author-email: swh-devel@inria.fr
License: UNKNOWN
Project-URL: Bug Reports, https://forge.softwareheritage.org/maniphest
Project-URL: Funding, https://www.softwareheritage.org/donate
Project-URL: Source, https://forge.softwareheritage.org/source/swh-objstorage
Project-URL: Documentation, https://docs.softwareheritage.org/devel/swh-objstorage/
Description: swh-objstorage
        ==============
        
        Content-addressable object storage for the Software Heritage project.
        
        
        Quick start
        -----------
        
        The easiest way to try the swh-objstorage object storage is to install it in a
        virtualenv. Here, we will be using
        [[https://virtualenvwrapper.readthedocs.io|virtualenvwrapper]]_ but any virtual
        env tool should work the same.
        
        In the example below we will create a new objstorage using the
        [[https://docs.softwareheritage.org/devel/apidoc/swh.objstorage.html#module-swh.objstorage.objstorage_pathslicing|pathslicer]]
        backend.
        
        
        ```
        ~/swh$ mkvirtualenv -p /usr/bin/python3 -i swh.objstorage swh-objstorage
        [...]
        (swh-objstorage) ~/swh$ cat >local.yml <<EOF
        objstorage:
          cls: pathslicing
          args:
            root: /tmp/objstorage
            slicing: 0:2/2:4/4:6
        EOF
        (swh-objstorage) ~/swh$ mkdir /tmp/objstorage
        (swh-objstorage) ~/swh$ swh-objstorage -C local.yml serve -p 15003
        INFO:swh.core.config:Loading config file local.yml
        ======== Running on http://0.0.0.0:15003 ========
        (Press CTRL+C to quit)
        ```
        
        Now we have an API listening on http://0.0.0.0:15003 we can use to store and
        retrieve objects from. I an other terminal:
        
        ```
        ~/swh$ workon swh-objstorage
        (swh-objstorage) ~/swh$ cat >remote.yml <<EOF
        objstorage:
          cls: remote
          args:
            url: http://127.0.0.1:15003
        EOF
        (swh-objstorage) ~/swh$ swh-objstorage -C remote.yml import .
        INFO:swh.core.config:Loading config file remote.yml
        Imported 1369 files for a volume of 722837 bytes in 2 seconds
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: testing
