Updated files with 'repo_helper'.

Author: domdfcoding

.github/workflows/docs_test_action.yml

@@ -14,6 +14,6 @@ jobs:
       - name: Install and Build 🔧
         uses: ammaraskar/sphinx-action@master
         with:
-          pre-build-command: apt-get update && apt-get install gcc python3-dev -y && python -m pip install tox
+          pre-build-command: apt-get update && apt-get install gcc python3-dev git -y && python -m pip install tox
           docs-folder: "doc-source/"
           build-command: "tox -e docs -- "

.github/workflows/python_ci.yml

@@ -12,12 +12,12 @@ jobs:
     name: "Python ${{ matrix.python-version }}"
     runs-on: "windows-2019"
     env:
-      USING_COVERAGE: '3.6,3.7,3.8,3.9-dev,pypy3'
+      USING_COVERAGE: '3.6,3.7,3.8,pypy3'
 
     strategy:
       fail-fast: False
       matrix:
-        python-version: ["3.6","3.7","3.8","3.9-dev","pypy3"]
+        python-version: ["3.6","3.7","3.8","pypy3"]
 
 
     steps:

.github/workflows/python_ci_macos.yml

@@ -12,12 +12,12 @@ jobs:
     name: "Python ${{ matrix.python-version }}"
     runs-on: "macos-latest"
     env:
-      USING_COVERAGE: '3.6,3.7,3.8,3.9-dev,pypy3'
+      USING_COVERAGE: '3.6,3.7,3.8,pypy3'
 
     strategy:
       fail-fast: False
       matrix:
-        python-version: ["3.6","3.7","3.8","3.9-dev","pypy3"]
+        python-version: ["3.6","3.7","3.8","pypy3"]
 
 
     steps:

.isort.cfg

@@ -18,9 +18,9 @@ known_third_party =
     flake8
     github
     pytest
-    pytest-cov
-    pytest-randomly
-    pytest-rerunfailures
+    pytest_cov
+    pytest_randomly
+    pytest_rerunfailures
     requests
 known_first_party = flake8_sphinx_links
 remove_redundant_aliases = True

.pre-commit-config.yaml

@@ -22,48 +22,40 @@ repos:
     - id: mixed-line-ending
 
  - repo: https://github.com/domdfcoding/pre-commit-hooks
-   rev: v0.0.2
+   rev: v0.0.4
    hooks:
     - id: requirements-txt-sorter
+      args: [--allow-git]
     - id: check-docstring-first
+      exclude: ^(doc-source/conf|__pkginfo__|make_conda_recipe|setup|tests/.*)\.py$
+    - id: bind-requirements
+
+ - repo: https://github.com/domdfcoding/flake8-dunder-all
+   rev: v0.0.4
+   hooks:
+    - id: ensure-dunder-all
+      files: ^flake8_sphinx_links/.*\.py$
 
  - repo: https://github.com/pre-commit/pygrep-hooks
    rev: v1.5.1
    hooks:
     - id: python-no-eval
-    - id: python-use-type-annotations
 
  - repo: https://github.com/asottile/pyupgrade
    rev: v1.5.1
    hooks:
     - id: pyupgrade
       args: [--py36-plus]
 
- - repo: https://github.com/timothycrosley/isort
-   rev: 5.1.4
-   hooks:
-    - id: isort
-      exclude: ^(doc-source/conf|__pkginfo__|make_conda_recipe|setup)\.py$
-
- - repo: https://github.com/pre-commit/mirrors-yapf
-   rev: v0.30.0
-   hooks:
-    - id: yapf
-      exclude: ^(doc-source/conf|__pkginfo__|make_conda_recipe|setup)\.py$
-      args: ["--in-place"]
-
  - repo: https://github.com/Lucas-C/pre-commit-hooks
    rev: v1.1.7
    hooks:
     - id: forbid-crlf
     - id: remove-crlf
 
-# - repo: https://github.com/shellcheck-py/shellcheck-py
-#   rev: v0.7.1.1
-#   hooks:
-#    - id: shellcheck
 
