tdfw 0.1.0__tar.gz

tdfw-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,26 @@
+![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/pyproject.toml

@@ -0,0 +1,41 @@
+[project]
+name = "tdfw"
+version = "0.1.0"
+description = "TouchDesigner Framework CLI scaffold tool for opinionated State Driven Command and Control/Code Driven project architecture"
+authors = [{ name = "Michael Kramer", email = "michael.kramer.guitar@gmail.com" }]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+dependencies = ["click"]
+
+[dependency-groups]
+dev = ["pytest", "pytest-cov", "twine"]
+
+[project.urls]
+Homepage = "https://github.com/MichaelKramerGuitar/tdfw"
+Repository = "https://github.com/MichaelKramerGuitar/tdfw"
+Issues = "https://github.com/MichaelKramerGuitar/tdfw/issues"
+
+[project.scripts]
+tdfw = "tdfw.cli:cli"
+
+[tool.setuptools]
+packages = ["tdfw"]
+
+[tool.uv]
+default-groups = ["dev"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=tdfw --cov-report=xml --cov-report=term-missing"
+
+[tool.coverage.run]
+branch = true
+omit = [
+    "*/__init__.py",
+    "tests/*"
+]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+

tdfw-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tdfw-0.1.0/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/tdfw.egg-info/PKG-INFO

@@ -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/tdfw.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+tdfw/__init__.py
+tdfw/cli.py
+tdfw.egg-info/PKG-INFO
+tdfw.egg-info/SOURCES.txt
+tdfw.egg-info/dependency_links.txt
+tdfw.egg-info/entry_points.txt
+tdfw.egg-info/requires.txt
+tdfw.egg-info/top_level.txt
+tests/test_cli.py

tdfw-0.1.0/tdfw.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tdfw-0.1.0/tdfw.egg-info/entry_points.txt

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

tdfw-0.1.0/tdfw.egg-info/requires.txt

@@ -0,0 +1 @@
+click

tdfw-0.1.0/tdfw.egg-info/top_level.txt

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

tdfw-0.1.0/tests/test_cli.py

@@ -0,0 +1,53 @@
+# tests/test_cli.py
+import os
+import shutil
+import pytest
+from click.testing import CliRunner
+from tdfw import cli
+
+@pytest.fixture
+def runner():
+    return CliRunner()
+
+@pytest.fixture
+def temp_app(tmp_path):
+    """Create a temporary app directory for testing."""
+    app_dir = tmp_path / "MyTestApp"
+    yield app_dir
+    if app_dir.exists():
+        shutil.rmtree(app_dir)
+
+def test_start_app_creates_structure(runner, temp_app):
+    result = runner.invoke(cli.start_app, [str(temp_app)])
+    assert result.exit_code == 0
+    assert (temp_app / "BAT").exists()
+    assert (temp_app / "DAT").exists()
+    assert (temp_app / "LOG").exists()
+    assert (temp_app / "README.md").exists()
+    assert (temp_app / ".gitignore").exists()
+    assert (temp_app / "BAT" / "MyTestApp.bat").exists()
+    for ext in ["StartupExt.py", "SettingsExt.py", "StateExt.py"]:
+        assert (temp_app / "DAT" / ext).exists()
+
+def test_start_app_echo_message(runner, temp_app):
+    result = runner.invoke(cli.start_app, [str(temp_app)])
+    assert "✅ Created TouchDesigner app scaffold" in result.output
+
+def test_create_ext_adds_file(runner, temp_app):
+    # First scaffold the app
+    runner.invoke(cli.start_app, [str(temp_app)])
+    cwd = os.getcwd()
+    os.chdir(temp_app)
+    result = runner.invoke(cli.create_ext, ["CameraExt"])
+    os.chdir(cwd) 
+    assert result.exit_code == 0
+    ext_file = temp_app / "DAT" / "CameraExt.py"
+    assert ext_file.exists()
+    content = ext_file.read_text()
+    assert "class CameraExt" in content
+
+def test_create_ext_without_dat(runner, tmp_path):
+    os.chdir(tmp_path)
+    result = runner.invoke(cli.create_ext, ["FooExt"])
+    assert result.exit_code == 0
+    assert "❌ No DAT directory found" in result.output