#ChiPy Debian development environment

The goal of this repository is to make it easier for ChiPy members to contribute to Debian Python packages without requiring them to use Debian as their base operating system. Using Vagrant and VirtualBox 7.0, a batteries included Debian 12.7.0 development environment is accessible via SSH.

#Inspiration

This Vagrant box has been created using the methods outlined in this blog post. Currently there is no automated script to run that installs things into the base imahe. Watch this space for more information about automating the creation of the base image.

#Installing the customized Debian 12.7.0 VM locally

The Vagrant base box is roughly 2.5 GB in size and is not contained in this repository. To download this Vagrant box, try this publicly-accessible link on Dropbox. If it's unavailable, ask someone at a ChiPy meetup for the Vagrant box which should be available on a flash drive for you to install on your machine.

Once you have the .box file locally, you need to add the Vagrant box to your system with the following command.

cd path/to/where/you/are/storing/the/box/file

vagrant box add debian-12.7.0-64 debian-12.7.0-64base.box

#Useful Vagrant commands

After the .box file has been successfully added to Vagrant locally, you can now interact with the Debian 12.7.0 development environment VM using vagrant ... commands.

#Starts the Debian 12.7.0 VM

vagrant up

#Provisions any changes to the Debian 12.7.0 VM

This is only needed if there are changes to the Puppet files found in the manifests/ directory.

vagrant provision

#Connect to the Debian 12.7.0 VM

vagrant ssh

#Suspend the Debian 12.7.0 VM

Useful if you want to quickly bring the VM back up.

vagrant suspend

#Shutdown the Debian 12.7.0 VM

Useful if you want to save resources on your host machine and turns the VM off.

vagrant halt

#Destroy the Debian 12.7.0 VM

Destroys the VM which frees up disk space on your host machine and deletes the VM.

vagrant destroy

#What's configured

The Debian 12.7.0 Vagrant box is configured as follows.

• Audio driver support is disabled
• USB driver support is disabled
• Network is available via NAT and configured to allow TCP traffic on port 2222 from host port 22
• Configured with 40GB of disk space, set to grow dynamically
• Configured with 4 CPU processes
• Configured with 8 GB of memory
• All the necessary and useful packages that are necessary for running commands that the Debian Python Team (DPT) use.
• Some of the tools installed are from suggestions in the Style Guide for Packaging Python Libraries from the Debian Wiki.

#What's installed?

This Debian 12.7.0 VM comes with the following tools installed by default.

• git-buildpackage
• sbuild-debian-developer-setup
• emacs
  • sanemacs
• neovim
  • kickstart.nvim
  • ninja-build
  • gettext
  • cmake
  • unzip
  • curl
• rust
  • rustup
  • cargo
  • bat
  • exa
  • fd-find
  • procs
  • starship
  • sd
  • tokei
  • du-dust
  • ripgrep
  • tealdeer
  • grex
  • zoxide
  • nushell