Metadata-Version: 2.4
Name: swh.loader.svn
Version: 2.4.2
Summary: Software Heritage Loader SVN
Author-email: Software Heritage developers <swh-devel@inria.fr>
Project-URL: Homepage, https://gitlab.softwareheritage.org/swh/devel/swh-loader-svn
Project-URL: Bug Reports, https://gitlab.softwareheritage.org/swh/devel/swh-loader-svn/-/issues
Project-URL: Funding, https://www.softwareheritage.org/donate
Project-URL: Documentation, https://docs.softwareheritage.org/devel/swh-loader-svn/
Project-URL: Source, https://gitlab.softwareheritage.org/swh/devel/swh-loader-svn.git
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.9
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: click
Requires-Dist: iso8601
Requires-Dist: requests
Requires-Dist: subvertpy>=0.11.1
Requires-Dist: tenacity>=8.4.2
Requires-Dist: typing-extensions
Requires-Dist: swh.storage>=2.4.1
Requires-Dist: swh.model>=8.1.0
Requires-Dist: swh.scheduler>=0.0.39
Requires-Dist: swh.loader.core>=5.24.0
Provides-Extra: testing
Requires-Dist: click; extra == "testing"
Requires-Dist: iso8601; extra == "testing"
Requires-Dist: requests; extra == "testing"
Requires-Dist: subvertpy>=0.11.1; extra == "testing"
Requires-Dist: tenacity>=8.4.2; extra == "testing"
Requires-Dist: typing-extensions; extra == "testing"
Requires-Dist: swh.storage>=2.4.1; extra == "testing"
Requires-Dist: swh.model>=8.1.0; extra == "testing"
Requires-Dist: swh.scheduler>=0.0.39; extra == "testing"
Requires-Dist: swh.loader.core>=5.24.0; extra == "testing"
Requires-Dist: celery-types; extra == "testing"
Requires-Dist: pytest>=8.1; extra == "testing"
Requires-Dist: pytest-mock; extra == "testing"
Requires-Dist: pytest-postgresql; extra == "testing"
Requires-Dist: requests_mock; extra == "testing"
Requires-Dist: swh.core[http]>=4.5.3; extra == "testing"
Requires-Dist: swh.loader.core[testing]>=5.24.0; extra == "testing"
Requires-Dist: types-python-dateutil; extra == "testing"
Dynamic: license-file

Software Heritage - Subversion loader |build status|
====================================================

.. |build status| image:: https://jenkins.softwareheritage.org/job/DLDSVN/job/master/badge/icon
   :target: https://jenkins.softwareheritage.org/job/DLDSVN/job/master/

The Software Heritage Subversion loader is a tool and a library to walk a
remote svn repository and inject into the Software Heritage archive all
contained files, directories and commits that weren't known before.

The main entry points are

- ``swh.loader.svn.loader.SvnLoader`` for the main svn loader which ingests
  content out of a remote svn repository

- ``swh.loader.svn.loader.SvnLoaderFromDump`` which mounts a repository
  out of a svn dump prior to ingest it.

- ``swh.loader.svn.loader.SvnLoaderFromRemoteDump`` which mounts a repository
  out of a svn dump obtained with svnrdump prior to ingest its content.

- ``swh.loader.svn.directory.SvnExportLoader`` which ingests an svn tree at a
  specific revision.

CLI run
-------

With the configuration:

``/tmp/loader_svn.yml``:

.. code-block:: yaml

   storage:
     cls: remote
     args:
       url: http://localhost:5002/

Run:

.. code-block:: shell

   $ swh loader --config-file /tmp/loader_svn.yml run svn <svn-repository-url>
