teloce-py 0.1.0__tar.gz

teloce_py-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2026 Aldane Hutchinson
+
+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.

teloce_py-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: teloce-py
+Version: 0.1.0
+Summary: A Python compiler for Teloce .vel Single File Components
+Author: Teloce Contributors
+Maintainer-email: Teloce Contributors <team@teloce.dev>
+License: 
+        MIT License
+        
+        Copyright (c) 2026 Aldane Hutchinson
+        
+        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.
+Project-URL: Homepage, https://teloce.dev
+Project-URL: Documentation, https://docs.teloce.dev
+Project-URL: Repository, https://github.com/aldanedev-create/telonce
+Project-URL: Issues, https://github.com/aldanedev-create/telonce/issues
+Project-URL: Changelog, https://github.com/aldanedev-create/telonce/blob/main/CHANGELOG.md
+Keywords: teloce,compiler,sfc,template-engine,python,flask,django,fastapi,flaxon
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Teloce-Py
+
+A Python compiler for Teloce `.vel` Single File Components.
+
+## Overview
+
+Teloce-Py is a **100% Python compiler** that transforms `.vel` Single File Components into **self-contained vanilla JavaScript**. It works with any Python web framework (Flask, Flaxon, Django, FastAPI) without requiring Node.js, npm, or a CDN.
+
+## Philosophy
+
+> **"Write components in Python, run them in the browser — no npm required."**
+
+- **100% Python** — The compiler is written entirely in Python
+- **Self-contained JavaScript** — The output includes everything needed to run in the browser
+- **No npm/Node.js** — Python developers don't need JavaScript tooling
+- **Framework Agnostic** — Works with Flask, Flaxon, Django, FastAPI, and more
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install teloce-py
+Create a .vel Component
+html
+<!-- static/js/App.vel -->
+<template>
+    <div class="app">
+        <h1>{{ title }}</h1>
+        <button @click="increment">{{ count }}</button>
+    </div>
+</template>
+
+<script>
+export default {
+    data() {
+        return {
+            title: "Hello Teloce",
+            count: 0
+        };
+    },
+    methods: {
+        increment() {
+            this.count++;
+        }
+    }
+};
+</script>
+
+<style scoped>
+.app { padding: 20px; }
+button { background: #6366f1; color: white; border: none; padding: 8px 16px; }
+</style>
+Run Your Python App
+python
+# app.py
+from flask import Flask, render_template
+
+app = Flask(__name__)
+
+@app.route('/')
+def home():
+    return render_template('index.html')
+
+if __name__ == '__main__':
+    app.run()
+The compiler automatically discovers .vel files and generates JavaScript.
+
+What Happens
+text
+static/js/App.vel
+        ↓
+Teloce-Py Compiler
+        ↓
+static/js/App.js (self-contained)
+        ↓
+Browser executes App.js
+No npm. No Node.js. No CDN. Just Python and vanilla JavaScript.
+
+### npm/CDN-style standalone usage
+
+For existing Flask, Django, FastAPI, Jinja, or static HTML pages that do not
+use `.vel` files, serve `src/teloce/runtime/standalone.js` (also available as
+`teloce.runtime.STANDALONE_RUNTIME`) and initialize the existing markup:
+
+```html
+<div id="app"><h1>{{ name }}</h1><button @click="count++">{{ count }}</button></div>
+<script src="/static/teloce.js"></script>
+<script>teloce.createApp('#app', { name: 'Python', count: 0 });</script>
+```
+
+This provides the npm-compatible `teloce.createApp()`/`mount()` entry point,
+interpolation, events, bindings, loops, conditions, filters, and plugins
+without requiring Node.js or a CDN.
+
+### CSS and template coordination
+
+Scoped component styles and generated markup use the same deterministic
+`data-v-*` scope attribute. Compiled components also install their CSS once
+when mounted, so a page that loads `App.js` does not need a separate CSS tag.
+The build still emits `App.css`; pass `inline_css=False` to `compile()` or the
+compiler options when you want to serve the stylesheet separately for caching.
+
+Features
+Single File Components — Template, script, and style in one .vel file
+
+Scoped CSS — Styles are automatically scoped to the component
+
+Reactive Signals — Fine-grained reactivity without a Virtual DOM
+
+Keyed Loops — Fast list rendering with DOM node reuse
+
+Human-Friendly Errors — Clear error messages with suggestions
+
+Framework Agnostic — Works with any Python web server
+
+Development Server — Auto-compile on file changes
+
+Production Build — Optimized output for deployment
+
+Documentation
+Architecture
+
+Compiler Design
+
+.vel Syntax
+
+Template Syntax
+
+Directives
+
+Reactivity
+
+License
+MIT
+
+Contributing
+Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
+
+Support
+GitHub Issues
+
+Discord

teloce_py-0.1.0/README.md

@@ -0,0 +1,143 @@
+# Teloce-Py
+
+A Python compiler for Teloce `.vel` Single File Components.
+
+## Overview
+
+Teloce-Py is a **100% Python compiler** that transforms `.vel` Single File Components into **self-contained vanilla JavaScript**. It works with any Python web framework (Flask, Flaxon, Django, FastAPI) without requiring Node.js, npm, or a CDN.
+
+## Philosophy
+
+> **"Write components in Python, run them in the browser — no npm required."**
+
+- **100% Python** — The compiler is written entirely in Python
+- **Self-contained JavaScript** — The output includes everything needed to run in the browser
+- **No npm/Node.js** — Python developers don't need JavaScript tooling
+- **Framework Agnostic** — Works with Flask, Flaxon, Django, FastAPI, and more
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install teloce-py
+Create a .vel Component
+html
+<!-- static/js/App.vel -->
+<template>
+    <div class="app">
+        <h1>{{ title }}</h1>
+        <button @click="increment">{{ count }}</button>
+    </div>
+</template>
+
+<script>
+export default {
+    data() {
+        return {
+            title: "Hello Teloce",
+            count: 0
+        };
+    },
+    methods: {
+        increment() {
+            this.count++;
+        }
+    }
+};
+</script>
+
+<style scoped>
+.app { padding: 20px; }
+button { background: #6366f1; color: white; border: none; padding: 8px 16px; }
+</style>
+Run Your Python App
+python
+# app.py
+from flask import Flask, render_template
+
+app = Flask(__name__)
+
+@app.route('/')
+def home():
+    return render_template('index.html')
+
+if __name__ == '__main__':
+    app.run()
+The compiler automatically discovers .vel files and generates JavaScript.
+
+What Happens
+text
+static/js/App.vel
+        ↓
+Teloce-Py Compiler
+        ↓
+static/js/App.js (self-contained)
+        ↓
+Browser executes App.js
+No npm. No Node.js. No CDN. Just Python and vanilla JavaScript.
+
+### npm/CDN-style standalone usage
+
+For existing Flask, Django, FastAPI, Jinja, or static HTML pages that do not
+use `.vel` files, serve `src/teloce/runtime/standalone.js` (also available as
+`teloce.runtime.STANDALONE_RUNTIME`) and initialize the existing markup:
+
+```html
+<div id="app"><h1>{{ name }}</h1><button @click="count++">{{ count }}</button></div>
+<script src="/static/teloce.js"></script>
+<script>teloce.createApp('#app', { name: 'Python', count: 0 });</script>
+```
+
+This provides the npm-compatible `teloce.createApp()`/`mount()` entry point,
+interpolation, events, bindings, loops, conditions, filters, and plugins
+without requiring Node.js or a CDN.
+
+### CSS and template coordination
+
+Scoped component styles and generated markup use the same deterministic
+`data-v-*` scope attribute. Compiled components also install their CSS once
+when mounted, so a page that loads `App.js` does not need a separate CSS tag.
+The build still emits `App.css`; pass `inline_css=False` to `compile()` or the
+compiler options when you want to serve the stylesheet separately for caching.
+
+Features
+Single File Components — Template, script, and style in one .vel file
+
+Scoped CSS — Styles are automatically scoped to the component
+
+Reactive Signals — Fine-grained reactivity without a Virtual DOM
+
+Keyed Loops — Fast list rendering with DOM node reuse
+
+Human-Friendly Errors — Clear error messages with suggestions
+
+Framework Agnostic — Works with any Python web server
+
+Development Server — Auto-compile on file changes
+
+Production Build — Optimized output for deployment
+
+Documentation
+Architecture
+
+Compiler Design
+
+.vel Syntax
+
+Template Syntax
+
+Directives
+
+Reactivity
+
+License
+MIT
+
+Contributing
+Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
+
+Support
+GitHub Issues
+
+Discord

teloce_py-0.1.0/pyproject.toml

@@ -0,0 +1,84 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "teloce-py"
+description = "A Python compiler for Teloce .vel Single File Components"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Teloce Contributors" }
+]
+maintainers = [
+    { name = "Teloce Contributors", email = "team@teloce.dev" }
+]
+keywords = [
+    "teloce",
+    "compiler",
+    "sfc",
+    "template-engine",
+    "python",
+    "flask",
+    "django",
+    "fastapi",
+    "flaxon"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Compilers",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+]
+requires-python = ">=3.10"
+dependencies = []
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://teloce.dev"
+Documentation = "https://docs.teloce.dev"
+Repository = "https://github.com/aldanedev-create/telonce"
+Issues = "https://github.com/aldanedev-create/telonce/issues"
+Changelog = "https://github.com/aldanedev-create/telonce/blob/main/CHANGELOG.md"
+
+[project.scripts]
+teloce = "teloce.cli.main:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+packages = { find = { where = ["src"] } }
+include-package-data = true
+
+[tool.setuptools.package-data]
+"teloce.runtime" = ["*.js"]
+
+[tool.setuptools.dynamic]
+version = { attr = "teloce.version.__version__" }
+
+[tool.black]
+line-length = 88
+target-version = ["py39"]
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+addopts = "-v --tb=short"

teloce_py-0.1.0/setup.cfg

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

teloce_py-0.1.0/src/teloce/__init__.py

@@ -0,0 +1,17 @@
+"""
+Teloce-Py - A Python compiler for Teloce .vel Single File Components
+
+Teloce-Py transforms .vel files into self-contained vanilla JavaScript
+without requiring Node.js, npm, or a CDN.
+"""
+
+from teloce.version import __version__
+
+__all__ = [
+    "__version__",
+    "compile",
+    "compile_file",
+    "compile_project",
+]
+
+from teloce.compiler.compiler import compile, compile_file, compile_project

teloce_py-0.1.0/src/teloce/__main__.py

@@ -0,0 +1,13 @@
+"""
+Teloce-Py command-line entry point.
+
+Usage:
+    python -m teloce [command] [options]
+"""
+
+import sys
+
+from teloce.cli.main import main
+
+if __name__ == "__main__":
+    sys.exit(main())

teloce_py-0.1.0/src/teloce/ast/__init__.py

@@ -0,0 +1,87 @@
+"""
+AST (Abstract Syntax Tree) package.
+
+Defines AST nodes for Teloce templates.
+"""
+
+from teloce.ast.nodes import (
+    ASTNode,
+    NodeType,
+    ElementNode,
+    TextNode,
+    InterpolationNode,
+    ForNode,
+    IfNode,
+    ElseNode,
+    EventNode,
+    BindingNode,
+    ComponentNode,
+    SlotNode,
+    FragmentNode,
+    AttributeNode,
+    CommentNode,
+    DoctypeNode,
+)
+
+from teloce.ast.expressions import (
+    ExpressionNode,
+    IdentifierNode,
+    LiteralNode,
+    BinaryNode,
+    UnaryNode,
+    CallNode,
+    MemberNode,
+)
+
+from teloce.ast.elements import (
+    ElementFactory,
+    VoidElement,
+    ContainerElement,
+)
+
+from teloce.ast.components import (
+    ComponentReference,
+    ComponentSlot,
+    ComponentProp,
+)
+
+from teloce.ast.visitors import (
+    ASTVisitor,
+    ASTTransformer,
+    ASTPrinter,
+)
+
+__all__ = [
+    "ASTNode",
+    "NodeType",
+    "ElementNode",
+    "TextNode",
+    "InterpolationNode",
+    "ForNode",
+    "IfNode",
+    "ElseNode",
+    "EventNode",
+    "BindingNode",
+    "ComponentNode",
+    "SlotNode",
+    "FragmentNode",
+    "AttributeNode",
+    "CommentNode",
+    "DoctypeNode",
+    "ExpressionNode",
+    "IdentifierNode",
+    "LiteralNode",
+    "BinaryNode",
+    "UnaryNode",
+    "CallNode",
+    "MemberNode",
+    "ElementFactory",
+    "VoidElement",
+    "ContainerElement",
+    "ComponentReference",
+    "ComponentSlot",
+    "ComponentProp",
+    "ASTVisitor",
+    "ASTTransformer",
+    "ASTPrinter",
+]

teloce_py-0.1.0/src/teloce/ast/components.py

@@ -0,0 +1,77 @@
+"""
+Component AST nodes.
+
+Defines nodes for custom components and component-related structures.
+"""
+
+from dataclasses import dataclass, field
+from typing import List, Optional, Dict, Any
+
+from teloce.ast.nodes import ASTNode, NodeType
+
+
+@dataclass(init=False)
+class ComponentReference(ASTNode):
+    """
+    Reference to a custom component.
+    """
+    name: str
+    props: Dict[str, str] = field(default_factory=dict)
+    children: List[ASTNode] = field(default_factory=list)
+    slots: Dict[str, List[ASTNode]] = field(default_factory=dict)
+    
+    def __init__(self, name: str, props: Dict[str, str] = None,
+                 children: List[ASTNode] = None,
+                 slots: Dict[str, List[ASTNode]] = None,
+                 line: int = 0, column: int = 0):
+        super().__init__(NodeType.COMPONENT, line, column)
+        self.name = name
+        self.props = props or {}
+        self.children = children or []
+        self.slots = slots or {}
+    
+    def accept(self, visitor):
+        return visitor.visit_component(self)
+
+
+@dataclass(init=False)
+class ComponentSlot(ASTNode):
+    """
+    Slot definition inside a component.
+    """
+    name: str = "default"
+    fallback: List[ASTNode] = field(default_factory=list)
+    
+    def __init__(self, name: str = "default", fallback: List[ASTNode] = None,
+                 line: int = 0, column: int = 0):
+        super().__init__(NodeType.SLOT, line, column)
+        self.name = name
+        self.fallback = fallback or []
+    
+    def accept(self, visitor):
+        return visitor.visit_slot(self)
+
+
+@dataclass(init=False)
+class ComponentProp(ASTNode):
+    """
+    Prop definition for a component.
+    """
+    name: str
+    type: Optional[str] = None
+    required: bool = False
+    default: Any = None
+    validator: Optional[str] = None
+    
+    def __init__(self, name: str, type: str = None, required: bool = False,
+                 default: Any = None, validator: str = None,
+                 line: int = 0, column: int = 0):
+        super().__init__(NodeType.ATTRIBUTE, line, column)
+        self.name = name
+        self.type = type
+        self.required = required
+        self.default = default
+        self.validator = validator
+    
+    def accept(self, visitor):
+        return visitor.visit_attribute(self)