# 🚀 Numo CLI
> Your Swiss Army Knife for Calculations, Conversions, and Translations in the Terminal!
[![PyPI version](https://badge.fury.io/py/numo.svg)](https://badge.fury.io/py/numo-cli)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
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
```bash
pip install numo-cli
```
For macOS/Linux users, add Python's bin directory to your PATH:
```bash
echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
### Interactive Mode
Launch the interactive shell:
```bash
numo-cli
```
### Direct Commands
```bash
# 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:
```bash
# 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:
```bash
numo-cli "1 + 1" "2 * 2" "3 ^ 2"
```
## 🛠️ Development Setup
1. Clone and setup:
```bash
git clone https://github.com/furkancosgun/numo-cli.git
cd numo-cli
```
2. Create virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
```
3. Install dependencies:
```bash
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](LICENSE) file for details.
## 👨💻 Author
**Furkan Cosgun**
- GitHub: [@furkancosgun](https://github.com/furkancosgun)
- LinkedIn: [Furkan Cosgun](https://linkedin.com/in/furkancsgn)
## 🙏 Acknowledgments
- Built with ❤️ using [Numo](https://github.com/furkancosgun/numo) library
- Special thanks to all contributors
---
<p align="center">
Made with ❤️ by Furkan Cosgun
</p>
Raw data
{
"_id": null,
"home_page": "https://github.com/furkancosgun/numo-cli",
"name": "numo-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "cli, calculator, converter, translator, utility, numo",
"author": "Furkan Cosgun",
"author_email": "furkan51cosgun@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d2/a0/ff9215a291289ab54463ebb0ba6ec26920c91db789a9a083431c80289552/numo-cli-0.2.2.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 Numo CLI\n\n> Your Swiss Army Knife for Calculations, Conversions, and Translations in the Terminal!\n\n\n[![PyPI version](https://badge.fury.io/py/numo.svg)](https://badge.fury.io/py/numo-cli)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n\n\nNumo 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!\n\n## \u2728 Features\n\n\ud83e\uddee **Smart Calculations**\n- Basic arithmetic operations\n- Complex mathematical expressions\n- Scientific calculations\n- Support for parentheses and operator precedence\n\n\ud83d\udd04 **Universal Converter**\n- Length (km, m, mi, ft, etc.)\n- Mass (kg, g, lb, oz, etc.)\n- Currency (Real-time rates for USD, EUR, GBP, etc.)\n- And many more!\n\n\ud83c\udf0d **Instant Translations**\n- Support for multiple languages\n- Natural language processing\n- Instant results\n\n\u26a1 **Powerful CLI**\n- Interactive shell with command history\n- Batch processing for multiple calculations\n- Function and variable listing\n- User-friendly error messages\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\npip install numo-cli\n```\n\nFor macOS/Linux users, add Python's bin directory to your PATH:\n```bash\necho 'export PATH=\"$HOME/Library/Python/3.9/bin:$PATH\"' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n### Interactive Mode\n\nLaunch the interactive shell:\n```bash\nnumo-cli\n```\n\n### Direct Commands\n\n```bash\n# Mathematical Operations\nnumo-cli \"2 * (3 + 4)\" # Output: 14\nnumo-cli \"sqrt(16)\" # Output: 4\n\n# Unit Conversions\nnumo-cli \"5.5 km to miles\" # Output: 3.42 miles\nnumo-cli \"100 usd to eur\" # Output: 91.85 EUR\nnumo-cli \"30 celsius to f\" # Output: 86\u00b0F\n\n# Translations\nnumo-cli \"hello world in spanish\" # Output: hola mundo\nnumo-cli \"good morning in japanese\" # Output: \u304a\u306f\u3088\u3046\u3054\u3056\u3044\u307e\u3059\n```\n\n## \ud83c\udfaf Advanced Usage\n\n### Available Commands\n\nIn interactive mode, try these special commands:\n\n```bash\n# List all available functions\n>>> list functions\n\n# List all available variables\n>>> list variables\n\n# Complex calculations\n>>> sin(45) + cos(30)\n>>> log(1000) / ln(10)\n\n# Chained conversions\n>>> 100 km/h to m/s\n>>> sum(1,2,3) usd to eur\n```\n\n### Batch Processing\n\nProcess multiple expressions at once:\n```bash\nnumo-cli \"1 + 1\" \"2 * 2\" \"3 ^ 2\"\n```\n\n## \ud83d\udee0\ufe0f Development Setup\n\n1. Clone and setup:\n```bash\ngit clone https://github.com/furkancosgun/numo-cli.git\ncd numo-cli\n```\n\n2. Create virtual environment:\n```bash\npython -m venv .venv\nsource .venv/bin/activate # Windows: .venv\\Scripts\\activate\n```\n\n3. Install dependencies:\n```bash\npip install -r requirements.txt\npip install -e .\n```\n\n## \ud83e\udd1d Contributing\n\nWe love your input! Want to contribute? Here's how:\n\n1. Fork the repo\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## \ud83d\udcdd License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\udc68\u200d\ud83d\udcbb Author\n\n**Furkan Cosgun**\n- GitHub: [@furkancosgun](https://github.com/furkancosgun)\n- LinkedIn: [Furkan Cosgun](https://linkedin.com/in/furkancsgn)\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with \u2764\ufe0f using [Numo](https://github.com/furkancosgun/numo) library\n- Special thanks to all contributors\n\n---\n\n<p align=\"center\">\nMade with \u2764\ufe0f by Furkan Cosgun\n</p>\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A powerful CLI tool for calculations, unit conversions, and translations using Numo",
"version": "0.2.2",
"project_urls": {
"Bug Tracker": "https://github.com/furkancosgun/numo-cli/issues",
"Documentation": "https://github.com/furkancosgun/numo-cli#readme",
"Homepage": "https://github.com/furkancosgun/numo-cli",
"Source Code": "https://github.com/furkancosgun/numo-cli"
},
"split_keywords": [
"cli",
" calculator",
" converter",
" translator",
" utility",
" numo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "045c0a9398381e15a26c119f13228a343900473820c0bcfc10a1d825309c2886",
"md5": "3bd0abe03c3e78ff073b7b7758c18348",
"sha256": "62eb680307cb3c5c2d7df8dfa89c27181e6ae962c3392a6e9acde5dbad8fcfd5"
},
"downloads": -1,
"filename": "numo_cli-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3bd0abe03c3e78ff073b7b7758c18348",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6020,
"upload_time": "2024-12-26T18:36:08",
"upload_time_iso_8601": "2024-12-26T18:36:08.064493Z",
"url": "https://files.pythonhosted.org/packages/04/5c/0a9398381e15a26c119f13228a343900473820c0bcfc10a1d825309c2886/numo_cli-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d2a0ff9215a291289ab54463ebb0ba6ec26920c91db789a9a083431c80289552",
"md5": "30ea73fd4abb1228958f652504b2269e",
"sha256": "5ecc0c1945dc2b843854b6b75f44056ca794443e37252e9e4d04440494d2f03c"
},
"downloads": -1,
"filename": "numo-cli-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "30ea73fd4abb1228958f652504b2269e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 5607,
"upload_time": "2024-12-26T18:36:10",
"upload_time_iso_8601": "2024-12-26T18:36:10.242600Z",
"url": "https://files.pythonhosted.org/packages/d2/a0/ff9215a291289ab54463ebb0ba6ec26920c91db789a9a083431c80289552/numo-cli-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-26 18:36:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "furkancosgun",
"github_project": "numo-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numo",
"specs": [
[
">=",
"0.1.0"
]
]
}
],
"lcname": "numo-cli"
}