@rtorcato/repo-tooling 3.5.0 → 3.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/repo-tooling",
-	"version": "3.5.0",
+	"version": "3.7.0",
 	"description": "One CLI to scaffold, audit and fix your repo's whole toolchain — linting, tests, commits, releases & CI.",
 	"type": "module",
 	"keywords": [
@@ -103,6 +103,10 @@
 		"tooling/mcp/mcp.json.example",
 		"tooling/swift/*.yml",
 		"tooling/swift/*.json",
+		"tooling/python/*.toml",
+		"tooling/python/*.ini",
+		"tooling/perl/perlcriticrc",
+		"tooling/perl/perltidyrc",
 		"tooling/github-actions/workflows/*.yml",
 		"README.md",
 		"AGENTS.md"

package/tooling/perl/perlcriticrc

@@ -0,0 +1,35 @@
+# .perlcriticrc — @rtorcato/repo-tooling Perl preset
+#
+# Perl::Critic is the linter; perltidy (see .perltidyrc) is the formatter.
+# They do not overlap: Perl::Critic never rewrites source, so unlike the
+# SwiftLint/SwiftFormat and ruff/black pairings there is no second rewriting
+# tool to fight — see src/languages/perl/checks.ts.
+
+# Severity 3 ("harsh") and above. Severity 1 turns on the whole Perl Best
+# Practices book, including rules modern code deliberately breaks; 4-5 catch
+# so little they stop functioning as a gate.
+severity = 3
+
+# One violation per line with a file:line:column prefix, which both an editor
+# and a CI log annotator can parse.
+verbose = %f:%l:%c %m (%p, severity %s)\n
+
+# --- Rule adjustments -------------------------------------------------------
+
+# RequireVersionVar wants a $VERSION in every .pm. Distributions that carry the
+# version in their metadata (Dist::Zilla) or in the main module alone would
+# have to repeat it in every file to satisfy it.
+[-Modules::RequireVersionVar]
+
+# RequirePodSections enforces a fixed POD skeleton in every file, including
+# private modules that have no public interface to document. The POD that
+# matters is on the distribution's entry points, which this cannot tell apart.
+[-Documentation::RequirePodSections]
+
+# These modules enable strict and warnings for you, so requiring the explicit
+# pragma alongside them is a false positive.
+[TestingAndDebugging::RequireUseStrict]
+equivalent_modules = Moose Moo Mojo::Base Test2::V0
+
+[TestingAndDebugging::RequireUseWarnings]
+equivalent_modules = Moose Moo Mojo::Base Test2::V0

package/tooling/perl/perltidyrc

@@ -0,0 +1,23 @@
+# .perltidyrc — @rtorcato/repo-tooling Perl preset
+#
+# perltidy is the formatter; Perl::Critic (see .perlcriticrc) is the linter.
+#
+# Order matters in this file: -pbp is a bundle that sets many options at once,
+# so every deviation from it has to come afterwards to win.
+
+# Perl Best Practices as the base: 4-column indents, no cuddled else,
+# consistent operator spacing.
+-pbp
+
+# 100 columns rather than PBP's 78 — the same width the JavaScript and Swift
+# presets in this distribution use, so a polyglot repo wraps consistently.
+-l=100
+
+# Keep up to two consecutive blank lines instead of collapsing to one:
+# deliberate vertical grouping inside a long sub is worth preserving.
+-mbl=2
+
+# Deliberately NOT set here: -b (in-place edit) and -bext. They change what a
+# bare `perltidy lib/Foo.pm` does for a human running it by hand — it would
+# silently rewrite the file instead of producing Foo.pm.tdy. The pre-commit
+# hook and the CI job pass those flags explicitly, where in-place is the point.

package/tooling/python/mypy.ini

@@ -0,0 +1,21 @@
+; mypy.ini — @rtorcato/repo-tooling Python preset
+;
+; Strict-by-default on your own code, lenient on third-party packages that ship
+; no type information. Without the second half, a single untyped dependency
+; turns every import into an error and the whole run gets ignored.
+
+[mypy]
+python_version = 3.10
+strict = True
+warn_unused_configs = True
+warn_unreachable = True
+show_error_codes = True
+exclude = (^|/)(build|dist|\.venv)/
+
+; Tests exercise deliberately-wrong inputs, so full strictness there costs more
+; than it catches.
+[mypy-tests.*]
+disallow_untyped_defs = False
+
+[mypy-tests.*.*]
+disallow_untyped_defs = False

package/tooling/python/pytest.ini

@@ -0,0 +1,15 @@
+; pytest.ini — @rtorcato/repo-tooling Python preset
+;
+; A standalone file rather than [tool.pytest.ini_options] in pyproject.toml:
+; pyproject is the project's own metadata, and merging a table into it needs a
+; TOML round-tripper this CLI does not carry. pytest reads pytest.ini first.
+
+[pytest]
+testpaths = tests
+; Fail on an unregistered marker or an unknown config key — both are typos that
+; otherwise silently skip tests.
+addopts = --strict-markers --strict-config
+; A warning that nobody ever sees is a bug waiting for a major version bump.
+filterwarnings =
+    error
+    ignore::DeprecationWarning:pkg_resources.*

package/tooling/python/ruff.toml

@@ -0,0 +1,32 @@
+# ruff.toml — @rtorcato/repo-tooling Python preset
+#
+# Ruff is both the linter and the formatter here. Its formatter is
+# black-compatible, so a separate black config would be a second rewriting
+# formatter fighting the first — see src/languages/python/checks.ts.
+
+line-length = 100
+target-version = "py310"
+
+exclude = [
+  ".venv",
+  "build",
+  "dist",
+]
+
+[lint]
+# E/W pycodestyle, F pyflakes, I isort, UP pyupgrade, B bugbear,
+# SIM simplify, RUF ruff-specific. The set flake8 + isort + pyupgrade would
+# have given you, minus the four extra dependencies.
+select = ["E", "W", "F", "I", "UP", "B", "SIM", "RUF"]
+
+# E501 is the formatter's job — leaving it on makes every long string a lint
+# error the formatter is not allowed to fix.
+ignore = ["E501"]
+
+[lint.per-file-ignores]
+# Test files legitimately shadow names and use bare asserts.
+"tests/**" = ["S101"]
+
+[format]
+quote-style = "double"
+indent-style = "space"