| Name | npe2 JSON |
| Version |
0.7.8
JSON |
| download |
| home_page | None |
| Summary | napari plugin engine v2 |
| upload_time | 2025-02-20 08:26:36 |
| maintainer | None |
| docs_url | None |
| author | Nathan Clack |
| requires_python | >=3.8 |
| license | BSD-3-Clause |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# npe2 - napari plugin engine version 2
[](https://github.com/napari/npe2/actions/workflows/ci.yml)
[](https://codecov.io/gh/napari/npe2)
## Project description
The **napari plugin engine version 2**, **npe2** extends the functionality of
[napari's core](https://github.com/napari/napari).
The plugin ecosystem offers user additional functionality for napari as well
as specific support for different scientific domains.
This repo contains all source code and documentation required for defining, validating and managing plugins for napari.
## Getting started
The [napari plugin docs landing page](https://napari.org/stable/plugins/index.html)
offers comprehensive information for **plugin users** and for **plugin developers**.
### Plugin users
For plugin users, the docs include information about:
- [Starting to use plugins](https://napari.org/stable/plugins/start_using_plugins/index.html#plugins-getting-started)
- [Finding and installing plugins](https://napari.org/stable/plugins/start_using_plugins/finding_and_installing_plugins.html#find-and-install-plugins)
### Plugin developers
For plugin developers, the docs cover topics like:
- [Building a plugin](https://napari.org/stable/plugins/building_a_plugin/index.html)
- [Guides to different plugin contributions](https://napari.org/stable/plugins/building_a_plugin/guides.html)
- [Technical references such as the plugin manifest](https://napari.org/stable/plugins/technical_references/manifest.html)
Try the [**napari plugin template**](https://github.com/napari/napari-plugin-template)
to streamline development of a new plugin.
## Installation
The `npe2` command line tool can be installed with `pip` or `conda`, but will already be installed as a dependency if you have napari installed.
### Using pip
1. Create and activate a virtual environment.
*If you are new to using virtual environments, visit our [virtual environments guide](https://napari.org/stable/plugins/virtual_environment_docs/1-virtual-environments.html)*.
```bash
python3 -m venv .venv
source .venv/bin/activate
```
2. Install npe2.
```bash
pip install npe2
```
3. Test your installation.
```bash
npe2 --help
```
### Using conda
1. Create and activate a virtual environment.
```bash
conda create -n npe-test -c conda-forge python=3.12
conda activate npe-test
```
2. Install npe2.
```bash
conda install npe2
```
3. Test your installation.
```bash
npe2 --help
```
## Usage
The command line tool `npe2` offers the following commands:
```bash
cache Cache utils
compile Compile @npe2.implements contributions to generate a manifest.
convert Convert first generation napari plugin to new (manifest) format.
fetch Fetch manifest from remote package.
list List currently installed plugins.
parse Show parsed manifest as yaml.
validate Validate manifest for a distribution name or manifest filepath.
```
### Examples
List currently installed plugins:
```bash
npe2 list
```
Compile a source directory to create a plugin manifest:
```bash
npe2 compile PATH_TO_SOURCE_DIRECTORY
```
Convert current directory to an npe2-ready plugin
(note: the repo must also be installed and importable in the current environment.):
```bash
npe2 convert .
```
Validate a plugin package. For example, a plugin named `your-plugin-package`:
```bash
npe2 validate your-plugin-package
```
Show a parsed manifest of your plugin:
```bash
npe2 parse your-plugin-package
```
## License
npe2 uses the [BSD License](./LICENSE).
## History
This repo replaces the initial napari plugin engine v1.
See also https://github.com/napari/napari/issues/3115 for
motivation and technical discussion about the creation of v2.
## Contact us
Visit [our community documentation](https://napari.org/stable/community/index.html)
or [open a new issue on this repo](https://github.com/napari/npe2/issues/new).
Raw data
{
"_id": null,
"home_page": null,
"name": "npe2",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Nathan Clack",
"author_email": "Talley Lambert <talley.lambert@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/14/2c/91f8cc810b91197c992aea036befea778dfbc87359930147018ac3dcf252/npe2-0.7.8.tar.gz",
"platform": null,
"description": "# npe2 - napari plugin engine version 2\n\n[](https://github.com/napari/npe2/actions/workflows/ci.yml)\n[](https://codecov.io/gh/napari/npe2)\n\n## Project description\n\nThe **napari plugin engine version 2**, **npe2** extends the functionality of\n[napari's core](https://github.com/napari/napari).\nThe plugin ecosystem offers user additional functionality for napari as well\nas specific support for different scientific domains.\n\nThis repo contains all source code and documentation required for defining, validating and managing plugins for napari.\n\n## Getting started\n\nThe [napari plugin docs landing page](https://napari.org/stable/plugins/index.html)\noffers comprehensive information for **plugin users** and for **plugin developers**.\n\n### Plugin users\n\nFor plugin users, the docs include information about:\n- [Starting to use plugins](https://napari.org/stable/plugins/start_using_plugins/index.html#plugins-getting-started)\n- [Finding and installing plugins](https://napari.org/stable/plugins/start_using_plugins/finding_and_installing_plugins.html#find-and-install-plugins)\n\n### Plugin developers\n\nFor plugin developers, the docs cover topics like:\n- [Building a plugin](https://napari.org/stable/plugins/building_a_plugin/index.html)\n- [Guides to different plugin contributions](https://napari.org/stable/plugins/building_a_plugin/guides.html)\n- [Technical references such as the plugin manifest](https://napari.org/stable/plugins/technical_references/manifest.html)\n\nTry the [**napari plugin template**](https://github.com/napari/napari-plugin-template)\nto streamline development of a new plugin.\n\n## Installation\n\nThe `npe2` command line tool can be installed with `pip` or `conda`, but will already be installed as a dependency if you have napari installed.\n\n### Using pip\n\n1. Create and activate a virtual environment.\n\n*If you are new to using virtual environments, visit our [virtual environments guide](https://napari.org/stable/plugins/virtual_environment_docs/1-virtual-environments.html)*.\n\n ```bash\n python3 -m venv .venv\n source .venv/bin/activate\n ```\n\n2. Install npe2.\n\n ```bash\n pip install npe2\n ```\n\n3. Test your installation.\n\n ```bash\n npe2 --help\n ```\n\n### Using conda\n\n1. Create and activate a virtual environment.\n\n ```bash\n conda create -n npe-test -c conda-forge python=3.12\n conda activate npe-test\n ```\n\n2. Install npe2.\n\n ```bash\n conda install npe2\n ```\n\n3. Test your installation.\n\n ```bash\n npe2 --help\n ```\n\n## Usage\n\nThe command line tool `npe2` offers the following commands:\n\n```bash\ncache Cache utils\ncompile Compile @npe2.implements contributions to generate a manifest.\nconvert Convert first generation napari plugin to new (manifest) format.\nfetch Fetch manifest from remote package.\nlist List currently installed plugins.\nparse Show parsed manifest as yaml.\nvalidate Validate manifest for a distribution name or manifest filepath.\n```\n\n### Examples\n\nList currently installed plugins:\n\n```bash\nnpe2 list\n```\n\nCompile a source directory to create a plugin manifest:\n\n```bash\nnpe2 compile PATH_TO_SOURCE_DIRECTORY\n```\n\nConvert current directory to an npe2-ready plugin\n(note: the repo must also be installed and importable in the current environment.):\n\n```bash\nnpe2 convert .\n```\n\nValidate a plugin package. For example, a plugin named `your-plugin-package`:\n\n```bash\nnpe2 validate your-plugin-package\n```\n\nShow a parsed manifest of your plugin:\n\n```bash\nnpe2 parse your-plugin-package\n```\n\n## License\n\nnpe2 uses the [BSD License](./LICENSE).\n\n## History\n\nThis repo replaces the initial napari plugin engine v1.\nSee also https://github.com/napari/napari/issues/3115 for\nmotivation and technical discussion about the creation of v2.\n\n## Contact us\n\nVisit [our community documentation](https://napari.org/stable/community/index.html)\nor [open a new issue on this repo](https://github.com/napari/npe2/issues/new).\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "napari plugin engine v2",
"version": "0.7.8",
"project_urls": {
"homepage": "https://github.com/napari/npe2",
"repository": "https://github.com/napari/npe2"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "21bf49603e48525d096941d21dbe00735ea9b1b53f63ac0908f71d671dc9dbee",
"md5": "c33c65191860ba89638459be3b5ab420",
"sha256": "96bc5cb4cdde9a213b2e96e4bcee9a50d214ffbfc0f9d0ca306822c5efb2bb29"
},
"downloads": -1,
"filename": "npe2-0.7.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c33c65191860ba89638459be3b5ab420",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 92853,
"upload_time": "2025-02-20T08:26:34",
"upload_time_iso_8601": "2025-02-20T08:26:34.445749Z",
"url": "https://files.pythonhosted.org/packages/21/bf/49603e48525d096941d21dbe00735ea9b1b53f63ac0908f71d671dc9dbee/npe2-0.7.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "142c91f8cc810b91197c992aea036befea778dfbc87359930147018ac3dcf252",
"md5": "ed2a9aaa17b5e830782ef953088c7cdc",
"sha256": "55f66aaeff6c2c8d444222826f602799252e4a5008bed7f4e50290a314d712a7"
},
"downloads": -1,
"filename": "npe2-0.7.8.tar.gz",
"has_sig": false,
"md5_digest": "ed2a9aaa17b5e830782ef953088c7cdc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 118280,
"upload_time": "2025-02-20T08:26:36",
"upload_time_iso_8601": "2025-02-20T08:26:36.727544Z",
"url": "https://files.pythonhosted.org/packages/14/2c/91f8cc810b91197c992aea036befea778dfbc87359930147018ac3dcf252/npe2-0.7.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-20 08:26:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "napari",
"github_project": "npe2",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "npe2"
}
