An open API service indexing awesome lists of open source software.

https://github.com/sermetpekin/nameisok

nameisok is a Python package that checks the availability of package names on PyPI. This tool is especially useful for developers looking to publish new packages and wanting to ensure their desired name is unique.
https://github.com/sermetpekin/nameisok

availability available-on-pypi naming pypi pypi-package utility utils

Last synced: 5 months ago
JSON representation

nameisok is a Python package that checks the availability of package names on PyPI. This tool is especially useful for developers looking to publish new packages and wanting to ensure their desired name is unique.

Awesome Lists containing this project

README

          

[![Python Package](https://github.com/SermetPekin/nameisok/actions/workflows/python-package.yml/badge.svg?2)](https://github.com/SermetPekin/nameisok/actions/workflows/python-package.yml)
[![PyPI](https://img.shields.io/pypi/v/nameisok)](https://img.shields.io/pypi/v/nameisok)
![t](https://img.shields.io/badge/status-maintained-yellow.svg) [![](https://img.shields.io/github/license/SermetPekin/nameisok.svg)](https://github.com/SermetPekin/nameisok/blob/master/LICENSE.md) ![](https://img.shields.io/badge/python-3.10+-blue.svg)
[![Downloads](https://static.pepy.tech/badge/evdschat)](https://pepy.tech/project/evdschat) [![Downloads](https://static.pepy.tech/badge/nameisok/month)](https://pepy.tech/project/nameisok) [![Downloads](https://pepy.tech/badge/nameisok/week)](https://pepy.tech/project/nameisok)

nameisok is a Python package that helps developers check the availability of package names on PyPI, taking it one step further with enhanced functionality. This tool is perfect for anyone looking to publish new packages and wanting to avoid name conflicts or similar names that could cause confusion.

### Key Features

- PyPI Availability Check: Quickly checks PyPI to see if a package name is available for registration.
- BigQuery Database Check: Uses the PyPI dataset on Google BigQuery for additional verification of package name availability.
- Similarity Check: Detects names that are too similar to existing packages, based on a customizable similarity threshold, preventing potential naming conflicts.

### Installation

To install nameisok, simply run:

```bash
pip install nameisok
```

### Usage

Check Multiple Names
```bash
nameisok example,my_package,nameisok

```
Output

```plaintext
❌ `example` is already taken.
🎉 Wow! `my_package` is available!
❌ `nameisok` is already taken.

```

### Check a Single Name

You can also check just one name at a time:

```bash
nameisok pandas
```

```plaintext
❌ `pandas` is already taken.

```

```bash
nameisok darling
```
```plaintext
. 🎉 Wow! `darling` is available!
```

### Similarity Warnings

When a name is not only taken but also too similar to existing packages, you'll see a warning:

```bash
nameisok numpyyy
```

```plaintext
⚠️ `numpyyy` is very similar to `numpy`, `numpy-extensions`
❌ `numpyyy` is too similar to an existing package.
```