Skip to main content

Plugin tooling for the Rapid7 Insight platform

Project description

Insight Plugin - CLI Tooling for plugin development

Commands

Analysis

Run Static Code Analysis on the plugin.

This command will run the static code analysis check on the plugin.

Linter

Run the linter check on the plugin.

This command will run the black linter on the plugin and return any formatting issues with the plugin.

Checks

Run analysis, linter and validate on the plugin.

This will allow you to recreate, locally, all the github checks that get run on plugins.

Create

Create a new plugin.

This command will generate the skeleton folder structure and code for a new plugin, based on the provided plugin.spec.yaml file.

Export

Export a plugin Docker image to a tarball.

This tarball can be uploaded as a custom plugin via the import functionality in the InsightConnect UI.

Refresh

Refresh the plugin.

This command will update the current plugin code, when updates are made in the plugin.spec.yaml file

Validate

Validate / Run checks against the plugin.

This command performs quality control checks on the current state of the plugin. This should be run before finalizing any new updates.

Semver

Update the plugin versioning.

This command should be run after finalizing any updates, defect fixes or new functionality, to update the versioning

Samples

Create test samples for actions and triggers.

This command will create new files under the 'tests' folder which can be used to test each new action/trigger. Note if a file already exists for a particular action/trigger, it will be overwritten.

Run

Run an action/trigger from a json test file (created during sample generation)

Server

Run the plugin in HTTP mode.

This allows an external API testing program to be used to test a plugin

Shell

Run the plugin via the docker shell to enable advanced debugging

View

Run a docker command to get an overview of a plugin.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

insight_plugin-1.5.0.tar.gz (71.2 kB view hashes)

Uploaded Source

Built Distribution

insight_plugin-1.5.0-py3-none-any.whl (112.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page