Skip to content

andalugeeks/andaluh-verbs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Verb Conjugator in Andalûh EPA

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.

About

Conjugador de verbos en Andaluh

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • PHP 100.0%