pkgcore 0.12.41__tar.gz → 0.12.43__tar.gz

{pkgcore-0.12.41 → pkgcore-0.12.43}/NEWS.rst

@@ -2,6 +2,84 @@
 Release Notes
 =============
 
+----------------------------
+pkgcore 0.12.43 (2029-09-12)
+----------------------------
+
+Fixes
+~~~~~
+
+- ``pmaint eclass -f devbook``: don't wrap a list item's only paragraph in
+  ``<p>`` (Arthur Zamarin, #485)
+
+- ``pmaint eclass``: ``-q`` no longer swallows errors along with the warnings
+  (Arthur Zamarin)
+
+- ``pmaint eclass``: render an eclass before opening its output file, so only
+  valid results are written (Arthur Zamarin)
+
+- ``pmaint eclass -f devbook``: map reST's admonitions, tables and field lists
+  onto the DevBook elements that match them, and render anything else DevBook
+  can't express as its content alone.  A single eclass reaching for reST beyond
+  DevBook used to abort the whole run (Arthur Zamarin)
+
+- eclass: read eclassdoc prose's hand-written inline code: both
+  ``\`markdown\``` style and GNU ``\`style'`` (Arthur Zamarin)
+
+- eclass: separate an ``@SUBSECTION`` heading from the prose above it, so it
+  renders as a heading (Arthur Zamarin)
+
+----------------------------
+pkgcore 0.12.42 (2026-09-05)
+----------------------------
+
+Features
+~~~~~~~~
+
+- eclass: support the ``@DEAD`` tag, rendering a warning box in the eclass docs
+  (Arthur Zamarin)
+
+- eclass: support the ``@BUGREPORTS:`` tag, replacing the default bug reporting
+  instructions (Arthur Zamarin)
+
+- eclass: support the ``@USER_VARIABLE`` tag on ``@VARIABLE:`` blocks, and
+  label such function variables in the docs (Arthur Zamarin)
+
+- ``pmaint eclass``: report docutils' complaints about eclassdoc through
+  pkgcore's logger, so they name the eclass and are silenced by ``-q``
+  (Arthur Zamarin)
+
+- ``pkgcore.landlock``: new module confining a process to a set of writable
+  paths, with outgoing TCP denied, for use around ebuild sourcing.  Requires
+  ``py-landlock`` and a kernel with Landlock enabled (Arthur Zamarin)
+
+- ``pmaint regen`` now confines itself while regenerating, so a sourced ebuild
+  can only write to the caches being regenerated.  Disable it with
+  ``--sandbox=n``, or require it with ``--sandbox=y`` (Arthur Zamarin)
+
+Fixes
+~~~~~
+
+- resolver: fix ``pmerge`` dying with ``TypeError: It's prohibited to pass
+  unhashable arguments to the WeaklyCached class MutableContainmentRestriction``
+  before it could resolve anything (Arthur Zamarin)
+
+- ``pmaint eclass -f man``: eclassdoc writes its own angle brackets around
+  maintainer and author addresses, and docutils wrapped the recognized address
+  in another pair, rendering ``<<gnu-emacs@gentoo.org>>`` (Arthur Zamarin, #479)
+
+- ``pmaint eclass``: fix escaping of variable values (Arthur Zamarin)
+
+- ``pmaint eclass -f man``: fix ``to_man()`` dropping the eclass blurb from the
+  object rather than from the document (Arthur Zamarin)
+
+- eclass: don't use all-caps for variable types (Ulrich Müller, #481)
+
+- eclass: fix regex for initial var="val" extraction (Ulrich Müller, #483)
+
+- eclass: remove backwards-compat code for ``@ECLASS-VARIABLE`` (Ulrich Müller,
+  #484)
+
 ----------------------------
 pkgcore 0.12.41 (2026-08-30)
 ----------------------------

{pkgcore-0.12.41 → pkgcore-0.12.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pkgcore
-Version: 0.12.41
+Version: 0.12.43
 Summary: package managing framework
 Author-email: Michał Górny <mgorny@gentoo.org>, Tim Harder <radhermit@gmail.com>, Brian Harring <ferringb@gmail.com>, Arthur Zamarin <arthurzam@gentoo.org>, Marien Zwart <marienz@gentoo.org>
 Maintainer-email: Arthur Zamarin <arthurzam@gentoo.org>
@@ -11,12 +11,14 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 License-File: LICENSE
-Requires-Dist: snakeoil >= 0.11.5
+Requires-Dist: snakeoil >= 0.11.6
 Requires-Dist: lxml
+Requires-Dist: py-landlock
 Requires-Dist: sphinx ; extra == "doc"
 Requires-Dist: ruff ; extra == "formatter"
 Requires-Dist: pytest >= 9.0 ; extra == "test"
 Requires-Dist: pytest-cov ; extra == "test"
+Requires-Dist: docutils >= 0.18 ; extra == "test"
 Project-URL: Documentation, https://pkgcore.github.io/pkgcore/
 Project-URL: Homepage, https://github.com/pkgcore/pkgcore
 Project-URL: Source, https://github.com/pkgcore/pkgcore

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/patom.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PATOM" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PATOM" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 patom \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pclean.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PCLEAN" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PCLEAN" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pclean \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pclonecache.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PCLONECACHE" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PCLONECACHE" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pclonecache \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pconfig.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PCONFIG" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PCONFIG" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pconfig \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pebuild.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PEBUILD" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PEBUILD" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pebuild \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pinspect.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PINSPECT" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PINSPECT" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pinspect \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pmaint.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PMAINT" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PMAINT" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pmaint \- Wrapper for running commandline scripts.
 .SH SYNOPSIS
@@ -222,8 +222,8 @@ if a matching pkg already exists in the target, don\(aqt update it
 .EX
 pmaint regen [\-\-domain DOMAIN] [\-h] [\-\-debug] [\-q] [\-v]
              [\-\-color BOOLEAN] [\-\-disable\-eclass\-caching] [\-t THREADS]
-             [\-\-force] [\-\-dir CACHE_DIR] [\-\-rsync] [\-\-use\-local\-desc]
-             [\-\-pkg\-desc\-index]
+             [\-\-force] [\-\-dir CACHE_DIR] [\-\-sandbox BOOLEAN] [\-\-rsync]
+             [\-\-use\-local\-desc] [\-\-pkg\-desc\-index]
              [repo ...]
 .EE
 .UNINDENT
@@ -300,6 +300,14 @@ use separate directory to store repository caches
 .UNINDENT
 .INDENT 0.0
 .TP
+.B \-\-sandbox BOOLEAN
+Confine the run with Landlock where the kernel supports it: writes are
+limited to the caches being regenerated, and outgoing TCP is denied.
+Enabled by default; \(aqy\(aq turns an unsupported kernel into an error
+instead of continuing unconfined, and \(aqn\(aq disables it.
+.UNINDENT
+.INDENT 0.0
+.TP
 .B \-\-rsync
 perform actions necessary for rsync repos (update metadata/timestamp.chk)
 .UNINDENT

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pmerge.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PMERGE" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PMERGE" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pmerge \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/build/sphinx/man/pquery.1

@@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
-.TH "PQUERY" "1" "Aug 30, 2026" "0.12.41" "pkgcore"
+.TH "PQUERY" "1" "Sep 12, 2026" "0.12.43" "pkgcore"
 .SH NAME
 pquery \- Wrapper for running commandline scripts.
 .SH SYNOPSIS

{pkgcore-0.12.41 → pkgcore-0.12.43}/pyproject.toml

@@ -1,7 +1,7 @@
 [build-system]
 requires = [
 	"flit_core >=3.8,<4",
-	"snakeoil >= 0.11.4",
+	"snakeoil >= 0.11.6",
 ]
 build-backend = "py_build"
 backend-path = ["."]
@@ -32,14 +32,16 @@ classifiers = [
 dynamic = ["version"]
 
 dependencies = [
-	"snakeoil >= 0.11.5",
+	"snakeoil >= 0.11.6",
 	"lxml",
+	"py-landlock",
 ]
 
 [project.optional-dependencies]
 test = [
 	"pytest >= 9.0",
 	"pytest-cov",
+	"docutils >= 0.18",
 ]
 doc = [
 	"sphinx",

{pkgcore-0.12.41 → pkgcore-0.12.43}/src/pkgcore/__init__.py

@@ -1,4 +1,4 @@
 __title__ = "pkgcore"
-__version__ = "0.12.41"
-__version_info__ = (0, 12, 41)
+__version__ = "0.12.43"
+__version_info__ = (0, 12, 43)
 __python_mininum_version__ = (3, 12, 0)

pkgcore-0.12.43/src/pkgcore/_verinfo.py

@@ -0,0 +1 @@
+version_info={'rev': '63d9d79a615e07724c782574bca124e68d2bdcbb', 'date': 'Sat Sep 12 11:10:56 2026', 'timestamp': 1789211456, 'tag': '0.12.43', 'commits': 0}

{pkgcore-0.12.41 → pkgcore-0.12.43}/src/pkgcore/ebuild/atom.py

@@ -75,11 +75,6 @@ class atom(boolean.AndRestriction):
         "repo_id",
     )
 
-    klass.inject_richcmp_methods_from_cmp(locals())
-    # hack; combine these 2 metaclasses at some point...
-    locals().pop("__eq__", None)
-    locals().pop("__ne__", None)
-
     # overrided in child class if it's supported
     evaluate_depset = None
 
@@ -429,7 +424,13 @@ class atom(boolean.AndRestriction):
     def __getitem__(self, index):
         return self.restrictions[index]
 
-    def __cmp__(self, other):
+    def _cmp(self, other) -> int:
+        """three way comparison of two atoms
+
+        Covers every attribute of :py:attr:`__attr_comparison__`, so atoms that
+        differ only in subslot or slot operator get a stable order rather than
+        comparing as equal.
+        """
         if not isinstance(other, atom):
             raise TypeError(f"other isn't of {atom!r} type, is {other.__class__}")
 
@@ -464,10 +465,15 @@ class atom(boolean.AndRestriction):
         if c:
             return c
 
-        def f(v):
-            return "" if v is None else v
+        c = cmp(self.slot, other.slot)
+        if c:
+            return c
+
+        c = cmp(self.subslot, other.subslot)
+        if c:
+            return c
 
-        c = cmp(f(self.slot), f(other.slot))
+        c = cmp(self.slot_operator, other.slot_operator)
         if c:
             return c
 
@@ -477,6 +483,18 @@ class atom(boolean.AndRestriction):
 
         return cmp(self.repo_id, other.repo_id)
 
+    def __lt__(self, other) -> bool:
+        return self._cmp(other) < 0
+
+    def __le__(self, other) -> bool:
+        return self._cmp(other) <= 0
+
+    def __gt__(self, other) -> bool:
+        return self._cmp(other) > 0
+
+    def __ge__(self, other) -> bool:
+        return self._cmp(other) >= 0
+
     no_usedeps = klass.alias_attr("get_atom_without_use_deps")
 
     @property

{pkgcore-0.12.41 → pkgcore-0.12.43}/src/pkgcore/ebuild/domain.py

@@ -24,7 +24,7 @@ from snakeoil.cli.exceptions import find_user_exception
 from snakeoil.data_source import local_source
 from snakeoil.log import suppress_logging
 from snakeoil.mappings import ImmutableDict, ProtectedDict
-from snakeoil.sequences import predicate_split, split_negations, stable_unique
+from snakeoil.sequences import predicate_split, split_negations, unique_stable
 
 from ..binpkg import repository as binary_repo
 from ..cache.flat_hash import md5_cache
@@ -301,7 +301,7 @@ class domain(config_domain):
     def system_shell_profile(self, data):
         # prepend system profile $PATH if it exists
         if "PATH" in data:
-            path = stable_unique(
+            path = unique_stable(
                 data["PATH"].split(os.pathsep) + os.environ["PATH"].split(os.pathsep)
             )
             os.environ["PATH"] = os.pathsep.join(path)
@@ -466,25 +466,25 @@ class domain(config_domain):
     def pkg_keywords(self, data, debug=False):
         if debug:
             return tuple(data)
-        return tuple((x[0], stable_unique(x[1])) for x in data)
+        return tuple((x[0], tuple(unique_stable(x[1]))) for x in data)
 
     @load_property("package.accept_keywords", parse_func=restriction_payload_splitter)
     def pkg_accept_keywords(self, data, debug=False):
         if debug:
             return tuple(data)
-        return tuple((x[0], stable_unique(x[1])) for x in data)
+        return tuple((x[0], tuple(unique_stable(x[1]))) for x in data)
 
     @load_property("package.license", parse_func=restriction_payload_splitter)
     def pkg_licenses(self, data, debug=False):
         if debug:
             return tuple(data)
-        return tuple((x[0], stable_unique(x[1])) for x in data)
+        return tuple((x[0], tuple(unique_stable(x[1]))) for x in data)
 
     @load_property("package.use", parse_func=package_use_splitter)
     def pkg_use(self, data, debug=False):
         if debug:
             return tuple(data)
-        return tuple((x[0], split_negations(stable_unique(x[1]))) for x in data)
+        return tuple((x[0], split_negations(unique_stable(x[1]))) for x in data)
 
     @load_property("package.env")
     def pkg_env(self, data, debug=False):

{pkgcore-0.12.41 → pkgcore-0.12.43}/src/pkgcore/ebuild/eapi.py

@@ -12,7 +12,7 @@ from snakeoil import klass
 from snakeoil.delayed import regexp
 from snakeoil.klass import immutable
 from snakeoil.mappings import ImmutableDict, OrderedFrozenSet, inject_getitem_as_getattr
-from snakeoil.sequences import stable_unique
+from snakeoil.sequences import unique_stable
 
 from ..log import logger
 from ..spawn import bash_version
@@ -488,7 +488,7 @@ class EAPI(immutable.Strict):
                         paths[phase].append(dirpath)
                     else:
                         raise ValueError(f"unknown phase: {phase!r}")
-        return ImmutableDict((k, tuple(stable_unique(v))) for k, v in paths.items())
+        return ImmutableDict((k, tuple(unique_stable(v))) for k, v in paths.items())
 
     @klass.jit_attr
     def ebd_env(self):