https://github.com/openscilab/reserver
Got a notion? Before it's taken, immediately reserve the product name in PyPi (pip)!
https://github.com/openscilab/reserver
pypi pypi-package python reserve reserver
Last synced: about 1 month ago
JSON representation
Got a notion? Before it's taken, immediately reserve the product name in PyPi (pip)!
- Host: GitHub
- URL: https://github.com/openscilab/reserver
- Owner: openscilab
- License: mit
- Created: 2024-01-13T07:21:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-01T19:06:28.000Z (about 2 months ago)
- Last Synced: 2025-04-13T15:12:48.983Z (about 1 month ago)
- Topics: pypi, pypi-package, python, reserve, reserver
- Language: Python
- Homepage:
- Size: 236 KB
- Stars: 24
- Watchers: 0
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Authors: AUTHORS.md
Awesome Lists containing this project
README
----------
## Disclaimer
**⚠️ Warning ⚠️**
The intention of this package is facilitating the reservation of package names on PyPI for legitimate and appropriate purposes. We explicitly disclaim any responsibility for the misuse or spamming of this tool, particularly in the excessive reservation of package names. Users are advised to be cautious and ensure the legitimate use of this package to avoid potential consequences such as the suspension of their PyPI account. By using this package, users acknowledge and agree to these terms.
## Overview
Reserver is an open source Python package that offers the ability to quickly reserve a PyPI package name. Got a notion? Before it's taken, immediately reserve the product name!
PyPI Counter
Github Stars
Branch
main
dev
CI
## Installation
### PyPI
- Check [Python Packaging User Guide](https://packaging.python.org/installing/)
- Run `pip install reserver==0.4`
### Source code
- Download [Version 0.4](https://github.com/openscilab/reserver/archive/v0.4.zip) or [Latest Source](https://github.com/openscilab/reserver/archive/dev.zip)
- Run `pip install .`
## Usage
### Programmatically
Reserve a package name in main PyPI (pypi.org)
```python
from reserver import PyPIUploader
uploader = PyPIUploader(PYPI_TOKEN, test_pypi=False)
uploader.upload("CONSIDERED_NAME_FOR_YOUR_PACKAGE")
```
Reserve batch of names with custom user-defined parameters in test PyPI (test.pypi.org)
```python
uploader = PyPIUploader(TEST_PYPI_TOKEN, test_pypi=True)
uploader.batch_upload(["PACKAGE_NAME_1", "PACKAGE_NAME_2"], ["config1.json", "config2.json"])
```
### CLI
ℹ️ You can use `reserver` or `python -m reserver` to run this program
#### Version
```console
reserver -v
reserver --version
```
#### Reserve in test PyPI (test.pypi.org)
```console
reserver --name sample_name1 sample_name2 --token=TEST_PYPI_TOKEN --test
```
#### Reserve in main PyPI (pypi.org)
```console
reserver --name sample_name1 sample_name2 --token=PYPI_TOKEN
```
#### Customizing package parameters
You can customize the following package parameters for reservations on PyPI using the Reserver CLI. The details and defaults are provided in the table below.
| Parameter | Type | Default | Description |
|---|---|---|---|
| `description` | string | `This name has been reserved using Reserver` | A short description of your PyPI package name reservation. |
| `author` | string | `Development Team` | The name of the author or development team. |
| `author_email` | email address | `[email protected]` | An email address for contact. |
| `url` | web address | `https://url.com` | The project's main repository URL. |
| `download_url` | web address | `https://download_url.com` | The download URL for the package. |
| `source` | web address | `https://github.com/source` | The source code repository URL. |
| `license` | string | `MIT` | The license under which your package is distributed. |
There are two ways to define these custom parameters:
**1. Single `param.json` for all packages:**
This approach uses a single JSON file (`param.json`) to define common parameters for all packages. This file could hold information like those described in the table.
Here's how to use this method:
```console
reserver --name sample_name1 sample_name2 --param config.json --token=PYPI_TOKEN
```
**2. Dedicated `param.json` per package:**
This approach allows for more customization by having a separate JSON file for each package. Each file would contain parameters specific to that particular package.
Here's how this method works:
```console
reserver --name sample_name1 sample_name2 --param name1_param.json name2_param.json --token=PYPI_TOKEN
```
Choose the method that best suits your needs. Using a single `param.json` is efficient for packages with similar information, while separate files offer more granular control.
ℹ️ You can use all available features on both `pypi.org` and `test.pypi.org`.
## Issues & bug reports
Just fill an issue and describe it. We'll check it ASAP! or send an email to [[email protected]](mailto:[email protected] "[email protected]").
- Please complete the issue template
You can also join our discord server
## Show your support
### Star this repo
Give a ⭐️ if this project helped you!
### Donate to our project
If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .
