Metadata-Version: 2.1
Name: fonemas
Version: 2.0.0
Summary: Phonetic transcription of Spanish
Home-page: https://github.com/fsanzl/fonemas
Author: Fernando Sanz-Lázaro
Author-email: fsanzl@gmail.com
License: LGPL
Project-URL: Source, https://github.com/fsanzl/fonemas/
Project-URL: Tracker, https://github.com/fsanzl/fonemas/issues
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.5
Classifier: Natural Language :: Spanish
Requires-Python: >=3.5
Description-Content-Type: text/markdown

[![License: LGPL](https://img.shields.io/github/license/fsanzl/fonemas)](https://opensource.org/licenses/LGPL-2.1)
[![Version: 2.0.0](https://img.shields.io/github/v/release/fsanzl/fonemas)](https://pypi.org/project/fonemas/)
[![Python versions: 3.5, 3.6, 3.7, 3.8, 3.9](https://img.shields.io/pypi/pyversions/fonemas)](https://pypi.org/project/fonemas/)


<h2 align="center">Fonemas</h2>
<h3 align="center">A Python phonologic transcription library for Spanish</h2>


*fonemas* is a Python library of methods and functions for phonologic and phonetic ranscription of Spanish words.

This library is part of the research project [Sound and Meaning in Spanish Golden Age Literature](https://soundandmeaning.univie.ac.at/). Automatic verse scansion required identifying phonologic features that can be used using this library.

## Installation

```bash
pip3 install fonemas
```

## Use

The library provides the class  *transcription(sentence, mono, epenthesis)*. The class takes the obligatoy argument *sentence*, which is a string of characters with a Spanish word or words. It optionally takes two Boolean arguments *mono* and *epenthesis* set to False as default. The argument *mono* sets whether the output shows graphic stresses for monosyllabic words and *epenthesis* set the behaviour S bfore consonant in onset (spiritu -> es pi ri tu|spi ri tu).

*transcription()* has three dictionary attributes: *phonology* for the phonological transcription, *phonetics* for the phonetic transcription, and *ascii* for a phonetic trasncription transliterated to ASCII characters. Both *phonology* and *phonetics*  have two keys *{sentence, syllables}* containing each a list of strings, whose elements are words or syllables, respectivelly. *ascii* values are strings with the values separated by spaces.


```python
>>> from fonemas import transcription
>>> object = transcription('Averigüéis')
>>> object.phonology
{'words': ["abeɾig'wejs"], 'syllables': ['a', 'be', 'ɾi', "'gwejs"]}
>>> object.phonetics
{'words': ["aβe'ɾiɣwejs"], 'syllables': ['a', 'βe', "'ɾi", 'ɣwejs']}
>>> object.ascii
{'words': "aBeri'Gwejs", 'syllables': "a Be ri 'Gwejs"}
['a', 'be', 'ɾi', "'gwejs"]
```

## Description

The transcription is done according to the Spanish phonology and phonotactics described by Quilis (2019).


## Contributions

Feel free to contribute using the [GitHub Issue Tracker](https://github.com/fsanzl/fonemas/issues) for feedback, suggestions, or bug reports.


## Licence

This project is under GNU LGPL 2.1. See [LICENCE](https://github.com/fsanzl/fonemas/LICENCE) for details.

## References

Quilis, Antonio, *Tratado de fonología y fonética españolas*. Madrid, Gredos, 2019.


