Metadata-Version: 2.1
Name: swh.loader.git
Version: 0.3.3
Summary: Software Heritage git loader
Home-page: https://forge.softwareheritage.org/diffusion/DLDG/
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-loader-git
Project-URL: Documentation, https://docs.softwareheritage.org/devel/swh-loader-git/
Description: swh-loader-git
        ==============
        
        The Software Heritage Git Loader is a tool and a library to walk a local
        Git repository and inject into the SWH dataset all contained files that
        weren't known before.
        
        License
        -------
        
        This program is free software: you can redistribute it and/or modify it
        under the terms of the GNU General Public License as published by the
        Free Software Foundation, either version 3 of the License, or (at your
        option) any later version.
        
        This program is distributed in the hope that it will be useful, but
        WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
        Public License for more details.
        
        See top-level LICENSE file for the full text of the GNU General Public
        License along with this program.
        
        Dependencies
        ------------
        
        ### Runtime
        
        -   python3
        -   python3-dulwich
        -   python3-retrying
        -   python3-swh.core
        -   python3-swh.model
        -   python3-swh.storage
        -   python3-swh.scheduler
        
        ### Test
        
        -   python3-nose
        
        Requirements
        ------------
        
        -   implementation language, Python3
        -   coding guidelines: conform to PEP8
        -   Git access: via dulwich
        
        Configuration
        -------------
        
        You can run the loader from a remote origin (*loader*) or from an
        origin on disk (*from_disk*) directly by calling:
        
        
        ```
        python3 -m swh.loader.git.{loader,from_disk}
        ```
        
        ### Location
        
        Both tools expect a configuration file.
        
        Either one of the following location:
        - /etc/softwareheritage/
        - ~/.config/swh/
        - ~/.swh/
        
        Note: Will call that location $SWH_CONFIG_PATH
        
        ### Configuration sample
        
        Respectively the loader from a remote (`git.yml`) and the loader from
        a disk (`git-disk.yml`), $SWH_CONFIG_PATH/loader/git{-disk}.yml:
        ```
        storage:
          cls: remote
          args:
            url: http://localhost:5002/
        ```
        
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
