CUNY-CL / latin_scansion

Apache License 2.0
0 stars 2 forks source link

🏛️ Latin scansion engine 🏛️

Supported Python
versions CircleCI

This library uses finite-state grammars to automate Latin scansion, with an initial focus on the dactylic hexameters of Virgil.

License

The engine is released under an Apache 2.0 license. Please see LICENSE.txt for details.

Installation

Conda is recommended for a reproducible environment. Assuming that Conda (either Miniconda or Anaconda) is available, the following command creates the environment scansion.

conda env create -f environment.yml

This only needs to be done once. The following command then activates the environment.

conda activate scansion

This second step needs to be repeated each time you start a new shell.

Installation

  1. Compile the grammar assets:

    make -j -C grammars
  2. Generate the textproto library:

    make -C latin_scansion
  3. Install the Python library:

    pip install -e .

Command-line tools

Installation produces two command-line tools:

Testing

Run:

pytest tests

Authors