nscout 0.1.1

A lightweight CLI tool to check whether a package name is taken on PyPI and TestPyPI.

nscout

A small command-line tool for checking whether a package name is already taken on PyPI and TestPyPI. It queries PyPI’s public JSON endpoints and reports the results in a simple, readable format.

---

Features

• Checks availability on both PyPI and TestPyPI
• No special exit codes — clear human-readable output only
• Minimal dependencies, very fast
• Works on Python 3.10+

---

Installation

From PyPI (after publishing):

pip install nscout

For local development:

pip install -e .

---

Usage

Run:

nscout <package-name>

Example:

nscout requests

Output:

PyPi : taken
TestPyPi : not taken

The tool always prints exactly these two lines — no exit-code text.

---

Why this tool exists

PyPI doesn’t have a dedicated “is this name available?” endpoint. This tool performs a lightweight check against PyPI’s JSON metadata URLs:

• If the endpoint returns 404, the name is not taken
• Any other response means the name exists or the server is unreachable

This makes the tool quick, reliable, and easy to use during package creation.

---

Development

Run directly from source:

python -m nscout <package-name>

Project layout:

nscout/
├── nscout/
│   ├── __init__.py
│   ├── cli.py          # command-line interface
│   └── checker.py      # availability logic
├── pyproject.toml
├── README.md
└── LICENSE

---