Metadata-Version: 2.1
Name: nome
Version: 0.0.1
Summary: A Python CLI to check if a package name is available in PyPI or npm.
Home-page: https://github.com/joaopalmeiro/nome
Keywords: nome,cli,pypi,npm,name
Author: João Palmeiro
Author-email: joaommpalmeiro@gmail.com
Requires-Python: >=3.6,<4
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Internet
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Project-URL: Bug Tracker, https://github.com/joaopalmeiro/nome/issues
Project-URL: Twitter, https://twitter.com/joaompalmeiro

# nome

A Python CLI to check if a package name is available in PyPI or npm.

## References

- Ewen Le Bihan's [check_availability](https://github.com/ewen-lbh/check-availability) CLI.
- Anton Zhiyanov's [How to make an awesome Python package in 2021](https://antonz.org/python-packaging/) blog post ([repo](https://github.com/nalgeon/podsearch-py)).
- [Development - Contributing](https://fastapi.tiangolo.com/contributing/) page (FastAPI documentation).

## Development

Current version of Python used for development: `Python 3.6.13`.

- `python -m venv env`.
- `source ./env/bin/activate`.
  - Run `which pip` to see if it worked. The path must end in `env/bin/pip`.
  - **Note**: Whenever you install a new package with `pip` in this environment, activate it again.
- `pip install flit==3.2.0`.
- `flit install --deps develop --symlink`.
  - To install all dependencies and `nome` in the local environment.
  - [For Windows](https://flit.readthedocs.io/en/latest/cmdline.html#flit-install), replace `--symlink` with `--pth-file`.

## Deployment

- `flit publish`.

## Notes

- [Why isn't my desired project name available?](https://pypi.org/help/#project-name):
  - `requirements.txt` is a prohibited project name.
- [stdlib-list](https://github.com/jackmaney/python-stdlib-list) package.
- [Python (3.6) Module Index](https://docs.python.org/3.6/py-modindex.html).
- [Flit](https://flit.readthedocs.io/en/latest/):
  - Python packaging tool.
  - [FastAPI](https://github.com/tiangolo/fastapi) uses it ([`pyproject.toml` file](https://github.com/tiangolo/fastapi/blob/master/pyproject.toml)).
- [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
- `python -m venv env` or `python3 -m venv env` (virtual environment with `venv`).

### `.pypirc` file

```ini
[distutils]
index-servers =
   pypi

[pypi]
username = joaopalmeiro
```

