{"id":15672777,"url":"https://github.com/mre/riffraff","last_synced_at":"2025-05-06T22:07:23.219Z","repository":{"id":30251286,"uuid":"124392832","full_name":"mre/riffraff","owner":"mre","description":"A commandline interface for Jenkins (like `fly` for Concourse).","archived":false,"fork":false,"pushed_at":"2023-04-05T04:58:40.000Z","size":8841,"stargazers_count":15,"open_issues_count":6,"forks_count":11,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-06T22:05:54.989Z","etag":null,"topics":["ci","cli","com","commandline","jenkins"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-08T13:07:54.000Z","updated_at":"2024-02-08T12:45:45.000Z","dependencies_parsed_at":"2024-06-19T00:21:04.015Z","dependency_job_id":"2be0188d-f3e9-472e-b9fe-201e5b1858df","html_url":"https://github.com/mre/riffraff","commit_stats":{"total_commits":82,"total_committers":14,"mean_commits":5.857142857142857,"dds":0.5487804878048781,"last_synced_commit":"d4aa7ff38660cc2c5df30954789ee5d45d78836d"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Friffraff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Friffraff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Friffraff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mre%2Friffraff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mre","download_url":"https://codeload.github.com/mre/riffraff/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252776579,"owners_count":21802468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ci","cli","com","commandline","jenkins"],"created_at":"2024-10-03T15:31:36.683Z","updated_at":"2025-05-06T22:07:23.204Z","avatar_url":"https://github.com/mre.png","language":"Go","readme":"\u003cimg alt=\"The riffraff logo\" src=\"assets/logo_withname.svg\" height=\"192px\" /\u003e\n\n[![Travis (.org)](https://img.shields.io/travis/mre/riffraff/master.svg?style=flat-square)](https://travis-ci.org/mre/riffraff)\n[![Codecov branch](https://img.shields.io/codecov/c/github/mre/riffraff/master.svg?style=flat-square)](https://codecov.io/gh/mre/riffraff)\n[![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg?style=flat-square)](https://godoc.org/github.com/mre/riffraff)\n[![Go Report Card](https://goreportcard.com/badge/github.com/mre/riffraff?style=flat-square)](https://goreportcard.com/report/github.com/mre/riffraff)\n\n![usage](assets/usage.gif)\n\nA commandline interface for Jenkins.\n\n## Features\n\n* Queries the current status of jobs in parallel.\n* Can trigger Jenkins builds from the commandline.\n* Visualizes the status of jobs and nodes.\n* Can diff the output two runs.\n\n```Shell\nriffraff is a commandline interface for Jenkins\n\nUsage:\n  riffraff [command]\n\nAvailable Commands:\n  build       Trigger build for all matching jobs\n  diff        Print a diff between two builds of a job\n  help        Help about any command\n  log         Show the logs of a job\n  nodes       Show the status of all Jenkins nodes\n  open        Open a job in the browser\n  queue       Show the queue of all matching jobs\n  status      Show the status of all matching jobs\n\nFlags:\n  -h, --help      help for riffraff\n      --salt      Show failed salt states\n  -v, --verbose   Verbose mode. Print full job output\n\nUse \"riffraff [command] --help\" for more information about a command.\n```\n\n## Installation\n\n```Shell\ngo get github.com/mre/riffraff\n```\n\n...or download a static binary from the [releases page](https://github.com/mre/riffraff/releases).\n\n## Getting started\n\nYou need to set the following environment variables:\n\n```Shell\nexport JENKINS_URL=\"http://example.com/\"\nexport JENKINS_USER=\"username\"\nexport JENKINS_PW=\"password\"\n```\n\nYou might want to put those into your `~/.bashrc`, `~/.zshrc` or equivalent.\n\n## Usage\n\n```Shell\nriffraff status jenkins-job-name\n```\n\nThis will print the current status of all Jenkins jobs matching the given pattern (`jenkins-job-name` in this case).\nYou can use any regular expression for that, e.g.:\n\n```Shell\nriffraff status \"^application-.*-unittests$\"\n```\n\nYou can get the full output of each last job matching the pattern with\n\n```Shell\nriffraff status -v \"^application-.*-unittests$\"\n```\n\n## Development\n\n* Install golang version 1.11 or later for [go modules](https://github.com/golang/go/wiki/Modules) support\n* Clone this repository to a directory in your `$GOPATH/src` tree (recommended) or use`go get -u github.com/mre/riffraff.git` (uses https not SSH)\n* In the source folder run `go run main.go` to install modules and run `riffraff`\n* If you don't have a Jenkins server you can run it by using its [`.war` file](https://jenkins.io/doc/pipeline/tour/getting-started/) (recommended) or installing its [`.deb` file](https://jenkins.io/doc/book/installing)\n\n## OBTW\n\nThe tool is named after the [butler from the Rocky Horror Picture Show](https://en.wikipedia.org/wiki/The_Rocky_Horror_Picture_Show:_Let%27s_Do_the_Time_Warp_Again), and not the rapper with the same name ;-).\n\n## Credits\n\nLogo design: [Franziska Böhm noxmoon.de](http://noxmoon.de) ([CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/))\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmre%2Friffraff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmre%2Friffraff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmre%2Friffraff/lists"}