FluxScript 0.1.0__py3-none-any.whl

fluxscript/parser.py

@@ -0,0 +1,82 @@
+"""Safe parser for FluxScript's declarative Python subset. Source is never executed."""
+import ast
+from pathlib import Path
+from .dsl import App, Page, Text, Heading, Button, Input
+from .models import AppSpec
+
+CONSTRUCTORS = {"App": App, "Page": Page, "Text": Text, "Heading": Heading, "Button": Button, "Input": Input}
+MAX_SOURCE_BYTES = 1_000_000
+class SourceError(ValueError): pass
+
+def _literal(node):
+    try: value = ast.literal_eval(node)
+    except (ValueError, TypeError, MemoryError, RecursionError) as exc:
+        raise SourceError(f"Only literal arguments are allowed (line {getattr(node, 'lineno', '?')}).") from exc
+    if isinstance(value, (str, bytes)) and len(value) > 10_000:
+        raise SourceError(f"String/bytes literal is too large (line {getattr(node, 'lineno', '?')}).")
+    return value
+
+def _construct(call: ast.Call, line: int):
+    if not isinstance(call.func, ast.Name) or call.func.id not in CONSTRUCTORS:
+        raise SourceError(f"Only approved constructors are allowed (line {line}).")
+    if any(k.arg is None for k in call.keywords): raise SourceError("**kwargs expansion is not supported.")
+    ctor = CONSTRUCTORS[call.func.id]
+    try:
+        return ctor(*[_literal(a) for a in call.args], **{k.arg: _literal(k.value) for k in call.keywords})
+    except (TypeError, ValueError, OverflowError) as exc:
+        raise SourceError(f"Invalid {call.func.id} at line {line}: {exc}") from exc
+
+def parse_source(source: str) -> AppSpec:
+    if not isinstance(source, str): raise TypeError("source must be a string")
+    if len(source.encode("utf-8")) > MAX_SOURCE_BYTES: raise SourceError("Source exceeds 1 MB limit.")
+    try: tree = ast.parse(source)
+    except (SyntaxError, ValueError, RecursionError) as exc:
+        if isinstance(exc, SyntaxError): raise SourceError(f"Python syntax error at line {exc.lineno}: {exc.msg}") from exc
+        raise SourceError("Source could not be parsed safely.") from exc
+    env: dict[str, object] = {}; app: App | None = None
+    for node in tree.body:
+        if isinstance(node, ast.ImportFrom):
+            if node.level != 0 or node.module != "fluxscript" or any(a.name not in CONSTRUCTORS or a.asname for a in node.names):
+                raise SourceError(f"Unsupported import at line {node.lineno}; import only approved names directly from fluxscript.")
+            continue
+        if isinstance(node, ast.Expr) and isinstance(node.value, ast.Constant) and isinstance(node.value.value, str): continue
+        if isinstance(node, ast.Assign) and len(node.targets) == 1 and isinstance(node.targets[0], ast.Name):
+            if node.targets[0].id.startswith("__"): raise SourceError(f"Private-looking names are not allowed (line {node.lineno}).")
+            if not isinstance(node.value, ast.Call): raise SourceError(f"Only approved constructor assignments are allowed (line {node.lineno}).")
+            obj = _construct(node.value, node.lineno)
+            if not isinstance(obj, (App, Page, Text, Heading, Button, Input)): raise SourceError("Unsupported constructor.")
+            env[node.targets[0].id] = obj
+            if isinstance(obj, App):
+                if app is not None: raise SourceError("Define exactly one App instance.")
+                app = obj
+            continue
+        if isinstance(node, ast.Expr) and isinstance(node.value, ast.Call):
+            call = node.value
+            if not isinstance(call.func, ast.Attribute) or not isinstance(call.func.value, ast.Name):
+                raise SourceError(f"Unsupported expression at line {node.lineno}.")
+            receiver = env.get(call.func.value.id)
+            if receiver is None: raise SourceError(f"Unknown declarative object {call.func.value.id!r} at line {node.lineno}.")
+            if len(call.args) != 1 or call.keywords: raise SourceError(f"Expected exactly one positional argument (line {node.lineno}).")
+            arg = call.args[0]
+            if isinstance(arg, ast.Name):
+                if arg.id not in env: raise SourceError(f"Unknown declarative object {arg.id!r} at line {node.lineno}.")
+                argument = env[arg.id]
+            elif isinstance(arg, ast.Call): argument = _construct(arg, node.lineno)
+            else: raise SourceError(f"Method arguments must be a declared object or approved constructor (line {node.lineno}).")
+            if isinstance(receiver, Page) and call.func.attr == "add" and isinstance(argument, (Text, Heading, Button, Input)): receiver.add(argument)
+            elif isinstance(receiver, App) and call.func.attr == "add_page" and isinstance(argument, Page): receiver.add_page(argument)
+            else: raise SourceError(f"Unsupported method call at line {node.lineno}.")
+            continue
+        raise SourceError(f"Unsupported statement at line {getattr(node, 'lineno', '?')}; only declarative app definitions are accepted.")
+    if app is None: raise SourceError("No App(...) declaration found.")
+    issues = app.spec.validate()
+    if issues: raise SourceError("Application validation failed:\n- " + "\n- ".join(issues))
+    return app.spec
+
+def parse_file(path) -> AppSpec:
+    p = Path(path)
+    if not p.is_file(): raise SourceError(f"Source file not found: {p}")
+    try:
+        if p.stat().st_size > MAX_SOURCE_BYTES: raise SourceError("Source exceeds 1 MB limit.")
+        return parse_source(p.read_text(encoding="utf-8"))
+    except UnicodeDecodeError as exc: raise SourceError("Source must be UTF-8 encoded.") from exc

