Skip to content

Commit

Permalink
Bump to v0.8.0 #minor
Browse files Browse the repository at this point in the history
  • Loading branch information
No767 authored Apr 25, 2024
1 parent 003f377 commit b4597e5
Show file tree
Hide file tree
Showing 6 changed files with 26 additions and 41 deletions.
2 changes: 1 addition & 1 deletion bot/cogs/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,4 @@ def __str__(self) -> str:


EXTENSIONS = [module.name for module in iter_modules(__path__, f"{__package__}.")]
VERSION: VersionInfo = VersionInfo(major=0, minor=7, micro=3, releaselevel="final")
VERSION: VersionInfo = VersionInfo(major=0, minor=8, micro=0, releaselevel="final")
21 changes: 15 additions & 6 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,26 @@
Addresses one small bug with the dictionary commands not responding. For the release of v0.7.0, please see the [release notes](https://github.com/No767/Catherine-Chan/releases/tag/v0.7.0)
Improved and standarized several components such as
configs, and others.

## ✨ TD;LR

- Addressed improper followups
- Internal codebase changes. No major changes for user features

## 🛠️ Changes

- Updated error responses in `dictionary` commands to properly follow up instead of failing
- Upgrade prod requirements
- Migrated from ENV to YAML configs (https://github.com/No767/Catherine-Chan/pull/165)
- Switched from Nox to Tox toolchains
- Updated documentation to reflect all new changes
- Cleaned up codebase (https://github.com/No767/Catherine-Chan/pull/166)
- Proper pull request templates

## ✨ Additions

- N/A
- New YAML configuration system
- Tox toolchain

## ➖ Removals

- N/A
- Poetry (https://github.com/No767/Catherine-Chan/pull/157)
- ENV support
- IPC support
- Old libraries
Binary file added docs/source/_static/trunk.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
37 changes: 6 additions & 31 deletions docs/source/guides/dev/contributing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -100,30 +100,8 @@ Example Cog:
Python Version Support
----------------------

Catherine-Chan's codebase is written to keep compatibility for Python versions 3.8 - 3.11.
Generally speaking, a Python version is supported until it's EOL (when the security support ends).

When a new version of Python releases, support for that version cannot be added **until the next patch version of that release**
or until all packages and codebase internally support that new release.
This means support for Python 3.12 for example, will not be included until Python 3.12.1 releases.

When writing code for this project, you must keep in mind to ensure that your code is compatible for versions 3.8 - 3.11.
If said code is not compatible, then it will not be merged.

Upgrading Dependencies to the Latest Version
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Generally the protocol is to wait until the latest version rolls out the first
bugfix version. But this may be broken **if and only if** all dependencies
(including sub-dependencies) meet these two requirements:

1. All dependencies (including sub-dependencies) support the newest version of Python and provide built wheels
2. All dependencies (including sub-dependencies) build successfully on the newest version of Python

.. NOTE::
Some libraries built using C require headers to be installed
(for example, ``cysystemd`` requires ``systemd/*.h`` headers, which are located under the ``libsystemd-dev`` package on Debian).
If the second requirement is met, you must denote the package (Debian/Ubuntu) that these headers are bundled in.
Catherine-Chan generally follows `NEP-29 <https://numpy.org/neps/nep-0029-deprecation_policy.html>`_.
Catherine-Chan is tested against versions supported by NEP-29.

GitHub Contributing Guidelines
-----------------------------------
Expand All @@ -146,16 +124,13 @@ Git Commit Styleguides
Source Control Branching Models
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: /_static/gitflow.svg
.. image:: /_static/trunk.png
:align: center
:width: 800

This project uses the standard and quite old Git Flow model.
The development branch is ``main``, and the production branch is ``stable``.
Each commit into stable represents a version release, whether it is a small fix or a major update.
**DO NOT** make PRs off of the ``stable`` branch (you probably can't), as each version update is guaranteed to be completely stable and production ready.

Instead, you are encouraged to fork only the ``main`` branch, and make PRs off of that. Once merged, then the feature or change will be included within the latest release.
This project uses an **trunk-based** development. The development branch is ``main``.
Each commit into ``main`` represents an known working version of the project.
You are encouraged to make PRs off of the ``main`` branch.

Releasing Tags
^^^^^^^^^^^^^^^
Expand Down
3 changes: 2 additions & 1 deletion docs/source/guides/dev/setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -82,4 +82,5 @@ Prometheus Metrics

Catherine-Chan also includes an Prometheus endpoint for metrics.
This can enabled through the ``prometheus.enabled`` key. If
you don't need this feature, feel free to entirely disable it.
you don't need this feature, feel free to entirely disable it.
Disabling this feature does not affect the bot.
4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "catherine-chan"
version = "0.7.3"
version = "0.8.0"
description = "An informational LGBTQ based discord bot"
readme = "README.md"
license = {file = "LICENSE"}
Expand Down Expand Up @@ -38,4 +38,4 @@ addopts = "-ra"
testpaths = [
"tests"
]
pythonpath = ["bot"]
pythonpath = ["bot"]

0 comments on commit b4597e5

Please sign in to comment.