bot-formatter

A formatter and language file validator for Python Discord bots.

✏️ Includes formatters for Pycord and discord.py.
📚 Format and compare YAML files.
📝 Supports Ezcord language files.

Installing

Python 3.10 or higher is required.

pip install bot-formatter

Usage

To format a file, run:

bot-formatter main.py

To format YAML language files in a directory, run:

bot-formatter --lang path/to/language/dir

To view all available options, run:

bot-formatter --help

For a full overview, see the documentation.

Pre-Commit

To use bot-formatter as a pre-commit hook, add the following lines to your .pre-commit-config.yaml:

- repo: https://github.com/CookieAppTeam/bot-formatter
  rev: 0.1.3
  hooks:
    - id: bot-formatter

Metadata

Release files for bot-formatter 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bot-formatter 0.1.3
File	Size	Uploaded
bot_formatter-0.1.3.tar.gz	9.6 kB	Mar 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bot-formatter 0.1.3
File	Interpreter	ABI	Platform	Reset
bot_formatter-0.1.3-py3-none-any.whl 10.7 kB Mar 28, 2026	Python 3	none	any	Details

Total release size: 20.4 kB

Release files / bot_formatter-0.1.3.tar.gz

Download URL	bot_formatter-0.1.3.tar.gz
Size	9.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`8eeb86b3ba8ead78e4c7ecb01950e86d71ef93477b9ec897f3b005dbc34c2069`
BLAKE2b-256 checksum How to use checksums	`9397d0e7e83aa015dc10d67842d575bb055934d4cc04cbf62bd66d0faa05d75b`
Upload date	Mar 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CookieAppTeam/bot-formatter
Publishing commit: github.com/CookieAppTeam/bot-formatter/tree/c481bb82d4c31c9dd53c12ae02d0cdf944cf42a5

Workflow

Publishing configuration: github.com/CookieAppTeam/bot-formatter/blob/c481bb82d4c31c9dd53c12ae02d0cdf944cf42a5/.github/workflows/python-publish.yml
Publishing logs: github.com/CookieAppTeam/bot-formatter/actions/runs/23683194101/attempts/1

Artifact

Subject: bot_formatter-0.1.3.tar.gz
SHA-256 checksum: 8eeb86b3ba8ead78e4c7ecb01950e86d71ef93477b9ec897f3b005dbc34c2069 Verifying attestations

Release files / bot_formatter-0.1.3-py3-none-any.whl

Download URL	bot_formatter-0.1.3-py3-none-any.whl
Size	10.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`666c046d90bb97e065f752bb1deb66eefb02ef29f5369fd4af4ce4dcfcac0453`
BLAKE2b-256 checksum How to use checksums	`9370b90a1b17afdbb5296e7c0f3a45e31e4ce7a31ee1f277e1269cea810e9b9b`
Upload date	Mar 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CookieAppTeam/bot-formatter
Publishing commit: github.com/CookieAppTeam/bot-formatter/tree/c481bb82d4c31c9dd53c12ae02d0cdf944cf42a5

Workflow

Publishing configuration: github.com/CookieAppTeam/bot-formatter/blob/c481bb82d4c31c9dd53c12ae02d0cdf944cf42a5/.github/workflows/python-publish.yml
Publishing logs: github.com/CookieAppTeam/bot-formatter/actions/runs/23683194101/attempts/1

Artifact

Subject: bot_formatter-0.1.3-py3-none-any.whl
SHA-256 checksum: 666c046d90bb97e065f752bb1deb66eefb02ef29f5369fd4af4ce4dcfcac0453 Verifying attestations