repo files

Author: hunterhogan

.editorconfig

@@ -20,7 +20,7 @@ end_of_line					= lf
 indent_size					= 2
 indent_style				= space
 insert_final_newline		= true
-max_line_length				= 101
+max_line_length				= 102
 spelling_language			= en-US
 tab_width					= 2
 trim_trailing_whitespace	= true

.github/HH-docstrings.md

@@ -19,7 +19,7 @@ Structure code so that readers encounter syntactic signals before the elements t
 ### Line Length
 
 - Prefer keeping function and method signatures on a single line when possible.
-- If a signature must wrap, apply semantic line breaking (see below), not arbitrary character-count breaking.
+- If a signature must span multiple lines, apply semantic line breaking (see below), not arbitrary character-count breaking.
 - Do not use automated formatters (Black, yapf, autopep8) unless the repository already uses them consistently.
 
 ### Line Continuation

.github/HH-formatting.md

@@ -49,7 +49,7 @@ message: str = f"I received `{dimensionLength = }`, but I need a value greater t
 message: str = f"I received '{computationDivisionsAsString}' for `computationDivisions`, but this value is not supported."
 ```
 
-Wrap identifiers in backticks within the message string for visual distinction.
+Enclose identifiers in backticks within the message string for visual distinction.
 
 ## Message Content Principles
 
@@ -151,6 +151,6 @@ Never use ANSI codes in exception messages or log entries—only for direct term
 
 ### Backtick Usage
 
-- Wrap all identifiers in backticks: `` `parameterName` ``, `` `ValueError` ``
-- Wrap Python keywords in backticks: `` `None` ``, `` `True` ``
+- Enclose all identifiers in backticks: `` `parameterName` ``, `` `ValueError` ``
+- Enclose Python keywords in backticks: `` `None` ``, `` `True` ``
 - Use backticks for code elements referenced in prose

.github/HH-status-messages.md

@@ -2,6 +2,10 @@
 
 Standards for Python type annotations emphasizing precision, completeness, modern syntax (PEP 585/604), and paradigm improvements (TypedDict, Protocol, TypeVar, overload).
 
+## DO NOT CHANGE THE LOGIC OR FORMATTING OR DOCSTRINGS OR IDENTIFIERS
+
+Your job is type annotations. Full stop.
+
 ## Core Philosophy
 
 Type annotations are engineering tools that prevent bugs, communicate intent to human readers, and enable editor/tooling assistance. Every annotation must carry practical value. Completeness matters: annotate everything precisely—every function signature (all parameters and return types), every variable binding, every class attribute.

.github/HH-type-annotations.md

@@ -35,5 +35,5 @@ jobs:
           except urllib.error.HTTPError as thisIsAStupidSystem:
             if thisIsAStupidSystem.code != 404:
               raise
-          urllib.request.urlopen(urllib.request.Request(url,json.dumps({'tag_name': tag, 'name': tag}).encode(),headers, method='POST'))
+            urllib.request.urlopen(urllib.request.Request(url,json.dumps({'tag_name': tag, 'name': tag}).encode(),headers, method='POST'))
           "

.github/workflows/githubRelease.yml

@@ -1,5 +1,8 @@
 [settings]
+add_imports								= from __future__ import annotations
 combine_as_imports						= true
+extend_skip_glob						=*.ipynb
+filter_files							= true
 force_alphabetical_sort_within_sections	= true
 from_first								= true
 honor_noqa								= true

.isort.cfg

@@ -1,4 +1,8 @@
 {
+	"deprecateTypingAliases": true,
+	"disableBytesTypePromotions": true,
+	"enableReachabilityAnalysis": true,
+	"enableTypeIgnoreComments": false,
 	"reportConstantRedefinition": false,
 	"reportInvalidTypeVarUse": false,
 	"reportPrivateUsage": false,
@@ -9,12 +13,8 @@
 	"reportUnusedFunction": "information",
 	"reportUnusedImport": "information",
 	"reportUnusedVariable": "information",
-	"typeCheckingMode": "strict",
-	"deprecateTypingAliases": true,
-	"disableBytesTypePromotions": true,
-	"enableReachabilityAnalysis": true,
-	"enableTypeIgnoreComments": false,
 	"strictDictionaryInference": true,
 	"strictListInference": true,
 	"strictSetInference": true,
+	"typeCheckingMode": "strict",
 }

pyrightconfig.json

@@ -1,6 +1,25 @@
 extend = "pyproject.toml"
 
+line-length = 140
+
 [lint]
+preview = true
+allowed-confusables = [
+  "′",
+  "×",
+  "−",
+  "∨",
+  "∪",
+  "⊗",
+  "ℓ",
+  "–",
+  "ℒ",
+  "ℝ",
+  "α",
+  "γ",
+  "ρ",
+  "σ",
+]
 ignore = [
   "ANN401",
   "C901",
@@ -13,7 +32,7 @@ ignore = [
   "F401",
   "FIX",
   "FLY002",
-  "I001",
+  "I",
   "N",
   "PGH004",
   "PLC0105",
@@ -38,20 +57,40 @@ ignore = [
   "S603",
   "SIM108",
   "SIM300",
-  "TC001",
-  "TC002",
-  "TC003",
-  "TC006",
   "TD",
   "W191",
   "W292",
+  # preview rules
+  "CPY001",
+  "D420",
+  "DOC102",
+  "E265",
+  "E302",
+  "E303",
+  "E305",
+  "PLR0914",
+  "PLR0917",
+  "S403",
 ]
 select = ["ALL"]
 task-tags = ["DEVELOPMENT", "NOTE", "SEMIOTICS", "TODO"]
 
 [lint.flake8-import-conventions]
-aliases = { numpy = "numpy", pandas = "pandas", "re" = "regex" }
-banned-aliases = { numpy = ["np"], pandas = ["pd"], regex=["re"] }
+banned-aliases = { numpy = ["np"], pandas = ["pd"], regex = ["re"] }
+
+[lint.flake8-import-conventions.aliases]
+"accelerate.utils.dataclasses" = "accelerate_dataclasses"
+"fs.path" = "fs_path"
+"itertools.product" = "CartesianProduct"
+"torch.autograd.grad" = "torch_grad"
+"torch.nn.functional" = "F"
+"torch.nn.parallel.DistributedDataParallel" = "DDP"
+numpy = "numpy"
+pandas = "pandas"
+re = "regex"
+
+[lint.flake8-quotes]
+inline-quotes = "single"
 
 [lint.per-file-ignores]
 "__init__.py" = ["PLC0414"]
@@ -70,4 +109,7 @@ banned-aliases = { numpy = ["np"], pandas = ["pd"], regex=["re"] }
 convention = "numpy"
 
 [format]
+docstring-code-format = true
+quote-style = "single"
 indent-style = "tab"
+skip-magic-trailing-comma = true