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

Uploaded Python 3

File details

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

File metadata

  • Download URL: numo-cli-0.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 097f069821fa1198a7c2d17cc14f00ce82d7aa9787f0e80e20153fa2291d8a34
MD5 4e29160415d9a6c7abe665052179ac9e
BLAKE2b-256 de64f8cbc71e5a6d8fe554fd1dae54bdf945583c7290623f51d0cb323642a3b3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: numo_cli-0.1.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 4d2432eab48b45920479a6ba344cadb2dc4c718816e60acfc1a0424a456e2e5d
MD5 7ee2e3750a83a78a270c07b077e30dec
BLAKE2b-256 ca270b50862f9129733d14beaf5dc588f95b5c2b8084ce9286448e0287ee18a9

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