| Name | pullbug JSON |
| Version |
5.1.3
JSON |
| download |
| home_page | http://github.com/justintime50/pullbug |
| Summary | Get bugged via Discord or Slack to merge your GitHub pull requests or close open issues. |
| upload_time | 2024-07-16 22:26:05 |
| maintainer | None |
| docs_url | None |
| author | Justintime50 |
| requires_python | <4,>=3.8 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
<div align="center">
# Pullbug 🐛
Get bugged via Discord or Slack to merge your GitHub pull requests or close open issues.
[](https://github.com/Justintime50/pullbug/actions)
[](https://coveralls.io/github/Justintime50/pullbug?branch=main)
[](https://pypi.org/project/pullbug)
[](LICENSE)
<img src="https://raw.githubusercontent.com/justintime50/assets/main/src/pullbug/showcase.png" alt="Showcase">
</div>
Pullbug can notify you on Discord or Slack of all open pull requests from GitHub. This tool ensures requests never go unnoticed as it can be setup on a schedule to constantly bug you to merge your work. This is perfect for finding old or stale requests and helps you to stay current on new ones. Pass in a few environment variables, setup a [Slackbot](https://slack.com/help/articles/115005265703-Create-a-bot-for-your-workspace) or [Discord](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) webhook and you're all set to be bugged by Pullbug.
**NOTE:** Pullbug works best if you have link unfurling turned off for GitHub on Discord and Slack.
## Install
```bash
# Install tool
pip3 install pullbug
# Install locally
just install
```
## Usage
Pullbug works best when run on a schedule. Run one-off reports or setup Pullbug to notify you at whatever interval you'd like to be bugged via Discord or Slack about pull requests.
Pullbug is highly customizable allowing you to choose which messaging service and what kinds of pull requests or issues you'd like.
```text
Usage:
pullbug --github_token 123... --github_owner justintime50 --github_context users
Options:
-h, --help show this help message and exit
-p, --pulls Bug GitHub for Pull Requests.
-i, --issues Bug GitHub for Issues.
-gt GITHUB_TOKEN, --github_token GITHUB_TOKEN
The token to authenticate with GitHub.
-go GITHUB_OWNER, --github_owner GITHUB_OWNER
The GitHub owner to retrieve pull requests or issues for (can be a user or organization).
-gs {all,open,closed}, --github_state {all,open,closed}
The GitHub state to retrieve pull requests or issues for.
-gc {orgs,users}, --github_context {orgs,users}
The GitHub context to retrieve pull requests or issues for.
-d, --discord Send Pullbug messages to Discord.
-du DISCORD_URL, --discord_url DISCORD_URL
The Discord webhook URL to send messages to.
-s, --slack Send Pullbug messages to Slack.
-st SLACK_TOKEN, --slack_token SLACK_TOKEN
The Slackbot token to authenticate with Slack.
-sc SLACK_CHANNEL, --slack_channel SLACK_CHANNEL
The Slack channel to send messages to.
-r REPOS, --repos REPOS
A comma-separated list of repos to run Pullbug against.
-dr, --drafts Include draft pull requests.
-l LOCATION, --location LOCATION
The location of the Pullbug logs and files.
--base_url BASE_URL The base URL of your GitHub instance (useful for enterprise users with custom hostnames).
--log_level {warning,debug,info,notset,error,critical}
The log level used for the tool.
--disable_descriptions
Disables descriptions in messages.
--quiet Does not output when there is nothing to bug about.
--version show program's version number and exit
```
## Development
```bash
# Get a comprehensive list of development tools
just --list
# Run the tool locally
venv/bin/python pullbug/cli.py --help
```
## Trusted By
The following companies use `Pullbug`:
* [EasyPost](https://easypost.com)
Raw data
{
"_id": null,
"home_page": "http://github.com/justintime50/pullbug",
"name": "pullbug",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Justintime50",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/80/6f/5d2694b6d3863382641f61acca33b52546efbc3a7b610dd00f3296bcc24f/pullbug-5.1.3.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# Pullbug \ud83d\udc1b\n\nGet bugged via Discord or Slack to merge your GitHub pull requests or close open issues.\n\n[](https://github.com/Justintime50/pullbug/actions)\n[](https://coveralls.io/github/Justintime50/pullbug?branch=main)\n[](https://pypi.org/project/pullbug)\n[](LICENSE)\n\n<img src=\"https://raw.githubusercontent.com/justintime50/assets/main/src/pullbug/showcase.png\" alt=\"Showcase\">\n\n</div>\n\nPullbug can notify you on Discord or Slack of all open pull requests from GitHub. This tool ensures requests never go unnoticed as it can be setup on a schedule to constantly bug you to merge your work. This is perfect for finding old or stale requests and helps you to stay current on new ones. Pass in a few environment variables, setup a [Slackbot](https://slack.com/help/articles/115005265703-Create-a-bot-for-your-workspace) or [Discord](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) webhook and you're all set to be bugged by Pullbug.\n\n**NOTE:** Pullbug works best if you have link unfurling turned off for GitHub on Discord and Slack.\n\n## Install\n\n```bash\n# Install tool\npip3 install pullbug\n\n# Install locally\njust install\n```\n\n## Usage\n\nPullbug works best when run on a schedule. Run one-off reports or setup Pullbug to notify you at whatever interval you'd like to be bugged via Discord or Slack about pull requests.\n\nPullbug is highly customizable allowing you to choose which messaging service and what kinds of pull requests or issues you'd like.\n\n```text\nUsage:\n pullbug --github_token 123... --github_owner justintime50 --github_context users\n\nOptions:\n -h, --help show this help message and exit\n -p, --pulls Bug GitHub for Pull Requests.\n -i, --issues Bug GitHub for Issues.\n -gt GITHUB_TOKEN, --github_token GITHUB_TOKEN\n The token to authenticate with GitHub.\n -go GITHUB_OWNER, --github_owner GITHUB_OWNER\n The GitHub owner to retrieve pull requests or issues for (can be a user or organization).\n -gs {all,open,closed}, --github_state {all,open,closed}\n The GitHub state to retrieve pull requests or issues for.\n -gc {orgs,users}, --github_context {orgs,users}\n The GitHub context to retrieve pull requests or issues for.\n -d, --discord Send Pullbug messages to Discord.\n -du DISCORD_URL, --discord_url DISCORD_URL\n The Discord webhook URL to send messages to.\n -s, --slack Send Pullbug messages to Slack.\n -st SLACK_TOKEN, --slack_token SLACK_TOKEN\n The Slackbot token to authenticate with Slack.\n -sc SLACK_CHANNEL, --slack_channel SLACK_CHANNEL\n The Slack channel to send messages to.\n -r REPOS, --repos REPOS\n A comma-separated list of repos to run Pullbug against.\n -dr, --drafts Include draft pull requests.\n -l LOCATION, --location LOCATION\n The location of the Pullbug logs and files.\n --base_url BASE_URL The base URL of your GitHub instance (useful for enterprise users with custom hostnames).\n --log_level {warning,debug,info,notset,error,critical}\n The log level used for the tool.\n --disable_descriptions\n Disables descriptions in messages.\n --quiet Does not output when there is nothing to bug about.\n --version show program's version number and exit\n```\n\n## Development\n\n```bash\n# Get a comprehensive list of development tools\njust --list\n\n# Run the tool locally\nvenv/bin/python pullbug/cli.py --help\n```\n\n## Trusted By\n\nThe following companies use `Pullbug`:\n\n* [EasyPost](https://easypost.com)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Get bugged via Discord or Slack to merge your GitHub pull requests or close open issues.",
"version": "5.1.3",
"project_urls": {
"Homepage": "http://github.com/justintime50/pullbug"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "681e7f49230b17f80f6f16a3359cb849f17e6a26c6e1706e4e1e80e79758ffbb",
"md5": "7b41899b51a31ea3f3c0911019879bac",
"sha256": "300fd334fe8484056bd857c6a0454eeaf40174270cbf538f0c277f52e3d403e2"
},
"downloads": -1,
"filename": "pullbug-5.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7b41899b51a31ea3f3c0911019879bac",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.8",
"size": 11702,
"upload_time": "2024-07-16T22:26:03",
"upload_time_iso_8601": "2024-07-16T22:26:03.221022Z",
"url": "https://files.pythonhosted.org/packages/68/1e/7f49230b17f80f6f16a3359cb849f17e6a26c6e1706e4e1e80e79758ffbb/pullbug-5.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "806f5d2694b6d3863382641f61acca33b52546efbc3a7b610dd00f3296bcc24f",
"md5": "2fe5f3bc457b3db0449c43affa02e4a0",
"sha256": "db3fad06736cb11b0c0a475ea80faf022423a8088e7d9443333ddd42cc037d43"
},
"downloads": -1,
"filename": "pullbug-5.1.3.tar.gz",
"has_sig": false,
"md5_digest": "2fe5f3bc457b3db0449c43affa02e4a0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.8",
"size": 14947,
"upload_time": "2024-07-16T22:26:05",
"upload_time_iso_8601": "2024-07-16T22:26:05.072346Z",
"url": "https://files.pythonhosted.org/packages/80/6f/5d2694b6d3863382641f61acca33b52546efbc3a7b610dd00f3296bcc24f/pullbug-5.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-16 22:26:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "justintime50",
"github_project": "pullbug",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "pullbug"
}
