npm-package-validator 1.0.0

No description has been added so far.

---

This python package allows you to validate nom package names. It is a python implementation of the original npm/validate-npm-package-name written in javascript.

$ pip install npm_package_validator

Usage

Validate an npm package name like this:

import npm_package_validator
assert npm_package_validator.valid_old_package('MY-package')  # SUCCEEDS!
assert npm_package_validator.valid_new_package('MY-package')  # FAILS!

If you want to know whats wrong with a name, use:

from npm_package_validator.validate import validate_package
errors, warnings = validate_package('MY-package')
print("Errors: %s" % ", ".join(errors))
print("Warnings: %s" % ", ".join(warnings))

A valid new package name must have neither errors nor warnings. Existing packages can have warnings, as the npm validation rules have become stricter over time.

Credits

This package is a port from npm/validate-npm-package-name

Development

For detailed instructions see CONTRIBUTING.

Tests

You can run tests with

$ invoke test
$ invoke test --min-coverage=90     # Fail when code coverage is below 90%
$ invoke type-check                 # Run mypy type checks

Linting and formatting

Lint and format the code with

$ invoke format
$ invoke lint

All of this happens when you run invoke pre-commit.

Note

This project is still in the alpha stage and should not be considered production ready.