[[PageOutline(2-5,Contents,pullout)]]

= GitHub issues to Trac conversion script

== Description

This script allows you to import issues from a GitHub repository to Trac.

Example use to import tickets from github.com/username/mycoolsoftware:

{{{#!sh
$ python github2trac.py --tracenv /usr/local/trac-projects/myproj/ \
    --clean --token your_github_token_here --repo username/mycoolsoftware
}}}

See below for more usage options.

See also: t:TracImport

== Bugs/Feature Requests

Contact me by email for now if you have something to add to the list.

 * No more than 100 milestones and 100 issues are imported (due to GitHub not sending more than that in one request, since my repositories are small, there was no need for me to implement the loop to get more, it shouldn't be too hard to do)
 * Releases are not imported
 * Downloads (release assets) are not imported
 * Pull requests are converted to issues with the "pull_request" keyword. This is not necessarily very useful, but it allows Trac tickets numbering to exactly match GitHub one. Maybe this could be made optional.
 * Wiki pages are not imported
 * Attachments (such as images in tickets) are nut imported

== Download

https://pulkomandy.tk/downloads/github2trac-2023.09.30.zip

== Source

https://pulkomandy.tk/gerrit/plugins/gitiles/github-trac-import

== Author/Contributors

'''Author:''' Adrien Destugues

Based on previous work for Bugzilla2Trac and Mantis2Trac