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.2.1.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.1-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: numo-cli-0.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 cad671c9c79519f29f85521e4d87ab9fcc79608d3c844608d1d06f8525679a2a
MD5 f9667a8ca23c7384168753c2d9d36953
BLAKE2b-256 9b4b48320fab66f63f73c853ecd9615ca57ef137eeeccca419cd1d3c75c2904b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: numo_cli-0.2.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a4d25c21803be0700f877ffdfb1e6152e0c3575b91028be37be2fe07a45a4e1f
MD5 0490e8ddfc2aa1890cb5b6226e713eeb
BLAKE2b-256 c15c01fe4fdfab1dccbb8d9cd1c8a6f47c5339a6d5ee89a33ed7e7b38d58520b

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