patch: tmate debug

.github/workflows/test-package.yaml

@@ -184,7 +184,7 @@ jobs:
   integration:
     needs: init
     if: contains(fromJson(needs.init.outputs.tests), 'integration') && !inputs.skip-juju
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     strategy:
       fail-fast: false
       matrix:
@@ -194,6 +194,11 @@ jobs:
       - uses: actions/checkout@v6
         with:
           persist-credentials: false
+
+      - name: Setup tmate session
+        uses: mxschmitt/action-tmate@v3
+        with:
+          detached: true
 
       - name: Install concierge
         run: sudo snap install --classic concierge
@@ -204,7 +209,7 @@ jobs:
 
       - name: Prepare Juju for machine
         if: ${{ matrix.substrate == 'machine' }}
-        run: sudo concierge prepare --verbose --juju-channel=3/stable --charmcraft-channel=3.x/stable -p machine
+        run: sudo concierge prepare --verbose --juju-channel=3/stable  --charmcraft-channel=3.x/stable -p machine
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7

CODEOWNERS

@@ -27,6 +27,7 @@
 /nginx_k8s/ @canonical/tracing-and-profiling
 /passwd/ @canonical/charmlibs-maintainers
 /pathops/ @canonical/charmlibs-maintainers
+/rollingops/ @canonical/data
 /snap/ @canonical/charmlibs-maintainers
 /sysctl/ @canonical/charmlibs-maintainers
 /systemd/ @canonical/charmlibs-maintainers

rollingops/README.md

@@ -0,0 +1,29 @@
+# charmlibs.rollingops
+
+The `rollingops` library.
+
+`rollingops` provides a rolling-operations manager for Juju charms backed by etcd.
+
+It coordinates operations across units by using etcd as a shared lock and queue backend,
+and uses TLS client credentials to authenticate requests to the etcd cluster.
+
+To install, add `charmlibs-rollingops` to your Python dependencies. Then in your Python code, import as:
+
+```py
+from charmlibs import rollingops
+```
+
+See the [reference documentation](https://documentation.ubuntu.com/charmlibs/reference/charmlibs/rollingops) for more.
+
+## Unit tests
+```py
+just python=3.12 unit rollingops
+```
+## Pack
+```py
+just python=3.12  pack-machine rollingops
+```
+## Integration tests
+```py
+just python=3.12  integration-machine rollingops
+```

rollingops/pyproject.toml

@@ -0,0 +1,78 @@
+[project]
+name = "charmlibs-rollingops"
+description = "The charmlibs.rollingops package."
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    {name="Data Platform"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Development Status :: 5 - Production/Stable",
+]
+dynamic = ["version"]
+dependencies = [
+    "ops",
+    "charmlibs-interfaces-tls-certificates>=1.8.1",
+    "charmlibs-pathops>=1.2.1",
+    "dpcharmlibs-interfaces==1.0.0",
+    "tenacity"
+]
+
+[dependency-groups]
+lint = [  # installed for `just lint rollingops` (unit, functional, and integration are also installed)
+    # "typing_extensions",
+]
+unit = [  # installed for `just unit rollingops`
+    "ops[testing]",
+]
+functional = [  # installed for `just functional rollingops`
+]
+integration = [  # installed for `just integration rollingops`
+    "jubilant",
+    "tenacity",
+    "charmlibs-apt",
+]
+
+[project.urls]
+"Repository" = "https://github.com/canonical/charmlibs"
+"Issues" = "https://github.com/canonical/charmlibs/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/charmlibs"]
+
+[tool.hatch.version]
+path = "src/charmlibs/rollingops/_version.py"
+
+[tool.ruff]
+extend = "../pyproject.toml"
+src = ["src", "tests/unit", "tests/functional", "tests/integration"]  # correctly sort local imports in tests
+
+[tool.ruff.lint.extend-per-file-ignores]
+# add additional per-file-ignores here to avoid overriding repo-level config
+"tests/**/*" = [
+    # "E501",  # line too long
+]
+
+[tool.pyright]
+extends = "../pyproject.toml"
+include = ["src", "tests"]
+exclude = ["tests/integration/.tmp/**"]
+pythonVersion = "3.12"  # check no python > 3.12 features are used
+
+[tool.charmlibs.functional]
+ubuntu = []  # ubuntu versions to run functional tests with, e.g. "24.04" (defaults to just "latest")
+pebble = []  # pebble versions to run functional tests with, e.g. "v1.0.0", "master" (defaults to no pebble versions)
+sudo = false  # whether to run functional tests with sudo (defaults to false)
+
+[tool.charmlibs.integration]
+# tags to run integration tests with (defaults to running once with no tag, i.e. tags = [''])
+# Available in CI in tests/integration/pack.sh and integration tests as CHARMLIBS_TAG
+tags = []  # Not used by the pack.sh and integration tests generated by the template

rollingops/src/charmlibs/rollingops/__init__.py

@@ -0,0 +1,30 @@
+# Copyright 2026 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The charmlibs.rollingops package."""
+
+from ._manager import EtcdRollingOpsManager
+from ._models import (
+    OperationResult,
+    RollingOpsEtcdNotConfiguredError,
+    RollingOpsInvalidLockRequestError,
+)
+from ._version import __version__ as __version__
+
+__all__ = (
+    'EtcdRollingOpsManager',
+    'OperationResult',
+    'RollingOpsEtcdNotConfiguredError',
+    'RollingOpsInvalidLockRequestError',
+)