A simple changelog parser
Simple Changes is a dead-simple changelog format that keeps track of changes and call them programmatically. The file format is dead-easy to follow, and you can use this package to parse the file and get information in the changelog. Simple Changes is used in Unscripted to parse the game's changelog and present the latest version information to players, but this library can be used anywhere.
- Python 2.7+
- Poetry package manager (for building)
Quick Start: Install on PyPI
Simple Changes is bundled in Unscripted, but you can install it into your projects anywhere from PyPI with pip:
pip install simplechanges
Install from source
To install Simple Changes from the source code, first clone the repository from GitHub via
git clone. You'll also need to install Poetry. In the root of the source, run the following commands:
- poetry install - poetry build
The resulting wheel files will be available in the dist directory.
- Comments are wrapped in
- Versions are denoted by square brackets:
- Notes are denoted with dashes in the beginning and end with a newline.
Note: To get the
latestversion to work in the parser, always place the latest version at the top of the file.
/* Changelog Test */ [v1.0.1] - Made a small bugfix. [v1.0.0] - Launched! - I ate cheese.
Using the package is relatively easy. To get the latest version in the changelog, assuming the changelog builds up:
from simplechanges import SimpleChangesParser changelog = SimpleChangesParser("changelog.changes") changelog.parse() version, notes = changelog.latest
After parsing, you also can browse for a specific version:
from simplechanges import SimpleChangesParser changelog = SimpleChangesParser("changelog.changes") changelog.parse() version, notes = changelog.versions["v1.0.0"]
This code is licensed under the Mozilla Public License, v2.0.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size simplechanges-0.1.0-py2.py3-none-any.whl (9.8 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
|Filename, size simplechanges-0.1.0.tar.gz (9.2 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for simplechanges-0.1.0-py2.py3-none-any.whl