bump: version 0.4.5 → 0.4.6

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to rattail-fabric2 will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## v0.4.6 (2025-09-06)
+
+### Fix
+
+- add `apt.is_installed()` function
+
 ## v0.4.5 (2025-02-01)
 
 ### Fix

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rattail-fabric2"
-version = "0.4.5"
+version = "0.4.6"
 description = "Fabric (v2) Utilities for Rattail"
 readme = "README.md"
 authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]

rattail_fabric2/apt.py

@@ -2,7 +2,7 @@
 ################################################################################
 #
 #  Rattail -- Retail Software Framework
-#  Copyright © 2010-2018 Lance Edgar
+#  Copyright © 2010-2025 Lance Edgar
 #
 #  This file is part of Rattail.
 #
@@ -44,6 +44,19 @@ def install(c, *packages, **kwargs):
         frontend, target, force_yes, ' '.join(packages)), **kwargs)
 
 
+def is_installed(c, package):
+    """
+    Check if the given APT package is installed.
+
+    :param c: Fabric connection.
+
+    :param package: Name of package to be checked.
+
+    :returns: ``True`` if package is installed, else ``False``.
+    """
+    return c.run(f"dpkg-query -s {package}", warn=True).ok
+
+
 def purge(c, *packages):
     """
     Uninstall and purge config for given packages