{"id":13458789,"url":"https://github.com/robertwayne/cogwatch","last_synced_at":"2026-04-08T13:31:40.175Z","repository":{"id":39534147,"uuid":"288949339","full_name":"robertwayne/cogwatch","owner":"robertwayne","description":"Hot-reloading for discord.py-based command files.","archived":false,"fork":false,"pushed_at":"2023-07-22T15:47:22.000Z","size":279,"stargazers_count":50,"open_issues_count":3,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-02T21:30:09.797Z","etag":null,"topics":["developer-tools","discord","discord-bot","discord-py","discord4py","disnake","hot-reload","nextcord","pycord"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertwayne.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-08-20T08:26:06.000Z","updated_at":"2025-11-24T08:57:36.000Z","dependencies_parsed_at":"2023-02-11T23:40:22.402Z","dependency_job_id":"ad5b89a9-9776-4f7c-a4d8-1df169db3817","html_url":"https://github.com/robertwayne/cogwatch","commit_stats":{"total_commits":89,"total_committers":8,"mean_commits":11.125,"dds":0.4831460674157303,"last_synced_commit":"4ee539b568fc17580c72381021b6280982a35d2b"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/robertwayne/cogwatch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertwayne%2Fcogwatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertwayne%2Fcogwatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertwayne%2Fcogwatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertwayne%2Fcogwatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertwayne","download_url":"https://codeload.github.com/robertwayne/cogwatch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertwayne%2Fcogwatch/sbom","scorecard":{"id":780502,"data":{"date":"2025-08-11","repo":{"name":"github.com/robertwayne/cogwatch","commit":"dce8e7e03fe8d035847934805eee505813fb4fcf"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.5,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 1/26 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v3.3.0 not signed: https://api.github.com/repos/robertwayne/cogwatch/releases/97767864","Warn: release artifact v3.2.0 not signed: https://api.github.com/repos/robertwayne/cogwatch/releases/89657566","Warn: release artifact v3.1.0 not signed: https://api.github.com/repos/robertwayne/cogwatch/releases/75560409","Warn: release artifact v3.0.1 not signed: https://api.github.com/repos/robertwayne/cogwatch/releases/73567585","Warn: release artifact v3.0.0 not signed: https://api.github.com/repos/robertwayne/cogwatch/releases/70566844","Warn: release artifact v3.3.0 does not have provenance: https://api.github.com/repos/robertwayne/cogwatch/releases/97767864","Warn: release artifact v3.2.0 does not have provenance: https://api.github.com/repos/robertwayne/cogwatch/releases/89657566","Warn: release artifact v3.1.0 does not have provenance: https://api.github.com/repos/robertwayne/cogwatch/releases/75560409","Warn: release artifact v3.0.1 does not have provenance: https://api.github.com/repos/robertwayne/cogwatch/releases/73567585","Warn: release artifact v3.0.0 does not have provenance: https://api.github.com/repos/robertwayne/cogwatch/releases/70566844"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 8 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"12 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-24 / GHSA-5h86-8mv2-jq9f","Warn: Project is vulnerable to: GHSA-5m98-qgg9-wh84","Warn: Project is vulnerable to: GHSA-7gpw-8wmc-pm8g","Warn: Project is vulnerable to: GHSA-8495-4g3g-x7pr","Warn: Project is vulnerable to: PYSEC-2024-26 / GHSA-8qpw-xqxj-h4r2","Warn: Project is vulnerable to: GHSA-9548-qrrj-x5pj","Warn: Project is vulnerable to: PYSEC-2023-246 / GHSA-gfw2-4jvh-wgfg","Warn: Project is vulnerable to: GHSA-pjjw-qhg8-p2p9","Warn: Project is vulnerable to: PYSEC-2023-250 / GHSA-q3qx-c6g2-7pw2","Warn: Project is vulnerable to: PYSEC-2023-251 / GHSA-qvrw-v9rv-5rjx","Warn: Project is vulnerable to: PYSEC-2024-48 / GHSA-fj7x-q9j7-g6q6","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-23T04:47:38.660Z","repository_id":39534147,"created_at":"2025-08-23T04:47:38.661Z","updated_at":"2025-08-23T04:47:38.661Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31558380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["developer-tools","discord","discord-bot","discord-py","discord4py","disnake","hot-reload","nextcord","pycord"],"created_at":"2024-07-31T09:00:57.353Z","updated_at":"2026-04-08T13:31:40.151Z","avatar_url":"https://github.com/robertwayne.png","language":"Python","funding_links":[],"categories":["Libraries and Extensions"],"sub_categories":["Utilities"],"readme":"\u003ch1 align=\"center\"\u003eCog Watch\u003c/h1\u003e\n    \n\u003cdiv align=\"center\"\u003e\n  \u003cstrong\u003e\u003ci\u003eAutomatic hot-reloading for your discord.py command files.\u003c/i\u003e\u003c/strong\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n  \n  \u003ca href=\"https://pypi.org/project/cogwatch\"\u003e \u003cimg\n    src=\"https://img.shields.io/pypi/v/cogwatch?color=0073B7\u0026label=Latest\u0026style=for-the-badge\"\n      alt=\"Version\" /\u003e \u003c/a\u003e\n  \u003ca href=\"https://python.org\"\u003e \u003cimg\n    src=\"https://img.shields.io/pypi/pyversions/cogwatch?color=0073B7\u0026style=for-the-badge\"\n      alt=\"Python Version\" /\u003e \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\n`cogwatch` is a utility that you can plug into your `discord.py` bot _(or\nvarious supported bot libraries)_ that will watch your command files directory\n_(cogs)_ and automatically reload them as you modify or move them around in\nreal-time.\n\nNo more reloading your commands manually every time you edit an embed just to\nmake sure it looks perfect!\n\n\u003cimg align=\"center\" src=\"assets/example.png\" alt=\"\"\u003e \u003cbr /\u003e\n\n## Features\n\n- Automatically reloads commands in real-time as you edit them _(no !reload\n  \u003ccommand_name\u003e needed)_.\n- Optionally handles the loading of all your commands on start-up _(removes\n  boilerplate)_.\n\n## Supported Libraries\n\n`cogwatch` _should_ work with any library that forked from `discord.py`.\nHowever, these libraries have been explicitly tested to work:\n\n- [discord.py](https://discordpy.readthedocs.io/en/stable/)\n- [nextcord](https://docs.nextcord.dev/en/stable/)\n- [discord4py](https://docs.discord4py.dev/en/developer/)\n- [disnake](https://disnake.readthedocs.io/en/latest/)\n- [pycord](https://docs.pycord.dev/en/stable/)\n\n## Getting Started\n\nYou can install the library with `pip install cogwatch`.\n\nImport the `watch` decorator and apply it to your `on_ready` method and let the\nmagic take effect.\n\nSee the [examples](/examples) directory for more details.\n\n```python\nimport asyncio\nfrom discord.ext import commands\nfrom cogwatch import watch\n\n\nclass ExampleBot(commands.Bot):\n    def __init__(self):\n        super().__init__(command_prefix='!')\n\n    @watch(path='commands', preload=True) # This is all you need to add.\n    async def on_ready(self):\n        print('Bot ready.')\n\n    async def on_message(self, message):\n        if message.author.bot:\n            return\n\n        await self.process_commands(message)\n\n\nasync def main():\n    client = ExampleBot()\n    await client.start('YOUR_TOKEN_GOES_HERE')\n\nif __name__ == '__main__':\n    asyncio.run(main())\n```\n\n__NOTE__: If you're following the example command files in the\n[examples](/examples) directory, make sure you only use `async/await` on your\nsetup function if the library you're using supports it. For example,\n`discord.py` uses async setup functions, but many other libraries do not.\n`cogwatch` supports both under-the-hood.\n\n## Configuration\n\nThese options can be passed to the decorator _(or the class if manually\ninitializing)_:\n\n| Option | Type | Description | Default |\n| --- | --- | --- | --- |\n| `path` | `str` | Path of the directory where your command files exist; cogwatch will watch recursively within this directory. | `commands` |\n| `preload` | `bool` | Whether to detect and load all cogs on start. | `False` |\n| `colors` | `bool` | Whether to use colorized terminal outputs or not. | `True` |\n| `default_logger` | `bool` | Whether to use the default logger _(to sys.stdout)_ or not. | `True` |\n| `loop` | `AbstractEventLoop` | Custom event loop. | `get_event_loop()` |\n| `debug` | `bool` | Whether to run the bot only when the Python __\\_\\_debug\\_\\___ flag is True. | `True` |\n\n__NOTE:__ `cogwatch` will only run if the __\\_\\_debug\\_\\___ flag is set on\nPython. You can read more about that\n[here](https://docs.python.org/3/library/constants.html). In short, unless you\nrun Python with the _-O_ flag from your command line, __\\_\\_debug\\_\\___ will be\n__True__. If you just want to bypass this feature, pass in `debug=False` and it\nwon't matter if the flag is enabled or not.\n\n## Logging\n\nBy default, the utility has a logger configured so users can get output to the\nconsole. You can disable this by passing in `default_logger=False`. If you want\nto hook into the logger -- for example, to pipe your output to another terminal\nor `tail` a file -- you can set up a custom logger like so:\n\n```python\nimport logging\nimport sys\n\nwatch_log = logging.getLogger('cogwatch')\nwatch_log.setLevel(logging.INFO)\nwatch_handler = logging.StreamHandler(sys.stdout)\nwatch_handler.setFormatter(logging.Formatter('[%(name)s] %(message)s'))\nwatch_log.addHandler(watch_handler)\n```\n\n## Contributing\n\n`cogwatch` is open to all contributions. If you have a feature request or found\na bug, please open an issue or submit a pull request. If your change is\nsignificant, please open an issue first to discuss it.\n\nCheck out the [contributing guidelines](/CONTRIBUTING.md) for more details.\n\n## Integration Tests\n\nIn order to test `cogwatch` against all of the supported libraries, there is a\nsmall integration test suite built-in to this repository. These are not\nautomatically checked tests, but rather a way to manually set up the environment\nfor a specific library and run a bot with `cogwatch` to ensure it works as\nexpected.\n\nThe available scripts are:\n\n- `poetry run discord4py`\n- `poetry run discordpy`\n- `poetry run disnake`\n- `poetry run nextcord`\n- `poetry run pycord`\n\n## License\n\ncogwatch is available under the __[MIT License](/LICENSE)__.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertwayne%2Fcogwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertwayne%2Fcogwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertwayne%2Fcogwatch/lists"}