dependence 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

dependence/_utilities.py

@@ -1,12 +1,32 @@
+import os
 import sys
 from functools import lru_cache
 from itertools import chain
+from subprocess import check_output as _check_output
+from tempfile import mktemp
 from traceback import format_exception
-from typing import Any, Dict, Hashable, Iterable, List, Set
+from typing import Any, Dict, Hashable, Iterable, List, Set, Tuple
 
 import tomli
 
 
+def check_output(command: Tuple[str, ...]) -> str:
+    """
+    This function wraps `subprocess.check_output`, but redirects stderr
+    to a temporary file, then deletes that file (a platform-independent
+    means of redirecting output to DEVNULL).
+
+    Parameters:
+
+    - command (Tuple[str, ...]): The command to run
+    """
+    stderr_path: str = mktemp()
+    with open(stderr_path, "w") as stderr:
+        output = _check_output(command, stderr=stderr, text=True)
+    os.remove(stderr_path)
+    return output
+
+
 def iter_distinct(items: Iterable[Hashable]) -> Iterable:
     """
     Yield distinct elements, preserving order

dependence/freeze.py

@@ -221,7 +221,6 @@ def _iter_frozen_requirements(
             )
         ),
     )
-
     requirements = map(get_requirement_string, requirements)
     return requirements
 

dependence/utilities.py

@@ -13,11 +13,12 @@ from itertools import chain
 from pathlib import Path
 from runpy import run_path
 from shutil import move, rmtree
-from subprocess import CalledProcessError, check_call, check_output
+from subprocess import CalledProcessError
 from tempfile import mkdtemp
 from types import ModuleType
 from typing import (
     IO,
+    AbstractSet,
     Any,
     Container,
     Dict,
@@ -37,6 +38,7 @@ from packaging.utils import canonicalize_name
 
 from ._utilities import (
     append_exception_text,
+    check_output,
     get_exception_text,
     iter_distinct,
 )
@@ -336,9 +338,28 @@ def _iter_setup_cfg_requirement_strings(path: str) -> Iterable[str]:
     return iter_distinct(requirement_strings)
 
 
-def _iter_tox_ini_requirement_strings(path: str) -> Iterable[str]:
+def _iter_tox_ini_requirement_strings(
+    path: Union[str, Path, ConfigParser] = "",
+    string: str = "",
+) -> Iterable[str]:
+    """
+    Parse a tox.ini file and yield the requirements found in the `deps`
+    options of each section.
+
+    Parameters:
+
+    - path (str|Path) = "": The path to a tox.ini file
+    - string (str) = "": The contents of a tox.ini file
+    """
     parser: ConfigParser = ConfigParser()
-    parser.read(path)
+    if path:
+        assert (
+            not string
+        ), "Either `path` or `string` arguments may be provided, but not both"
+        parser.read(path)
+    else:
+        assert string, "Either a `path` or `string` argument must be provided"
+        parser.read_string(string)
 
     def get_section_option_requirements(
         section_name: str, option_name: str
@@ -366,27 +387,112 @@ def _iter_tox_ini_requirement_strings(path: str) -> Iterable[str]:
     )
 
 
-def _iter_pyproject_toml_requirement_strings(path: str) -> Iterable[str]:
+def _iter_pyproject_toml_requirement_strings(
+    path: str,
+    exclude_build_system: bool = False,
+    exclude_project: bool = False,
+    exclude_project_dependencies: bool = False,
+    exclude_project_optional_dependencies: bool = False,
+    include_project_optional_dependencies: Iterable[str] = frozenset(),
+    exclude_tools: bool = False,
+    exclude_tox: bool = False,
+) -> Iterable[str]:
+    """
+    Read a pyproject.toml file and yield the requirements found.
+
+    - exclude_build_system (bool) = False: If `True`, build-system
+      requirements will not be included
+    - exclude_project (bool) = False: If `True`, build-system
+      requirements will not be included
+    - exclude_project_dependencies (bool) = False: If `True`, project
+      dependencies will not be included
+    - exclude_project_optional_dependencies (bool) = False: If `True`, project
+      optional dependencies will not be included
+    - include_project_optional_dependencies ({str}) = frozenset(): If a
+      non-empty set is provided, *only* dependencies for the specified extras
+      (options) will be included
+    - exclude_tools (bool) = False: If `True`, tool requirements will not be
+      included
+    - exclude_tox (bool) = False: If `True`, tool.tox dependencies will not be
+      included
+    """
+    include_project_optional_dependencies = (
+        include_project_optional_dependencies
+        if isinstance(include_project_optional_dependencies, set)
+        else frozenset(include_project_optional_dependencies)
+    )
     pyproject_io: IO[str]
     with open(path) as pyproject_io:
         pyproject: Dict[str, Any] = tomli.loads(pyproject_io.read())
-        if ("build-system" in pyproject) and (
-            "requires" in pyproject["build-system"]
+        # Build system requirements
+        if (
+            ("build-system" in pyproject)
+            and ("requires" in pyproject["build-system"])
+            and not exclude_build_system
         ):
             yield from pyproject["build-system"]["requires"]
-        if ("project" in pyproject) and (
-            "dependencies" in pyproject["project"]
-        ):
-            yield from pyproject["project"]["dependencies"]
-        if "project.optional-dependencies" in pyproject:
-            values: Iterable[str]
-            for values in pyproject["project.optional-dependencies"].values():
-                yield from values
+        # Project requirements
+        if ("project" in pyproject) and not exclude_project:
+            if (
+                "dependencies" in pyproject["project"]
+            ) and not exclude_project_dependencies:
+                yield from pyproject["project"]["dependencies"]
+            if (
+                "optional-dependencies" in pyproject["project"]
+            ) and not exclude_project_optional_dependencies:
+                key: str
+                values: Iterable[str]
+                for key, values in pyproject["project"][
+                    "optional-dependencies"
+                ].items():
+                    if (not include_project_optional_dependencies) or (
+                        key in include_project_optional_dependencies
+                    ):
+                        yield from values
+        # Tool Requirements
+        if ("tool" in pyproject) and not exclude_tools:
+            # Tox
+            if ("tox" in pyproject["tool"]) and not exclude_tox:
+                if "legacy_tox_ini" in pyproject["tool"]["tox"]:
+                    yield from _iter_tox_ini_requirement_strings(
+                        string=pyproject["tool"]["tox"]["legacy_tox_ini"]
+                    )
 
 
-def iter_configuration_file_requirement_strings(path: str) -> Iterable[str]:
+def iter_configuration_file_requirement_strings(
+    path: str,
+    exclude_build_system: bool = False,
+    exclude_project: bool = False,
+    exclude_project_dependencies: bool = False,
+    exclude_project_optional_dependencies: bool = False,
+    include_project_optional_dependencies: AbstractSet[str] = frozenset(),
+    exclude_tools: bool = False,
+    exclude_tox: bool = False,
+) -> Iterable[str]:
     """
     Read a configuration file and yield the parsed requirements.
