https://github.com/neholos/numio-cli
Tool to perform time calculations.
https://github.com/neholos/numio-cli
Last synced: 21 days ago
JSON representation
Tool to perform time calculations.
- Host: GitHub
- URL: https://github.com/neholos/numio-cli
- Owner: neholos
- License: mit
- Created: 2025-03-16T17:58:49.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-03-16T20:50:53.000Z (12 months ago)
- Last Synced: 2026-01-07T17:59:40.412Z (2 months ago)
- Language: Swift
- Homepage:
- Size: 29.3 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - numio-cli - Tool to perform time calculations. (<a name="calc"></a>Calculators)
- awesome-cli-apps - numio-cli - Tool to perform time calculations. (<a name="calc"></a>Calculators)
README
# Numio CLI
Numio CLI is a command-line tool written in Swift to perform time calculations. It allows users to add or subtract time in the `HH:mm` or `HH` format.
## ✨ Features
- Add or subtract time from a given starting time.
- Works with time inputs in the `HH:mm` or `HH` format.
- Supports simple time operations using `+` or `-` operators.
## 🖥️ Usage
### Command Format
The CLI accepts three arguments:
```zsh
numio
```
- **start-time**: The starting time in HH:mm or HH format.
- **operator**: Either + or - to add or subtract time.
- **add-time**: The time to add or subtract in HH:mm or HH format.
### Example
**Add Time**:
```zsh
numio 12:30 + 02:15
```
Output:
```zsh
14:45
```
**Subtract Time**:
```zsh
numio 14:45 - 01:30
```
Output:
```zsh
13:15
```
### Error Handling
- If an invalid time format is provided, the command will output an error message.
- If an invalid operator (other than + or -) is used, an error will be thrown.
- If the time calculation fails, an error message will be displayed.
## ⚙️ Installation
### Using Homebrew
```bash
brew tap neholos/numio
brew install numio-cli
```
## 🏗️ Build from Source
If you prefer to build the project yourself, follow these steps:
1. Clone the repository:
```zsh
git clone https://github.com/neholos/numio-cli.git
```
2. Navigate to the project directory:
```zsh
cd numio-cli
```
3. Build the project using Swift:
```zsh
swift build
```
4. You can now run the executable:
```zsh
.build/debug/numio
```
## 🤝 Contributing
If you'd like to contribute to this project, feel free to fork the repository, create a branch, and submit a pull request with your changes.
## 📄 License
This project is licensed under the [MIT license](LICENSE.md).