Steampunk Spotter Visual Studio Code extension

Table of Contents

• Introduction
• Installation
• Usage
• Development
• Acknowledgement

Introduction

Steampunk Spotter provides an Ansible Playbook Scanning Tool that analyzes and offers recommendations for your Ansible Playbooks.

The Steampunk Spotter VS Code extension enables the use of the VS Code with the ability to scan Ansible content such as playbooks, roles, collections, or task files.

Installation

You can install the extension from Visual Studio Marketplace or Open VSX Registry. The extension requires a Steampunk Spotter user account and the Steampunk Spotter CLI installed in the console that you use with VS Code. You can adjust the path to the Steampunk Spotter CLI in the extension settings. When you first activate any extension action, you will be prompted to log in with your Steampunk Spotter account.

Usage

The extension currently supports the following actions:

• adjusting settings such as Steampunk Spotter CLI path and scanning events
• running separate commands
• scanning and rewriting files and folders by right-clicking in the explorer
• scanning and rewriting files and folders by right-clicking in the editor
• scanning and rewriting the whole workspace
• scanning on different events (on file change, on file save, etc.)

Development

Use the commands below to develop and publish the VSC extension.

# install Node JS from https://nodejs.org/en/download/
# and test it with node -v and npm -v command

# install prerequisite packages
npm install

# test the plugin in VS Code (this will open a new window with your extension loaded)
press F5 (Run Extension)

# package and publish the extension
# if you don't have npx install it with: npm install npx
npx vsce package

Acknowledgement

This tool was created by XLAB Steampunk, IT automation specialist and leading expert in building Enterprise Ansible Collections.