Forgerie

Forgerie is an open source tool for converting software projects from one collaborative development forge to another (e.g., Phabricator -> GitLab).

See the DESIGN.md for design decisions.

Install quicklisp

Forgerie requires quicklisp on sbcl. Generally you can get sbcl through your distribution. Once installed, you then need to install quicklsip.

Follow the installation instructions at quicklisp.org

Running

Configure

To configure:

$ cp config/config.lisp.tmpl config/config.lisp 
$ $EDITOR config/config.lisp

A lot of these configuration options will lead you to need to take other actions, such as making sure the database for phabricator is local to the machine.

You'll also need to ensure that keys are set up on various machines that will need to be sshed to.

Run the script

Run bin/run

Postmortem

After run, if forgerie-core:*log-mapping-errors* is turned out, running bin/postmortem will dump out a log of all the errors that happened during the run

Generating config.lisp.tmpl

There's a helper script bin/build-config-tmpl to generate config/config.lisp.tmpl from inline documentation.