<p align="center">
<img src="https://github.com/wntrblm/nox/raw/main/docs/_static/alice.png" alt="logo" width=50%>
</p>
# Nox
[![Nox](https://img.shields.io/badge/%F0%9F%A6%8A-Nox-D85E00.svg)](https://github.com/wntrblm/nox)
[![License](https://img.shields.io/github/license/wntrblm/nox)](https://github.com/wntrblm/nox)
[![PyPI](https://img.shields.io/pypi/v/nox.svg?logo=python)](https://pypi.python.org/pypi/nox)
[![GitHub](https://img.shields.io/github/v/release/wntrblm/nox?logo=github&sort=semver)](https://github.com/wntrblm/nox)
[![Code Style](https://img.shields.io/badge/code%20style-black-black)](https://github.com/wntrblm/nox)
[![CI](https://github.com/wntrblm/nox/workflows/CI/badge.svg)](https://github.com/wntrblm/nox/actions?query=workflow%3ACI)
[![Downloads](https://static.pepy.tech/personalized-badge/nox?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads)](https://pepy.tech/project/nox)
*Flexible test automation with Python*
* **Documentation:** [https://nox.readthedocs.io](https://nox.readthedocs.io)
* **Source Code:** [https://github.com/wntrblm/nox](https://github.com/wntrblm/nox)
## Overview
`nox` is a command-line tool that automates testing in multiple Python environments, similar to [tox][]. Unlike tox, Nox uses a standard Python file for configuration:
```python
import nox
@nox.session
def tests(session: nox.Session) -> None:
session.install("pytest")
session.run("pytest")
@nox.session
def lint(session: nox.Session) -> None:
session.install("flake8")
session.run("flake8", "--import-order-style", "google")
```
## Installation
Nox is designed to be installed globally (not in a project virtual environment), the recommended way of doing this is via [pipx], a tool designed to install python CLI programs whilst keeping them separate from your global or system python.
To install Nox with [pipx][]:
```shell
pipx install nox
```
You can also use [pip][] in your global python:
```shell
python3 -m pip install nox
```
You may want to user the [user-site][] to avoid messing with your Global python install:
```shell
python3 -m pip install --user nox
```
## Usage
### List all sessions
```shell
nox -l/--list
```
### Run all sessions
```shell
nox
```
### Run a particular session
```shell
nox -s/--session test
```
Checkout the [docs](https://nox.readthedocs.io) for more! 🎉
## Contributing
Nox is an open source project and welcomes contributions of all kinds, checkout the [contributing guide](CONTRIBUTING.md) for help on how to help us out!
All contributors must follow the [code of conduct](CODE_OF_CONDUCT.md) and be nice to one another! 😃
[tox]: https://tox.readthedocs.io
[pipx]: https://pypa.github.io/pipx/
[pip]: https://pip.pypa.io/en/stable/
[user-site]: https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-to-the-user-site
Raw data
{
"_id": null,
"home_page": "",
"name": "nox",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "automation,testing,tox",
"author": "Alethea Katherine Flowers",
"author_email": "me@thea.codes",
"download_url": "https://files.pythonhosted.org/packages/8a/6b/2c02879d29704b74586a89900c48d9744780a5aad771f1d182c7394cfd57/nox-2024.3.2.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n<img src=\"https://github.com/wntrblm/nox/raw/main/docs/_static/alice.png\" alt=\"logo\" width=50%>\n</p>\n\n# Nox\n\n[![Nox](https://img.shields.io/badge/%F0%9F%A6%8A-Nox-D85E00.svg)](https://github.com/wntrblm/nox)\n[![License](https://img.shields.io/github/license/wntrblm/nox)](https://github.com/wntrblm/nox)\n[![PyPI](https://img.shields.io/pypi/v/nox.svg?logo=python)](https://pypi.python.org/pypi/nox)\n[![GitHub](https://img.shields.io/github/v/release/wntrblm/nox?logo=github&sort=semver)](https://github.com/wntrblm/nox)\n[![Code Style](https://img.shields.io/badge/code%20style-black-black)](https://github.com/wntrblm/nox)\n[![CI](https://github.com/wntrblm/nox/workflows/CI/badge.svg)](https://github.com/wntrblm/nox/actions?query=workflow%3ACI)\n[![Downloads](https://static.pepy.tech/personalized-badge/nox?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads)](https://pepy.tech/project/nox)\n\n*Flexible test automation with Python*\n\n* **Documentation:** [https://nox.readthedocs.io](https://nox.readthedocs.io)\n\n* **Source Code:** [https://github.com/wntrblm/nox](https://github.com/wntrblm/nox)\n\n## Overview\n\n`nox` is a command-line tool that automates testing in multiple Python environments, similar to [tox][]. Unlike tox, Nox uses a standard Python file for configuration:\n\n```python\nimport nox\n\n\n@nox.session\ndef tests(session: nox.Session) -> None:\n session.install(\"pytest\")\n session.run(\"pytest\")\n\n@nox.session\ndef lint(session: nox.Session) -> None:\n session.install(\"flake8\")\n session.run(\"flake8\", \"--import-order-style\", \"google\")\n```\n\n## Installation\n\nNox is designed to be installed globally (not in a project virtual environment), the recommended way of doing this is via [pipx], a tool designed to install python CLI programs whilst keeping them separate from your global or system python.\n\nTo install Nox with [pipx][]:\n\n```shell\npipx install nox\n```\n\nYou can also use [pip][] in your global python:\n\n```shell\npython3 -m pip install nox\n```\n\nYou may want to user the [user-site][] to avoid messing with your Global python install:\n\n```shell\npython3 -m pip install --user nox\n```\n\n## Usage\n\n### List all sessions\n\n```shell\nnox -l/--list\n```\n\n### Run all sessions\n\n```shell\nnox\n```\n\n### Run a particular session\n\n```shell\nnox -s/--session test\n```\n\nCheckout the [docs](https://nox.readthedocs.io) for more! \ud83c\udf89\n\n## Contributing\n\nNox is an open source project and welcomes contributions of all kinds, checkout the [contributing guide](CONTRIBUTING.md) for help on how to help us out!\n\nAll contributors must follow the [code of conduct](CODE_OF_CONDUCT.md) and be nice to one another! \ud83d\ude03\n\n[tox]: https://tox.readthedocs.io\n[pipx]: https://pypa.github.io/pipx/\n[pip]: https://pip.pypa.io/en/stable/\n[user-site]: https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-to-the-user-site\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Flexible test automation.",
"version": "2024.3.2",
"project_urls": {
"bug-tracker": "https://github.com/wntrblm/nox/issues",
"documentation": "https://nox.thea.codes",
"homepage": "https://github.com/wntrblm/nox",
"repository": "https://github.com/wntrblm/nox"
},
"split_keywords": [
"automation",
"testing",
"tox"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c255c0d4ca1e6f68da8a1c7055ad80d4bf1fef651af08a68b52323cee97880c9",
"md5": "6a8a45b321f53c108c5afa63e7c6836b",
"sha256": "e53514173ac0b98dd47585096a55572fe504fecede58ced708979184d05440be"
},
"downloads": -1,
"filename": "nox-2024.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6a8a45b321f53c108c5afa63e7c6836b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 58282,
"upload_time": "2024-03-03T20:08:52",
"upload_time_iso_8601": "2024-03-03T20:08:52.032029Z",
"url": "https://files.pythonhosted.org/packages/c2/55/c0d4ca1e6f68da8a1c7055ad80d4bf1fef651af08a68b52323cee97880c9/nox-2024.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8a6b2c02879d29704b74586a89900c48d9744780a5aad771f1d182c7394cfd57",
"md5": "ffbc86ea37eca32d945b8f6ae0e387af",
"sha256": "f521ae08a15adbf5e11f16cb34e8d0e6ea521e0b92868f684e91677deb974553"
},
"downloads": -1,
"filename": "nox-2024.3.2.tar.gz",
"has_sig": false,
"md5_digest": "ffbc86ea37eca32d945b8f6ae0e387af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 3994775,
"upload_time": "2024-03-03T20:08:54",
"upload_time_iso_8601": "2024-03-03T20:08:54.879733Z",
"url": "https://files.pythonhosted.org/packages/8a/6b/2c02879d29704b74586a89900c48d9744780a5aad771f1d182c7394cfd57/nox-2024.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-03 20:08:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wntrblm",
"github_project": "nox",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nox"
}