This Python script allows you to import issues and pull requests from one repository to another; works even for private repositories, and if the two repositories are not related to each other in any way.
Forked of the script by Andreas
Renberg which in turn was a
fork of one of the tools by Max Korenkov
separated from its original location at
mokorenkov/tools.
The script will by default look for a file named config.ini located in the
same folder as the Python script. For a list of all possible configuration
options, see
Configuration.
To quickly get started, rename config.ini.sample to config.ini, and edit
the fields to match your login info and repository info. If you want to use a
different credentials for the source and target repositories, please see
Configuration: Enterprise Accounts and Advanced Login
Options.
Store the config file in the same folder as the gh-issues-import.py script,
or store it in a different folder, using the --config <file> option to
specify which config file to load in.
Warning: The password is stored in plain-text, so avoid storing the config
file in a public repository. To avoid this, you can instead pass the username
and/or password as arguments by using the -u <username> and -p <password>
flags respectively. If the username or password is not passed in from either of
these locations, the user will be prompted for them when the script runs.
Run the script with the following command to import all open issues into the repository defined in the config:
$ python3 gh-issues-import.py --open
If you want to import all issues (including the closed ones), use --all
instead of --open. Closed issues will still be open in the target repository,
but titles will begin with [CLOSED].
Or to only import specific issues, run the script and include the issue numbers of all issues you wish to import (can be done for one or several issues, and will even include closed issues):
$ python3 gh-issues-import.py --issues 25 26 29
Some config options can be passed as arguments. For a full list, see the the
Arguments page, or
run the script using the --help flag.
Every issue imported will create a new issue in the target repository. Remember that the ID of the issue in the new repository will most likely not be the same as the ID of the original issue. Keep this in mind when writing commit messages such as "Closes #25".
If the issue is a pull request, this will be indicated on the issue, and a link to the code will be provided. However, it will be treated as a new issue in the target repository, and not a pull request. Pulling in the suggested code into the repository will need to be done manually.
Any comments on the issue will be imported, however, the author of all imported comments will be the account specified in the config. Instead, a link and header is provided for each comment indicating who the original author was and the original date and time of the comment. Any subsequent comments added to the issue after it has been imported into the target repository will not be included.
Labels and milestones attached to the issue will be imported and added to the target repository if they do not already exist there. If the label or milestone with the same name already exists, the issue will point to the existing one, and any difference in the description or other details will be ignored.
If allowed by GitHub's policies, it may be a good idea to use a "neutral" account to import the issues and issue comments to avoid imported comments from getting mixed up with developer comments (example: FlixelCommunityBot).
The script will by default use the
Markdown-formatted
templates found in the
templates directory. You can
edit those, or point to your own templates from the config file; see Custom
Templates for more
details.
