Metadata-Version: 2.4
Name: fr-audio
Version: 0.1.3
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-conjugation-verb-audio
Project-URL: Issues, https://github.com/yenyen1/french-conjugation-verb-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 Verb Conjugation Audios

[![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 verb conjugations. 
Provide the infinitive form of a verb and use options to specify which tenses to download. 
By default, only the infinitive form audio is downloaded.

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.

## 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

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

# Download infinitive present verb audio
fr-audio aller

# Download present tense
fr-audio aller --present

# Download multiple tenses
fr-audio aller --present --past --past_simple --future

```

## 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.

