name: apt
shortdesc: The apt module offers pseudo-declarative package and repository management using apt.
example: |
  type: apt
  repos:
    cleanup: true # clean up added repos after module is done
    files:
      - https://brave-browser-apt-release.s3.brave.com/brave-browser.list
      - custom.list
    ppa:
      - ppa:ondrej/php
      - ppa:git-core/ppa
    keys:
      - https://brave-browser-apt-release.s3.brave.com/brave-core.asc
    backports: true # enable backports repository
  optfix: # performs symlinking for `/opt/` to allow certain packages to install
    - Tabby # needed because tabby installs into `/opt/Tabby/`
    - brave.com
  install:
    skip-unavailable: true # skip unavailable packages
    packages:
      - repo: brave-browser
        packages:
          - brave-browser
      - starship
      - https://github.com/Eugeny/tabby/releases/download/v1.0.209/tabby-1.0.209-linux-x64.deb
      - kubectl.deb
  remove:
    packages:
      - firefox
      - firefox-l10n-all
  replace:
    - from-repo: ppa:ondrej/php
      skip-unavailable: true # skip unavailable packages
      packages:
        - php8.2
        - php8.2-common
        - php8.2-cli
  task-install:
    with-optional: true # install optional packages from task
    packages:
      - gnome-desktop-environment
      - kde-plasma-desktop
      - xfce4
  task-remove:
    packages:
      - development-tools