Metadata-Version: 2.4
Name: fr-audio
Version: 0.3.0
Summary: Provide a French infinitive verb and specify desired tense(s), the tool automatically downloads audio files for all person-specific conjugations
Project-URL: Homepage, https://github.com/yenyen1/French-learning-audio
Project-URL: Issues, https://github.com/yenyen1/French-learning-audio/issues
Author-email: Yenyen Wang <wangyenyen.st00g@g2.nctu.edu.tw>
License-Expression: LGPL-3.0-or-later
License-File: LICENSE
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: edge-tts<8.0,>=7.2
Requires-Dist: verbecc<3.0,>=2.0
Provides-Extra: dev
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Description-Content-Type: text/markdown

# Download French Learning Audio

[![PyPI - Version](https://img.shields.io/pypi/v/fr-audio.svg)](https://pypi.org/project/fr-audio)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fr-audio.svg)](https://pypi.org/project/fr-audio)

A CLI tool for downloading MP3 audio of French learning. Currently supports two features:

- **Verb conjugations**: Enter the infinitive form and use the options to specify which tenses you want. The program automatically converts the verb conjugations and downloads the corresponding audio files. Currently supported common tenses include: indicatif présent, indicatif futur simple, indicatif passé composé, indicatif passé simple, conditionnel présent, and impératif présent.
- **French Sentence**: Generate and download MP3 audio for input French sentences.



## Installation

### From PyPI
```
pip install fr-audio
```
### From Git
```
git clone https://github.com/yenyen1/french-conjugation-verb-audio.git 
cd french-conjugation-verb-audio 
pip install .
``` 

## Usage: Download verb conjugation audio

**Note**: The first run may take about a minute to download the model.

### Print help
```
fr-audio verb --help
```

### Download infinitive present verb audio
```
fr-audio verb aller
```

### Download present tense
```
fr-audio verb aller --present
```
### Download multiple tenses 
```
fr-audio verb aller --present --past --past-simple --future
```

## Usage: Download French sentence audio

**Note**: The first run may take about a minute to download the model.

### Print help
```
fr-audio sentence --help
```

### Download sentence audio
```
fr-audio sentence --sentence "Vous devez remplir un formulaire d'inscription."
```


## Credits
This tool uses the following Python libraries:
- [verbecc](https://github.com/bretttolbert/verbecc?tab=readme-ov-file): A Python library for verb conjugation, enhanced with machine learning techniques.
- [edge-tts](https://github.com/rany2/edge-tts?tab=readme-ov-file): A Python module that allows access to Microsoft Edge’s online text-to-speech service from Python code.

