dev-quick-init 0.1.8

Quick developer machine setup from YAML

Quick Setup

Quick Setup is a Python-based tool that automates the setup of a developer environment on Windows, macOS, or Linux. It reads a YAML configuration file describing software to install, commands to run before and after installation, and files to create.

The tool supports multiple package managers and can iterate over lists of parameters for repeated tasks.

Usage

$ uvx  dev-quick-init  --help     
Usage: dev-quick-init [OPTIONS] [YAML_FILE]

 Quick developer machine setup based on YAML.

Options:
 -v, --verbose         Show detailed command output
 -d, --dry-run         Show commands without executing
 -l, --list            Show available installer drivers
 -g, --generate TEXT   Generate sample template (e.g., 'windows-full'). If
                       not provided, will list all available templates.
 -t, --list-templates  List all available templates
 --help                Show this message and exit.

🚀 Features

• Install software with winget, scoop, chocolatey, brew, apt, pacman, or dnf.
• Run pre-install (before) and post-install (after) commands.
• Automatically handle list parameters for iteration (e.g., multiple repos or SDK versions).
• Create configuration files with template substitution.
• Optionally run in verbose mode to see all output.
• Prints total setup time at the end.
• Dry run will only print the commands without running it.

🎯 Intention

The goal of Quick Setup is to simplify the process of setting up a new development machine, ensuring that all tools, programming languages, cloud CLIs, IDEs, and Kubernetes tooling are installed correctly and consistently, with minimal manual steps.

It is especially useful for:

• Developers provisioning new machines.
• Teams wanting a reproducible environment.
• Multi-platform setups (Windows, macOS, Linux).

Automating repetitive setup tasks across multiple machines.

📄 YAML Configuration

The YAML file defines:

• Driver
• before commands
• install software usign the driver
• after commands
• file creation

Driver – Which package manager to use:

driver: winget # options: winget, scoop, chocolatey, brew, apt, pacman, dnf

Params – Variables for templates:

params:
  name: Joe Doe
  email: [e-mail]
  ssh_key_path: ~/.ssh/id_rsa
  python_default: 3.12
  repos:
    - [e-mail]:user/repo1.git
    - [e-mail]:user/repo2.git
  repos_dir: ~/Projects
  dotnet_sdk:
    - 8
    - 10

Before commands – Commands to run before installation:

before:
  - sudo apt update
  - sudo apt upgrade -y
  - mkdir -p "{{repos_dir}}"

Install – List of software packages (supports template iteration):

install:
  - git
  - git-lfs
  - kubectl
  - helm
  - dotnet-sdk-{{dotnet_sdk}}

After commands – Commands to run after installation:

after:
  <whatever-label-you-whant>:
    - git config --global user.name "{{name}}"
    - git config --global user.email "{{email}}"
    - git lfs install
  python:
    - uv python install 3.10
    - uv python install {{python_default}}
    - uv python list
  clone-repos:
    - cmd: git clone {{repos}}
      dir: {{repos_dir}}

Files – Create configuration files with templated content:

files:
  "~/.config/my_app_config.ini": |
    [settings]
    enabled=true
    name={{name}}
    email={{email}}

💻 Usage

Install Quick Setup

pip install dev-quick-init

Run with a YAML file

dev-quick-init path/to/setup.yml

Run in verbose mode

dev-quick-init path/to/setup.yml -v

Run in dry run mode

dev-quick-init path/to/setup.yml -d

List all quick templates

dev-quick-init -t

Generate a full windows template and install it

dev-quick-init -g windows_full > install.yml
dev-quick-init install.yml

🛠 Use Cases

• New Developer Machine

  • Automatically install Git, Docker, NodeJS, Python, .NET SDKs, Kubernetes tools, and IDEs.

• Team Reproducibility

  • Share a single YAML config for all team members to ensure consistent environments.

• Multi-platform Setup

  • Supports Windows, macOS, and Linux via the appropriate package manager.

• Automated Repo Cloning

  • Clones multiple repositories and sets up SSH keys automatically.

• Custom Config Files

  • Create .ini, .yaml, or any config files with templated content.

⚡ Example: Minimal macOS YAML

Please check the examples folder.

🔧 Supported Package Managers

Platform Manager Windows winget, scoop, chocolatey macOS brew Linux apt, pacman, dnf

📌 Notes

• List Parameters: Any params that are lists will be automatically iterated in install and after commands.
• Template Syntax: Use {{param_name}} to substitute a variable.
• Verbose Flag: -v shows all command outputs; without it, output is suppressed.
• Files: Paths support ~ and environment variables like %USERPROFILE% or $HOME.