wyrdcraeft

Current version is 1.2.0.

wyrdcraeft is a Python command-line tool for converting Old English texts into a standard JSON format that can be used for programmatic analysis and manipulation.

Core Features

wyrdcraeft provides the following key features:

  • Ingesting Old English texts from local text files and TEI XML files.

  • Converting the text into a standard JSON format using deterministic heuristics or TEI XML parsing.

  • Properly handling both prose and verse.

  • Generating Old English morphology forms using the migrated Python implementation from Ondřej Tichý’s original Perl-based generator workflow.

Getting Started

To get started with wyrdcraeft:

  1. Installation: Follow the Installation guide

  2. Quick Start: See the Quickstart Guide guide for basic usage

  3. Usage Guide: Learn about commands and options in Using the Command Line Interface and Configuration: Python Client

  4. Configuration: Learn about CLI configuration options in Configuration: Command Line Tool.

  5. FAQ: Check the Frequently Asked Questions section for common questions and troubleshooting

For developers, see the Contributing and Python coding standards guides.

Requirements

  • Python 3.10 - 3.13 (we’re waiting for a dependency to be updated to 3.14)

Licensing and provenance

Bosworth-Toller Old English Dictionary

The OCR extracted text of the Bosworth-Toller Old English Dictionary used in this project is from the Germanic Lexicon Project. The scanning was done by Jason Burton, B. Dan Fairchild, Margaret Hoyt, Grace Mrowicki, Michael O’Keefe, Sarah Hartman, Finlay Logan, Sean Crist, Thomas McFadden, David Harrison, and Sean Crist; that data is in the public domain.

Morphological Analyser of Old English

  • The Old English morphology generator in wyrdcraeft is based on the work of Ondřej Tichý’s thesis, Morphological Analyser of Old English (2017).

  • The upstream morphological generator Perl code and data is (c) Ondřej Tichý, is released under the CC BY 4.0 license. The modified Perl code itself, with Madeleine Thompson’s changes, can be found at github:madeleineth/tichy_oe_generator.

  • Changes made to the morphology generator in this repository by the maintainers of wyrdcraeft are released under the MIT license.

All other code

  • All other code implemented directly by Christopher Malek, also released under the MIT license.