https://github.com/artemeon/mantis2github
A small CLI tool to create a GitHub issue out of a Mantis issue.
https://github.com/artemeon/mantis2github
cli github issue issue-management issues mantis mantisbt synchronization ticket ticketing-system
Last synced: 6 months ago
JSON representation
A small CLI tool to create a GitHub issue out of a Mantis issue.
- Host: GitHub
- URL: https://github.com/artemeon/mantis2github
- Owner: artemeon
- License: mit
- Created: 2021-09-24T09:37:27.000Z (about 4 years ago)
- Default Branch: dev/3.x
- Last Pushed: 2025-03-24T18:35:35.000Z (7 months ago)
- Last Synced: 2025-03-24T19:15:57.721Z (7 months ago)
- Topics: cli, github, issue, issue-management, issues, mantis, mantisbt, synchronization, ticket, ticketing-system
- Language: PHP
- Homepage: https://packagist.org/packages/artemeon/mantis2github
- Size: 146 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Mantis 2 GitHub Connector
[](https://packagist.org/packages/artemeon/mantis2github)
[](https://packagist.org/packages/artemeon/mantis2github)
[](https://packagist.org/packages/artemeon/mantis2github)
A small CLI tool to create a GitHub issue out of a Mantis issue.
Creates cross-references, so links the GitHub issue to mantis and vice versa.
## Installation
```shell
composer global require artemeon/mantis2github
```
## Configuration
When you first installed the package, call the `configure` command. You only need to do this once.
```shell
mantis2github configure
```
The command will direct you through the installation process.
### Quick setup
If you have used a previous version of this package and already have a `config.yaml` file, you can skip the configuration by running:
```shell
mantis2github configure path/to/config.yaml
```
## Usage
```shell
mantis2github [command]
```
### Available Commands
| Command | Description |
|------------------------------|-------------------------------------------------------------------|
| [`sync`](#sync) | Create a GitHub issue from a Mantis issue |
| [`read:github`](#readgithub) | Read details of a GitHub issue |
| [`read:mantis`](#readmantis) | Read details of a Mantis issue |
| [`issues:list`](#issueslist) | Get a list of Mantis Tickets with their associated GitHub Issues. |
#### `sync`
Create a GitHub issue from a list of Mantis issues.
```shell
mantis2github sync ...
```
##### Arguments
| Argument | required | Description |
|----------|----------|------------------|
| `ids` | `true` | Mantis issue ids |
##### Examples
###### Sync a single issue
```shell
mantis2github sync 123
```
###### Sync multiple issues
```shell
mantis2github sync 123 456 789
```
#### `read:github`
Read details of a GitHub issue.
```shell
mantis2github read:github
```
##### Arguments
| Argument | required | Description |
|----------|----------|-----------------|
| `id` | `true` | GitHub issue id |
#### `read:mantis`
Read details of a Mantis issue.
```shell
mantis2github read:mantis
```
##### Arguments
| Argument | required | Description |
|----------|----------|-----------------|
| `id` | `true` | Mantis issue id |
#### `issues:list`
Get a list of Mantis Tickets with their associated GitHub Issues.
```shell
mantis2github issues:list [--output=html]
```
##### Options
| Option | Possible values | Description |
|----------|-----------------|---------------|
| `output` | `html` | Output Format |
## License
This project is open-sourced software licensed under the [MIT license](LICENSE).