tdfw 0.1.1__py3-none-any.whl

tdfw/cli.py

@@ -0,0 +1,201 @@
+import os
+import click
+import subprocess
+import shutil
+
+def check_tool(tool_name):
+    """Return True if tool is available in PATH"""
+    return shutil.which(tool_name) is not None
+
+def ensure_dir(path):
+    if not os.path.exists(path):
+        os.makedirs(path)
+
+@click.group()
+def cli():
+    """TouchDesigner Framework CLI (tdfw)"""
+    pass
+
+# ----------------------------
+# App scaffolding
+# ----------------------------
+@click.command()
+@click.argument("app_name")
+@click.option("--td-path", default=None,
+              help="Override path to TouchDesigner executable")
+def start_app(app_name, td_path):
+    """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")
+
+    # Default TD path
+    default_td_path = "C:\\Program Files\\Derivative\\TouchDesigner\\bin\\TouchDesigner.exe"
+    td_exec = td_path if td_path else default_td_path
+
+    # Windows .bat
+    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 "" "{td_exec}" "{app_name}.toe"
+""")
+
+    # Mac/Linux .bash
+    bash_path = os.path.join(base, "BAT", f"{os.path.basename(app_name)}.bash")
+    with open(bash_path, "w") as f:
+        f.write(f"""#!/bin/bash
+export NODE=DEV
+open -a "{td_exec}" "{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}")
+
+# ----------------------------
+# Extension stub
+# ----------------------------
+@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}")
+
+# ----------------------------
+# Environment management
+# ----------------------------
+@click.command()
+@click.argument("env_name")
+def init_env(env_name):
+    """Initialize a Python virtual environment using uv (fallback to pip)"""
+    if check_tool("uv"):
+        click.echo(f"📦 Creating uv environment: {env_name}")
+        subprocess.run(["uv", "venv", env_name], check=True)
+        click.echo("✅ uv environment created")
+    elif check_tool("python"):
+        click.echo("⚠️ uv not found, falling back to Python venv + pip")
+        subprocess.run(["python", "-m", "venv", env_name], check=True)
+        subprocess.run([f"{env_name}/Scripts/pip", "install", "--upgrade", "pip"], check=True)
+        click.echo("✅ Python venv created and pip upgraded")
+    else:
+        click.echo("❌ Neither uv nor Python found. Please install one of them.")
+
+@click.command()
+@click.argument("env_name")
+def init_conda(env_name):
+    """Initialize a Conda environment"""
+    if not check_tool("conda"):
+        click.echo("❌ Conda is not installed. Please install Conda first.")
+        return
+    click.echo(f"📦 Creating Conda environment: {env_name}")
+    subprocess.run(["conda", "create", "-y", "-n", env_name, "python=3.12"], check=True)
+    click.echo("✅ Conda environment created")
+
+@click.command()
+def sync_env():
+    """Export requirements for reproducibility"""
+    click.echo("📤 Exporting requirements.txt")
+    subprocess.run(["uv", "pip", "freeze", ">", "requirements.txt"], shell=True)
+    click.echo("✅ requirements.txt exported")
+
+@click.command()
+@click.argument("env_file")
+def import_env(env_file):
+    """Import environment from requirements.txt or environment.yml"""
+    if env_file.endswith(".yml"):
+        click.echo(f"📥 Importing Conda environment from {env_file}")
+        subprocess.run(["conda", "env", "create", "-f", env_file], check=True)
+    else:
+        click.echo(f"📥 Importing uv environment from {env_file}")
+        subprocess.run(["uv", "pip", "install", "-r", env_file], check=True)
+    click.echo("✅ Environment imported")
+
+@click.command()
+def help():
+    """Show comprehensive help for tdfw"""
+    click.echo("""
+TouchDesigner Framework CLI (tdfw)
+
+Available commands:
+  
+  doctor                  Check system readiness for tdfw
+  start-app <name>        Scaffold a new TouchDesigner app
+    --td-path             Override TouchDesigner executable path
+
+  create-ext <name>       Create a new extension stub
+
+  init-env <name>         Create a uv-managed Python environment - falls back to Python venv if uv is not available
+  init-conda <name>       Create a Conda environment
+  sync-env                Export requirements.txt from current env
+  import-env <file>       Import env from requirements.txt or environment.yml
+""")
+
+@click.command()
+@click.option("--td-path", default=None,
+              help="Override path to TouchDesigner executable")
+def doctor(td_path):
+    """Check system readiness for tdfw"""
+    click.echo("🔎 Running tdfw system check...\n")
+
+    # uv
+    if check_tool("uv"):
+        click.echo("✅ uv found")
+    else:
+        click.echo("⚠️ uv not found (tdfw will fall back to pip)")
+
+    # pip
+    if check_tool("pip"):
+        click.echo("✅ pip found")
+    else:
+        click.echo("❌ pip not found — install Python with pip")
+
+    # conda
+    if check_tool("conda"):
+        click.echo("✅ conda found")
+    else:
+        click.echo("⚠️ conda not found (optional, only needed if you want Conda envs)")
+
+    # TouchDesigner executable
+    default_td_path = "C:\\Program Files\\Derivative\\TouchDesigner\\bin\\TouchDesigner.exe"
+    td_exec = td_path if td_path else default_td_path
+    if os.path.exists(td_exec):
+        click.echo(f"✅ TouchDesigner executable found at {td_exec}")
+    else:
+        click.echo(f"⚠️ TouchDesigner executable not found at {td_exec}. Use --td-path to override.")
+
+    click.echo("\n🩺 System check complete.")
+
+# ----------------------------
+# Register commands
+# ----------------------------
+cli.add_command(help)
+cli.add_command(doctor)
+cli.add_command(start_app)
+cli.add_command(create_ext)
+cli.add_command(init_env)
+cli.add_command(init_conda)
+cli.add_command(sync_env)
+cli.add_command(import_env)

tdfw-0.1.1.dist-info/METADATA

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: tdfw
+Version: 0.1.1
+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
+
+# Confirm installation and check options
+tdfw help
+
+# 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.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+tdfw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tdfw/cli.py,sha256=vW_xUaTm5GHoH7M1OC8mgIpGrFqY2B1KGhhNYO0qVXg,6816
+tdfw-0.1.1.dist-info/licenses/LICENSE,sha256=05n4WcQHvyc-Fi8IFQRxbrCw4DiQd1J7PodC656Vliw,1076
+tdfw-0.1.1.dist-info/METADATA,sha256=XAc6zLdbJKOI5uAI5kj1AXmIcJ5lqg3txbSlperu2wE,2047
+tdfw-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tdfw-0.1.1.dist-info/entry_points.txt,sha256=sexsRrgHG_TItNlhrw0SZmJ1PpcT28-m5juhm-RIb24,38
+tdfw-0.1.1.dist-info/top_level.txt,sha256=oziS-VKmCRbi7VujpSauiswWyOIEoFnOGzSW8uF9mok,5
+tdfw-0.1.1.dist-info/RECORD,,

tdfw-0.1.1.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.1.dist-info/entry_points.txt

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

tdfw-0.1.1.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.1.dist-info/top_level.txt

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