jammy


Namejammy JSON
Version 0.1.46 PyPI version JSON
download
home_pageNone
SummaryA Versatile ToolBox
upload_time2025-01-28 09:17:42
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8.1
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1 align="center"> Jammy (Jam) </h1>

<p align="center">
  <a href="https://pypi.org/project/jammy/">
    <img src="https://img.shields.io/pypi/v/jammy?style=for-the-badge" alt="PyPI" />
  </a>
  <a href="#">
    <img src="https://img.shields.io/pypi/l/jammy?style=for-the-badge" alt="PyPI - License" />
  </a>
  <a href="https://github.com/qsh-zh/jam">
    <img src="https://img.shields.io/badge/-github-grey?style=for-the-badge&logo=github" alt="GitHub code" />
  </a>
  <a href="https://gitlab.com/qsh.zh/jam">
    <img src="https://img.shields.io/badge/-gitlab-grey?style=for-the-badge&logo=gitlab" alt="GitLab code" />
  </a>
  <a href="https://jammy.readthedocs.io/en/stable/index.html">
    <img src="https://img.shields.io/readthedocs/jammy?style=for-the-badge" alt="Read the Docs" />
  </a>
  <a href="#">
    <img src="https://img.shields.io/pypi/pyversions/jammy?style=for-the-badge" alt="PyPI - Python Version" />
  </a>
  <a href="https://github.com/psf/black">
    <img src="https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge" alt="Code style: black" />
  </a>
  <p align="center">
    <i>A personal toolbox by <a href="https://qsh-zh.github.io/">Qsh.zh</a>.</i>
  </p>
</p>

### Usage

#### setup

* For core package, run `pip install jammy`
* To access functions in `bin`
```shell
git clone https://gitlab.com/qsh.zh/jam.git --recursive
export PATH=<path_to_jam>/bin:$PATH
# run python program
jam-run main.py
jam-crun 1 main.py # use second nvidia gpu
```


#### sample of io
```python
import jammy.io as jio
from jamtorch.utils import as_numpy
jio.dump("ndarray.npz", np.arange(10))
jio.dump("foo.pkl", {"foo": as_numpy(torch.arange(10).cuda())})
ndarray = jio.load("ndarray.npz")
jio.load("foo.pkl")
model_dict = jio.load("checkpoint.pth")
```
```shell
$ jinspect-file foo.pkl
> python3
[ins] print(f1)
# content of foo.pkl

```

### Advanced Usage