fluxscript/project.py

@@ -0,0 +1,74 @@
+"""Project export and storage helpers."""
+from __future__ import annotations
+import json
+import os
+import re
+import shutil
+import zipfile
+from datetime import datetime
+from pathlib import Path
+from .backends import BACKENDS
+from .parser import parse_file, SourceError
+
+
+def safe_slug(value: str) -> str:
+    slug = re.sub(r"[^A-Za-z0-9._-]+", "-", value.strip()).strip(".-_").lower()
+    return slug[:64] or "fluxscript-project"
+
+
+def default_storage() -> Path:
+    """Choose shared Android storage when mounted, otherwise a user-home directory."""
+    android_storage = Path("/storage/emulated/0")
+    if android_storage.is_dir() and os.access(android_storage, os.W_OK):
+        return android_storage / "FluxScriptProjects"
+    return Path.home() / "FluxScriptProjects"
+
+
+def generate_project(source: Path, target: str, storage: Path, *, install_dependencies: bool = True) -> tuple[Path, Path, list[Path]]:
+    """Generate a self-contained project directory and ZIP archive under storage."""
+    if target not in (*BACKENDS.keys(), "all"):
+        raise ValueError(f"Unsupported target {target!r}; choose {', '.join((*BACKENDS.keys(), 'all'))}.")
+    spec = parse_file(source)
+    stamp = datetime.now().strftime("%Y%m%d-%H%M%S-%f")
+    name = safe_slug(spec.name)
+    root = storage.expanduser().resolve()
+    root.mkdir(parents=True, exist_ok=True)
+    project_dir = root / f"{name}-{target}-{stamp}"
+    project_dir.mkdir(parents=False, exist_ok=False)
+    generated: list[Path] = []
+    selected = list(BACKENDS) if target == "all" else [target]
+    try:
+        for backend_name in selected:
+            out = project_dir / backend_name if target == "all" else project_dir
+            generated.extend(BACKENDS[backend_name](spec, out))
+            if backend_name == "web":
+                from bs4 import BeautifulSoup
+                soup = BeautifulSoup((out / "index.html").read_text(encoding="utf-8"), "html.parser")
+                if soup.title is None or soup.main is None or not soup.find_all("section", attrs={"data-route": True}):
+                    raise RuntimeError("Generated website failed structural HTML validation.")
+            elif backend_name == "android":
+                from defusedxml import ElementTree
+                ElementTree.parse(str(out / "app/src/main/AndroidManifest.xml"))
+            elif backend_name == "ios":
+                swift = (out / "GeneratedApp.swift").read_text(encoding="utf-8")
+                if "@main" not in swift or "struct ContentView" not in swift:
+                    raise RuntimeError("Generated iOS source failed entry-point validation.")
+            elif backend_name == "cli":
+                import ast
+                ast.parse((out / "app_cli.py").read_text(encoding="utf-8"), filename="app_cli.py")
+        manifest = {
+            "name": spec.name, "version": "0.1.0", "source_file": Path(source).name,
+            "targets": selected, "generated_at": datetime.now().astimezone().isoformat(),
+            "files": sorted(str(p.relative_to(project_dir)) for p in generated),
+        }
+        manifest_path = project_dir / "fluxscript-project.json"
+        manifest_path.write_text(json.dumps(manifest, indent=2), encoding="utf-8")
+        generated.append(manifest_path)
+        archive = root / f"{project_dir.name}.zip"
+        with zipfile.ZipFile(archive, "w", compression=zipfile.ZIP_DEFLATED, compresslevel=9) as zf:
+            for file in sorted(project_dir.rglob("*")):
+                if file.is_file(): zf.write(file, file.relative_to(project_dir.parent))
+        return project_dir, archive, generated
+    except Exception:
+        shutil.rmtree(project_dir, ignore_errors=True)
+        raise

fluxscript/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

