hyjinx


Namehyjinx JSON
Version 1.0.7 PyPI version JSON
download
home_pageNone
SummaryA minimal Hy utility library, using mostly the standard libraries.
upload_time2024-11-09 21:14:28
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT License Copyright (c) 2024 the authors. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords hy hylang utilities zeromq llm openai anthropic
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## 🦑 Hyjinx

*Functions and macros useful for modern living in the [Hy](http://hylang.org) REPL.*

Compatible with Hy 0.29.0.


### Hylights

- A Hy code beautifier and in-REPL syntax highlighting
- An `inspect` module that works like Python's, but also for Hy code
- Pretty tracebacks with correct syntax highlighting for hy or python
- Print/get/edit source code of a function, module etc. (e.g. `(print-source hyjinx.lib.sieve)`
- A sensible, lispy `defmethod`
- In-repl code analysis and discussion using LLMs (e.g. for writing docstrings)
- In-repl syntax highlighting and latex rendering (for [sixel-capable terminals](https://www.arewesixelyet.com)) for LLM replies
- Numpy array pretty printing
- A zmq lazy pirate protocol
- A minimal ncurses class


### Modules

- hyjinx.lib: a smorgasbord of convenience functions.
- hyjinx.source: live code inspection.
- hyjinx.inspect: code inspection.
- hyjinx.doc: peruse hy documentation.
- hyjinx.screen: a convenient ncurses wrapper.

- hyjinx.mat: numpy pretty-printing for humans. (requires numpy, jax optional)

- hyjinx.[zmq_client, zmq_server, crypto, wire]: lazy-pirate zmq RPC architecture. (requires zmq, ecdsa, zstandard, msgpack)

- hyjinx.llm: discuss code with a Large Language Model (AI). TabbyAPI, OpenAI-compatible and Claude are supported. (requires `openai` and `anthropic` packages.)


### Install

```bash
$ pip install -U hyjinx
```

or, with optional dependencies,
```bash
$ pip install -U hyjinx[zmq]
$ pip install -U hyjinx[llm]
```

To install offline hy/hyrule documentation,
```bash
$ hy -m hyjinx.docs
```

For syntax highlighting in the REPL, put 
```hylang
(import hyjinx.source [hylight]) (setv repl-output-fn hylight)
```
in your .hyrc.

See hyjinx.hyrc for example usage.

For in-terminal sixel rendering of latex in LLM replies, make sure pdflatex, dvipng and img2sixel are installed, and that you're using a sixel-capable terminal.


### Optional dependencies

You can install with the `[zmq]` option which also installs ecdsa, [pyzmq](https://pypi.org/project/pyzmq/) and [zstandard](https://pypi.org/project/zstandard/) for the zmq server/client

You can install with the `[llm]` option which also installs openai and lets you discuss code objects with ChatGPT or a locally-served LLM (via TabbyAPI or similar).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hyjinx",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "hy, hylang, utilities, zeromq, llm, openai, anthropic",
    "author": null,
    "author_email": "Ati Sharma <ati+hyjinx@agalmic.ltd>",
    "download_url": "https://files.pythonhosted.org/packages/6f/fa/7da0607a265647970a133a871571c8e5d829053e3d7e149988b452cbee56/hyjinx-1.0.7.tar.gz",
    "platform": null,
    "description": "## \ud83e\udd91 Hyjinx\n\n*Functions and macros useful for modern living in the [Hy](http://hylang.org) REPL.*\n\nCompatible with Hy 0.29.0.\n\n\n### Hylights\n\n- A Hy code beautifier and in-REPL syntax highlighting\n- An `inspect` module that works like Python's, but also for Hy code\n- Pretty tracebacks with correct syntax highlighting for hy or python\n- Print/get/edit source code of a function, module etc. (e.g. `(print-source hyjinx.lib.sieve)`\n- A sensible, lispy `defmethod`\n- In-repl code analysis and discussion using LLMs (e.g. for writing docstrings)\n- In-repl syntax highlighting and latex rendering (for [sixel-capable terminals](https://www.arewesixelyet.com)) for LLM replies\n- Numpy array pretty printing\n- A zmq lazy pirate protocol\n- A minimal ncurses class\n\n\n### Modules\n\n- hyjinx.lib: a smorgasbord of convenience functions.\n- hyjinx.source: live code inspection.\n- hyjinx.inspect: code inspection.\n- hyjinx.doc: peruse hy documentation.\n- hyjinx.screen: a convenient ncurses wrapper.\n\n- hyjinx.mat: numpy pretty-printing for humans. (requires numpy, jax optional)\n\n- hyjinx.[zmq_client, zmq_server, crypto, wire]: lazy-pirate zmq RPC architecture. (requires zmq, ecdsa, zstandard, msgpack)\n\n- hyjinx.llm: discuss code with a Large Language Model (AI). TabbyAPI, OpenAI-compatible and Claude are supported. (requires `openai` and `anthropic` packages.)\n\n\n### Install\n\n```bash\n$ pip install -U hyjinx\n```\n\nor, with optional dependencies,\n```bash\n$ pip install -U hyjinx[zmq]\n$ pip install -U hyjinx[llm]\n```\n\nTo install offline hy/hyrule documentation,\n```bash\n$ hy -m hyjinx.docs\n```\n\nFor syntax highlighting in the REPL, put \n```hylang\n(import hyjinx.source [hylight]) (setv repl-output-fn hylight)\n```\nin your .hyrc.\n\nSee hyjinx.hyrc for example usage.\n\nFor in-terminal sixel rendering of latex in LLM replies, make sure pdflatex, dvipng and img2sixel are installed, and that you're using a sixel-capable terminal.\n\n\n### Optional dependencies\n\nYou can install with the `[zmq]` option which also installs ecdsa, [pyzmq](https://pypi.org/project/pyzmq/) and [zstandard](https://pypi.org/project/zstandard/) for the zmq server/client\n\nYou can install with the `[llm]` option which also installs openai and lets you discuss code objects with ChatGPT or a locally-served LLM (via TabbyAPI or similar).\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2024 the authors.  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "A minimal Hy utility library, using mostly the standard libraries.",
    "version": "1.0.7",
    "project_urls": {
        "Repository": "https://github.com/atisharma/hyjinx"
    },
    "split_keywords": [
        "hy",
        " hylang",
        " utilities",
        " zeromq",
        " llm",
        " openai",
        " anthropic"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "22d22821583862bc670cb5eda7beebfe54460c463d2b55d51dfe8cb15d1cf6bb",
                "md5": "3e917496b3ffb1acf63f388b75cce5ca",
                "sha256": "ddbb6aeb5fe3458136bf4fc535c8626fefd6161f0b9f3ae1513af2ad36fb9ad3"
            },
            "downloads": -1,
            "filename": "hyjinx-1.0.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3e917496b3ffb1acf63f388b75cce5ca",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 47487,
            "upload_time": "2024-11-09T21:14:27",
            "upload_time_iso_8601": "2024-11-09T21:14:27.541119Z",
            "url": "https://files.pythonhosted.org/packages/22/d2/2821583862bc670cb5eda7beebfe54460c463d2b55d51dfe8cb15d1cf6bb/hyjinx-1.0.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6ffa7da0607a265647970a133a871571c8e5d829053e3d7e149988b452cbee56",
                "md5": "fc9809d5015bcd865443a3c6fdcd7bfb",
                "sha256": "d3c8bc4e1a815edb8381562753c40132758593ab3347fa75ca0ea1b4d27282c3"
            },
            "downloads": -1,
            "filename": "hyjinx-1.0.7.tar.gz",
            "has_sig": false,
            "md5_digest": "fc9809d5015bcd865443a3c6fdcd7bfb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 44544,
            "upload_time": "2024-11-09T21:14:28",
            "upload_time_iso_8601": "2024-11-09T21:14:28.882170Z",
            "url": "https://files.pythonhosted.org/packages/6f/fa/7da0607a265647970a133a871571c8e5d829053e3d7e149988b452cbee56/hyjinx-1.0.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-09 21:14:28",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "atisharma",
    "github_project": "hyjinx",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "hyjinx"
}
        
Elapsed time: 1.08284s