* [A DDP pytorch training framework](https://jammy.readthedocs.io/en/stable/jamtorch.ddp.html)
* [Registry](https://jammy.readthedocs.io/en/stable/jammy.utils.html?highlight=registry#jammy.utils.registry.CallbackRegistry)
* TODO

### Etymology
* The naming is inspired from [Jyutping](https://en.wikipedia.org/wiki/Jyutping) of [Qin](https://en.wiktionary.org/wiki/%E6%AC%BD).

### MICS

* The package and framework are inspired from [Jacinle](https://github.com/vacancy/Jacinle) by [vacancy](https://github.com/vacancy), from which I learn and take utility functions shamelessly.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "jammy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8.1",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Qin <qsh.zh27@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/42/08/efeadb9bbb795ae7f85cc05569e06bb5de2b1c43d17265605352f9e5ca7c/jammy-0.1.46.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\"> Jammy (Jam) </h1>\n\n<p align=\"center\">\n  <a href=\"https://pypi.org/project/jammy/\">\n    <img src=\"https://img.shields.io/pypi/v/jammy?style=for-the-badge\" alt=\"PyPI\" />\n  </a>\n  <a href=\"#\">\n    <img src=\"https://img.shields.io/pypi/l/jammy?style=for-the-badge\" alt=\"PyPI - License\" />\n  </a>\n  <a href=\"https://github.com/qsh-zh/jam\">\n    <img src=\"https://img.shields.io/badge/-github-grey?style=for-the-badge&logo=github\" alt=\"GitHub code\" />\n  </a>\n  <a href=\"https://gitlab.com/qsh.zh/jam\">\n    <img src=\"https://img.shields.io/badge/-gitlab-grey?style=for-the-badge&logo=gitlab\" alt=\"GitLab code\" />\n  </a>\n  <a href=\"https://jammy.readthedocs.io/en/stable/index.html\">\n    <img src=\"https://img.shields.io/readthedocs/jammy?style=for-the-badge\" alt=\"Read the Docs\" />\n  </a>\n  <a href=\"#\">\n    <img src=\"https://img.shields.io/pypi/pyversions/jammy?style=for-the-badge\" alt=\"PyPI - Python Version\" />\n  </a>\n  <a href=\"https://github.com/psf/black\">\n    <img src=\"https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge\" alt=\"Code style: black\" />\n  </a>\n  <p align=\"center\">\n    <i>A personal toolbox by <a href=\"https://qsh-zh.github.io/\">Qsh.zh</a>.</i>\n  </p>\n</p>\n\n### Usage\n\n#### setup\n\n* For core package, run `pip install jammy`\n* To access functions in `bin`\n```shell\ngit clone https://gitlab.com/qsh.zh/jam.git --recursive\nexport PATH=<path_to_jam>/bin:$PATH\n# run python program\njam-run main.py\njam-crun 1 main.py # use second nvidia gpu\n```\n\n\n#### sample of io\n```python\nimport jammy.io as jio\nfrom jamtorch.utils import as_numpy\njio.dump(\"ndarray.npz\", np.arange(10))\njio.dump(\"foo.pkl\", {\"foo\": as_numpy(torch.arange(10).cuda())})\nndarray = jio.load(\"ndarray.npz\")\njio.load(\"foo.pkl\")\nmodel_dict = jio.load(\"checkpoint.pth\")\n```\n```shell\n$ jinspect-file foo.pkl\n> python3\n[ins] print(f1)\n# content of foo.pkl\n\n```\n\n### Advanced Usage\n\n* [A DDP pytorch training framework](https://jammy.readthedocs.io/en/stable/jamtorch.ddp.html)\n* [Registry](https://jammy.readthedocs.io/en/stable/jammy.utils.html?highlight=registry#jammy.utils.registry.CallbackRegistry)\n* TODO\n\n### Etymology\n* The naming is inspired from [Jyutping](https://en.wikipedia.org/wiki/Jyutping) of [Qin](https://en.wiktionary.org/wiki/%E6%AC%BD).\n\n### MICS\n\n* The package and framework are inspired from [Jacinle](https://github.com/vacancy/Jacinle) by [vacancy](https://github.com/vacancy), from which I learn and take utility functions shamelessly.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Versatile ToolBox",
    "version": "0.1.46",
    "project_urls": {
        "Documentation": "https://jammy.readthedocs.io/en/latest/"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "fca506a2b0f879cb296c3893b7a21b9317659b54510c4b1ed1eec36e078bd132",
                "md5": "266933c83f9913f9eade617d5db0b7fb",
                "sha256": "c40e317a4c11065fd172671609baf0e54a97f817b3aec33a15abb9b1a5fec66f"
            },
            "downloads": -1,
            "filename": "jammy-0.1.46-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "266933c83f9913f9eade617d5db0b7fb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8.1",
            "size": 224509,
            "upload_time": "2025-01-28T09:17:40",
            "upload_time_iso_8601": "2025-01-28T09:17:40.926862Z",
            "url": "https://files.pythonhosted.org/packages/fc/a5/06a2b0f879cb296c3893b7a21b9317659b54510c4b1ed1eec36e078bd132/jammy-0.1.46-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4208efeadb9bbb795ae7f85cc05569e06bb5de2b1c43d17265605352f9e5ca7c",
                "md5": "38fa74702909ae13b147df859f69018f",
                "sha256": "418d5f22179e766c90ae68dc94ca47581ca28bb3aaa0859a721edaf02f57eb18"
            },
            "downloads": -1,
            "filename": "jammy-0.1.46.tar.gz",
            "has_sig": false,
            "md5_digest": "38fa74702909ae13b147df859f69018f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8.1",
            "size": 457544,
            "upload_time": "2025-01-28T09:17:42",
            "upload_time_iso_8601": "2025-01-28T09:17:42.849520Z",
            "url": "https://files.pythonhosted.org/packages/42/08/efeadb9bbb795ae7f85cc05569e06bb5de2b1c43d17265605352f9e5ca7c/jammy-0.1.46.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-01-28 09:17:42",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "jammy"
}
        
Elapsed time: 0.47732s