Metadata-Version: 2.4
Name: talocode-devtool
Version: 0.2.1
Summary: Unified CLI toolbox for developers — base64, JWT, timestamps, UUID, JSON, hash, URL, case, color, cron, diff, markdown, IP, HTML, math, and more
Author: Talocode
License: MIT
Project-URL: Homepage, https://github.com/talocode/devtool
Project-URL: PyPI, https://pypi.org/project/talocode-devtool/
Project-URL: npm, https://www.npmjs.com/package/@talocode/devtool
Keywords: developer-tools,cli,base64,uuid,hash,json,talocode
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# DevTool

**Unified developer toolbox** — base64, JWT, timestamps, UUID, JSON, hash, URL, case conversion, color, cron, timezone, diff, markdown, IP, HTML, math, fake data generators, and more.

Part of **[Talocode](https://talocode.site)**. Runs **locally** (no API key required for core tools).

| | |
|--|--|
| **Package** | `pip install talocode-devtool` |
| **Import** | `from devtool.tools import ...` |
| **CLI** | `devtool` |
| **npm** | `@talocode/devtool` |
| **Repo** | [github.com/talocode/devtool](https://github.com/talocode/devtool) |
| **License** | MIT |

---

## Why DevTool?

Everyday engineering is full of micro-tasks: encode this, hash that, convert a timestamp, pretty-print JSON. DevTool is a **single CLI + Python SDK** with a consistent `{ ok, data }` / error shape so agents and humans can script the same toolbox.

- **Local-first** — no network for most tools  
- **Agent-friendly** — structured JSON results  
- **Cross-runtime** — same product family as the npm `@talocode/devtool` package  

---

## Install

```bash
pip install -U talocode-devtool
```

Python **3.10+**.

> Note: the PyPI project name is **`talocode-devtool`**. The import package and CLI are still `devtool`.

---

## CLI

```bash
devtool list                    # list tools
devtool base64 encode hello     # aGVsbG8=
devtool base64 decode aGVsbG8=
devtool uuid v4
devtool uuid v7
devtool json format '{"a":1}'
devtool json minify '{"a": 1}'
devtool hash sha256 hello
devtool hash md5 hello
devtool ts now
devtool case camel hello world
devtool case snake HelloWorld
devtool url encode "a b"
devtool hex-to-rgb "#ff5500"
devtool cron describe "0 * * * *"
devtool diff lines "a\nb" "a\nc"
devtool md to-html "# Title"
devtool ip validate 1.2.3.4
devtool gen email
```

Exact subcommands may vary by version; run `devtool list` / `devtool --help`.

---

## Python SDK

```python
from devtool.tools import (
    base64_encode,
    base64_decode,
    uuid_v4,
    hash_sha256,
    json_format,
    list_tools,
)

print(base64_encode("hello"))   # {"ok": True, "data": "aGVsbG8="}
print(uuid_v4())
print(hash_sha256("hello"))
print(json_format('{"a":1}'))
print(list_tools())             # catalog of available tools
```

### Tool groups (highlights)

| Area | Examples |
|------|----------|
| Encoding | `base64_encode/decode`, `url_encode/decode`, `html_encode/decode` |
| Crypto-ish | `hash_md5`, `hash_sha1`, `hash_sha256`, `hash_sha512`, `jwt_decode` |
| Time | `ts_now`, `ts_to_date`, `date_to_ts`, `tz_convert`, `tz_now` |
| ID | `uuid_v4`, `uuid_v7`, `uuid_validate` |
| JSON | `json_format`, `json_minify`, `json_validate` |
| Text | case camel/snake/kebab/pascal, length, reverse, regex |
| Color / units | hex↔rgb, px↔rem, temp, bytes humanize |
| Cron | `cron_describe`, `cron_next` |
| Diff | line / char diff |
| Markdown | to HTML, strip, tables |
| Network | IP validate/info, CIDR |
| Generators | name, email, phone, address, paragraph |

---

## Agents & automation

DevTool is ideal as an MCP-adjacent **local skill**: deterministic transforms without spending cloud credits. Pair with Codra/Tera for LLM work and DevTool for pure data munging.

---

## Related packages

| Package | Role |
|---------|------|
| `talocode-devtool` | **This package** |
| `talocode` | Cloud multi-product client |
| `talocode-codra` | Coding agent API |
| `talocode-tera` | AI chat/writing/coding API |

---

## Talocode ecosystem

| Project | Role |
|---------|------|
| **[DevTool](https://github.com/talocode/devtool)** | This product |
| **[Codra](https://github.com/talocode/codra)** | Coding agent |
| **[Tera](https://github.com/talocode/tera)** | AI capabilities |
| **[StackLane](https://github.com/talocode/stacklane)** | Cloud platform |
| **[SearchLane](https://github.com/talocode/searchlane)** | Agent search |

[docs.talocode.site](https://docs.talocode.site) · [github.com/talocode](https://github.com/talocode)

## License

MIT © Talocode
