Metadata-Version: 2.4
Name: pykernel-cli
Version: 1.2.0
Summary: A hackable Python REPL with first-class command support
Author-email: zKaiden <odrekzinho@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/odrekzinho-art/pykernel
Project-URL: Repository, https://github.com/odrekzinho-art/pykernel
Project-URL: Bug Tracker, https://github.com/odrekzinho-art/pykernel/issues
Keywords: repl,shell,interactive,python
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Interpreters
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# PyKernel

A hackable Python REPL with first-class command support.

## Install

```bash
pip install pykernel
```

## Usage

```bash
pykernel
# or
python -m pykernel
```

Type `/help` to see all commands.

## Commands

| Command | Description |
|---|---|
| `/help` | List all commands |
| `/vars` | List variables in the namespace |
| `/run <file>` | Execute a Python file |
| `/sh <cmd>` | Run a shell command |
| `/snip` | Manage code snippets |
| `/timeit <expr>` | Time an expression |

## Plugins

Drop a `.py` file with a `register(registry)` function into `~/.pykernel/plugins/`:

```python
def register(reg):
    @reg.command("hello", help="Say hello")
    def cmd_hello(ctx, *args):
        ctx.print("Hello!")
```

## Config

Edit `~/.pykernel/config.toml`:

```toml
[kernel]
prompt = ">>> "
theme  = "dark"   # dark | light | none
```
