Metadata-Version: 2.4
Name: nanoacademic-atomistics-cli
Version: 0.0.1
Summary: Signpost: the real nanoacademic-atomistics-cli is published at https://pypi.nanoacademic.ca/simple/, not on public PyPI.
Maintainer-email: Nanoacademic Technologies <onoel@nanoacademic.com>
License-Expression: MIT
Project-URL: Homepage, https://nanoacademic.com
Project-URL: Package index, https://pypi.nanoacademic.ca/simple/
Keywords: nanoacademic,nanoacademic-atomistics-cli
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# nanoacademic-atomistics-cli

**This PyPI release is a signpost. The real `nanoacademic-atomistics-cli` is not distributed through
pypi.org.**

Nanoacademic publishes `nanoacademic-atomistics-cli` on its own package index. Install it with:

```bash
pip install --index-url https://pypi.nanoacademic.ca/simple/ --extra-index-url https://pypi.org/simple/ nanoacademic-atomistics-cli
```

Both indexes are required: `https://pypi.nanoacademic.ca/simple/` serves `nanoacademic-atomistics-cli`
itself, and `https://pypi.org/simple/` serves its open-source dependencies.

## What this package does

Importing it prints the message above to stderr, and the `nanoacademic-atomistics-cli` console script
does the same and exits non-zero -- so a build that picked up this release
instead of the real one fails loudly with an actionable message rather than
silently doing nothing.

```console
$ nanoacademic-atomistics-cli
nanoacademic-atomistics-cli on public PyPI is a signpost, not the real package.
...
```

## Why it exists

`pip install --index-url <private> --extra-index-url https://pypi.org/simple/` resolves
to the **highest** version found across *all* configured indexes. An unclaimed name on
public PyPI is therefore an open door: anyone could publish `nanoacademic-atomistics-cli` there at a high
version and have it installed in place of the real package. Holding the name at 0.0.1
closes that door, because the real release always compares higher.

- Homepage: <https://nanoacademic.com>
- Contact: <onoel@nanoacademic.com>