fluxscript-0.1.0.dist-info/METADATA

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: FluxScript
+Version: 0.1.0
+Summary: FluxScript Python-first multi-target application generator and developer CLI
+Author: Md Safarujjaman
+License-Expression: MIT
+Keywords: fluxscript,compiler,code-generation,python,web,android,ios
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Compilers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: build>=1.2; extra == "test"
+Requires-Dist: twine>=5.0; extra == "test"
+Dynamic: license-file
+
+# FluxScript 0.1.0
+
+FluxScript is a Python-first project generator and developer command-line toolkit. It provides a restricted declarative Python source format, shared application model, web source generation, native-platform source starters, project export, and an optional remote execution-service client.
+
+> **Release status:** 0.1.0 is an alpha. It is suitable for experimentation and generated-source workflows, not a claim that arbitrary Python compiles to every platform. Inspect generated source and validate native projects with their real toolchains before production use.
+
+## Install
+
+After the package is published under the PyPI project name `FluxScript`, install it with `python -m pip install FluxScript`. Package names are case-insensitive on PyPI. Until publication, install from the source checkout using the command below.
+
+
+From the extracted source directory:
+
+```bash
+python -m pip install .
+fluxscript --version
+fluxscript guide
+```
+
+After FluxScript has been published to PyPI, users can install or update it with `python -m pip install --upgrade FluxScript`. It has **not** been published from this archive. FluxScript's core has no mandatory third-party runtime dependencies. When a builder is invoked, it automatically upgrades the Python helper packages required for that target's validation. Use `--no-install-deps` to disable this network/install step when the helper is already installed. This does not install operating-system toolchains.
+
+## First project
+
+```bash
+fluxscript new my_app
+cd my_app
+fluxscript check app.py
+fluxscript website app.py
+```
+
+Preview the generated site:
+
+```bash
+cd build/web
+python -m http.server 8000
+```
+
+Open `http://127.0.0.1:8000` in a browser.
+
+## Generate a project ZIP into storage
+
+```bash
+fluxscript generateproject --source app.py --target web
+fluxscript generateproject --source app.py --target android
+fluxscript generateproject --source app.py --target ios
+fluxscript generateproject --source app.py --target all
+```
+
+This creates **both a project directory and a ZIP archive**. By default, FluxScript uses `/storage/emulated/0/FluxScriptProjects` when that shared Android storage location exists and is writable; otherwise it uses `~/FluxScriptProjects`. Specify `--storage /path/to/folder` to choose a different location.
+
+## Builders
+
+```bash
+fluxscript website app.py --out build/web
+fluxscript android app.py --out build/android
+fluxscript ios app.py --out build/ios
+fluxscript cli app.py --out build/cli
+fluxscript build app.py --target all --out build/all
+```
+
+- **Website:** HTML, responsive CSS, JavaScript, TypeScript, and structural HTML validation. Buttons emit action events; real business logic, APIs, authentication and persistence must be connected by the developer.
+- **Android:** Kotlin/Gradle source project with a manifest validated by a safe XML parser. Building an APK requires a JDK, Android SDK, and compatible Gradle/Android Gradle Plugin toolchain.
+- **iOS:** SwiftUI source starter. Building/signing an app requires macOS and Xcode. The builder does not produce an IPA.
+- **CLI:** standalone Python `argparse` command interface for declared button actions; generated commands emit JSON action requests for application-specific handlers to consume.
+
+The web and Android builder commands automatically upgrade their respective Python validation helper package to the latest available release. The iOS source generator has no Python helper dependency to install. Native build tools are not pip packages and are not silently downloaded.
+
+## Remote execution service
+
+Configure an execution API that implements the documented runtime-listing and code-execution request shape. FluxScript never starts a remote service implicitly.
+
+```bash
+fluxscript service status
+export FLUXSCRIPT_SERVICE_URL='http://127.0.0.1:2000/api/v2'
+export FLUXSCRIPT_SERVICE_TOKEN='your-token-if-required'
+fluxscript service runtimes
+fluxscript service run python 3.12 main.py
+fluxscript service run javascript 20.11.1 app.js --stdin-file input.txt
+```
+
+Remote non-local endpoints must use HTTPS. Never send secrets or untrusted code to an execution service unless you trust its operator and isolation controls. Client-side limits do not make a server secure.
+
+## Commands
+
+Run `fluxscript guide` for the complete built-in command reference. Other useful commands:
+
+```bash
+fluxscript --help
+fluxscript new [directory]
+fluxscript check [app.py]
+fluxscript targets
+fluxscript doctor
+fluxscript integrations
+fluxscript analyze ./source --out report.json
+fluxscript review ./source
+```
+
+## Source format and security boundary
+
+The `app.py` source is parsed using Python's AST and is **not executed**. Version 0.1.0 accepts only an explicit subset of declarative constructors, assignments, and page-registration calls. It is not a general Python interpreter or arbitrary Python-to-native compiler. Unsupported statements are rejected.
+
+## Development and release checks
+
+```bash
+python -m compileall -q fluxscript tests
+python -m unittest discover -s tests -v
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+```
+
+See `docs/ARCHITECTURE.md`, `docs/COMMANDS.md`, `docs/INTEGRATION_NOTES.md`, `docs/ROADMAP.md`, and `docs/PYPI_RELEASE.md`.
+
+## Clean command names
+
+The CLI accepts easy-to-type commands without hyphens or underscores: `fluxscript website app.py`, `fluxscript android app.py`, `fluxscript ios app.py`, `fluxscript cli app.py`, `fluxscript generateproject --source app.py --target all`, and `fluxscript device`. Existing hyphenated commands remain supported for compatibility.
+
+## Author
+
+**Md Safarujjaman** is the author listed in the package metadata. Run `fluxscript developer` to display the project author and version.

