Skip to main content

Kerbal Space Program changelog file generator

Project description

yaclog-ksp

CI Status PyPI version

A command line tool based on yaclog for converting markdown changelogs to KerbalChangelog config files.

a yak who is a log

Logo by Erin Cassidy

Installation

Install and update with pip:

$ pip install -U yaclog-ksp

Or with uv:

$ uv tool install yaclog-ksp

Usage

Usage: yaclog-ksp [OPTIONS]

  Converts markdown changelogs to KSP changelog configs.

Options:
  --path FILE        Location of the changelog file.  [default: CHANGELOG.md]
  -o, --output FILE  Output file to write to. Uses
                     'GameData/{name}/Versioning/{name}ChangeLog.cfg' by
                     default.

  -n, --name TEXT    The name of the mod. Derived from the current directory
                     by default.

  --version          Show the version and exit.
  --help             Show this message and exit.

for example, running yaclog-ksp --path MyLog.md -n "My KSP Mod" would output to GameData/MyKSPMod/Versioning/MyKSPModChangeLog.cfg

Input files are in markdown, and use a certain syntax to be readable by the tool. Metadata is included in a table at the top of the file (which row you make the header doesnt matter). Each version is an subheading with the version, an optional date, and the KSP version as a tag on the end in brackets

Example Changelog:

# Changelog

This is the changelog for my cool mod!

| modName | MyCoolMod     |
| ------- | ------------- |
| license | CC-By-SA      |
| website | Example.com   |
| author  | A cool person |

## 1.0.0 - 2020-04-16 [KSP 1.11]

First full release

### Fixed

- Nyan Cat now has correct music

### Added

- Multiplayer

## 0.9.1 [KSP 1.10.1]

Supported versions: 0.2.0 beta to 1.10.x

### Changed

A very complicated thing that I can't easily explain in bullet points, 
but this paragraph works pretty well to get the point across!

- Another thing that has multiple specific items
    - this bullet point
    * and this other one
    + oh and another one!

### Removed

- Herobrine

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yaclog_ksp-1.3.0.tar.gz (26.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yaclog_ksp-1.3.0-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file yaclog_ksp-1.3.0.tar.gz.

File metadata

  • Download URL: yaclog_ksp-1.3.0.tar.gz
  • Upload date:
  • Size: 26.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.5

File hashes

Hashes for yaclog_ksp-1.3.0.tar.gz
Algorithm Hash digest
SHA256 7c24b0b04f934eb8c6e70d14f36ed2b4e4618ad1a96959471ea23e6084e0b3f5
MD5 70577c5b613894fdf9a02b5c493c54dc
BLAKE2b-256 46da96cc856977bb9dee442342ba4864fde6e7e800ff42c1db1a1ab7c372584d

See more details on using hashes here.

File details

Details for the file yaclog_ksp-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: yaclog_ksp-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 20.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.5

File hashes

Hashes for yaclog_ksp-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14cdf956a54c9f3f37bee34798bc7efc64928244fd8abd9ab13cafcdac6ebac4
MD5 23be73ec6a47fc5fd894281c1dc67fab
BLAKE2b-256 cfa056d8871b3b2761a7abc3a9f4f75b969d9948f26e8796bf43560de301af95

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page