Verb Conjugator in Andalûh EPA

May 5, 2026 · View on GitHub

This project conjugates verbs in Spanish (-ar, -er, -ir) to conjugations in Andalûh EPA (Êttandâ pal Andalûh) (-âh, -êh, -îh). Also conjugates Andalûh EPA verbs directly.

Description

The Andalusian varieties of [Spanish] (Spanish: andalûh; Andalusian) are spoken in Andalusia, Ceuta, Melilla, and Gibraltar. They include perhaps the most distinct of the southern variants of peninsular Spanish, differing in many respects from northern varieties, and also from Standard Spanish. Further info: https://en.wikipedia.org/wiki/Andalusian_Spanish.

This package introduces transliteration functions to convert español (spanish) spelling to andaluz. As there's no official or standard andaluz spelling, andaluh-py is adopting the EPA proposal (Er Prinzipito Andaluh). Further info: https://andaluhepa.wordpress.com. Other andaluz spelling proposals are planned to be added as well.

✨ Main Features

  • Conjugation in Python: Uses verbecc library directly as underlying spanish verbs conjugation library.
  • Transliteration to EPA: Uses andaluh to transliterate from Spanish orthography to the Andalûh EPA proposal.
  • Handling of irregularities: Applies specific normalizations and corrections for irregular and regular verbs with special endings and particular pronouns.

⚙️ Prerequisites

  • Python 3.12 or higher
  • Virtualenv recommended

🚀 Installation and Setup

  1. Clone the repository:

    git clone https://github.com/andalugeeks/andaluh-verbs
cd andaluh-verbs

  2. Create and activate the virtual environment:

    python3 -m venv .venv
source .venv/bin/activate

  3. Install dependencies:

    pip install -r requirements.txt

  4. Install the package in editable mode (optional):

    pip install -e .

  5. Verify the installation:

    python3 run_andaluh_verbs.py --q "jocifar"

💡 Usage

Run from the terminal

python3 run_andaluh_verbs.py --q "jocifar"

Run as a package

python3 -m andaluh_verbs --q "jocifar"

Run as installed command

andaluh-verbs --q "jocifar"

Use as a library from Python

from andaluh_verbs import Conjugador

conj = Conjugador('jocifar')
result = conj.conjugate()
print(result)

Parameters

  • --q: verb to conjugate (required)

Example:

python3 run_andaluh_verbs.py --q "jocifar"

📄 Code Structure

  • run_andaluh_verbs.py
    • Executable script that takes the verb from --q.
    • Loads the logic from andaluh_verbs.cli and exposes CLI behavior.
  • andaluh_verbs/
    • andaluh_verbs/core.py: centralizes the Conjugador class, verb corrections, and form mapping.
    • andaluh_verbs/cli.py: defines the program entry, parameter parsing, and JSON output.
    • andaluh_verbs/__main__.py: allows running the package with python3 -m andaluh_verbs.
  • requirements.txt
    • Lists the necessary dependencies: andaluh and verbecc.

🔗 Dependencies

  • andaluh-py @ https://github.com/andalugeeks/andaluh-py
  • verbecc @ git+https://github.com/bretttolbert/verbecc.git

License

Check the LICENSE file for more details.