touchable-templates 2026.2.3a0__tar.gz → 2026.2.5a0__tar.gz

touchable_templates-2026.2.5a0/.python-version

@@ -0,0 +1 @@
+3.13

{touchable_templates-2026.2.3a0 → touchable_templates-2026.2.5a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: touchable-templates
-Version: 2026.2.3a0
+Version: 2026.2.5a0
 Summary: A dev tool that magically opens templates and partials in your IDE
 Author: Brady Whitby
 License-Expression: MIT

{touchable_templates-2026.2.3a0 → touchable_templates-2026.2.5a0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "touchable-templates"
-version = "2026.02.3a"
+version = "2026.02.5a"
 description = "A dev tool that magically opens templates and partials in your IDE"
 readme = "README.md"
 license = "MIT"
@@ -22,10 +22,5 @@ url = "https://test.pypi.org/simple/"
 publish-url = "https://test.pypi.org/legacy/"
 explicit = true
 
-[tool.hatch.build]
-include = [
-    "touchable_templates/static/**",
-]
-# [tool.hatch.build.targets.wheel]
-# packages = ["touchable_templates"]
-
+[tool.hatch.build.targets.wheel]
+packages = ["src/touchable_templates"]

touchable_templates-2026.2.5a0/src/touchable_templates/__init__.py

@@ -0,0 +1 @@
+"""Touchable Templates package initializer."""

touchable_templates-2026.2.5a0/src/touchable_templates/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class TouchableTemplatesConfig(AppConfig):
+    name = "touchable_templates"

touchable_templates-2026.2.5a0/src/touchable_templates/django/loader.py

@@ -0,0 +1,112 @@
+from django.template.loaders.filesystem import Loader as FileSystemLoader
+from django.template.loaders.app_directories import Loader as AppDirectoriesLoader
+from django.conf import settings
+import os
+import logging
+
+logger = logging.getLogger(__name__)
+
+IDE_TO_URI_MAPPER = {
+    "atom": "atom://core/open/file?filename=",
+    "codelite": "codelite://open?file=",
+    "cursor": "cursor://file/",
+    "emacs": "emacs://open?url=",
+    "espresso": "x-espresso://open?filepath=",
+    "idea": "idea://open?file=",
+    "macvim": "mvim://open/?url=",
+    "netbeans": "netbeans://open/?f=",
+    "nova": "nova://open?path=",
+    "pycharm": "pycharm://open?file=",
+    "sublime": "subl://open?url=",
+    "textmate": "txmt://open?url=",
+    "vscode": "vscode://file/",
+    "vscode-insiders": "vscode-insiders://file/",
+    "vscode-insiders-remote": "vscode-insiders://vscode-remote/",
+    "vscode-remote": "vscode://vscode-remote/",
+    "vscodium": "vscodium://file/",
+    "xdebug": "xdebug://",
+}
+
+
+def _get_setting_or_env(name):
+    # Prefer Django setting, fall back to environment variable
+    return getattr(settings, name, None) or os.environ.get(name)
+
+
+def _inject_ide_link(source_content, template_name, filename):
+    touchable_templates_ide = _get_setting_or_env("TOUCHABLE_TEMPLATES_IDE")
+    custom_uri = IDE_TO_URI_MAPPER.get(touchable_templates_ide)
+    touchable_templates_root = _get_setting_or_env("TOUCHABLE_TEMPLATES_ROOT") or ""
+    touchable_templates_remove_prefix = _get_setting_or_env("TOUCHABLE_TEMPLATES_REMOVE_PREFIX") or ""
+
+    try:
+        # compute a relative path portion if a remove-prefix was provided
+        rel_path = filename
+        if touchable_templates_remove_prefix and filename.startswith(touchable_templates_remove_prefix):
+            rel_path = filename[len(touchable_templates_remove_prefix):]
+
+        absolute_template_path = (custom_uri or "") + touchable_templates_root + rel_path
+    except Exception:
+        absolute_template_path = filename
+
+    # If template extends another template, we avoid wrapping the child; Django
+    # templates are compiled in processor order so this is a best-effort approach.
+
+    bordered = (
+        f'<div class="touchable-templates-container" '
+        f'data-template-name="{template_name}" '
+        f'data-template-path="{absolute_template_path}" '
+        f'style="display: block;">{source_content}</div>'
+    )
+
+    return bordered
+
+
+class TouchableTemplatesLoader(FileSystemLoader):
+    """A drop-in replacement for Django's filesystem.Loader that wraps
+    template source in a touchable-templates container when enabled.
+
+    To use: in `TEMPLATES[...]['OPTIONS']['loaders']` reference
+    `touchable_templates.django.loader.TouchableTemplatesLoader` instead of
+    `django.template.loaders.filesystem.Loader`.
+    """
+
+    def get_contents(self, origin):
+        source = super().get_contents(origin)
+
+        enabled = _get_setting_or_env("TOUCHABLE_TEMPLATES_ENABLE")
+        if not enabled:
+            return source
+
+        try:
+            template_name = getattr(origin, "template_name", None) or getattr(origin, "name", "")
+            filename = getattr(origin, "name", "")
+            return _inject_ide_link(source, template_name, filename)
+        except Exception:
+            logger.exception("touchable_templates: failed to inject IDE link into Django template")
+            return source
+
+
+class TouchableTemplatesAppDirectoriesLoader(AppDirectoriesLoader):
+    """A drop-in replacement for Django's app_directories.Loader that wraps
+    template source in a touchable-templates container when enabled.
+
+    To use: in `TEMPLATES[...]['OPTIONS']['loaders']` reference
+    `touchable_templates.django.loader.TouchableTemplatesAppDirectoriesLoader` instead of
+    `django.template.loaders.app_directories.Loader`.
+    """
+
+    def get_contents(self, origin):
+        source = super().get_contents(origin)
+
+        enabled = _get_setting_or_env("TOUCHABLE_TEMPLATES_ENABLE")
+        if not enabled:
+            return source
+
+        try:
+            template_name = getattr(origin, "template_name", None) or getattr(origin, "name", "")
+            filename = getattr(origin, "name", "")
+            return _inject_ide_link(source, template_name, filename)
+        except Exception:
+            logger.exception("touchable_templates: failed to inject IDE link into Django app template")
+            return source

touchable_templates-2026.2.5a0/src/touchable_templates/django/middleware.py

@@ -0,0 +1,52 @@
+from django.utils.deprecation import MiddlewareMixin
+from django.conf import settings
+from bs4 import BeautifulSoup
+
+
+class TouchableTemplatesMiddleware(MiddlewareMixin):
+    """
+    Middleware to post-process Django template responses and mark children with
+    the `touchable-templates` class so the client script can provide IDE links.
+    """
+
+    def process_response(self, request, response):
+        if not getattr(settings, "TOUCHABLE_TEMPLATES_ENABLE", False):
+            return response
+
+        content_type = response.get('Content-Type', '').split(';')[0]
+        if content_type != 'text/html':
+            return response
+        
+        # Decode the response content
+        content = response.content.decode(response.charset)
+        soup = BeautifulSoup(content, 'html.parser')
+
+        # Find all elements with class 'touchable-templates-container'
+        containers = soup.find_all(class_='touchable-templates-container')
+        for container in containers:
+            # Get data attributes from the container
+            data_template_name = container.get('data-template-name')
+            data_template_path = container.get('data-template-path')
+
+            # Iterate over direct children of the container
+            for child in container.find_all(recursive=False):
+                # Add 'touchable-templates' class to the child
+                existing_classes = child.get('class', [])
+                if 'touchable-templates' not in existing_classes:
+                    child['class'] = existing_classes + ['touchable-templates']
+
+                # Copy data attributes to the child
+                if data_template_name:
+                    child['data-template-name'] = data_template_name
+                if data_template_path:
+                    child['data-template-path'] = data_template_path
+
+            # Remove the container but keep its children
+            container.unwrap()
+
+        # Update the response content
+        updated_content = str(soup).encode(response.charset)
+        response.content = updated_content
+        response['Content-Length'] = len(response.content)
+
+        return response

touchable_templates-2026.2.5a0/src/touchable_templates/static/js/touchable_templates.js

@@ -0,0 +1,66 @@
+let altToggled = false;
+
+// Append the element to the DOM, for example, to the body
+var elemDiv = document.createElement('div');
+elemDiv.id = 'floating-template-name';
+elemDiv.style.cssText = "display: none; position: absolute; background: white; border: 1px solid black; padding: 5px; z-index: 9999;"
+document.body.appendChild(elemDiv);
+const floatingElement = document.getElementById("floating-template-name");    
+
+document.addEventListener("DOMContentLoaded", function(event) {
+
+    document.addEventListener('keydown', function(event) {
+        if (event.key === 'Alt') {
+            altToggled = !altToggled;
+            if (!altToggled) {
+                floatingElement.style.display = 'none';
+            }
+        }
+    });
+
+    document.addEventListener('click', function(event) {
+        if (altToggled) {
+            let closestElement = event.target.closest('.touchable-templates');
+            if (closestElement) {
+                let templatePath = closestElement.getAttribute('data-template-path');
+                if (templatePath) {
+                    window.open(templatePath, '_blank');
+                    event.stopPropagation();
+                }
+            }
+        }
+    }, true);
+
+    document.addEventListener('mousemove', (e) => {
+        if (!altToggled) return;
+        const el = e.target.closest('.touchable-templates');
+        if (!el) return floatingElement.style.display = 'none';
+
+        const name = el.getAttribute('data-template-name');
+        if (!name) return;
+
+        floatingElement.textContent = name;
+        floatingElement.style.display = 'block';
+        const { pageX: x, pageY: y } = e;
+        const { offsetWidth: w, offsetHeight: h } = floatingElement;
+        const { innerWidth: vw, innerHeight: vh } = window;
+        floatingElement.style.left = `${x + w + 20 > vw ? x - w - 5 : x + 10}px`;
+        floatingElement.style.top = `${y + h + 20 > vh ? y - h - 5 : y + 10}px`;
+    });
+
+    document.addEventListener('mouseleave', () => {
+        floatingElement.style.display = 'none';
+    });
+
+    document.addEventListener('mouseenter', (e) => {
+        if (altToggled) {
+            const el = e.target.closest('.touchable-templates');
+            if (el) {
+                const name = el.getAttribute('data-template-name');
+                floatingElement.textContent = name;
+                floatingElement.style.display = 'block';
+            }
+        }
+    });
+
+});

touchable_templates-2026.2.5a0/uv.lock

@@ -0,0 +1,45 @@
+version = 1
+revision = 2
+requires-python = ">=3.10"
+
+[[package]]
+name = "beautifulsoup4"
+version = "4.14.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "soupsieve" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737, upload-time = "2025-11-30T15:08:26.084Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" },
+]
+
+[[package]]
+name = "soupsieve"
+version = "2.8.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7b/ae/2d9c981590ed9999a0d91755b47fc74f74de286b0f5cee14c9269041e6c4/soupsieve-2.8.3.tar.gz", hash = "sha256:3267f1eeea4251fb42728b6dfb746edc9acaffc4a45b27e19450b676586e8349", size = 118627, upload-time = "2026-01-20T04:27:02.457Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl", hash = "sha256:ed64f2ba4eebeab06cc4962affce381647455978ffc1e36bb79a545b91f45a95", size = 37016, upload-time = "2026-01-20T04:27:01.012Z" },
+]
+
+[[package]]
+name = "touchable-templates"
+version = "2026.2.4a0"
+source = { editable = "." }
+dependencies = [
+    { name = "beautifulsoup4" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "beautifulsoup4", specifier = ">=4.9.2" }]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]