+
+    Parameters:
+
+    - path (str): The path to a configuration file
+
+    Parameters only applicable to `pyproject.toml` files:
+
+    - exclude_build_system (bool) = False: If `True`, build-system
+      requirements will not be included
+    - exclude_project (bool) = False: If `True`, build-system
+      requirements will not be included
+    - exclude_project_dependencies (bool) = False: If `True`, project
+      dependencies will not be included
+    - exclude_project_optional_dependencies (bool) = False: If `True`, project
+      optional dependencies will not be included
+    - include_project_optional_dependencies ({str}) = frozenset(): If a
+      non-empty set is provided, *only* dependencies for the specified extras
+      (options) will be included
+    - exclude_tools (bool) = False: If `True`, tool requirements will not be
+      included
+    - exclude_tox (bool) = False: If `True`, tool.tox dependencies will not be
+      included
     """
     configuration_file_type: ConfigurationFileType = (
         get_configuration_file_type(path)
@@ -394,9 +500,22 @@ def iter_configuration_file_requirement_strings(path: str) -> Iterable[str]:
     if configuration_file_type == ConfigurationFileType.SETUP_CFG:
         return _iter_setup_cfg_requirement_strings(path)
     elif configuration_file_type == ConfigurationFileType.PYPROJECT_TOML:
-        return _iter_pyproject_toml_requirement_strings(path)
+        return _iter_pyproject_toml_requirement_strings(
+            path,
+            exclude_build_system=exclude_build_system,
+            exclude_project=exclude_project,
+            exclude_project_dependencies=exclude_project_dependencies,
+            exclude_project_optional_dependencies=(
+                exclude_project_optional_dependencies
+            ),
+            include_project_optional_dependencies=(
+                include_project_optional_dependencies
+            ),
+            exclude_tools=exclude_tools,
+            exclude_tox=exclude_tox,
+        )
     elif configuration_file_type == ConfigurationFileType.TOX_INI:
-        return _iter_tox_ini_requirement_strings(path)
+        return _iter_tox_ini_requirement_strings(path=path)
     else:
         assert (
             configuration_file_type == ConfigurationFileType.REQUIREMENTS_TXT
@@ -451,13 +570,7 @@ def _get_setup_py_metadata(path: str, args: Tuple[str, ...]) -> str:
         if os.path.isfile(path):
             command: Tuple[str, ...] = (sys.executable, path) + args
             try:
-                value = (
-                    check_output(
-                        command, encoding="utf-8", universal_newlines=True
-                    )
-                    .strip()
-                    .split("\n")[-1]
-                )
+                value = check_output(command).strip().split("\n")[-1]
             except CalledProcessError:
                 warn(
                     f"A package name could not be found in {path}, "
@@ -467,13 +580,7 @@ def _get_setup_py_metadata(path: str, args: Tuple[str, ...]) -> str:
                 # re-write egg info and attempt to get the name again
                 setup_egg_info(directory)
                 try:
-                    value = (
-                        check_output(
-                            command, encoding="utf-8", universal_newlines=True
-                        )
-                        .strip()
-                        .split("\n")[-1]
-                    )
+                    value = check_output(command).strip().split("\n")[-1]
                 except Exception:
                     warn(
                         f"A package name could not be found in {path}"
@@ -707,7 +814,7 @@ def _install_requirement_string(
         if editable:
             flags += ("-e",)
         try:
-            check_call(
+            check_output(
                 (
                     sys.executable,
                     "-m",

{dependence-0.3.0.dist-info → dependence-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dependence
-Version: 0.3.0
+Version: 0.3.1
 Summary: Requirement (dependency) management for python projects
 Home-page: https://github.com/enorganic/dependence
 Author-email: david@belais.me

dependence-0.3.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+dependence/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dependence/__main__.py,sha256=myBIBZdez2jC3_dkVSE-mOLo39yKi2cF_0NuVXcXF1E,1528
+dependence/_utilities.py,sha256=3fhceJ3yNRLp3HsDxvIEFZsjRlemEQ6oOF7Wx1jaRhQ,3296
+dependence/freeze.py,sha256=6sP-z-BIwOzF7JgnUD134gu4711-LY-zaQ26yPdq5JE,13298
+dependence/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dependence/update.py,sha256=FRl0FsdAIfjWacw1cVS8Fh024ZN7hK3ZHJiQpsRinfQ,16571
+dependence/utilities.py,sha256=DwYIFlS5h9B-wrycsntZsOtmuMped0Eyra9ZFmnCxwU,36201
+dependence-0.3.1.dist-info/METADATA,sha256=V2-5Ce3KwhYzl31JGftABxvlRDV42Y3ahZbvgvfoqK4,5597
+dependence-0.3.1.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
+dependence-0.3.1.dist-info/entry_points.txt,sha256=NStO_B0D81ObVYr9zDs6LCy0whm0a8KCiiFHMmTwOVE,56
+dependence-0.3.1.dist-info/top_level.txt,sha256=5rooMYWKlAUelE8hjGegbf4uuAIqNuRlhlpA7oc7Qro,11
+dependence-0.3.1.dist-info/RECORD,,

{dependence-0.3.0.dist-info → dependence-0.3.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.3.0)
+Generator: setuptools (71.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

dependence-0.3.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-dependence/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dependence/__main__.py,sha256=myBIBZdez2jC3_dkVSE-mOLo39yKi2cF_0NuVXcXF1E,1528
-dependence/_utilities.py,sha256=txNRK5Y7Dd7w8-qG7wGmS6mrAcGvy73DIjAHswW4glA,2684
-dependence/freeze.py,sha256=kGT1Kjr7QeKMqXEO03cg4CD4s_rOc3khjJla_822gOk,13299
-dependence/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dependence/update.py,sha256=FRl0FsdAIfjWacw1cVS8Fh024ZN7hK3ZHJiQpsRinfQ,16571
-dependence/utilities.py,sha256=8QdX2_O-Qdc-dh-qpi76KuykEROpvKZrApNOzOTaO8I,31816
-dependence-0.3.0.dist-info/METADATA,sha256=Yzr2gGfOu3qEQ9pCgIaAUFqWvB6cU0N8GHzG8JmEIac,5597
-dependence-0.3.0.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
-dependence-0.3.0.dist-info/entry_points.txt,sha256=NStO_B0D81ObVYr9zDs6LCy0whm0a8KCiiFHMmTwOVE,56
-dependence-0.3.0.dist-info/top_level.txt,sha256=5rooMYWKlAUelE8hjGegbf4uuAIqNuRlhlpA7oc7Qro,11
-dependence-0.3.0.dist-info/RECORD,,