| Name | ticketeer JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | Utility to insert task ticket id into commit message. |
| upload_time | 2024-12-27 23:19:54 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT |
| keywords |
git
hook
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Ticketeer [](https://github.com/mishamyrt/ticketeer/actions/workflows/quality-assurance.yaml) [](https://coveralls.io/github/mishamyrt/ticketeer?branch=main)
<img src="./docs/logo.svg" align="right" width="100" />
Utility to insert task ticket id into commit message.
- **Simple**. Does not need to be configured;
- **Environment agnostic**. Works with any platform that can run git;
- **Fast**. Won't slow down your commit process as actions are performed instantly.
## Installation
### go
```bash
go install github.com/mishamyrt/ticketeer@latest
```
### pnpm
```bash
pnpm add --save-dev ticketeer
```
### npm
```bash
npm install --save-dev ticketeer
```
### yarn
```bash
yarn add --dev ticketeer
```
## Usage
### Standalone
Ticketeer can be used as a standalone tool. To install hook, run:
```bash
ticketeer install
```
The utility will check for installed hooks and install its own.
### Runner
If you are already using runner hooks on your project and want to keep everything under their control, add a `ticketeer apply` call to your runner configuration.
#### [Lefthook](https://github.com/evilmartians/lefthook)
Add the following to your `lefthook.yml` file:
```yaml
prepare-commit-msg:
commands:
append-ticket-id:
run: ticketeer apply
```
If ticketeer is installed using NodeJS package manager, prefix command with your package manager runner, e.g. `pnpm ticketeer apply`, `yarn ticketeer apply` or `npx ticketeer apply`.
## Configuration
Ticketeer is configured by default to be as comfortable as possible for most, but the settings can be overridden. All options are optional (hehe), if you don't specify your own - default value will be used.
- `message`
- `location` - where to insert ticket id into commit message (`title` or `body`).
- `template` - template to use when inserting ticket id into commit message. Must include `{ticket}` variable.
- `ticket`
- `format` - format of ticket id (`numeric`, `alphanumeric`, `alphanumeric-small`, `alphanumeric-caps`).
- `allow-empty` - allow empty ticket id. If set to `false`, commit will be aborted if branch name doesn't contain ticket id.
- `branch`
- `format` - format of branch name (`git-flow`, `git-flow-typeless`, `ticket-id`).
- `ignore` - Additional list of branch names to ignore. Default value is `["main", "master", "develop", "dev", "release/*"]`.
Default configuration is as follows:
```yaml
message:
location: body
template: "{ticket}"
ticket:
format: alphanumeric-caps
allow-empty: true
branch:
format: git-flow
```
Raw data
{
"_id": null,
"home_page": null,
"name": "ticketeer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "git, hook",
"author": null,
"author_email": "Mikhael Khrustik <misha@myrt.co>",
"download_url": "https://files.pythonhosted.org/packages/af/64/b3c22bb0cf66fb5d2e48de54c8882ff6e268a5f4ce798048d2d1586f1242/ticketeer-0.1.5.tar.gz",
"platform": null,
"description": "# Ticketeer [](https://github.com/mishamyrt/ticketeer/actions/workflows/quality-assurance.yaml) [](https://coveralls.io/github/mishamyrt/ticketeer?branch=main)\n\n<img src=\"./docs/logo.svg\" align=\"right\" width=\"100\" />\n\nUtility to insert task ticket id into commit message.\n\n- **Simple**. Does not need to be configured;\n- **Environment agnostic**. Works with any platform that can run git;\n- **Fast**. Won't slow down your commit process as actions are performed instantly.\n\n## Installation\n\n### go\n\n```bash\ngo install github.com/mishamyrt/ticketeer@latest\n```\n\n### pnpm\n\n```bash\npnpm add --save-dev ticketeer\n```\n\n### npm\n\n```bash\nnpm install --save-dev ticketeer\n```\n\n### yarn\n\n```bash\nyarn add --dev ticketeer\n```\n\n## Usage\n\n### Standalone\n\nTicketeer can be used as a standalone tool. To install hook, run:\n\n```bash\nticketeer install\n```\n\nThe utility will check for installed hooks and install its own.\n\n### Runner\n\nIf you are already using runner hooks on your project and want to keep everything under their control, add a `ticketeer apply` call to your runner configuration.\n\n#### [Lefthook](https://github.com/evilmartians/lefthook)\n\nAdd the following to your `lefthook.yml` file:\n\n```yaml\nprepare-commit-msg:\n commands:\n append-ticket-id:\n run: ticketeer apply\n```\n\nIf ticketeer is installed using NodeJS package manager, prefix command with your package manager runner, e.g. `pnpm ticketeer apply`, `yarn ticketeer apply` or `npx ticketeer apply`.\n\n## Configuration\n\nTicketeer is configured by default to be as comfortable as possible for most, but the settings can be overridden. All options are optional (hehe), if you don't specify your own - default value will be used.\n\n- `message`\n - `location` - where to insert ticket id into commit message (`title` or `body`).\n - `template` - template to use when inserting ticket id into commit message. Must include `{ticket}` variable.\n- `ticket`\n - `format` - format of ticket id (`numeric`, `alphanumeric`, `alphanumeric-small`, `alphanumeric-caps`).\n - `allow-empty` - allow empty ticket id. If set to `false`, commit will be aborted if branch name doesn't contain ticket id.\n- `branch`\n - `format` - format of branch name (`git-flow`, `git-flow-typeless`, `ticket-id`).\n - `ignore` - Additional list of branch names to ignore. Default value is `[\"main\", \"master\", \"develop\", \"dev\", \"release/*\"]`.\n\nDefault configuration is as follows:\n\n```yaml\nmessage:\n location: body\n template: \"{ticket}\"\nticket:\n format: alphanumeric-caps\n allow-empty: true\nbranch:\n format: git-flow\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Utility to insert task ticket id into commit message.",
"version": "0.1.5",
"project_urls": null,
"split_keywords": [
"git",
" hook"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b573c29b767a660803cd1961940c8620dd0cec1eb23952f40ef7eb89db6238f6",
"md5": "845c04f50c3b78edc4f3931d787e1ef8",
"sha256": "9b9be9a4b901ea0de6031a5070b682f19761d04f725a09d4cb122517eb877744"
},
"downloads": -1,
"filename": "ticketeer-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "845c04f50c3b78edc4f3931d787e1ef8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 3886,
"upload_time": "2024-12-27T23:19:53",
"upload_time_iso_8601": "2024-12-27T23:19:53.283776Z",
"url": "https://files.pythonhosted.org/packages/b5/73/c29b767a660803cd1961940c8620dd0cec1eb23952f40ef7eb89db6238f6/ticketeer-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "af64b3c22bb0cf66fb5d2e48de54c8882ff6e268a5f4ce798048d2d1586f1242",
"md5": "bfcd255c5604642352cb62117cf73109",
"sha256": "edf37fc0b6514590ca0580a8263f011b27b35c784ad4432d70dade2b3eba0910"
},
"downloads": -1,
"filename": "ticketeer-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "bfcd255c5604642352cb62117cf73109",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 3531,
"upload_time": "2024-12-27T23:19:54",
"upload_time_iso_8601": "2024-12-27T23:19:54.839200Z",
"url": "https://files.pythonhosted.org/packages/af/64/b3c22bb0cf66fb5d2e48de54c8882ff6e268a5f4ce798048d2d1586f1242/ticketeer-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-27 23:19:54",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ticketeer"
}
