| .forgejo/workflows | ||
| .vscode | ||
| docs | ||
| examplecog | ||
| LICENSES | ||
| schema/meta | ||
| tests | ||
| tidegear | ||
| .editorconfig | ||
| .envrc | ||
| .gitignore | ||
| .readthedocs.yml | ||
| flake.lock | ||
| flake.nix | ||
| mkdocs.yml | ||
| pyproject.toml | ||
| README.md | ||
| renovate.json | ||
| REUSE.toml | ||
| uv.lock | ||
Tidegear
A collection of utilities for use with Red-DiscordBot, made for SeaCogs. This library is fully documented.
Licensing
Tidegear is licensed under the Mozilla Public License 2.0. Asset files and documentation are licensed under CCO 1.0. Additionally, Tidegear uses the Reuse tool to validate license compliance. If a file does not have an explicit license header - which most should! - you may check the REUSE.toml file to determine the file's license.
Developing
You'll need some prerequisites before you can start working on Tidegear.
git - uv
Additionally, I recommend a code editor of some variety. Visual Studio Code is a good, beginner-friendly option.
Installing Prerequisites
This section of the guide only applies to Windows systems. If you're on Linux, refer to the documentation of the projects listed above. I also offer a Nix Flake that contains all of the required prerequisites, if you're a Nix user.
git
You can download git from the git download page.
Alternatively, you can use winget:
winget install --id=Git.Git -e --source=winget
uv
You can install uv with the following Powershell command:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Alternatively, you can use winget:
winget install --id=astral-sh.uv -e
Getting the Source Code
Once you have git installed, you can use the git clone command to get a copy of the repository on your system.
git clone https://c.csw.im/cswimr/tidegear.git
Then, you can use uv to install the Python dependencies required for development.
uv sync --all-groups --all-extras --frozen