Metadata-Version: 2.1
Name: swh.loader.mercurial
Version: 3.4.3
Summary: Software Heritage Mercurial Loader
Home-page: https://forge.softwareheritage.org/diffusion/DLDHG/
Author: Software Heritage developers
Author-email: swh-devel@inria.fr
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-mercurial
Project-URL: Documentation, https://docs.softwareheritage.org/devel/swh-loader-mercurial/
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 :: 4 - Beta
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: click
Requires-Dist: patool
Requires-Dist: python-dateutil
Requires-Dist: python-hglib
Requires-Dist: mercurial
Requires-Dist: swh.model>=2.6.1
Requires-Dist: swh.storage>=0.37.0
Requires-Dist: swh.scheduler>=0.0.39
Requires-Dist: swh.loader.core>=5.0.0
Provides-Extra: testing
Requires-Dist: pytest; extra == "testing"
Requires-Dist: pytest-mock; extra == "testing"
Requires-Dist: swh.core[http]>=0.0.61; extra == "testing"
Requires-Dist: swh.scheduler[testing]>=0.5.0; extra == "testing"
Requires-Dist: swh.storage[testing]; extra == "testing"
Requires-Dist: types-click; extra == "testing"
Requires-Dist: types-deprecated; extra == "testing"
Requires-Dist: types-python-dateutil; extra == "testing"

swh-loader-mercurial
====================

The Software Heritage Mercurial Loader is a tool and a library to walk a local
mercurial repository and inject into the SWH dataset all contained files that
weren't known before.

The main entry points are:

- ``swh.loader.mercurial.loader.HgLoader`` which reads and loads a local
  repository into an SWH archive.

- ``swh.loader.mercurial.loader.HgArchiveLoader`` which reads and loads
  a local repository wrapped within a tarball

- ``swh.loader.mercurial.directory.HgCheckoutLoader`` which ingests the hg
  tree at a specific changeset or tag.

CLI run
-------

Configuration file
++++++++++++++++++

/tmp/mercurial.yml:

.. code-block:: yaml

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


Basic use
+++++++++

.. code-block:: shell

   swh loader --C /tmp/mercurial.yml run mercurial https://www.mercurial-scm.org/repo/hello
