<div align="center">
<img src="https://github.com/openscilab/reserver/raw/main/otherfiles/reserver.png" width="300" height="300">
<br/>
<br/>
<a href="https://codecov.io/gh/openscilab/reserver"><img src="https://codecov.io/gh/openscilab/reserver/branch/main/graph/badge.svg" alt="Codecov"/></a>
<a href="https://badge.fury.io/py/reserver"><img src="https://badge.fury.io/py/reserver.svg" alt="PyPI version" height="18"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
<a href="https://discord.gg/RD2y6SGuY3"><img src="https://img.shields.io/discord/1064533716615049236.svg" alt="Discord Channel"></a>
</div>
----------
## Disclaimer
**⚠️ Warning ⚠️**
<p align="justify">
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.
</p>
## Overview
<p align="justify">
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!
</p>
<table>
<tr>
<td align="center">PyPI Counter</td>
<td align="center">
<a href="http://pepy.tech/project/reserver">
<img src="http://pepy.tech/badge/reserver">
</a>
</td>
</tr>
<tr>
<td align="center">Github Stars</td>
<td align="center">
<a href="https://github.com/openscilab/reserver">
<img src="https://img.shields.io/github/stars/openscilab/reserver.svg?style=social&label=Stars">
</a>
</td>
</tr>
</table>
<table>
<tr>
<td align="center">Branch</td>
<td align="center">main</td>
<td align="center">dev</td>
</tr>
<tr>
<td align="center">CI</td>
<td align="center">
<img src="https://github.com/openscilab/reserver/actions/workflows/test.yml/badge.svg?branch=main">
</td>
<td align="center">
<img src="https://github.com/openscilab/reserver/actions/workflows/test.yml/badge.svg?branch=dev">
</td>
</tr>
</table>
## Installation
### PyPI
- Check [Python Packaging User Guide](https://packaging.python.org/installing/)
- Run `pip install reserver==0.3`
### Source code
- Download [Version 0.3](https://github.com/openscilab/reserver/archive/v0.3.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 | `test@test.com` | 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 [reserver@openscilab.com](mailto:reserver@openscilab.com "reserver@openscilab.com").
- Please complete the issue template
You can also join our discord server
<a href="https://discord.gg/RD2y6SGuY3"><img src="https://img.shields.io/discord/1064533716615049236.svg?style=for-the-badge" alt="Discord Channel"></a>
## 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 ;-) .
<a href="https://openscilab.com/#donation" target="_blank"><img src="https://github.com/openscilab/reserver/raw/main/otherfiles/donation.png" height="90px" width="270px" alt="Reserver Donation"></a>
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Added
### Changed
## [0.3] - 2024-08-28
### Added
- CLI tests added
- `param` arg in CLI Handler
- more testcases in conflict cases
- `batch_upload` tests
- `read_json` method in `util.py`
### Changed
- `README.md` updated
- `upload` method in `reserver_obj.py`
- `batch_upload` method `reserver_obj.py`
## [0.2] - 2024-06-17
### Added
- `CLI` handler
- `Python 3.6` support
- `has_named_parameter` method in `util.py`
- `feature_request.yml` template
- `config.yml` for issue template
- `batch_upload` method in `PyPIUploader`
- `SECURITY.md`
### Changed
- `upload` method in `reserver_obj.py`
- `does_package_exist` method in `reserver_func.py`
- `test.yml` for `Python 3.6` support
- Logo updated
- Bug report template modified
- `Uploader` changed to `PyPIUploader`
- `README.md` modified
## [0.1] - 2024-02-07
### Added
- `Uploader` class
- Check package name existence
- Upload template package to test PyPI
- Upload template package to PyPI
- Generate template package for a given name
- Handle similar name existence in PyPI
- Handle issue with "-" character `.egginfo` file name
[Unreleased]: https://github.com/openscilab/reserver/compare/v0.3...dev
[0.3]: https://github.com/openscilab/reserver/compare/v0.2...v0.3
[0.2]: https://github.com/openscilab/reserver/compare/v0.1...v0.2
[0.1]: https://github.com/openscilab/reserver/compare/0ae5bb9...v0.1
Raw data
{
"_id": null,
"home_page": "https://github.com/openscilab/reserver",
"name": "reserver",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "python3 python PyPI pip package name reservation",
"author": "Reserver Development Team",
"author_email": "reserver@openscilab.com",
"download_url": "https://files.pythonhosted.org/packages/b6/24/101aa46a690d2d90b9216fa75f8ab3255cc9e289a62e641db362f0adb05f/reserver-0.3.tar.gz",
"platform": null,
"description": "\n<div align=\"center\">\n <img src=\"https://github.com/openscilab/reserver/raw/main/otherfiles/reserver.png\" width=\"300\" height=\"300\">\n <br/>\n <br/>\n <a href=\"https://codecov.io/gh/openscilab/reserver\"><img src=\"https://codecov.io/gh/openscilab/reserver/branch/main/graph/badge.svg\" alt=\"Codecov\"/></a>\n <a href=\"https://badge.fury.io/py/reserver\"><img src=\"https://badge.fury.io/py/reserver.svg\" alt=\"PyPI version\" height=\"18\"></a>\n <a href=\"https://www.python.org/\"><img src=\"https://img.shields.io/badge/built%20with-Python3-green.svg\" alt=\"built with Python3\"></a>\n <a href=\"https://discord.gg/RD2y6SGuY3\"><img src=\"https://img.shields.io/discord/1064533716615049236.svg\" alt=\"Discord Channel\"></a>\n</div>\n\n----------\n\n## Disclaimer \n**\u26a0\ufe0f Warning \u26a0\ufe0f**\n\n<p align=\"justify\">\n\nThe 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.\n</p>\n\n## Overview\n<p align=\"justify\">\nReserver is an open source Python package that offers\u00a0the\u00a0ability\u00a0to\u00a0quickly\u00a0reserve\u00a0a\u00a0PyPI\u00a0package\u00a0name. Got\u00a0a\u00a0notion? Before\u00a0it's\u00a0taken,\u00a0immediately\u00a0reserve\u00a0the\u00a0product\u00a0name!\n</p>\n<table>\n <tr>\n <td align=\"center\">PyPI Counter</td>\n <td align=\"center\">\n <a href=\"http://pepy.tech/project/reserver\">\n <img src=\"http://pepy.tech/badge/reserver\">\n </a>\n </td>\n </tr>\n <tr>\n <td align=\"center\">Github Stars</td>\n <td align=\"center\">\n <a href=\"https://github.com/openscilab/reserver\">\n <img src=\"https://img.shields.io/github/stars/openscilab/reserver.svg?style=social&label=Stars\">\n </a>\n </td>\n </tr>\n</table>\n<table>\n <tr> \n <td align=\"center\">Branch</td>\n <td align=\"center\">main</td>\n <td align=\"center\">dev</td>\n </tr>\n <tr>\n <td align=\"center\">CI</td>\n <td align=\"center\">\n <img src=\"https://github.com/openscilab/reserver/actions/workflows/test.yml/badge.svg?branch=main\">\n </td>\n <td align=\"center\">\n <img src=\"https://github.com/openscilab/reserver/actions/workflows/test.yml/badge.svg?branch=dev\">\n </td>\n </tr>\n</table>\n\n\n## Installation\n\n### PyPI\n\n- Check [Python Packaging User Guide](https://packaging.python.org/installing/)\n- Run `pip install reserver==0.3`\n### Source code\n- Download [Version 0.3](https://github.com/openscilab/reserver/archive/v0.3.zip) or [Latest Source](https://github.com/openscilab/reserver/archive/dev.zip)\n- Run `pip install .`\n\n## Usage\n\n### Programmatically \nReserve a package name in main PyPI (pypi.org)\n```python\nfrom reserver import PyPIUploader\nuploader = PyPIUploader(PYPI_TOKEN, test_pypi=False)\nuploader.upload(\"CONSIDERED_NAME_FOR_YOUR_PACKAGE\")\n```\nReserve batch of names with custom user-defined parameters in test PyPI (test.pypi.org)\n```python\nuploader = PyPIUploader(TEST_PYPI_TOKEN, test_pypi=True)\nuploader.batch_upload([\"PACKAGE_NAME_1\", \"PACKAGE_NAME_2\"], [\"config1.json\", \"config2.json\"])\n```\n### CLI\n\u26a0\ufe0f You can use `reserver` or `python -m reserver` to run this program\n#### Version\n```console\nreserver -v\nreserver --version\n```\n#### Reserve in test PyPI (test.pypi.org)\n```console\nreserver --name sample_name1 sample_name2 --token=TEST_PYPI_TOKEN --test\n```\n#### Reserve in main PyPI (pypi.org)\n```console\nreserver --name sample_name1 sample_name2 --token=PYPI_TOKEN\n```\n#### Customizing package parameters\n\nYou can customize the following package parameters for reservations on PyPI using the Reserver CLI. The details and defaults are provided in the table below.\n\n| Parameter | Type | Default | Description |\n|---|---|---|---|\n| `description` | string | `This name has been reserved using Reserver` | A short description of your PyPI package name reservation. |\n| `author` | string | `Development Team` | The name of the author or development team. |\n| `author_email` | email address | `test@test.com` | An email address for contact. |\n| `url` | web address | `https://url.com` | The project's main repository URL. |\n| `download_url` | web address | `https://download_url.com` | The download URL for the package. |\n| `source` | web address | `https://github.com/source` | The source code repository URL. |\n| `license` | string | `MIT` | The license under which your package is distributed. |\n\nThere are two ways to define these custom parameters:\n\n**1. Single `param.json` for all packages:**\n\nThis 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.\n\nHere's how to use this method:\n\n```console\nreserver --name sample_name1 sample_name2 --param config.json --token=PYPI_TOKEN\n```\n**2. Dedicated `param.json` per package:**\n\nThis approach allows for more customization by having a separate JSON file for each package. Each file would contain parameters specific to that particular package.\n\nHere's how this method works:\n\n```console\nreserver --name sample_name1 sample_name2 --param name1_param.json name2_param.json --token=PYPI_TOKEN\n```\n\nChoose 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.\n\n\u26a0\ufe0f You can use all available features on both `pypi.org` and `test.pypi.org`.\n## Issues & bug reports\n\nJust fill an issue and describe it. We'll check it ASAP! or send an email to [reserver@openscilab.com](mailto:reserver@openscilab.com \"reserver@openscilab.com\"). \n\n- Please complete the issue template\n \nYou can also join our discord server\n\n<a href=\"https://discord.gg/RD2y6SGuY3\"><img src=\"https://img.shields.io/discord/1064533716615049236.svg?style=for-the-badge\" alt=\"Discord Channel\"></a>\n\n## Show your support\n\n### Star this repo\nGive a \u2b50\ufe0f if this project helped you!\n\n### Donate to our project\nIf 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 ;-) .\t\t\t\n\n<a href=\"https://openscilab.com/#donation\" target=\"_blank\"><img src=\"https://github.com/openscilab/reserver/raw/main/otherfiles/donation.png\" height=\"90px\" width=\"270px\" alt=\"Reserver Donation\"></a>\n\n# Changelog\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)\nand this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n### Added\n### Changed\n## [0.3] - 2024-08-28\n### Added\n- CLI tests added\n- `param` arg in CLI Handler\n- more testcases in conflict cases\n- `batch_upload` tests\n- `read_json` method in `util.py`\n### Changed\n- `README.md` updated\n- `upload` method in `reserver_obj.py`\n- `batch_upload` method `reserver_obj.py`\n## [0.2] - 2024-06-17\n### Added\n- `CLI` handler\n- `Python 3.6` support\n- `has_named_parameter` method in `util.py`\n- `feature_request.yml` template\n- `config.yml` for issue template\n- `batch_upload` method in `PyPIUploader`\n- `SECURITY.md`\n### Changed\n- `upload` method in `reserver_obj.py`\n- `does_package_exist` method in `reserver_func.py`\n- `test.yml` for `Python 3.6` support\n- Logo updated\n- Bug report template modified\n- `Uploader` changed to `PyPIUploader`\n- `README.md` modified\n## [0.1] - 2024-02-07\n### Added\n- `Uploader` class\n- Check package name existence\n- Upload template package to test PyPI\n- Upload template package to PyPI\n- Generate template package for a given name\n- Handle similar name existence in PyPI\n- Handle issue with \"-\" character `.egginfo` file name\n\n[Unreleased]: https://github.com/openscilab/reserver/compare/v0.3...dev\n[0.3]: https://github.com/openscilab/reserver/compare/v0.2...v0.3\n[0.2]: https://github.com/openscilab/reserver/compare/v0.1...v0.2\n[0.1]: https://github.com/openscilab/reserver/compare/0ae5bb9...v0.1\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "PyPI package name reserver",
"version": "0.3",
"project_urls": {
"Download": "https://github.com/openscilab/reserver/tarball/v0.3",
"Homepage": "https://github.com/openscilab/reserver",
"Source": "https://github.com/openscilab/reserver"
},
"split_keywords": [
"python3",
"python",
"pypi",
"pip",
"package",
"name",
"reservation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a322fcd697b3bafb4fc27cd9bf0b3161366f146b55db9f7010125a0d5e496902",
"md5": "b6d542fc40bcd79d1b551cc4490b52f5",
"sha256": "9343b5a13353c53b73dcfba799bdfffcd25fadde9d9fb48e3da1c870cd993a84"
},
"downloads": -1,
"filename": "reserver-0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b6d542fc40bcd79d1b551cc4490b52f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 12713,
"upload_time": "2024-08-28T15:54:21",
"upload_time_iso_8601": "2024-08-28T15:54:21.937333Z",
"url": "https://files.pythonhosted.org/packages/a3/22/fcd697b3bafb4fc27cd9bf0b3161366f146b55db9f7010125a0d5e496902/reserver-0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b624101aa46a690d2d90b9216fa75f8ab3255cc9e289a62e641db362f0adb05f",
"md5": "f1cf21ff0fed1dea582ecea4e4876c6d",
"sha256": "53ae9f7e513b55f2047171887780bc3ce116fc2d4416b4a1d7452e76329e8c6b"
},
"downloads": -1,
"filename": "reserver-0.3.tar.gz",
"has_sig": false,
"md5_digest": "f1cf21ff0fed1dea582ecea4e4876c6d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 14245,
"upload_time": "2024-08-28T15:54:20",
"upload_time_iso_8601": "2024-08-28T15:54:20.594343Z",
"url": "https://files.pythonhosted.org/packages/b6/24/101aa46a690d2d90b9216fa75f8ab3255cc9e289a62e641db362f0adb05f/reserver-0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-28 15:54:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "openscilab",
"github_project": "reserver",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "reserver"
}
JSON
