funkshway 2026.5.2__py3-none-any.whl

funkshway/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from funkshway!"

funkshway/core.py

@@ -0,0 +1,73 @@
+import libcst as cst
+import libcst.matchers as m
+
+class UnrecognizedBlockError(Exception):
+    pass
+
+class FunkshwayTransformer(cst.CSTTransformer):
+    """
+    Initial transformer for funkshway.
+    Currently just performs an idempotent round-trip.
+    """
+    pass
+
+def is_constant_assignment(node: cst.CSTNode) -> bool:
+    if m.matches(node, m.SimpleStatementLine(body=[m.Assign(targets=[m.AssignTarget(target=m.Name(value=m.MatchRegex(r"^[A-Z_][A-Z0-9_]*$")))])])):
+        return True
+    return False
+
+def is_main_block(node: cst.CSTNode) -> bool:
+    if m.matches(node, m.If(test=m.Comparison(left=m.Name(value="__name__"), comparisons=[m.ComparisonTarget(operator=m.Equal(), comparator=m.SimpleString(value='"__main__"'))]))):
+        return True
+    if m.matches(node, m.If(test=m.Comparison(left=m.Name(value="__name__"), comparisons=[m.ComparisonTarget(operator=m.Equal(), comparator=m.SimpleString(value="'__main__'"))]))):
+        return True
+    return False
+
+def check_for_unrecognized_blocks(module: cst.Module):
+    """
+    Checks if there are any blocks at the top level that are not supported.
+    """
+    for statement in module.body:
+        # Ignore empty lines and comments at top level if they are just standalone?
+        # Actually, comments should be associated with blocks.
+        
+        # Supported:
+        # 1. Imports
+        if m.matches(statement, m.SimpleStatementLine(body=[m.Import() | m.ImportFrom()])):
+            continue
+        
+        # 2. Constants
+        if is_constant_assignment(statement):
+            continue
+            
+        # 3. Classes
+        if m.matches(statement, m.ClassDef()):
+            continue
+            
+        # 4. Functions
+        if m.matches(statement, m.FunctionDef()):
+            continue
+            
+        # 5. Main block
+        if is_main_block(statement):
+            continue
+            
+        # 6. Standalone comments/docstrings might be tricky.
+        # For Phase 1, let's be strict.
+        if m.matches(statement, m.SimpleStatementLine(body=[m.Expr(value=m.SimpleString())])):
+            # Docstring
+            continue
+            
+        raise UnrecognizedBlockError(f"Unrecognized block at top level: {statement}")
+
+def format_code(source_code: str) -> str:
+    """
+    Parses source code, applies transformations, and returns formatted code.
+    """
+    module = cst.parse_module(source_code)
+    
+    check_for_unrecognized_blocks(module)
+    
+    # Phase 1: Just idempotent round-trip
+    transformed_module = module.visit(FunkshwayTransformer())
+    return transformed_module.code

funkshway/main.py

@@ -0,0 +1,25 @@
+import argparse
+import sys
+from funkshway.core import format_code, UnrecognizedBlockError
+
+def main():
+    parser = argparse.ArgumentParser(description="funkshway: Opinionated Python code reordering")
+    parser.add_argument("file", help="Python file to format")
+    args = parser.parse_args()
+
+    try:
+        with open(args.file, "r") as f:
+            source_code = f.read()
+        
+        formatted_code = format_code(source_code)
+        print(formatted_code, end="")
+        
+    except UnrecognizedBlockError as e:
+        print(f"Refusal: {e}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

funkshway-2026.5.2.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: funkshway
+Version: 2026.5.2
+Summary: CLI to move code blocks in a Python file into an opinionated, idempotent order
+Author-email: David Seaward <72779-lofidevops@users.noreply.gitlab.com>
+Requires-Python: >=3.12
+Requires-Dist: libcst>=1.3.1
+Description-Content-Type: text/markdown
+
+# funkshway 🕺
+
+CLI to move code blocks in a Python file into an opinionated, idempotent order.
+
+## Installation
+
+```bash
+uv tool install funkshway
+```
+
+## Usage
+
+```bash
+funkshway path/to/file.py
+```
+
+Idempotent round-trip guaranteed for supported blocks.
+Unrecognized code at top-level will cause the tool to refuse formatting.
+
+## Release
+
+```shell
+git tag -a 2.0.0 -m "Version 2.0.0"
+uv build
+uv publish  # uses tag for version number
+```
+
+## Colophon
+
+Building almost exclusively with Junie using AGENTS.md, specification.toml and PLAN.md

funkshway-2026.5.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+funkshway/__init__.py,sha256=imkavrY7QF6kURhae7tbS664tPadwehGUmmpEuXtt6U,55
+funkshway/core.py,sha256=utT4ngCAbNtOW0Ct_VCIlf1p-XAuO_if6l6cG4NlW2w,2593
+funkshway/main.py,sha256=mLYcgs1FL2Q1ajPdOz7DQwo4O8rqaIHvQjSAgmv8mAE,725
+funkshway/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+funkshway-2026.5.2.dist-info/METADATA,sha256=T2KR6xQxoahK31L3zHYEplIQg2zEqLR15bvgUnlpYzY,856
+funkshway-2026.5.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+funkshway-2026.5.2.dist-info/entry_points.txt,sha256=o2qWzHStUsUChbkvDH_tKvTmVsdTIGZoM1LdqaIn00Q,50
+funkshway-2026.5.2.dist-info/RECORD,,

funkshway-2026.5.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

funkshway-2026.5.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+funkshway = funkshway.main:main