gitwtfhub

wtf is qontract-development-cli?

jfchevrette/qontract-development-cli — explained in plain English

Analysis updated 2026-08-15 · repo last pushed 2023-09-25

Audience · developerComplexity · 3/5DormantSetup · moderate

TL;DR

A command-line tool that helps developers test infrastructure-as-code integrations locally by automatically running the needed services in containers and restarting them on file changes.

Mindmap

mindmap
  root((repo))
    What it does
      Runs services in containers
      Restarts on file changes
      Creates profiles for integrations
      Supports PR and MR workflows
    Tech stack
      Python
      Docker containers
      CLI tooling
    Use cases
      Test integration changes locally
      Review teammate PRs easily
      Run integrations in dry-run mode
    Audience
      Infrastructure developers
      Red Hat App-Interface maintainers
    Workflow
      Initial configuration
      Profile creation
      Service startup and watching

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Test changes to a qontract-reconcile integration locally before merging a pull request.

REASON 2

Create a profile from a teammate's PR to review and run their changes in isolated working copies.

REASON 3

Run integrations in safe dry-run mode to simulate actions without making real changes.

What's in the stack?

PythonDocker

How it stacks up

jfchevrette/qontract-development-cli000madz000/rfid-attendance00kaku/gallery-slider-block
LanguageTypeScriptJavaScript
Last pushed2023-09-252024-07-222021-05-19
MaintenanceDormantDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker and familiarity with the App-Interface infrastructure ecosystem to configure profiles correctly.

Wtf does this do

Qontract Development CLI is a tool that makes it easier for developers to work on qontract-reconcile, a system used to manage infrastructure as code. Instead of wrestling with complex setup steps every time you want to test a change, this tool automates the process of running the necessary services locally. It is essentially a helper that streamlines your daily development workflow. At a high level, the tool runs the qontract-reconcile and qontract-server components in containers on your local machine. You start by creating an initial configuration, then set up a "profile" for the specific integration you want to test (like a sql-query integration). When you run that profile, the tool handles starting up the right services. It also watches your files for changes and automatically restarts or rebuilds the affected services, so you don't have to manually restart things as you code. The tool is designed for developers working within the App-Interface ecosystem, which appears to be an internal Red Hat system for managing infrastructure. You would use this if you are building or maintaining integrations that qontract-reconcile runs. For example, if you open a pull request to change how an integration works, you can create a profile directly from that PR. The tool will set up isolated copies of the relevant code, start the services, and let you test your changes locally before merging. One notable feature is the built-in support for pull requests and merge requests. When you create a profile from a PR, it automatically sets up separate working copies of the repositories involved, starts the containers with the correct paths, and can even fetch updates when you restart. This makes reviewing and testing changes from teammates straightforward. The tool also defaults to a safe "dry-run" mode, meaning integrations simulate their actions without making real changes unless you explicitly turn that off.

Yoink these prompts

Prompt 1
Help me install and set up qontract-development-cli on my machine so I can run qontract-reconcile integrations locally in containers
Prompt 2
Walk me through creating a profile for a sql-query integration using qontract-development-cli and explain how to run it
Prompt 3
Show me how to create a profile from a pull request in qontract-development-cli so I can test a teammate's changes locally
Prompt 4
Explain how to turn off dry-run mode in qontract-development-cli so my integration makes real changes during testing

Frequently asked questions

wtf is qontract-development-cli?

A command-line tool that helps developers test infrastructure-as-code integrations locally by automatically running the needed services in containers and restarting them on file changes.

Is qontract-development-cli actively maintained?

Dormant — no commits in 2+ years (last push 2023-09-25).

How hard is qontract-development-cli to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qontract-development-cli for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.