Metadata-Version: 2.4
Name: pyjinx-installer
Version: 0.1.5
Summary: PyJinx project creator
Requires-Python: <4.0,>=3.10
Description-Content-Type: text/markdown

# PyJinx Installer

> **Temporary project names:** this installer package uses the PyJinx name.
> The global project creator is **`pyjinx`**. Generated projects use the
> project-local framework executable **`loom`**, for both PyJinx and Veyra.

The global installer creates a new application from the private
[`pyjinx/starter`](https://github.com/pyjinx/starter) repository. It removes the
starter's development checkout and local framework copy, then leaves the
application configured to install the `pyjinx` framework distribution from
PyPI.

## Installation

Install from a checked-out copy with uv:

```console
uv tool install .
```

For local development, run the package through the checked-out project:

```console
uv run pyjinx --help
```

## Create an application

```console
pyjinx new hello-world
cd hello-world
uv sync
```

The command refuses to populate a non-empty destination. Project names must be
one safe directory name made from letters, numbers, `-`, and `_`, beginning with
a letter.

For local starter development or tests, pass a directory explicitly:

```console
pyjinx new hello-world --starter-path /path/to/starter
```

The `PYJINX_STARTER_REPOSITORY` environment variable can select a starter
repository or local directory. If `--starter-path` is omitted and the current
directory contains a starter checkout (`app/` and `bootstrap/`), that directory
is used. Otherwise the private `pyjinx/starter` repository is cloned.
