Metadata-Version: 2.4
Name: kajihs-utils
Version: 0.10.0
Summary: Totally typed, plausibly practical, and remarkably random utilities—for me, and maybe for you too.
Project-URL: Repository, https://github.com/Kajiih/kajihs-utils
Project-URL: Homepage, https://github.com/Kajiih/kajihs-utils
Project-URL: Issues, https://github.com/Kajiih/kajihs-utils/issues
Project-URL: Changelog, https://github.com/Kajiih/kajihs-utils/blob/main/CHANGELOG.md
Project-URL: Documentation, https://Kajiih.github.io/kajihs-utils/
Author-email: Julian Paquerot <itskajih@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: jax,loguru,matplotlib,numpy,pyplot,python,tools,utils,whenever
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.12
Provides-Extra: jax
Requires-Dist: jax>=0.4.36; extra == 'jax'
Provides-Extra: loguru
Requires-Dist: loguru>=0.7.3; extra == 'loguru'
Requires-Dist: rich>=13.9.4; extra == 'loguru'
Provides-Extra: numpy
Requires-Dist: numpy>=2.2.0; extra == 'numpy'
Provides-Extra: pyplot
Requires-Dist: matplotlib>=3.10.0; extra == 'pyplot'
Provides-Extra: whenever
Requires-Dist: whenever>=0.7.3; extra == 'whenever'
Description-Content-Type: text/markdown

<p align="center">
<a href="https://github.com/Kajiih/kajihs-utils">
    <img alt="Kajih's Utils" src="https://www.python.org/static/community_logos/python-logo-generic.svg"/>
</a>
</p>

<p align="center">
    <em>Totally typed, plausibly practical, and remarkably random utilities—for me, and maybe for you too.</em>
</p>
<!-- 4 to 5 badges max -->
<p align="center">
<a href="https://github.com/Kajiih/kajihs-utils/actions/workflows/ci.yaml" target="_blank">
    <img src="https://img.shields.io/github/actions/workflow/status/Kajiih/kajihs-utils/ci.yaml?branch=main&label=CI&logo=github&style=for-the-badge" alt="CI">
</a>
<a href="https://github.com/Kajiih/kajihs-utils/actions/workflows/publish.yaml" target="_blank">
    <img src="https://img.shields.io/github/actions/workflow/status/Kajiih/kajihs-utils/publish.yaml?branch=main&label=Publish&logo=github&style=for-the-badge" alt="Publish">
</a>
<a href="https://codecov.io/github/Kajiih/kajihs-utils" target="_blank">
    <img src="https://img.shields.io/codecov/c/github/Kajiih/kajihs-utils?logo=codecov&style=for-the-badge" alt="Coverage">
</a>
<a href="https://pypi.org/project/kajihs-utils" target="_blank">
    <img src="https://img.shields.io/pypi/v/kajihs-utils?logo=pypi&style=for-the-badge" alt="Package version">
</a>
<a href="https://pypi.org/project/kajihs-utils" target="_blank">
    <img src="https://img.shields.io/pypi/pyversions/kajihs-utils?logo=python&style=for-the-badge" alt="Supported Python versions">
</a>
</p>

---

**Documentation**: <https://Kajiih.github.io/kajihs-utils/>

**Source Code**: <https://github.com/Kajiih/kajihs-utils>

---

<!--
One paragraph describing the project:
- First, one or 2 sentences to describe the project (it's the first thing that
appears in a search engine below the link)
- Then, after a line break a description af the features explaining what it does etc

Example:
Kajih's Utils is a tool/app/library for ....

The key features are:

- ...
- ...
- ...

-->

# 🧰 Kajih's Utils <!-- You can add a punchline here -->

## ⬇️ Installation

We recommend you use [uv](https://docs.astral.sh/uv/) to install packages from PyPI:

```shell
uv add kajihs-utils
```

Then import the module in your code:

```python
import kajihs_utils
```

## 🧩 Example

Embed code like this:

```python:dev/readme_snippets/formatted/code_embedding_demo.py
```

Add a `# snippet: no-exec` comment to not execute the line when formatting the snippet prints
(useful for when a user input would be required).

❗**You have to manually add extras (any external package) used in snippet in the github workflow.
Check the [workflow file](/.github/workflows/code-embedder.yaml)**
