xk6-subcommand-example

Example k6 subcommand extension

This k6 extension showcases how to develop a k6 Subcommand extension. It serves as the basis for new Subcommand extensions created with the xk6 new command. Additionally, this repository functions as a GitHub template for creating k6 subcommand extension repositories.

This subcommand includes a greet command that prints greeting messages to the console, showcasing how to add custom functionality. It demonstrates how to add functional subcommands to an xk6 extension. Users can specify a name to greet using the --name flag.

./k6 x example greet --name Alice

The parent command has no standalone functionality - use its subcommands to perform actions, though you can add direct functionality if desired.

Quick start

1. Create a GitHub repository. This can be done interactively in a browser by clicking here.

   Alternatively, use the GitHub CLI to create the repository.

   gh repo create -p grafana/xk6-subcommand-example -d "Experimental k6 subcommand extension" --public xk6-subcommand-quickstart

2. Create a codespace. Go to the repository you created in the previous step. Click the green Code button and then select Codespaces from the dropdown menu. Click Create new codespace.

   Alternatively, use the GitHub CLI to create the codespace, replacing USER with your GitHub username:

   gh codespace create --repo USER/xk6-subcommand-quickstart --web

   Once the codespace is ready, it will open in your browser as a Visual Studio Code-like environment, letting you begin working on your project with the repository code already checked out.

3. Run the example greet command. Use the xk6 x command instead of k6 x to execute your subcommand.

   xk6 x -- quickstart greet --name Alice

Note

Don't forget to update README.md after creating new repository from the template.

Development environment

While using a GitHub codespace in the browser is a good starting point, you can also set up a local development environment for a better developer experience.

To create a local development environment, you need an IDE that supports Development Containers. Visual Studio Code supports Development Containers after installing the Dev Containers extension.

1. First, clone the xk6-subcommand-quickstart repository to your machine and open it in Visual Studio Code. Make sure to replace USER with your GitHub username:

   git clone https://github.com/USER/xk6-subcommand-quickstart.git
   code xk6-subcommand-quickstart

2. Visual Studio Code will detect the development container configuration and show a pop-up to open the project in a dev container. Accept the prompt and the project opens in the dev container, and the container image is rebuilt if necessary.

3. Run the subcommand. When developing k6 extensions, use the xk6 x command instead of k6 x to execute your subcommand.

   xk6 x -- quickstart greet

Download

Building a custom k6 binary with the xk6-subcommand-example extension is necessary for its use. You can download pre-built k6 binaries from the Releases page.

Build

Use the xk6 tool to build a custom k6 binary with the xk6-subcommand-example extension. Refer to the xk6 documentation for more information.

Contribute

If you wish to contribute to this project, please start by reading the Contributing Guidelines.