github3-utils 0.6.1__tar.gz → 0.7.1__tar.gz

{github3_utils-0.6.1 → github3_utils-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: github3-utils
-Version: 0.6.1
+Version: 0.7.1
 Summary: Handy utilities for github3.py
 Author-email: Dominic Davis-Foster <dominic@davis-foster.co.uk>
 License: MIT
@@ -22,20 +22,22 @@ Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.6
-Requires-Dist: apeye>=0.5.1
+Requires-Dist: apeye-core>=1.0.0
 Requires-Dist: attrs>=20.3.0
 Requires-Dist: click>=7.1.2
-Requires-Dist: cryptography==3.3.2; platform_system != "Linux" and platform_python_implementation != "CPython"
+Requires-Dist: cryptography<40; implementation_name == "pypy" and python_version <= "3.7"
 Requires-Dist: domdf-python-tools>=1.1.0
 Requires-Dist: github3-py>=1.3.0
 Requires-Dist: pynacl>=1.4.0
 Requires-Dist: requests>=2.25.1
-Requires-Dist: typing-extensions>=3.7.4.3
+Requires-Dist: typing-extensions!=3.10.0.1,>=3.10.0.0
 Requires-Dist: betamax>=0.8.1; extra == 'testing'
 Requires-Dist: pytest>=6.0.0; extra == 'testing'
 Requires-Dist: betamax>=0.8.1; extra == 'all'
@@ -105,8 +107,8 @@ github3-utils
 	:target: https://github.com/domdfcoding/github3-utils/actions?query=workflow%3A%22mypy%22
 	:alt: mypy status
 
-.. |requires| image:: https://dependency-dash.herokuapp.com/github/domdfcoding/github3-utils/badge.svg
-	:target: https://dependency-dash.herokuapp.com/github/domdfcoding/github3-utils/
+.. |requires| image:: https://dependency-dash.repo-helper.uk/github/domdfcoding/github3-utils/badge.svg
+	:target: https://dependency-dash.repo-helper.uk/github/domdfcoding/github3-utils/
 	:alt: Requirements Status
 
 .. |coveralls| image:: https://img.shields.io/coveralls/github/domdfcoding/github3-utils/master?logo=coveralls
@@ -148,7 +150,7 @@ github3-utils
 .. |language| image:: https://img.shields.io/github/languages/top/domdfcoding/github3-utils
 	:alt: GitHub top language
 
-.. |commits-since| image:: https://img.shields.io/github/commits-since/domdfcoding/github3-utils/v0.6.1
+.. |commits-since| image:: https://img.shields.io/github/commits-since/domdfcoding/github3-utils/v0.7.1
 	:target: https://github.com/domdfcoding/github3-utils/pulse
 	:alt: GitHub commits since tagged version
 
@@ -156,7 +158,7 @@ github3-utils
 	:target: https://github.com/domdfcoding/github3-utils/commit/master
 	:alt: GitHub last commit
 
-.. |maintained| image:: https://img.shields.io/maintenance/yes/2022
+.. |maintained| image:: https://img.shields.io/maintenance/yes/2023
 	:alt: Maintenance
 
 .. |pypi-downloads| image:: https://img.shields.io/pypi/dm/github3-utils

{github3_utils-0.6.1 → github3_utils-0.7.1}/README.rst

@@ -58,8 +58,8 @@ github3-utils
 	:target: https://github.com/domdfcoding/github3-utils/actions?query=workflow%3A%22mypy%22
 	:alt: mypy status
 
-.. |requires| image:: https://dependency-dash.herokuapp.com/github/domdfcoding/github3-utils/badge.svg
-	:target: https://dependency-dash.herokuapp.com/github/domdfcoding/github3-utils/
+.. |requires| image:: https://dependency-dash.repo-helper.uk/github/domdfcoding/github3-utils/badge.svg
+	:target: https://dependency-dash.repo-helper.uk/github/domdfcoding/github3-utils/
 	:alt: Requirements Status
 
 .. |coveralls| image:: https://img.shields.io/coveralls/github/domdfcoding/github3-utils/master?logo=coveralls
@@ -101,7 +101,7 @@ github3-utils
 .. |language| image:: https://img.shields.io/github/languages/top/domdfcoding/github3-utils
 	:alt: GitHub top language
 
-.. |commits-since| image:: https://img.shields.io/github/commits-since/domdfcoding/github3-utils/v0.6.1
+.. |commits-since| image:: https://img.shields.io/github/commits-since/domdfcoding/github3-utils/v0.7.1
 	:target: https://github.com/domdfcoding/github3-utils/pulse
 	:alt: GitHub commits since tagged version
 
@@ -109,7 +109,7 @@ github3-utils
 	:target: https://github.com/domdfcoding/github3-utils/commit/master
 	:alt: GitHub last commit
 
-.. |maintained| image:: https://img.shields.io/maintenance/yes/2022
+.. |maintained| image:: https://img.shields.io/maintenance/yes/2023
 	:alt: Maintenance
 
 .. |pypi-downloads| image:: https://img.shields.io/pypi/dm/github3-utils

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/__init__.py

@@ -2,7 +2,7 @@
 #
 #  __init__.py
 """
-Handy utilities for `github3.py <https://github3py.readthedocs.io/en/master/>`_.
+Handy utilities for `github3.py <https://github3.readthedocs.io/en/latest/>`_.
 """
 #
 #  Copyright © 2020 Dominic Davis-Foster <dominic@davis-foster.co.uk>
@@ -60,7 +60,7 @@ from typing import Iterable, Iterator, List, Optional, Union, overload
 
 # 3rd party
 import attr
-from apeye import URL
+from apeye_core import URL
 from click import echo
 from github3 import GitHub
 from github3.orgs import Organization
@@ -70,15 +70,15 @@ from github3.users import User
 from typing_extensions import Literal
 
 # this package
-from github3_utils.headers import LUKE_CAKE
+from github3_utils.headers import LUKE_CAGE
 
 __author__: str = "Dominic Davis-Foster"
 __copyright__: str = "2020 Dominic Davis-Foster"
 __license__: str = "MIT License"
-__version__: str = "0.6.1"
+__version__: str = "0.7.1"
 __email__: str = "dominic@davis-foster.co.uk"
 
-__all__ = [
+__all__ = (
 		"RateLimitExceeded",
 		"echo_rate_limit",
 		"get_user",
@@ -86,7 +86,7 @@ __all__ = [
 		"Impersonate",
 		"get_repos",
 		"iter_repos",
-		]
+		)
 
 
 class RateLimitExceeded(RuntimeError):
@@ -179,7 +179,7 @@ def protect_branch(branch: Branch, status_checks: Optional[List[str]] = None) ->
 	resp = branch._put(
 			str(URL(branch._api) / "protection"),
 			json=edit,
-			headers=LUKE_CAKE,
+			headers=LUKE_CAGE,
 			)
 
 	if branch._boolean(resp, 200, 404):
@@ -305,6 +305,7 @@ def iter_repos(
 	:param orgs: An iterable of organization names to fetch the repositories for.
 	"""
 
+	# pylint: disable=loop-invariant-statement
 	for user in users:
 		_user: Optional[User] = github.user(user)
 		if _user is None:
@@ -319,3 +320,4 @@ def iter_repos(
 			raise ValueError(f"No such organization {org}")
 
 		yield from get_repos(_org, full=False)
+	# pylint: enable=loop-invariant-statement

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/apps.py

@@ -41,7 +41,7 @@ from typing_extensions import Literal
 # this package
 from github3_utils.headers import MACHINE_MAN
 
-__all__ = ["ContextSwitcher", "iter_installed_repos", "make_footer_links"]
+__all__ = ("ContextSwitcher", "iter_installed_repos", "make_footer_links")
 
 
 @attr.s
@@ -127,6 +127,8 @@ def iter_installed_repos(
 	:param private_key_pem: The bytes of the private key for this GitHub App.
 	:param app_id: The integer identifier for this GitHub App.
 
+	.. latex:clearpage::
+
 	Either ``context_switcher`` or all of ``client``, ``private_key_pem`` and ``app_id`` must be provided.
 	"""
 

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/check_labels.py

@@ -42,7 +42,7 @@ from github3.pulls import PullRequest, ShortPullRequest
 from github3.repos import Repository
 from github3.repos.commit import ShortCommit
 
-__all__ = ["Label", "check_status_labels", "Checks", "get_checks_for_pr", "label_pr_failures"]
+__all__ = ("Label", "check_status_labels", "Checks", "get_checks_for_pr", "label_pr_failures")
 
 
 @prettify_docstrings
@@ -133,6 +133,7 @@ def get_checks_for_pr(pull: Union[PullRequest, ShortPullRequest]) -> Checks:
 	check_run: CheckRun
 	for check_run in head_commit.check_runs():
 
+		# pylint: disable=loop-invariant-statement
 		if check_run.status in {"queued", "running", "in_progress"}:
 			running.add(check_run.name)
 		elif check_run.conclusion in {"failure", "cancelled", "timed_out", "action_required"}:
@@ -143,6 +144,7 @@ def get_checks_for_pr(pull: Union[PullRequest, ShortPullRequest]) -> Checks:
 			skipped.add(check_run.name)
 		elif check_run.conclusion == "neutral":
 			neutral.add(check_run.name)
+		# pylint: enable=loop-invariant-statement
 
 	# Remove failing checks from successful etc. (as all checks appear twice for PRs)
 	successful = successful - failing - running
@@ -178,9 +180,10 @@ def label_pr_failures(pull: Union[PullRequest, ShortPullRequest]) -> Set[str]:
 
 	def determine_labels(from_: Set[str], to: Set[str]) -> None:
 		for check in from_:
-			if _python_dev_re.match(check):
+			if _python_dev_re.match(check):  # pylint: disable=loop-global-usage
 				continue
 
+			# pylint: disable=loop-invariant-statement
 			if check in {"Flake8", "docs"}:
 				to.add(f"failure: {check.lower()}")
 			elif check.startswith("mypy"):
@@ -189,6 +192,7 @@ def label_pr_failures(pull: Union[PullRequest, ShortPullRequest]) -> Set[str]:
 				to.add("failure: Linux")
 			elif check.startswith("windows"):
 				to.add("failure: Windows")
+			# pylint: enable=loop-invariant-statement
 
 	determine_labels(pr_checks.failing, failure_labels)
 	determine_labels(pr_checks.successful, success_labels)

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/click.py

@@ -34,7 +34,7 @@ from typing import Callable, TypeVar
 # 3rd party
 import click
 
-__all__ = ["token_option"]
+__all__ = ("token_option", )
 
 _C = TypeVar("_C", bound=click.Command)
 

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/headers.py

@@ -28,7 +28,8 @@ GitHub-specific custom HTTP headers.
 #  OR OTHER DEALINGS IN THE SOFTWARE.
 #
 
-__all__ = ["LUKE_CAKE", "MACHINE_MAN"]
+__all__ = ("LUKE_CAGE", "MACHINE_MAN")
 
-LUKE_CAKE = {"Accept": "application/vnd.github.luke-cage-preview+json"}
+# There was a typo. It used to say LUKE_CAKE. Keep the old name to avoid breakage.
+LUKE_CAKE = LUKE_CAGE = {"Accept": "application/vnd.github.luke-cage-preview+json"}
 MACHINE_MAN = {"Accept": "application/vnd.github.machine-man-preview+json"}

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/secrets.py

@@ -31,22 +31,20 @@ from base64 import b64encode
 from typing import List
 
 # 3rd party
-from apeye import URL
+from apeye_core import URL
 from github3.repos import Repository
 from nacl import encoding, public
 from requests import Response
+from typing_extensions import TypedDict
 
-# this package
-from github3_utils._typing import make_typed_dict
-
-__all__ = [
+__all__ = (
 		"build_secrets_url",
 		"encrypt_secret",
 		"get_public_key",
 		"get_secrets",
 		"set_secret",
 		"PublicKey",
-		]
+		)
 
 
 def build_secrets_url(repo: Repository) -> URL:
@@ -63,7 +61,7 @@ def build_secrets_url(repo: Repository) -> URL:
 	return URL(repo._build_url("actions/secrets", base_url=repo._api))
 
 
-_PublicKey = make_typed_dict("_PublicKey", {"ETag": str, "Last-Modified": str}, total=False)
+_PublicKey = TypedDict("_PublicKey", {"ETag": str, "Last-Modified": str}, total=False)
 
 
 class PublicKey(_PublicKey):

{github3_utils-0.6.1 → github3_utils-0.7.1}/github3_utils/testing.py

@@ -51,7 +51,7 @@ from _pytest.fixtures import FixtureRequest  # nodep
 from betamax import Betamax  # type: ignore[import]  # nodep
 from github3 import GitHub
 
-__all__ = ["cassette", "github_client", "module_cassette"]
+__all__ = ("cassette", "github_client", "module_cassette")
 
 
 @pytest.fixture()

{github3_utils-0.6.1 → github3_utils-0.7.1}/pyproject.toml

@@ -4,21 +4,21 @@ build-backend = "whey"
 
 [project]
 name = "github3-utils"
-version = "0.6.1"
+version = "0.7.1"
 description = "Handy utilities for github3.py"
 readme = "README.rst"
 keywords = [ "github",]
 dynamic = []
 dependencies = [
-    "apeye>=0.5.1",
+    "apeye-core>=1.0.0",
     "attrs>=20.3.0",
     "click>=7.1.2",
-    'cryptography==3.3.2; platform_system != "Linux" and platform_python_implementation != "CPython"',
+    'cryptography<40; implementation_name == "pypy" and python_version <= "3.7"',
     "domdf-python-tools>=1.1.0",
     "github3-py>=1.3.0",
     "pynacl>=1.4.0",
     "requests>=2.25.1",
-    "typing-extensions>=3.7.4.3",
+    "typing-extensions!=3.10.0.1,>=3.10.0.0",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -27,6 +27,8 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.6",
     "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
@@ -63,7 +65,7 @@ base-classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
 ]
-python-versions = [ "3.6", "3.7", "3.8", "3.9",]
+python-versions = [ "3.6", "3.7", "3.8", "3.9", "3.10", "3.11",]
 python-implementations = [ "CPython", "PyPy",]
 platforms = [ "Windows", "macOS", "Linux",]
 license-key = "MIT"
@@ -90,6 +92,7 @@ extensions = [
     "sphinx_toolbox.more_autosummary",
     "sphinx_toolbox.documentation_summary",
     "sphinx_toolbox.tweaks.param_dash",
+    "sphinxcontrib.toctree_plus",
     "sphinx_toolbox.tweaks.latex_layout",
     "sphinx_toolbox.tweaks.latex_toc",
     "sphinx.ext.intersphinx",
@@ -100,7 +103,6 @@ extensions = [
     "notfound.extension",
     "sphinx_copybutton",
     "sphinxcontrib.default_values",
-    "sphinxcontrib.toctree_plus",
     "sphinx_debuginfo",
     "sphinx_licenseinfo",
     "seed_intersphinx_mapping",
@@ -108,8 +110,7 @@ extensions = [
     "attr_utils.autoattrs",
     "attr_utils.annotations",
     "sphinx_autofixture",
-    "sphinx_toolbox_experimental.autosummary_widths",
-    "sphinx_toolbox_experimental.needspace",
+    "sphinx_toolbox.more_autosummary.column_widths",
 ]
 sphinxemoji_style = "twemoji"
 gitstamp_fmt = "%d %b %Y"
@@ -161,7 +162,7 @@ autodoc_exclude_members = [
 ]
 
 [tool.mypy]
-python_version = "3.6"
+python_version = "3.8"
 namespace_packages = true
 check_untyped_defs = true
 warn_unused_ignores = true

github3_utils-0.7.1/requirements.txt

@@ -0,0 +1,9 @@
+apeye-core>=1.0.0
+attrs>=20.3.0
+click>=7.1.2
+cryptography<40; implementation_name == "pypy" and python_version <= "3.7"
+domdf-python-tools>=1.1.0
+github3-py>=1.3.0
+pynacl>=1.4.0
+requests>=2.25.1
+typing-extensions!=3.10.0.1,>=3.10.0.0

github3_utils-0.6.1/github3_utils/_typing.py

@@ -1,54 +0,0 @@
-# stdlib
-import sys
-
-__all__ = ["make_typed_dict"]
-
-if sys.version_info > (3, 9):  # pragma: no cover (<py39)
-	# stdlib
-	from typing import TypedDict
-
-	make_typed_dict = TypedDict
-
-else:  # pragma: no cover (py39+)
-	# 3rd party
-	from typing_extensions import _TypedDictMeta
-
-	def make_typed_dict(typename, *args, total=True, **kwargs):  # pragma: no cover
-		"""
-		Create a TypedDict.
-
-		Temporary fix until https://github.com/python/typing/issues/761 is merged.
-
-		:param typename:
-		:param args:
-		:param total:
-		:param kwargs:
-		"""
-
-		# From CPython
-		# PSF Licensed
-		# Copyright Python Software Foundation
-
-		if args:
-			try:
-				fields, = args  # allow the "_fields" keyword be passed
-			except ValueError:
-				raise TypeError(
-						f'TypedDict.__new__() takes from 2 to 3 positional arguments but {len(args) + 2} were given'
-						)
-		else:
-			raise TypeError("TypedDict.__new__(): not enough arguments")
-
-		if fields is None:
-			fields = kwargs
-		elif kwargs:
-			raise TypeError("TypedDict takes either a dict or keyword arguments, but not both")
-
-		ns = {"__annotations__": dict(fields), "__total__": total}
-		try:
-			# Setting correct module is necessary to make typed dict classes pickleable.
-			ns["__module__"] = sys._getframe(1).f_globals.get("__name__", "__main__")
-		except (AttributeError, ValueError):
-			pass
-
-		return _TypedDictMeta(typename, (), ns, total=total)

github3_utils-0.6.1/github3_utils/_typing.pyi

@@ -1,4 +0,0 @@
-__all__ = ["make_typed_dict"]
-
-# 3rd party
-from typing_extensions import TypedDict as make_typed_dict

github3_utils-0.6.1/requirements.txt

@@ -1,9 +0,0 @@
-apeye>=0.5.1
-attrs>=20.3.0
-click>=7.1.2
-cryptography==3.3.2; platform_system != "Linux" and platform_python_implementation != "CPython"
-domdf-python-tools>=1.1.0
-github3-py>=1.3.0
-pynacl>=1.4.0
-requests>=2.25.1
-typing-extensions>=3.7.4.3