Initial commit; enough to prove concepts at least

was able to bootstrap a complete machine with this, although there's lots
missing yet...

rattail_fabric2/apt.py

@@ -0,0 +1,105 @@
+# -*- coding: utf-8; -*-
+################################################################################
+#
+#  Rattail -- Retail Software Framework
+#  Copyright © 2010-2018 Lance Edgar
+#
+#  This file is part of Rattail.
+#
+#  Rattail is free software: you can redistribute it and/or modify it under the
+#  terms of the GNU General Public License as published by the Free Software
+#  Foundation, either version 3 of the License, or (at your option) any later
+#  version.
+#
+#  Rattail is distributed in the hope that it will be useful, but WITHOUT ANY
+#  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#  FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+#  details.
+#
+#  You should have received a copy of the GNU General Public License along with
+#  Rattail.  If not, see <http://www.gnu.org/licenses/>.
+#
+################################################################################
+"""
+Fabric library for the APT package system
+"""
+
+from __future__ import unicode_literals, absolute_import
+
+from rattail_fabric2 import make_deploy, get_debian_version, get_ubuntu_version
+
+
+deploy = make_deploy(__file__)
+
+
+def install(c, *packages, **kwargs):
+    """
+    Install one or more packages via ``apt-get install``.
+    """
+    frontend = kwargs.get('frontend', 'noninteractive')
+    target = kwargs.get('target_release')
+    target = '--target-release={}'.format(target) if target else ''
+    force_yes = ' --force-yes' if kwargs.get('force_yes') else ''
+    c.sudo('DEBIAN_FRONTEND={} apt-get --assume-yes {}{} install {}'.format(
+        frontend, target, force_yes, ' '.join(packages)))
+
+
+def purge(c, *packages):
+    """
+    Uninstall and purge config for given packages
+    """
+    c.sudo('apt-get --assume-yes purge {}'.format(' '.join(packages)))
+
+
+def update(c):
+    """
+    Perform an ``apt-get update`` operation.
+    """
+    c.sudo('apt-get update')
+
+
+def add_source(c, entry):
+    """
+    Add a new entry to the apt/sources.list file
+    """
+    if c.run("grep '^{}' /etc/apt/sources.list".format(entry), warn=True).failed:
+        c.sudo("""bash -c 'echo "{}" >> /etc/apt/sources.list'""".format(entry))
+        update(c)
+
+
+def dist_upgrade(c, frontend='noninteractive'):
+    """
+    Perform a full ``apt-get dist-upgrade`` operation.
+    """
+    update(c)
+    options = ''
+    if frontend == 'noninteractive':
+        options = '--option Dpkg::Options::="--force-confdef" --option Dpkg::Options::="--force-confold"'
+    c.sudo('DEBIAN_FRONTEND={} apt-get --assume-yes {} dist-upgrade'.format(frontend, options))
+
+
+def configure_listchanges(c):
+    """
+    Configure apt listchanges to never use a frontend.
+    """
+    deploy(c, 'apt/listchanges.conf', '/etc/apt/listchanges.conf', use_sudo=True)
+
+
+def install_emacs(c):
+    """
+    Install the Emacs editor
+    """
+    if not c.run('which emacs', warn=True).failed:
+        return
+
+    emacs = 'emacs-nox'
+    debian_version = get_debian_version(c)
+    if debian_version:
+        if debian_version < 8:
+            emacs = 'emacs23-nox'
+    else:
+        ubuntu_version = get_ubuntu_version(c)
+        if ubuntu_version and ubuntu_version < 16:
+            emacs = 'emacs23-nox'
+
+    install(c, emacs, 'emacs-goodies-el')