tdfw 0.1.0__py3-none-any.whl

tdfw/cli.py

@@ -0,0 +1,62 @@
+import os
+import click
+
+def ensure_dir(path):
+    if not os.path.exists(path):
+        os.makedirs(path)
+
+@click.group()
+def cli():
+    """TouchDesigner Framework CLI (tdfw)"""
+    pass
+
+@click.command()
+@click.argument("app_name")
+def start_app(app_name):
+    """Scaffold a new TouchDesigner app"""
+    base = os.path.abspath(app_name)
+    ensure_dir(base)
+
+    for folder in ["BAT", "DAT", "LOG"]:
+        ensure_dir(os.path.join(base, folder))
+
+    with open(os.path.join(base, "README.md"), "w") as f:
+        f.write(f"# {app_name}\nGenerated by tdfw\n")
+
+    with open(os.path.join(base, ".gitignore"), "w") as f:
+        f.write("*.toe\n*.log\n")
+
+    bat_path = os.path.join(base, "BAT", f"{os.path.basename(app_name)}.bat")
+
+    with open(bat_path, "w") as f:
+        f.write(f"""@echo off
+set NODE=DEV
+start "" "C:\\Program Files\\Derivative\\TouchDesigner\\bin\\TouchDesigner.exe" "{app_name}.toe"
+""")
+
+    for ext in ["StartupExt", "SettingsExt", "StateExt"]:
+        ext_path = os.path.join(base, "DAT", f"{ext}.py")
+        with open(ext_path, "w") as f:
+            f.write(f"class {ext}:\n    def __init__(self, ownerComp):\n        self.ownerComp = ownerComp\n")
+
+    click.echo(f"✅ Created TouchDesigner app scaffold at {base}")
+
+@click.command()
+@click.argument("ext_name")
+def create_ext(ext_name):
+    """Create a new extension stub"""
+    path = os.path.join("DAT", f"{ext_name}.py")
+    if not os.path.exists("DAT"):
+        click.echo("❌ No DAT directory found. Run start-app first.")
+        return
+
+    with open(path, "w") as f:
+        f.write(f"""class {ext_name}:
+    \"\"\"{ext_name} description\"\"\"
+    def __init__(self, ownerComp):
+        self.ownerComp = ownerComp
+""")
+    click.echo(f"✅ Created extension stub: {path}")
+
+cli.add_command(start_app)
+cli.add_command(create_ext)

tdfw-0.1.0.dist-info/METADATA

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: tdfw
+Version: 0.1.0
+Summary: TouchDesigner Framework CLI scaffold tool for opinionated State Driven Command and Control/Code Driven project architecture
+Author-email: Michael Kramer <michael.kramer.guitar@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MichaelKramerGuitar/tdfw
+Project-URL: Repository, https://github.com/MichaelKramerGuitar/tdfw
+Project-URL: Issues, https://github.com/MichaelKramerGuitar/tdfw/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Dynamic: license-file
+
+![Coverage](https://codecov.io/gh/MichaelKramerGuitar/tdfw/branch/main/graph/badge.svg) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+
+# tdfw
+TouchDesigner Framework CLI scaffold tool with an opinionated slant towards State Driven/Code Driven project architecture.
+
+## About
+
+Hi, I'm Michael. I play guitar and write code. I was introduced to TouchDesigner by my friend Andrew Zolty, who's also known as `BREAKFAST`. He's an incredible kinetic artist. 
+
+Getting started with TouchDesigner as a GUI never really happened for me. I started a few YouTube courses on it but didn't have the time to follow through and learn how to use the interface. 
+
+But the concept of a network of nodes and subnodes made sense to my programmer/software engineer brain. I thought "there must be a purely code driven way to architect these TouchDesinger apps". So I looked on YouTube and found [this](https://www.youtube.com/watch?v=nQT7EhYCVg0) video (read more about that in [BACKGROUND.md](./BACKGROUND.md)). I was thrilled and what has resulted is essentially this tool which abstracts out all the boilerplate he gives. 
+
+# How To Use
+
+```bash
+# Install 
+uv pip install tdfw
+
+# Start a TouchDesigner App
+tdfw start-app <MyFirstApp>
+
+# Create a Python Extension stub (from your TouchDesigner Project Root i.e. the dir with the <MyFirstApp>.toe file)
+tdfw create-ext <MyFirstExt>
+```

tdfw-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+tdfw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tdfw/cli.py,sha256=Zj7rAVTt8CCsWmNlt1El3cWlHg6mIFg1NMmcuSDsHdc,1823
+tdfw-0.1.0.dist-info/licenses/LICENSE,sha256=05n4WcQHvyc-Fi8IFQRxbrCw4DiQd1J7PodC656Vliw,1076
+tdfw-0.1.0.dist-info/METADATA,sha256=i9It7WBAC3bpPFYyuWXKjTzyGEkpzDX-uTrE_sPJBdE,1995
+tdfw-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tdfw-0.1.0.dist-info/entry_points.txt,sha256=sexsRrgHG_TItNlhrw0SZmJ1PpcT28-m5juhm-RIb24,38
+tdfw-0.1.0.dist-info/top_level.txt,sha256=oziS-VKmCRbi7VujpSauiswWyOIEoFnOGzSW8uF9mok,5
+tdfw-0.1.0.dist-info/RECORD,,

tdfw-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tdfw-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tdfw = tdfw.cli:cli

tdfw-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MichaelKramerGuitar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tdfw-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tdfw