Metadata-Version: 2.4
Name: offside
Version: 0.1.0
Summary: A minimal demonstration of import-time exception behavior
Author: offside contributors
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# offside

`offside` is a minimal Python package demonstrating import-time exception behavior.

## Behavior

Importing the package intentionally raises a `RuntimeError`:

```python
import offside
```

The error occurs because Python executes `offside/__init__.py` while initializing the package during import. The top-level `raise RuntimeError(...)` statement therefore runs automatically; no function or class call is needed.

## Install

After the package has been published to PyPI:

```console
python -m pip install offside
```

The installation succeeds, but importing the package intentionally fails with the predefined `RuntimeError`.

## Build and publish

From the project root, install the packaging tools, build the source and wheel distributions, and upload them to PyPI:

```console
python -m pip install --upgrade build twine
python -m build
python -m twine upload dist/*
```

Then install the published release with:

```console
python -m pip install offside
```

Publishing requires a configured PyPI account and credentials for `twine`.