-# - repo: https://github.com/adrienverge/yamllint
-#   rev: v1.23.0
-#   hooks:
-#    - id: yamllint
+ - repo: https://github.com/domdfcoding/yapf-isort
+   rev: v0.3.0
+   hooks:
+    - id: yapf-isort
+      exclude: ^(doc-source/conf|__pkginfo__|make_conda_recipe|setup)\.py$

.travis.yml

@@ -2,7 +2,7 @@
 ---
 
 language: python
-dist: xenial
+dist: focal
 cache: pip
 python:
   - '3.6'
@@ -11,6 +11,7 @@ python:
   - '3.9-dev'
   - 'pypy3'
 
+arch: amd64
 install:
 
   - pip install --upgrade pip
@@ -31,6 +32,14 @@ stages:
 
 jobs:
   include:
+    - stage: test
+      dist: bionic
+      python: 3.8
+
+    - stage: test
+      arch: arm64
+      python: 3.8
+
     - stage: deploy_pypi
       python: "3.6"
       script: skip
@@ -56,7 +65,5 @@ jobs:
         - chmod +x .ci/travis_deploy_conda.sh
       script: skip
       deploy:
-        on:
-          repo: domdfcoding/flake8-sphinx-links
         provider: script
         script: .ci/travis_deploy_conda.sh || return 1;

CONTRIBUTING.rst

@@ -1,9 +1,9 @@
-.. This file based on https://github.com/PyGithub/PyGithub/blob/master/CONTRIBUTING.md
-
 ==============
 Contributing
 ==============
 
+.. This file based on https://github.com/PyGithub/PyGithub/blob/master/CONTRIBUTING.md
+
 ``flake8_sphinx_links`` uses `tox <https://tox.readthedocs.io>`_ to automate testing and packaging, and `pre-commit <https://pre-commit.com>`_ to maintain code quality.
 
 Install ``pre-commit`` with ``pip`` and install the git hook:

README.rst

@@ -30,7 +30,7 @@ flake8_sphinx_links
 
 .. |docs| image:: https://img.shields.io/readthedocs/flake8-sphinx-links/latest?logo=read-the-docs
 	:target: https://flake8-sphinx-links.readthedocs.io/en/latest/?badge=latest
-	:alt: Documentation Status
+	:alt: Documentation Build Status
 
 .. |docs_check| image:: https://github.com/domdfcoding/flake8-sphinx-links/workflows/Docs%20Check/badge.svg
 	:target: https://github.com/domdfcoding/flake8-sphinx-links/actions?query=workflow%3A%22Docs+Check%22

doc-source/conf.py

@@ -7,9 +7,6 @@
 import re
 import sys
 
-# 3rd party
-from sphinx.locale import _
-
 sys.path.append(os.path.abspath('.'))
 sys.path.append(os.path.abspath('..'))
 
@@ -18,7 +15,10 @@
 # User-configurable lines
 # End of user-configurable lines
 
