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.)
  • 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
>>> sum(1,2,3) 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.2.2.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.2.2-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: numo-cli-0.2.2.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.2.2.tar.gz
Algorithm Hash digest
SHA256 5ecc0c1945dc2b843854b6b75f44056ca794443e37252e9e4d04440494d2f03c
MD5 30ea73fd4abb1228958f652504b2269e
BLAKE2b-256 d2a0ff9215a291289ab54463ebb0ba6ec26920c91db789a9a083431c80289552

See more details on using hashes here.

File details

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

File metadata

  • Download URL: numo_cli-0.2.2-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.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 62eb680307cb3c5c2d7df8dfa89c27181e6ae962c3392a6e9acde5dbad8fcfd5
MD5 3bd0abe03c3e78ff073b7b7758c18348
BLAKE2b-256 045c0a9398381e15a26c119f13228a343900473820c0bcfc10a1d825309c2886

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