https://github.com/achannarasappa/locust-cli

Developer tools to accelerate development of Locust jobs
https://github.com/achannarasappa/locust-cli

cli crawler headless-chrome puppeteer scraper

Last synced: about 2 hours ago
JSON representation

Developer tools to accelerate development of Locust jobs

• Host: GitHub
• URL: https://github.com/achannarasappa/locust-cli
• Owner: achannarasappa
• License: mit
• Created: 2019-06-29T22:21:33.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-12-10T13:16:52.000Z (almost 2 years ago)
• Last Synced: 2024-05-17T00:27:19.177Z (6 months ago)
• Topics: cli, crawler, headless-chrome, puppeteer, scraper
• Language: JavaScript
• Homepage: https://locust.dev
• Size: 1.07 MB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.com/achannarasappa/locust-cli.svg?branch=master)](https://travis-ci.com/achannarasappa/locust-cli) [![Coverage Status](https://coveralls.io/repos/github/achannarasappa/locust-cli/badge.svg?branch=master)](https://coveralls.io/github/achannarasappa/locust?branch=master)







Locust CLI



Developer tools to accelerate development of Locust jobs



## Quick Start

```

npm install @achannarasappa/locust-cli

```

```

❯ locust

locust 

Commands:

  locust run       run in single job mode

  locust start     starts a job and crawls until a stop condition is met

  locust stop      Stop running jobs and stop redis and browserless containers

  locust generate  generate a job definition through a series of prompts

  locust validate  validate a job definition

  locust info      information on queue state and jobs in each status

Options:

  -v, --version  Show version number                                   [boolean]

  -h, --help     Show help                                             [boolean]

```

## Features

### Generate a job definition file

Interactively generate a job definition file with `locust generate` by answering a set of prompts.

### Test CSS selectors and data extraction logic 

Running a job with `locust run` makes a request to the entrypoint url and runs the `extract` hook which is a lightweight way to test that the defined CSS selectors and other data extraction logic works as expected.

### Start a job locally before pushing to a cloud provider

Simulate and debug a job run on a cloud provider without pushing up code or provisioning infrastructure. `locust start` will run a job as it would on a cloud provider and presents a dashboard to help understand what the job is doing and identify potential problem areas.

## Reference

* Reference

  * [API](https://locust.dev/docs/api)

  * [CLI](https://locust.dev/docs/cli)

* [Examples](https://github.com/achannarasappa/locust-examples)

* Related

  * [locust](https://github.com/achannarasappa/locust)

  * [locust-aws-terraform](https://github.com/achannarasappa/locust-aws-terraform)

  * [locust-website](https://github.com/achannarasappa/locust-website)