chore: Update project template to sphinx-notes/cookiecutter@800a79a0

Author: SilverRainZ

.cruft.json

@@ -1,6 +1,6 @@
 {
   "template": "https://github.com/sphinx-notes/template",
-  "commit": "0b096cd7ecff1b28ee8c2887ba3321418be34b9a",
+  "commit": "800a79a06f9a67494516bc14bcda85b3472dcac9",
   "checkout": null,
   "context": {
     "cookiecutter": {
@@ -14,8 +14,13 @@
       "github_repo": "snippet",
       "pypi_name": "sphinxnotes-snippet",
       "pypi_owner": "SilverRainZ",
+      "is_python_project": true,
+      "python_version": "3.12",
+      "is_sphinx_extension": true,
+      "sphinx_version": "7.0",
+      "development_status": "3 - Alpha",
       "_template": "https://github.com/sphinx-notes/template",
-      "_commit": "0b096cd7ecff1b28ee8c2887ba3321418be34b9a"
+      "_commit": "800a79a06f9a67494516bc14bcda85b3472dcac9"
     }
   },
   "directory": null

Makefile

@@ -9,30 +9,30 @@ RM    = rm -rf
 GIT   = git
 OPEN  = xdg-open
 
-# Build sphinx documentation.
 .PHONY: docs
 docs:
 	$(MAKE) -C docs/
 
-# View sphinx HTML documentation in browser.
 .PHONY: view
 view:
 	$(OPEN) docs/_build/html/index.html
 
 .PHONY: clean
 clean:
-	$(MAKE) -C docs/ clean | true
-	$(RM) dist/ | true
+	$(MAKE) -C docs/ clean; $(RM) dist/
 
-.PHONY: clean
+.PHONY: fmt
 fmt:
-	ruff format src/
+	ruff format src/ && ruff check --fix src/
 
-# Run unittest.
 .PHONY: test
 test:
 	$(PY) -m unittest discover -s tests -v
 
+################################################################################
+# Distribution Package
+################################################################################
+
 # Build distribution package, for "install" or "upload".
 .PHONY: dist
 dist: pyproject.toml clean
@@ -54,33 +54,43 @@ install: dist
 upload: dist
 	$(PY) -m twine upload --repository pypi $</*
 
-# Same to the aboved "upload" target, but this publishs to PyPI test server
-# <https://test.pypi.org/>.
-.PHONY: upload-test
-upload-test: dist
-	$(PY) -m twine upload --repository testpypi $</*
+################################################################################
+# Cookiecutter Incremental Updates
+################################################################################
 
 # Keep up to date with the latest template.
-# See also https://github.com/sphinx-notes/cookiecutter.
-.PHONY: update-template
-update-template:
+# See https://github.com/sphinx-notes/cookiecutter.
+.PHONY: tmpl-update tmpl-update-done tmpl-apply-rej
+
+tmpl-update:
 	$(PY) -m cruft update
 
-.PHONY: update-template-done
-update-template-done:
+tmpl-update-done:
 	$(GIT) commit -m "chore: Update project template to sphinx-notes/cookiecutter@$(shell jq -r '.commit' .cruft.json | head -c8)"
 
+tmpl-apply-rej:
+	@for rej in $$(find . -name '*.rej'); do \
+		echo "applying $$rej..."; \
+		wiggle --replace $${rej%.rej} $$rej; \
+	done
+
 # Update project version.
-.PHONY: bump-version
+.PHONY: bump-version bump-version-done
+
 bump-version:
 	@echo -n "Please enter the version to bump: "
 	@read version && $(PY) -m cruft update --variables-to-update "{ \"version\" : \"$$version\" }"
 
-# EXTRA TARGETS START
+bump-version-done:
+	VERSION=$(shell jq -r '.context.cookiecutter.version' .cruft.json); \
+	$(GIT) commit -m "chore: Bump version to $$VERSION"; \
+	$(GIT) tag $$VERSION
+
+################################################################################
+# CUSTOM TARGETS
+################################################################################
 
 # Usage: make cli args=--help
 .PHONY: cli
 cli:
 	$(PY) ./utils/cli.py --config ./utils/conf.py $(args)
-
-# EXTRA TARGETS END

README.rst

@@ -8,15 +8,12 @@ sphinxnotes-snippet
 .. |docs| image:: https://img.shields.io/github/deployments/sphinx-notes/snippet/github-pages
    :target: https://sphinx.silverrainz.me/snippet
    :alt: Documentation Status
-
 .. |license| image:: https://img.shields.io/github/license/sphinx-notes/snippet
    :target: https://github.com/sphinx-notes/snippet/blob/master/LICENSE
    :alt: Open Source License
-
 .. |pypi| image:: https://img.shields.io/pypi/v/sphinxnotes-snippet.svg
    :target: https://pypi.python.org/pypi/sphinxnotes-snippet
    :alt: PyPI Package
-
 .. |download| image:: https://img.shields.io/pypi/dm/sphinxnotes-snippet
    :target: https://pypi.python.org/pypi/sphinxnotes-snippet
    :alt: PyPI Package Downloads

docs/conf.py

@@ -7,9 +7,6 @@
 # list see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
-import os
-import sys
-
 # -- Project information -----------------------------------------------------
 
 project = 'sphinxnotes-snippet'
@@ -28,6 +25,7 @@
     'sphinx.ext.githubpages',
     'sphinx_design',
     'sphinx_copybutton',
+    'sphinx_last_updated_by_git',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -95,6 +93,15 @@
     'jinja': ('https://jinja.palletsprojects.com/en/latest/', None),
 }
 
+extensions.append('sphinx_sitemap')
+sitemap_filename = "sitemap.xml"
+sitemap_url_scheme = "{link}"
+
+extensions.append('sphinxext.opengraph')
+ogp_site_url = html_baseurl
+ogp_site_name = project
+ogp_image = html_baseurl + '/' + html_logo
+
 extensions.append('sphinxnotes.comboroles')
 comboroles_roles = {
     'parsed_literal': (['literal'], True),
@@ -108,15 +115,15 @@
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
+import os
+import sys
 sys.path.insert(0, os.path.abspath('../src/sphinxnotes'))
 extensions.append('snippet')
 
-# DOG FOOD CONFIGURATION START
+# CUSTOM CONFIGURATION
 
 snippet_config = {
     'cache_dir': '/tmp/' + 'sphinxnotes-snippet'
 }
 
 extensions.append('sphinxcontrib.asciinema')
-
-# DOG FOOD CONFIGURATION END

docs/index.rst

@@ -8,19 +8,15 @@ sphinxnotes-snippet
 .. |docs| image:: https://img.shields.io/github/deployments/sphinx-notes/snippet/github-pages?label=docs
    :target: https://sphinx.silverrainz.me/snippet
    :alt: Documentation Status
-
 .. |license| image:: https://img.shields.io/github/license/sphinx-notes/snippet
    :target: https://github.com/sphinx-notes/snippet/blob/master/LICENSE
    :alt: Open Source License
-
 .. |pypi| image:: https://img.shields.io/pypi/v/sphinxnotes-snippet.svg
    :target: https://pypi.python.org/pypi/sphinxnotes-snippet
    :alt: PyPI Package
-
 .. |download| image:: https://img.shields.io/pypi/dm/sphinxnotes-snippet
    :target: https://pypi.python.org/pypi/sphinxnotes-snippet
    :alt: PyPI Package Downloads
-
 .. |github| image:: https://img.shields.io/badge/GitHub-181717?style=flat&logo=github&logoColor=white/
    :target: https://github.com/sphinx-notes/snippet
    :alt: GitHub Repository
@@ -48,12 +44,14 @@ Getting Started
    We assume you already have a Sphinx documentation,
    if not, see `Getting Started with Sphinx`_.
 
+
 First, downloading extension from PyPI:
 
 .. code-block:: console
 
    $ pip install sphinxnotes-snippet
 
+
 Then, add the extension name to ``extensions`` configuration item in your
 :parsed_literal:`conf.py_`:
 

pyproject.toml

@@ -9,27 +9,41 @@
 name = "sphinxnotes-snippet"
 description = "Sphinx documentation snippets manager"
 readme = "README.rst"
-license = { file = "BSD-3-Clause" }
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
 authors = [ { name = "Shengyu Zhang" } ]
 maintainers = [ { name = "Shengyu Zhang" } ]
-keywords = ["sphinx", "extension", "documentation"] # TOOD: additional_keywords
+keywords = [
+    "sphinx",
+    "extension",
+    "documentation",
+    "sphinxnotes",
+
+    # CUSTOM KEYWORDS START
+    # CUSTOM KEYWORDS END
+]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 3 - Alpha",
     "Environment :: Plugins",
     "Framework :: Sphinx",
     "Framework :: Sphinx :: Extension",
-    "License :: OSI Approved :: BSD License",
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Topic :: Documentation",
     "Topic :: Documentation :: Sphinx",
+
+    # CUSTOM CLASSIFIERS START
     "Topic :: Utilities",
+    # CUSTOM CLASSIFIERS END
 ]
 
+# See ``make pyver`` for more details.
 requires-python = ">=3.12"
 dependencies = [
-    "Sphinx >= 4",
+    "Sphinx >= 7.0",
+
+    # CUSTOM DEPENDENCIES START
     "langid",
     "jieba",
     "python-pinyin",
@@ -38,6 +52,7 @@ dependencies = [
     "setuptools", # req by stopwordsiso, https://stackoverflow.com/a/39930983/4799273
     "wcwidth",
     "wordsegment",
+    # CUSTOM DEPENDENCIES END
 ]
 
 dynamic = ["version"] # required by setuptools_scm, see section [build-system]
@@ -47,20 +62,28 @@ dev = [
     "build",
     "twine",
     "cruft",
-    "ruff",
-    "pre-commit"
+    "ruff>=0.11.10", # pwndbg#2716
+    "pre-commit",
 ]
 test = [
     "pytest",
 ]
 docs = [
     "furo",
-    "sphinxnotes-project",
     "sphinx_design",
     "sphinx_copybutton",
     "sphinxcontrib-gtagjs",
+    "sphinx-sitemap",
+    "sphinxext-opengraph",
+    "sphinx-last-updated-by-git",
+
+    # Dependencies of sphinxnotes projcts.
+    "sphinxnotes-project",
     "sphinxnotes-comboroles",
+
+    # CUSTOM DOCS DEPENDENCIES START
     "sphinxcontrib.asciinema",
+    # CUSTOM DOCS DEPENDENCIES END
 ]
 
 [project.urls]
@@ -87,6 +110,8 @@ version_scheme = "no-guess-dev"
 # check out https://setuptools.pypa.io/en/latest/userguide/package_discovery.html#finding-namespace-packages
 where = ["src"]
 
+# CUSTOM CONFIGURATION
+
 [tool.setuptools.package-data]
 # A maps from PACKAGE NAMES to lists of glob patterns,
 # see also https://setuptools.pypa.io/en/latest/userguide/datafiles.html

ruff.toml

@@ -7,3 +7,8 @@ exclude = [
 
 [format]
 quote-style = "single"
+
+[lint]
+ignore = [
+    "E741", # Checks for the use of the characters 'l', 'O', or 'I' as variable names
+]

src/sphinxnotes/snippet/meta.py

@@ -0,0 +1,35 @@
+# This file is generated from sphinx-notes/cookiecutter.
+# DO NOT EDIT!!!
+
+################################################################################
+# Project meta infos.
+################################################################################
+
+from __future__ import annotations
+from importlib import metadata
+
+__project__ = 'sphinxnotes-snippet'
+__author__ = 'Shengyu Zhang'
+__desc__ = 'Sphinx documentation snippets manager'
+
+try:
+    __version__ = metadata.version('sphinxnotes-snippet')
+except metadata.PackageNotFoundError:
+    __version__ = 'unknown'
+
+
+################################################################################
+# Sphinx extension utils.
+################################################################################
+
+
+def pre_setup(app):
+    app.require_sphinx('7.0')
+
+
+def post_setup(app):
+    return {
+        'version': __version__,
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }