Metadata-Version: 2.1
Name: hg-fastimport
Version: 0.1.1
Summary: Mercurial extension for importing a git fast-import stream.
Home-page: https://roy.marples.name/hg/hg-fastimport/
Author: The hg-fastimport authors
Maintainer: Roy Marples
Maintainer-email: roy@marples.name
License: GPLv2
Keywords: hg git mercurial
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, <4
License-File: COPYING

=============
hg-fastimport
=============

WARNING: this extension is incomplete and lightly tested.  It is
currently intended for Mercurial developers or particularly daring
users.

hg-fastimport is a Mercurial extension for importing Git's fast-import
dumps into Mercurial. fast-import is a file format for representing the
entire history of a version control repository.

This file format was designed to make it easier to write tools which
convert from foreign (non-Git) VCS repository formats into Git; such
tools exist for CVS, Mercurial, Darcs, and Perforce.

==============
How to Install
==============

Using Pip
---------

You can install the latest released version using pip::

  $ pip install --user hg-fastimport

Then enable it in yourn hgrc::

  [extensions]
  fastimport =

From Source
-----------

To install a local version from source::

  $ hg clone https://roy.marples.name/hg/hg-fastimport/
  $ cd hg-fastimport
  $ pip install --user .

Then enable it in your hgrc::

  [extensions]
  fastimport =

==========
How to Use
==========

To import into a brand-new Mercurial repository::

  $ hg init new
  $ cd new
  $ hg fastimport --datesort FILE...

where FILE... is a list of one or more fast-import dumps.
