Skip to main content

A powerful CLI tool for calculations, unit conversions, and translations using Numo

Project description

🚀 Numo CLI

Your Swiss Army Knife for Calculations, Conversions, and Translations in the Terminal!

PyPI version License: MIT Python 3.8+

Numo CLI transforms your terminal into a powerful computational assistant. Whether you need to crunch numbers, convert units, or translate text, Numo CLI has got you covered - all without leaving your command line!

✨ Features

🧮 Smart Calculations

  • Basic arithmetic operations
  • Complex mathematical expressions
  • Scientific calculations
  • Support for parentheses and operator precedence

🔄 Universal Converter

  • Length (km, m, mi, ft, etc.)
  • Mass (kg, g, lb, oz, etc.)
  • Currency (Real-time rates for USD, EUR, GBP, etc.)
  • Temperature (°C, °F, K)
  • And many more!

🌍 Instant Translations

  • Support for multiple languages
  • Natural language processing
  • Instant results

Powerful CLI

  • Interactive shell with command history
  • Batch processing for multiple calculations
  • Function and variable listing
  • User-friendly error messages

🚀 Quick Start

Installation

pip install numo-cli

For macOS/Linux users, add Python's bin directory to your PATH:

echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Interactive Mode

Launch the interactive shell:

numo-cli

Direct Commands

# Mathematical Operations
numo-cli "2 * (3 + 4)"          # Output: 14
numo-cli "sqrt(16)"             # Output: 4

# Unit Conversions
numo-cli "5.5 km to miles"      # Output: 3.42 miles
numo-cli "100 usd to eur"       # Output: 91.85 EUR
numo-cli "30 celsius to f"      # Output: 86°F

# Translations
numo-cli "hello world in spanish"  # Output: hola mundo
numo-cli "good morning in japanese" # Output: おはようございます

🎯 Advanced Usage

Available Commands

In interactive mode, try these special commands:

# List all available functions
>>> list functions

# List all available variables
>>> list variables

# Complex calculations
>>> sin(45) + cos(30)
>>> log(1000) / ln(10)

# Chained conversions
>>> 100 km/h to m/s
>>> 1 btc to usd to eur

Batch Processing

Process multiple expressions at once:

numo-cli "1 + 1" "2 * 2" "3 ^ 2"

🛠️ Development Setup

  1. Clone and setup:
git clone https://github.com/furkancosgun/numo-cli.git
cd numo-cli
  1. Create virtual environment:
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
pip install -e .

🤝 Contributing

We love your input! Want to contribute? Here's how:

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Furkan Cosgun

🙏 Acknowledgments

  • Built with ❤️ using Numo library
  • Special thanks to all contributors

Made with ❤️ by Furkan Cosgun

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

numo-cli-0.1.6.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

numo_cli-0.1.6-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file numo-cli-0.1.6.tar.gz.

File metadata

  • Download URL: numo-cli-0.1.6.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.9.6

File hashes

Hashes for numo-cli-0.1.6.tar.gz
Algorithm Hash digest
SHA256 a9010bbd699c32c1ee991d7bae4c02efb6ddabf7e3636c1c4b9eea7b9b40d249
MD5 1ca057c187bcc9d364f0257c93f85d0e
BLAKE2b-256 91561eb474c66447cecec18f4a3433ebda5bb9aedd729fcdc1b0a41099405d0e

See more details on using hashes here.

File details

Details for the file numo_cli-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: numo_cli-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.9.6

File hashes

Hashes for numo_cli-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a685663549400db7195e1b6c28cd70768c59dd4b25f0d0aa9c85836ba5dc5167
MD5 a4ef1c9b07915c4b03238b743dda2e5a
BLAKE2b-256 144323170850a14c4da2d5794f7e113440b4d9d9327736635b288d19238899c8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page