npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

gaucho

v0.2.3

Published

Minimalistic task launcher with GUI

Downloads

8

Readme

Gaucho

by @angrykoala
Build Status

Minimalistic task launcher

Gaucho Screenshot
Gaucho 0.2.0

Download

Gaucho can be downloaded here. Available versions for Linux, Mac and Windows (64 bits).

To use, unzip in the desired location and execute gaucho (execute file depends on you OS).

If you need a different version, please, follow the development instructions to make your own build from the source code

Usage

Gaucho allows you to configure tasks as part of different suites or groups you can access the different suites by clicking on its name in the navbar menu.

Executing tasks

On each suite, you will find the list of possible tasks to launch. By clicking on Run you will start that task. Clicking the same button again (now the Stop button) you can stop the tasks.

You can easily see the name, execution time and status of each task. The status (shown with the status icon) can be idle (black), running (blue), successful (green) or failed (red).

Clicking in the task name the log will be displayed, allowing you to check the task output in real time.

Creating and Editing tasks

By clicking the Edit button (on the top right corner) you'll be able to edit the suites and tasks.

You can add new tasks to the current suite by clicking "Add New Task" at the bottom of the list. By clicking on a task name you'll be able to edit that task.

While editing/creating a new tasks, you should add a name to the task and a command. The command can be any shell/terminal accepted command or an executable file. Optionally a path can be added as well, if no path is added, the gaucho execution path will be used.

The tasks can be deleted by clicking the Delete button.

Keep in mind that you won't be able to run new tasks in edit mode

While in edit mode, suites names can also be changed by clicking on it. To close edit mode simply click again on the edit button.

Menu

Next to the edit button, is the menu button. When clicking the menu, several options will be shown, those options may change if the edit mode is active:

Normal mode

  • Run Suite: Runs all tasks in the current suite (except those already running)
  • Stop Suite: Stops all running tasks in suite

Edit mode

  • Add new Suite: Created a new suite
  • Delete Suite: Deletes current suite

User and Tasks Configuration

All tasks and user changes are saved automatically when closing gaucho. This includes all the tasks/suites information as well as the window size.

This information is stored in config.json and tasks.json if any of those files is not present, the default configuration will be loaded and the file will be created

Development

If you want to contribute to Gaucho, create a new different version of Gaucho, or compile it from source code, follow these instructions.

Clone/download source code from the github repo. Make sure you have node and npm already installed in your system:

  1. npm install to install electron and all the dependencies.
  2. npm start to start gaucho.
    • npm run start-dev to run gaucho with chrome dev tools enabled.
  3. npm run build-electron to build gaucho for your system (build will be placed in builds folder).
    • npm run build-electron-all to make builds for windows, linux and mac.
  4. npm test to run the automated tests.
    • Please, ensure the tests are passing before creating a pull requests. Add tests for your changes.

Acknowledgments

License

Gaucho is being developed and maintained as Open-Source software by @angrykoala (https://github.com/angrykoala) licensed under GNU GENERAL PUBLIC LICENSE version 3

The original source code can be found at: https://github.com/angrykoala/gaucho