-github_url = "https://github.com/domdfcoding/flake8-sphinx-links"
+github_username = "domdfcoding"
+github_repository = "flake8-sphinx-links"
+github_url = f"https://github.com/{github_username}/{github_repository}"
+
 
 rst_prolog = f""".. |pkgname| replace:: flake8_sphinx_links
 .. |pkgname2| replace:: ``flake8_sphinx_links``
@@ -34,25 +34,22 @@
 package_root = "flake8_sphinx_links"
 
 extensions = [
-		'sphinx.ext.intersphinx',
-		'sphinx.ext.autodoc',
-		'sphinx.ext.mathjax',
-		'sphinx.ext.viewcode',
-		'sphinxcontrib.httpdomain',
-		"sphinxcontrib.extras_require",
-		"sphinx.ext.todo",
-		"sphinxemoji.sphinxemoji",
-		"notfound.extension",
-		"sphinx_tabs.tabs",
-		"sphinx-prompt",
-		"sphinx_autodoc_typehints",
-		"sphinx.ext.autosummary",
-		"autodocsumm",
-		"sphinx_copybutton",
-		"sphinxcontrib.default_values",
-		"sphinxcontrib.toctree_plus",
-		# "sphinx_gitstamp",
-		]
+	'sphinx_toolbox',
+	'sphinx_toolbox.more_autodoc',
+	'sphinx_toolbox.more_autosummary',
+	'sphinx_toolbox.tweaks.param_dash',
+	'sphinx.ext.intersphinx',
+	'sphinx.ext.mathjax',
+	'sphinxcontrib.httpdomain',
+	'sphinxcontrib.extras_require',
+	'sphinx.ext.todo',
+	'sphinxemoji.sphinxemoji',
+	'notfound.extension',
+	'sphinx_copybutton',
+	'sphinxcontrib.default_values',
+	'sphinxcontrib.toctree_plus',
+	'seed_intersphinx_mapping',
+	]
 
 sphinxemoji_style = 'twemoji'
 todo_include_todos = bool(os.environ.get("SHOW_TODOS", 0))
@@ -68,18 +65,11 @@
 pygments_style = 'default'
 
 intersphinx_mapping = {
-		'rtd': ('https://docs.readthedocs.io/en/latest/', None),
-		'sphinx': ('https://www.sphinx-doc.org/en/stable/', None),
 		'python': ('https://docs.python.org/3/', None),
-		"NumPy": ('https://numpy.org/doc/stable/', None),
-		"SciPy": ('https://docs.scipy.org/doc/scipy/reference', None),
-		"Pandas": ('https://pandas.pydata.org/docs/', None),
-		"matplotlib": ('https://matplotlib.org', None),
+		'sphinx': ('https://www.sphinx-doc.org/en/stable/', None),
+		'rtd': ('https://docs.readthedocs.io/en/latest/', None),
 		"h5py": ('https://docs.h5py.org/en/latest/', None),
-		"Sphinx": ('https://www.sphinx-doc.org/en/master/', None),
-		"Django": ('https://docs.djangoproject.com/en/dev/', 'https://docs.djangoproject.com/en/dev/_objects/'),
 		"sarge": ('https://sarge.readthedocs.io/en/latest/', None),
-		"attrs": ('https://www.attrs.org/en/stable/', None),
 		}
 
 html_theme = 'domdf_sphinx_theme'
@@ -103,13 +93,33 @@
 man_pages = [('index', slug, project, [author], 1)]
 texinfo_documents = [('index', slug, project, author, slug, project, 'Miscellaneous')]
 
+toctree_plus_types = {
+		"class",
+		"function",
+		"method",
+		"data",
+		"enum",
+		"flag",
+		"confval",
+		"directive",
+		"role",
+		"confval",
+		"protocol",
+		"typeddict",
+		"namedtuple",
+		}
+
+add_module_names = False
+
 
 autodoc_default_options = {
 		'members': None,  # Include all members (methods).
 		'special-members': None,
 		"autosummary": None,
+		"show-inheritance": None,
 		'exclude-members': ','.join([   # Exclude "standard" methods.
 				"__dict__",
+				"__class__",
 				"__dir__",
 				"__weakref__",
 				"__module__",
@@ -118,33 +128,11 @@
 				"__parameters__",
 				"__subclasshook__",
 				"__init_subclass__",
-				])
+				"__attrs_attrs__",
+				"__init__",
+				"__new__",
+				"__getnewargs__",
+				"__abstractmethods__",
+				"__hash__",
+				]),
 		}
-
-
-# Extensions to theme docs
-def setup(app):
-	from sphinx.domains.python import PyField
-	from sphinx.util.docfields import Field
-
-	app.add_object_type(
-			'confval',
-			'confval',
-			objname='configuration value',
-			indextemplate='pair: %s; configuration value',
-			doc_field_types=[
-					PyField(
-							'type',
-							label=_('Type'),
-							has_arg=False,
-							names=('type', ),
-							bodyrolename='class',
-							),
-					Field(
-							'default',
-							label=_('Default'),
-							has_arg=False,
-							names=('default', ),
-							),
-					]
-			)

doc-source/contributing.rst

@@ -1,8 +1,7 @@
-.. This file based on https://github.com/PyGithub/PyGithub/blob/master/CONTRIBUTING.md
+Overview
+---------
 
-==============
-Contributing
-==============
+.. This file based on https://github.com/PyGithub/PyGithub/blob/master/CONTRIBUTING.md
 
 ``flake8_sphinx_links`` uses `tox <https://tox.readthedocs.io>`_ to automate testing and packaging, and `pre-commit <https://pre-commit.com>`_ to maintain code quality.