Metadata-Version: 2.4
Name: scrambleeer
Version: 0.1.1
Summary: Shuffle a sequence of numbers, then swap the first and last values.
License-Expression: MIT
Keywords: shuffle,random,numbers
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# scrambleeer

`scrambleeer` is a tiny Python package that shuffles a sequence of numbers and
then swaps the first and last values. It returns a new list and does not modify
the input sequence.

## Installation

```bash
pip install scrambleeer
```

## Usage

```python
from scrambleeer import scrambleeer

numbers = [1, 2, 3, 4, 5]
scrambled = scrambleeer(numbers)

print(scrambled)
print(numbers)  # Still [1, 2, 3, 4, 5]
```

Empty and one-item sequences are supported:

```python
scrambleeer([])       # []
scrambleeer([10])     # [10]
```

## Development

Run the tests from the project root:

```bash
python -m unittest discover -s tests -v
```

Build the distributions:

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
```

Publish to TestPyPI first:

```bash
python -m twine upload --repository testpypi dist/*
```

When the TestPyPI package works as expected, publish it to PyPI:

```bash
python -m twine upload dist/*
```

The name `scrambleeer` must be available on PyPI before it can be registered by
the first upload. Update the version in `pyproject.toml` for every later release.

