Metadata-Version: 2.4
Name: g2p_barranquenho
Version: 0.1.2a1
Summary: Rule-based grapheme-to-phoneme converter for Barranquenho
Author-email: JarbasAi <jarbasai@mailfence.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/TigreGotico/g2p_barranquenho
Project-URL: Repository, https://github.com/TigreGotico/g2p_barranquenho
Keywords: barranquenho,g2p,grapheme-to-phoneme,phonemizer,ipa,portuguese
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: orthography2ipa>=1.64.0a1
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: license-file

## `g2p_barranquenho` - Barranquenho Phonemizer

This repository provides a rule-based Grapheme-to-Phoneme (G2P) converter for the **Barranquenho** language.

[Barranquenho](https://en.wikipedia.org/wiki/Barranquenho) is an Ibero-Romance language (often classified as a dialect) spoken in the municipality of Barrancos, Portugal, which shares many features with the nearby Spanish dialects of Extremadura and Andalusia.

The rules implemented in the `phonemize` function are based on the three official 2025 normative sources listed in the **Sources** section below.

### Architecture

`phonemize` builds on the shared [`orthography2ipa`](https://github.com/OpenVoiceOS/orthography2ipa) pronunciation lattice rather than a private tokenizer:

- **Tokenization** is done by the language-agnostic `orthography2ipa.phonetok.PhonetokTokenizer` — a maximal-munch trie over the Barranquenho grapheme set (the consonant multigraphs `tch ch nh lh rr ss` plus the single letters). There is no hand-rolled digraph detection or index arithmetic.
- **Vowel identity** is decided by `orthography2ipa.vowels.is_orthographic_vowel` (which recognises the `ẽ ĩ ũ` nasal vowels), so the engine shares one vowel inventory with the spec instead of keeping a private copy.
- **Barranquenho-specific rules** — coda-conditioned nasalization, nasal diphthongs, stress-conditioned vowel quality, `⟨qu⟩`/`⟨gu⟩` glide elision, `⟨s⟩` → `[h]` coda aspiration, and the three-way `⟨x⟩` rule — are each expressed as an `orthography2ipa.rescorer.LatticeRescorer` re-costing the shared per-grapheme lattice slots, instead of a parallel private cascade.

Nasal vowels are emitted as a single atomic phoneme carrying the IPA/Unicode nasalization diacritic COMBINING TILDE (U+0303), e.g. `[ɐ̃]`. The coda `⟨m⟩`/`⟨n⟩` is absorbed into the preceding nasal vowel rather than surfacing as its own segment, so a nasal vowel is one list item, not a vowel followed by a separate tilde.

### 🚀 Usage

The core functionality is provided by the `phonemize` function, which takes a word (string) and returns a list of International Phonetic Alphabet (IPA) phonemes.

```python
from g2p_barranquenho import phonemize

for word in [...]:
    phonemes = phonemize(word)
    print(word, phonemes)
    
# paraba ['p', 'ɐ', 'ɾ', 'a', 'b', 'ɐ']
# pássaru ['p', 'a', 's', 'ɐ', 'ɾ', 'u']
# biba ['b', 'i', 'b', 'ɐ']
# cahtelu ['k', 'ɐ', 'h', 't', 'e', 'l', 'u']
# boca ['b', 'o', 'k', 'ɐ']
# ambu ['ɐ̃', 'b', 'u']
# cantá ['k', 'ɐ̃', 't', 'a']
# manhán ['m', 'ɐ', 'ɲ', 'ɐ̃']
# que ['k', 'ɨ']
# aquí ['ɐ', 'k', 'i']
```

### Sources

The phoneme rules are derived from the coordinated normative suite produced under the *Programa de Preservação e Valorização da Língua e Cultura Barranquenhas*:

- **Convenção Ortográfica do Barranquenho** (June 2025). Câmara Municipal de Barrancos / II Congresso Barranquenho working group. Available at: https://cm-barrancos.pt/upload_files/1/3/Noticias/2025/II%20Congresso%20Barranquenho/Conven%C3%A7%C3%A3o%20Ortogr%C3%A1fica%20do%20Barranquenho%20junho%202025%20final.pdf
- **Gramática Básica de Barranquenho** (July 2025). Maria Filomena Gonçalves (Universidade de Évora / CIDEHUS-UÉ / FCT / Cátedra UNESCO em Património Imaterial e Saber-Fazer Tradicional), María Victoria Navas (Universidad Complutense de Madrid / CLUL), Victor M. Diogo Correia (Universidade de Évora / CIDEHUS-UÉ / FCT). Universidade de Évora, 1ª edição. ISBN 978-972-778-464-6.
- **Dicionário de Barranquenho** (2025). Maria Filomena Gonçalves (Universidade de Évora / CIDEHUS-UÉ / FCT / Cátedra UNESCO), María Victoria Navas (Universidad Complutense de Madrid / CLUL), Vera Ferreira (CIDLeS — Centro de Documentação Linguística e Social). Universidade de Évora, 1ª edição. ISBN 978-972-778-460-8.
