avnie 2024.8.6

A fast & user-friendly command-line interface (CLI) for avro.py.

avnie

A fast & user-friendly command-line interface (CLI) for avro.py.

---

[!IMPORTANT] avnie is currently in development and not yet recommended for production use, however you can take part in shaping it's future by submitting an issue to let us know what you think.

---

⚡ Overview

avnie provides a fast and sleek command-line based user interface for the avro.py Python package. It allows you to easily do all of the necessary functions avro.py provides - parsing from English, reversing to Bengali, converting to other formats, you name it! And, avnie does this without the need of writing any actual code.

The project is also built on top of the same Python version that avro.py is based on, so that you can have both of these installed on your local machine without needing to cross-interpret between them.

✨ ... but for whom?

The project is made for those who'd like to use their terminal as a way of quickly and conveniently typing Avro Keyboard-based Bengali text without the need for a hefty frontend UI, or for all the terminal geeks out there.

🔨 Installation

Pip

This package requires Python 3.8 or higher to be used inside your development environment.

# Install / upgrade.
$ pip install avnie

🚀 Usage

The usage of avnie is pretty straightforward. You can either use avro or avnie as the keyword for executing avnie commands. Here are some examples:

# Get basic help regarding usage.
# This also provides additional functionality like autocompletion (TBA).
$ avnie --help
$ avro --help  # or

# Parse a given English text to Bengali.
$ avro parse "ami banglay gan gaite bhalobasi"

# Reverse a given Bengali text to English.
$ avro reverse "আমি বাংলায় গান গাইতে ভালবাসি"

More commands and features will be available as the project progresses in its development phase. For now, you can use the commands above to get started with the basic functionalities. Additional options can be found by running avnie <command> --help.

Some universal flags for each commands include:

# Automatically copy the output to clipboard.
$ avnie parse "oiTa ke?" --copy-on-success  # or -c

# Get text from clipboard.
$ avnie parse --from-clip # or -f

# Toggle between remap and full manual mode.
$ avnie parse "wikipedia"  # remap
$ avnie parse "wikipedia" --ignore-remap  # no remap (can also use --i)

# Convert to Bijoy on output.
$ avnie parse "আমি বাংলায় গান গাইতে ভালবাসি" --bijoy  # or -b

🔨 Building

Requirements

• Python 3.8 or higher
• The Poetry package manager

Steps

# Create a virtual environment using the venv command.
$ python -m venv venv && source venv/bin/activate

# Install the required dependencies.
$ poetry install --sync

# (Optional) Update the dependencies.
$ poetry update

Running Unit Tests

# Use the following command to run the unit tests.
$ poetry run pytest .

---

📋 License

Licensed under the MIT License.