| Name | botterino JSON |
| Version |
0.5.6
JSON |
| download |
| home_page | https://github.com/pgitox/botterino |
| Summary | Automate posting and hosting of rounds on /r/picturegame |
| upload_time | 2024-08-21 17:38:56 |
| maintainer | None |
| docs_url | None |
| author | itoxici |
| requires_python | >=3.8 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Botterino
Botterino allows automation of hosting and posting of /r/picturegame coordinates rounds
When running botterino, if you win a round, your round will automatically be posted.
It will reply with 'x' or '+correct' to any comments on your round automatically, with configurable tolerances.
---
## Pre-requisites
0. All the files you interact with will live in the botterino-config folder which is located:
1. windows: `C:\Users\your username\botterino-config`
2. mac: `/Users/<your username/botterino-config`
3. linux: `~/botterino-config`
These files are created for you the first time you run the bot
1. You must have [Python](https://www.python.org/downloads/) installed on your computer
1. If on windows it is best to install python from the [microsoft store](https://www.microsoft.com/en-us/p/python-39/9p7qfqmjrfp7?activetab=pivot:overviewtab)
2. Install the bot
1. open a terminal or command prompt window and type the following command: `pip install botterino`
3. You must [create a Reddit app](https://www.reddit.com/prefs/apps/) and add authentication details in
`botterino-config/praw.ini`; see `sample-praw.ini` (on github) for an example
1. Give app any name you choose, such as 'botterino'
2. Choose 'script' as app type
3. Fill in 'redirect URI' with `http://localhost:8080` (This is irrelevant unless OAuth2 is used,but it's a required field)
4. Once created, you'll have a 'secret', copy/paste that as `client_secret` in botterino-config/praw.ini
5. You'll also have a less obvious client id, in the top left under the app name and the words 'personal use script' - copy/paste that into `client_id` in praw.ini
4. Fill out the rest of 'botterino-config/praw.ini' with your Reddit username/password as well as anything you want for `user_agent`
---
## Usage
- add round(s) in botterino-config/rounds/rounds.yaml. See sample-rounds.yaml on botterino github page for information on round syntax and types of features supported.
- run with `python -m botterino`
## UI:
- The ui can be launched with `python -m botterino.ui`
- Through the ui you can automatically populate rounds.yaml and start/stop the bot
### Normal hosting
Rounds are kept in the 'rounds/rounds.yaml' file, see 'sample.yaml' for some examples
#### Steps
1. Add round(s) to 'botterino-config/rounds/rounds.yaml'
2. Open a terminal or command prompt and type `python -m botterino`
1. Then all you have to do is win. Until you win, botterino will do nothing
2. When you win, the top round in rounds.yaml is posted as soon as you are approved to host
Any new rounds added to 'botterino-config/rounds/rounds.yaml' while the app is running will automatically be added to the queue, no need to restart.
Once a round is complete, it will be moved to 'botterino-config/rounds/archive.yaml'.
### Live rounds
Botterino can be used on a round that is already live
This is useful for cases where
1. You post manually and decide you would like bot to host
2. Bot posts for you but crashes during hosting for some reason
#### Steps
1. Will use the top round in rounds.yaml
1. `url` field should be omitted
2. Run with `python -m botterino.failure`
### Hints:
Botterino can schedule hints and post them automatically.
The file `botterino-config/hints.yaml` will be scanned for entries with the same key
as the corresponding entry in `botterino-config/rounds.yaml`. See `sample-hints.yaml` for syntax.
---
## Misc
### Customize
Options such as correct message and incorrect message can be customized in botterino-config/config.ini
### Update
Update this botterino with
`pip install --upgrade botterino`
### Issues
* Bot does not run, crash message shows 403 error, everything in praw.ini looks correct
1. try a different user agent
### Colors on windows
This botterino uses colorful output. If you see strange output like this on windows
then download [Windows terminal](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?rtc=1)
from the Microsoft store.
Raw data
{
"_id": null,
"home_page": "https://github.com/pgitox/botterino",
"name": "botterino",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "itoxici",
"author_email": "itox@picturegame.co",
"download_url": "https://files.pythonhosted.org/packages/89/7b/5b1388bc926c19ca45f5d9586fc23b892589e4cf6fda4a650231f834178e/botterino-0.5.6.tar.gz",
"platform": null,
"description": "# Botterino\n\nBotterino allows automation of hosting and posting of /r/picturegame coordinates rounds\n\nWhen running botterino, if you win a round, your round will automatically be posted.\nIt will reply with 'x' or '+correct' to any comments on your round automatically, with configurable tolerances.\n\n---\n\n## Pre-requisites\n\n0. All the files you interact with will live in the botterino-config folder which is located:\n 1. windows: `C:\\Users\\your username\\botterino-config`\n 2. mac: `/Users/<your username/botterino-config`\n 3. linux: `~/botterino-config`\n These files are created for you the first time you run the bot\n1. You must have [Python](https://www.python.org/downloads/) installed on your computer\n 1. If on windows it is best to install python from the [microsoft store](https://www.microsoft.com/en-us/p/python-39/9p7qfqmjrfp7?activetab=pivot:overviewtab)\n2. Install the bot\n 1. open a terminal or command prompt window and type the following command: `pip install botterino`\n3. You must [create a Reddit app](https://www.reddit.com/prefs/apps/) and add authentication details in\n `botterino-config/praw.ini`; see `sample-praw.ini` (on github) for an example\n 1. Give app any name you choose, such as 'botterino'\n 2. Choose 'script' as app type\n 3. Fill in 'redirect URI' with `http://localhost:8080` (This is irrelevant unless OAuth2 is used,but it's a required field)\n 4. Once created, you'll have a 'secret', copy/paste that as `client_secret` in botterino-config/praw.ini\n 5. You'll also have a less obvious client id, in the top left under the app name and the words 'personal use script' - copy/paste that into `client_id` in praw.ini\n4. Fill out the rest of 'botterino-config/praw.ini' with your Reddit username/password as well as anything you want for `user_agent`\n\n---\n\n## Usage\n\n- add round(s) in botterino-config/rounds/rounds.yaml. See sample-rounds.yaml on botterino github page for information on round syntax and types of features supported.\n- run with `python -m botterino`\n\n## UI:\n- The ui can be launched with `python -m botterino.ui`\n- Through the ui you can automatically populate rounds.yaml and start/stop the bot\n\n### Normal hosting\n\nRounds are kept in the 'rounds/rounds.yaml' file, see 'sample.yaml' for some examples\n\n#### Steps\n1. Add round(s) to 'botterino-config/rounds/rounds.yaml'\n2. Open a terminal or command prompt and type `python -m botterino`\n 1. Then all you have to do is win. Until you win, botterino will do nothing\n 2. When you win, the top round in rounds.yaml is posted as soon as you are approved to host\n\nAny new rounds added to 'botterino-config/rounds/rounds.yaml' while the app is running will automatically be added to the queue, no need to restart.\nOnce a round is complete, it will be moved to 'botterino-config/rounds/archive.yaml'.\n\n### Live rounds\n\nBotterino can be used on a round that is already live\n\nThis is useful for cases where\n1. You post manually and decide you would like bot to host\n2. Bot posts for you but crashes during hosting for some reason\n\n#### Steps\n1. Will use the top round in rounds.yaml\n 1. `url` field should be omitted\n2. Run with `python -m botterino.failure`\n\n### Hints:\nBotterino can schedule hints and post them automatically.\nThe file `botterino-config/hints.yaml` will be scanned for entries with the same key\nas the corresponding entry in `botterino-config/rounds.yaml`. See `sample-hints.yaml` for syntax.\n\n---\n\n## Misc\n\n### Customize\nOptions such as correct message and incorrect message can be customized in botterino-config/config.ini\n\n### Update\nUpdate this botterino with\n`pip install --upgrade botterino`\n\n### Issues\n* Bot does not run, crash message shows 403 error, everything in praw.ini looks correct\n 1. try a different user agent\n\n\n### Colors on windows\nThis botterino uses colorful output. If you see strange output like this on windows\n\nthen download [Windows terminal](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701?rtc=1)\nfrom the Microsoft store.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Automate posting and hosting of rounds on /r/picturegame",
"version": "0.5.6",
"project_urls": {
"Homepage": "https://github.com/pgitox/botterino"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "46d3d24b1214803a2cef382c5263b4ab8ff6211f50b5bcbf229067cc92a6563b",
"md5": "49b54e9738c386ea7ec694a89778032a",
"sha256": "ff46ed578ea1a6d22c236129ecda780f421ff7c3272a842633e9e313804e95e8"
},
"downloads": -1,
"filename": "botterino-0.5.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "49b54e9738c386ea7ec694a89778032a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18694,
"upload_time": "2024-08-21T17:38:55",
"upload_time_iso_8601": "2024-08-21T17:38:55.364657Z",
"url": "https://files.pythonhosted.org/packages/46/d3/d24b1214803a2cef382c5263b4ab8ff6211f50b5bcbf229067cc92a6563b/botterino-0.5.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "897b5b1388bc926c19ca45f5d9586fc23b892589e4cf6fda4a650231f834178e",
"md5": "5011a46dc0bb072cbaf8a4ec25b1dc17",
"sha256": "adaafd74502e7c6e03d1fd1715708a1b471da2e58642351d125cc5a1731a3b44"
},
"downloads": -1,
"filename": "botterino-0.5.6.tar.gz",
"has_sig": false,
"md5_digest": "5011a46dc0bb072cbaf8a4ec25b1dc17",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14585,
"upload_time": "2024-08-21T17:38:56",
"upload_time_iso_8601": "2024-08-21T17:38:56.465289Z",
"url": "https://files.pythonhosted.org/packages/89/7b/5b1388bc926c19ca45f5d9586fc23b892589e4cf6fda4a650231f834178e/botterino-0.5.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-21 17:38:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pgitox",
"github_project": "botterino",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "botterino"
}
