Expand GitHub issue references into Markdown links
Project description
issue-expander
Expand GitHub issue references into Markdown links
$ echo 'rust-lang/rust#106827' | issue-expander -
[Update LLVM to 15.0.7 #106827](https://github.com/rust-lang/rust/pull/106827)
$ echo '#106827' | issue-expander --default-source 'rust-lang/rust'
[Update LLVM to 15.0.7 #106827](https://github.com/rust-lang/rust/pull/106827)
This project is not yet stable in any way and makes absolutely no guarantees about behavior (between releases, or otherwise).
Usage
Usage: issue-expander [OPTIONS] FILE
Turn references like "foo/bar#123" into Markdown links, like
"[Prevent side fumbling #123](https://github.com/foo/bar/pull/123)"
issue-expander works for references to issues and to pull requests.
References are only expanded if they are found at GitHub. To expand
references from private repositories, you'll need to pass your GitHub username
and token. This can be done via environment variables or via command line
options.
To interpret references like `#1138` as `adamwolf/issue-expander#1138`,
specify defaults using `--default-source`.
Options:
--default-source USER/REPO Use USER/REPO when not specified in issue
reference. (Example: "adamwolf/issue-
expander")
-u, --github-username USERNAME GitHub username for looking up issue
references. You can use the environment
variable ISSUE_EXPANDER_GITHUB_USERNAME.
-p, --github-token TOKEN GitHub token for looking up issue references.
You may want to use the environment variable
ISSUE_EXPANDER_GITHUB_TOKEN instead.
--version Show the version and exit.
--help Show this message and exit.
Installation
If you use Homebrew, you can install issue-expander like this:
brew tap adamwolf/issue-expander
brew install issue-expander
Otherwise, I recommend installing with pipx. Once you've got pipx installed, you can install issue-expander like this:
pipx install issue-expander
and pipx installs issue-expander into its own little area, just for you, where you don't have to worry about it messing with any system-wide or even user-wide Python dependencies.
If you want to do something different, issue-expander is available on PyPI. Go hogwild.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for issue_expander-0.1.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 583fcaab5446d3fc129e23403a1acd6ce1255326c550e7ebb9dcfaf779830a8f |
|
MD5 | 126adeb060e7608e4cb0035b692c3365 |
|
BLAKE2b-256 | a8436cb9a837174745958669cd517b3b4ab76bc6a004ec1f66fdb474e456c635 |