fluxscript-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+fluxscript/__init__.py,sha256=RQmJ1Dt94ntXmgaI6GEtYnRRXDzI4rFG3rg4FZW3L0o,238
+fluxscript/__main__.py,sha256=ee5vE0xcUZM3fPmxicvcw-IJXkm6nOwxARREHBWpF8Q,47
+fluxscript/analyzer.py,sha256=5fJyKye_DMgrAbXVKA7x5bxNvUtidgB9mchZrev5wnA,4717
+fluxscript/cli.py,sha256=VCh-LPNM1kt9w-tlUuN5D_CF2ibHz6sMkdUWuB0SmVA,19759
+fluxscript/dependencies.py,sha256=D-_G5zL99a03RrgTwAEBjqf19WaZLOkrlYBfrfunDuA,3705
+fluxscript/dsl.py,sha256=Y9TrGX1DHIQ2VatpWigycB9ElcXSOV0pNbfdueNubjY,1463
+fluxscript/models.py,sha256=9wqvAsaZlaMhxKIwOoCdJUekQbkmP0OOM0GzCLLUX8Q,2842
+fluxscript/parser.py,sha256=t8nIL_bPlGIIwyXNNj71gelOhMhmjhjA49oUDFSwKqE,5465
+fluxscript/project.py,sha256=AXijhLypXEFKUA_5qlMbbAGq9DTk0oHWKm0PHpk903k,3688
+fluxscript/version.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+fluxscript/backends/__init__.py,sha256=kWF5kgFZ8z-kvvNiWwRh0LafJdhzQlkFXX7B7NT6ZHM,233
+fluxscript/backends/android.py,sha256=XqyP2SLZWXi3DTjsth_bT_KOBE3kyhEWLUebtzYdJ4k,5846
+fluxscript/backends/cli.py,sha256=rDr5YQglFjAoqVNSSy_pjX4klW0E_AH0xXTk1GAToYg,2635
+fluxscript/backends/ios.py,sha256=KNs49ObPimcUL2auluUawWk3TnTQBbEB2YYhV1Oz4fQ,3429
+fluxscript/backends/web.py,sha256=x5xsr62IicsCfsobdGQIkF9JGezFyHWK3-xAMea_gXA,9580
+fluxscript/integrations/__init__.py,sha256=m4xjX458bYTox0La3UYkyONA3m-3lmuaM2pSgu3pjWw,1725
+fluxscript/integrations/commands.py,sha256=4U5gJZkl_LXRCuMdJLiFeEojF29pbxT-963bZ514Bn8,1676
+fluxscript/integrations/execution_service.py,sha256=MnCpSJVFl4zx-_CYnNczhJPcuITZ7kX8FcPE4SMRt-g,4268
+fluxscript-0.1.0.dist-info/licenses/LICENSE,sha256=-UpPSGmvlj2HTDHPvzgLixIDXVWX_CyD0S-YgzpqhA4,1072
+fluxscript-0.1.0.dist-info/METADATA,sha256=0EeEJsIy9hjCuVU08nYSCcZgvK7RMT41Fejv24vX-3s,6518
+fluxscript-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+fluxscript-0.1.0.dist-info/entry_points.txt,sha256=8SxxPOwXjr7XEjZU7kh7NAFa8YNUr02XRlLGhiZDcb8,78
+fluxscript-0.1.0.dist-info/top_level.txt,sha256=j-le8HTwMG5o_327BMwvi3dhalEt2wAIuFJVtxVQM-w,11
+fluxscript-0.1.0.dist-info/RECORD,,

fluxscript-0.1.0.dist-info/WHEEL

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

fluxscript-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+flux = fluxscript.cli:main
+fluxscript = fluxscript.cli:main

fluxscript-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Md Safarujjaman
+
+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.

fluxscript-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fluxscript