Metadata-Version: 2.1
Name: swh.loader.git
Version: 0.0.47
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: Source, https://forge.softwareheritage.org/source/swh-loader-git
Project-URL: Funding, https://www.softwareheritage.org/donate
Project-URL: Bug Reports, https://forge.softwareheritage.org/maniphest
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
Description-Content-Type: text/markdown
Requires-Dist: dulwich (>=0.18.7)
Requires-Dist: retrying
Requires-Dist: vcversioner
Requires-Dist: click
Requires-Dist: swh.core (>=0.0.7)
Requires-Dist: swh.loader.core (>=0.0.37)
Requires-Dist: swh.model (>=0.0.27)
Requires-Dist: swh.scheduler (>=0.0.14)
Requires-Dist: swh.storage (>=0.0.108)
Provides-Extra: testing
Requires-Dist: pytest ; extra == 'testing'

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/
```


