FluxScript 0.1.0__tar.gz

fluxscript-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: FluxScript CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: fluxscript-ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pip build
+      - run: python -m compileall -q fluxscript tests
+      - run: python -m unittest discover -s tests -v
+      - run: python -m build
+      - run: python -m pip install --no-deps dist/fluxscript-0.1.0-py3-none-any.whl
+      - run: fluxscript --version
+
+  web-smoke:
+    name: Generated web smoke test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - run: python -m pip install .
+      - run: fluxscript new /tmp/fluxscript-smoke
+      - run: fluxscript check /tmp/fluxscript-smoke/app.py
+      - run: fluxscript build /tmp/fluxscript-smoke/app.py --target web --out /tmp/fluxscript-smoke/build/web
+      - run: node --check /tmp/fluxscript-smoke/build/web/app.js
+      - run: cd /tmp/fluxscript-smoke/build/web && npm install && npm run typecheck

fluxscript-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+- Establish FluxScript's restricted declarative Python source API and shared application model.
+- Generate web, Android, iOS and standalone CLI source projects.
+- Add a read-only source/project analyzer with JSON reports and review findings.
+- Add target-specific validation and on-demand upgrade of required Python helper packages.
+- Add project export to a timestamped storage directory and ZIP archive.
+- Add `guide`, builder, `generate-project`, and remote execution-service commands.
+- Add a capability registry, architecture/security documentation, tests and CI workflow.

fluxscript-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# Contributing
+
+1. Keep core runtime dependencies at zero unless a dependency is essential and justified.
+2. Do not execute source being compiled. Extend the parser through explicit AST node allowlists and tests.
+3. Keep the semantic model backend-neutral. Validate model constraints before any backend writes files.
+4. Add regression tests for parser rejection cases, escaping, multi-page generation, CLI behavior and service error handling.
+5. Run before submitting changes:
+
+   ```bash
+   python -m compileall -q fluxscript tests
+   python -m unittest discover -s tests -v
+   python -m pip wheel . --no-deps --no-build-isolation -w /tmp/fluxscript-wheel
+   ```
+
+6. If Node.js and TypeScript are available, generate a sample project and run `node --check app.js` and `tsc --noEmit`. Validate Kotlin/Gradle on a configured Android SDK/JDK and SwiftUI on macOS/Xcode; do not claim those targets build if they were not actually tested.
+7. Never include service tokens, user source files, generated credentials or proprietary third-party code in commits.
+8. Version changes require updating `fluxscript/version.py`, `pyproject.toml`, tests and release notes together.

fluxscript-0.1.0/FluxScript.egg-info/PKG-INFO

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

@@ -0,0 +1,41 @@
+CHANGELOG.md
+CONTRIBUTING.md
+FluxScript_Release.ipynb
+LICENSE
+MANIFEST.in
+README.md
+SECURITY.md
+TEST_REPORT.md
+pyproject.toml
+.github/workflows/ci.yml
+FluxScript.egg-info/PKG-INFO
+FluxScript.egg-info/SOURCES.txt
+FluxScript.egg-info/dependency_links.txt
+FluxScript.egg-info/entry_points.txt
+FluxScript.egg-info/requires.txt
+FluxScript.egg-info/top_level.txt
+docs/ARCHITECTURE.md
+docs/COMMANDS.md
+docs/INTEGRATION_NOTES.md
+docs/PYPI_RELEASE.md
+docs/ROADMAP.md
+examples/app.py
+fluxscript/__init__.py
+fluxscript/__main__.py
+fluxscript/analyzer.py
+fluxscript/cli.py
+fluxscript/dependencies.py
+fluxscript/dsl.py
+fluxscript/models.py
+fluxscript/parser.py
+fluxscript/project.py
+fluxscript/version.py
+fluxscript/backends/__init__.py
+fluxscript/backends/android.py
+fluxscript/backends/cli.py
+fluxscript/backends/ios.py
+fluxscript/backends/web.py
+fluxscript/integrations/__init__.py
+fluxscript/integrations/commands.py
+fluxscript/integrations/execution_service.py
+tests/test_core.py

fluxscript-0.1.0/FluxScript.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fluxscript-0.1.0/FluxScript.egg-info/entry_points.txt

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

fluxscript-0.1.0/FluxScript.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[test]
+pytest>=8.0
+build>=1.2
+twine>=5.0

fluxscript-0.1.0/FluxScript.egg-info/top_level.txt

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

fluxscript-0.1.0/FluxScript_Release.ipynb

@@ -0,0 +1,283 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# FluxScript 0.1.0 \u2014 GitHub and PyPI Release Notebook\n",
+        "\n",
+        "**Author:** Md Safarujjaman  \n",
+        "**Distribution:** `FluxScript`  \n",
+        "**Version:** `0.1.0`\n",
+        "\n",
+        "This notebook prepares a clean release, runs tests, builds and validates the wheel/source archive, and optionally publishes to PyPI and pushes source to an existing GitHub repository.\n",
+        "\n",
+        "**Security:** Tokens are requested through hidden prompts and are not written into source files. Never print, paste into a code cell, or commit a token. Prefer a project-scoped PyPI token or PyPI Trusted Publishing. The PyPI project name must be available to you. GitHub publishing requires an existing empty repository and a token with repository contents write access. Publishing is optional and requires explicit confirmation in the relevant cells.\n",
+        "\n",
+        "Run top to bottom. Works best in Google Colab, but the upload cell also accepts a local file path in ordinary Jupyter."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "from pathlib import Path\n",
+        "import os, shutil, subprocess, sys, zipfile, tempfile, getpass, textwrap\n",
+        "\n",
+        "WORK_ROOT = Path.cwd()\n",
+        "SOURCE_ZIP = None\n",
+        "\n",
+        "def run(command, *, cwd=None, env=None):\n",
+        "    print(\"$\", \" \".join(map(str, command)))\n",
+        "    subprocess.run(list(map(str, command)), cwd=cwd, env=env, check=True)\n",
+        "\n",
+        "def locate_project(root: Path) -> Path:\n",
+        "    candidates = [root] + [p for p in root.rglob(\"pyproject.toml\") if p.parent != root]\n",
+        "    for candidate in candidates:\n",
+        "        if (candidate / \"pyproject.toml\").is_file() and (candidate / \"fluxscript\").is_dir():\n",
+        "            return candidate\n",
+        "    raise FileNotFoundError(\"Could not find a FluxScript source folder containing pyproject.toml and fluxscript/.\")\n",
+        "\n",
+        "print(\"Python:\", sys.version)\n",
+        "print(\"Working directory:\", WORK_ROOT)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 1. Upload the source ZIP\n",
+        "\n",
+        "Upload `FluxScript-0.1.0-source.zip` from the project download. In Google Colab, a file picker opens. In local Jupyter, enter the ZIP path when prompted."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "try:\n",
+        "    from google.colab import files  # type: ignore\n",
+        "    uploaded = files.upload()\n",
+        "    if not uploaded:\n",
+        "        raise RuntimeError(\"No ZIP uploaded.\")\n",
+        "    SOURCE_ZIP = Path(next(iter(uploaded.keys()))).resolve()\n",
+        "except ImportError:\n",
+        "    SOURCE_ZIP = Path(input(\"Path to FluxScript source ZIP: \").strip()).expanduser().resolve()\n",
+        "\n",
+        "if not SOURCE_ZIP.is_file() or SOURCE_ZIP.suffix.lower() != \".zip\":\n",
+        "    raise FileNotFoundError(f\"Source ZIP not found or not a .zip file: {SOURCE_ZIP}\")\n",
+        "\n",
+        "EXTRACT_ROOT = WORK_ROOT / \"fluxscript_release_input\"\n",
+        "if EXTRACT_ROOT.exists():\n",
+        "    shutil.rmtree(EXTRACT_ROOT)\n",
+        "EXTRACT_ROOT.mkdir(parents=True)\n",
+        "with zipfile.ZipFile(SOURCE_ZIP) as archive:\n",
+        "    # Reject path traversal entries before extraction.\n",
+        "    for member in archive.infolist():\n",
+        "        destination = (EXTRACT_ROOT / member.filename).resolve()\n",
+        "        if destination != EXTRACT_ROOT.resolve() and EXTRACT_ROOT.resolve() not in destination.parents:\n",
+        "            raise ValueError(f\"Unsafe ZIP path: {member.filename}\")\n",
+        "    archive.extractall(EXTRACT_ROOT)\n",
+        "PROJECT = locate_project(EXTRACT_ROOT)\n",
+        "print(\"Source project:\", PROJECT)\n",
+        "print((PROJECT / \"pyproject.toml\").read_text(encoding=\"utf-8\"))"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 2. Install release tools and verify metadata\n",
+        "\n",
+        "This installs the packaging tools in the notebook runtime only. It does not modify the FluxScript runtime dependency list."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "run([sys.executable, \"-m\", \"pip\", \"install\", \"--upgrade\", \"build\", \"twine\"])\n",
+        "\n",
+        "try:\n",
+        "    import tomllib\n",
+        "except ImportError:  # Python 3.10\n",
+        "    run([sys.executable, \"-m\", \"pip\", \"install\", \"tomli\"])\n",
+        "    import tomli as tomllib\n",
+        "metadata = tomllib.loads((PROJECT / \"pyproject.toml\").read_text(encoding=\"utf-8\"))\n",
+        "project_meta = metadata[\"project\"]\n",
+        "assert project_meta[\"name\"].lower() == \"fluxscript\", project_meta[\"name\"]\n",
+        "assert project_meta[\"version\"] == \"0.1.0\", project_meta[\"version\"]\n",
+        "assert project_meta.get(\"authors\", [{}])[0].get(\"name\") == \"Md Safarujjaman\"\n",
+        "print(\"Metadata checks passed:\", project_meta[\"name\"], project_meta[\"version\"], project_meta[\"authors\"])"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 3. Run tests and build clean distributions\n",
+        "\n",
+        "The source ZIP may contain previously generated artifacts; this step removes them and builds fresh artifacts from the checked source."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "dist_dir = PROJECT / \"dist\"\n",
+        "if dist_dir.exists():\n",
+        "    shutil.rmtree(dist_dir)\n",
+        "for generated in PROJECT.glob(\"*.egg-info\"):\n",
+        "    shutil.rmtree(generated, ignore_errors=True)\n",
+        "\n",
+        "run([sys.executable, \"-m\", \"compileall\", \"-q\", \"fluxscript\", \"tests\"], cwd=PROJECT)\n",
+        "run([sys.executable, \"-m\", \"unittest\", \"discover\", \"-s\", \"tests\", \"-v\"], cwd=PROJECT)\n",
+        "run([sys.executable, \"-m\", \"build\"], cwd=PROJECT)\n",
+        "run([sys.executable, \"-m\", \"twine\", \"check\", *sorted(dist_dir.glob(\"*\"))], cwd=PROJECT)\n",
+        "print(\"Release artifacts:\")\n",
+        "for artifact in sorted(dist_dir.glob(\"*\")):\n",
+        "    print(artifact.name, artifact.stat().st_size, \"bytes\")"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 4. Optional: publish to PyPI\n",
+        "\n",
+        "Confirm that the `FluxScript` project name is available and that you control it before continuing. For an existing project, use a project-scoped API token. The token is read with a hidden prompt and passed to Twine only through environment variables."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "publish_pypi = input(\"Publish these artifacts to PyPI now? Type YES to confirm: \").strip()\n",
+        "if publish_pypi == \"YES\":\n",
+        "    pypi_token = getpass.getpass(\"PyPI API token (input hidden): \").strip()\n",
+        "    if not pypi_token.startswith(\"pypi-\"):\n",
+        "        raise ValueError(\"This does not look like a PyPI API token. Nothing was uploaded.\")\n",
+        "    env = os.environ.copy()\n",
+        "    env[\"TWINE_USERNAME\"] = \"__token__\"\n",
+        "    env[\"TWINE_PASSWORD\"] = pypi_token\n",
+        "    env[\"TWINE_NON_INTERACTIVE\"] = \"1\"\n",
+        "    try:\n",
+        "        run([sys.executable, \"-m\", \"twine\", \"upload\", \"--non-interactive\", *sorted(dist_dir.glob(\"*\"))], cwd=PROJECT, env=env)\n",
+        "        print(\"PyPI upload command completed. Verify the release on your PyPI project page.\")\n",
+        "    finally:\n",
+        "        env.pop(\"TWINE_PASSWORD\", None)\n",
+        "        pypi_token = None\n",
+        "else:\n",
+        "    print(\"Skipped PyPI upload. Artifacts remain in:\", dist_dir)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 5. Optional: push source to GitHub\n",
+        "\n",
+        "Create an **empty** GitHub repository first. This cell pushes the source tree to its `main` branch. A token is entered with a hidden prompt and is not embedded in the remote URL or saved in the repository. Do not use a personal token with broader permissions than necessary."
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {},
+      "outputs": [],
+      "source": [
+        "push_github = input(\"Push this source tree to an existing GitHub repository? Type YES to confirm: \").strip()\n",
+        "if push_github == \"YES\":\n",
+        "    repo_url = input(\"HTTPS URL of your empty GitHub repository (for example https://github.com/USER/REPO.git): \").strip()\n",
+        "    if not repo_url.startswith(\"https://github.com/\") or not repo_url.endswith(\".git\"):\n",
+        "        raise ValueError(\"Use an HTTPS GitHub repository URL ending in .git. No push was attempted.\")\n",
+        "    github_token = getpass.getpass(\"GitHub token (hidden; needs repository contents write access): \").strip()\n",
+        "    if not github_token:\n",
+        "        raise ValueError(\"GitHub token is empty.\")\n",
+        "\n",
+        "    run([\"git\", \"--version\"], cwd=PROJECT)\n",
+        "    run([\"git\", \"init\", \"-b\", \"main\"], cwd=PROJECT)\n",
+        "    run([\"git\", \"config\", \"user.name\", \"Md Safarujjaman\"], cwd=PROJECT)\n",
+        "    commit_email = input(\"Git commit email (public email or GitHub noreply email): \").strip()\n",
+        "    if not commit_email or \"\\n\" in commit_email:\n",
+        "        raise ValueError(\"A valid one-line commit email is required.\")\n",
+        "    run([\"git\", \"config\", \"user.email\", commit_email], cwd=PROJECT)\n",
+        "    run([\"git\", \"add\", \"-A\"], cwd=PROJECT)\n",
+        "    run([\"git\", \"commit\", \"-m\", \"Release FluxScript 0.1.0\"], cwd=PROJECT)\n",
+        "    # Configure askpass in a temporary file; the secret is supplied only via env.\n",
+        "    askpass_dir = Path(tempfile.mkdtemp(prefix=\"fluxscript-askpass-\"))\n",
+        "    askpass = askpass_dir / \"askpass.py\"\n",
+        "    askpass.write_text(\n",
+        "        \"import os, sys\\nprompt = sys.argv[1].lower() if len(sys.argv) > 1 else ''\\n\"\n",
+        "        \"print('x-access-token' if 'username' in prompt else os.environ.get('FLUXSCRIPT_GITHUB_TOKEN', ''))\\n\",\n",
+        "        encoding=\"utf-8\",\n",
+        "    )\n",
+        "    env = os.environ.copy()\n",
+        "    env[\"GIT_ASKPASS\"] = sys.executable + \" \" + str(askpass)\n",
+        "    # GIT_ASKPASS is normally an executable path; use a temporary executable wrapper.\n",
+        "    wrapper = askpass_dir / \"askpass\"\n",
+        "    wrapper.write_text(\"#!/bin/sh\\nexec \"+repr(sys.executable)+\" \"+repr(str(askpass))+\" \\\"$@\\\"\\n\", encoding=\"utf-8\")\n",
+        "    wrapper.chmod(0o700)\n",
+        "    env[\"GIT_ASKPASS\"] = str(wrapper)\n",
+        "    env[\"GIT_TERMINAL_PROMPT\"] = \"0\"\n",
+        "    env[\"FLUXSCRIPT_GITHUB_TOKEN\"] = github_token\n",
+        "    try:\n",
+        "        remotes = subprocess.run([\"git\", \"remote\"], cwd=PROJECT, capture_output=True, text=True, check=True).stdout.split()\n",
+        "        if \"origin\" in remotes:\n",
+        "            run([\"git\", \"remote\", \"set-url\", \"origin\", repo_url], cwd=PROJECT)\n",
+        "        else:\n",
+        "            run([\"git\", \"remote\", \"add\", \"origin\", repo_url], cwd=PROJECT)\n",
+        "        run([\"git\", \"push\", \"-u\", \"origin\", \"main\"], cwd=PROJECT, env=env)\n",
+        "        print(\"GitHub push completed. Verify the repository page.\")\n",
+        "    finally:\n",
+        "        env.pop(\"FLUXSCRIPT_GITHUB_TOKEN\", None)\n",
+        "        github_token = None\n",
+        "        shutil.rmtree(askpass_dir, ignore_errors=True)\n",
+        "else:\n",
+        "    print(\"Skipped GitHub push. Source remains in:\", PROJECT)"
+      ]
+    },
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "## 6. Final checklist\n",
+        "\n",
+        "- [ ] Confirm the PyPI project name `FluxScript` is available or belongs to you.\n",
+        "- [ ] Check package metadata, license, README and release notes.\n",
+        "- [ ] Review the test output and `twine check` results.\n",
+        "- [ ] Prefer TestPyPI or a protected GitHub Actions Trusted Publishing workflow before a production release.\n",
+        "- [ ] Verify the PyPI release and GitHub repository after upload.\n",
+        "\n",
+        "**This notebook does not publish anything unless you explicitly type `YES` in the corresponding cell.** Version stays `0.1.0`; PyPI does not allow replacing an already-published file with the same version, so any changes after publishing require a new version."
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3.10+"
+    },
+    "colab": {
+      "name": "FluxScript_Release.ipynb",
+      "provenance": []
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 5
+}

fluxscript-0.1.0/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/MANIFEST.in

@@ -0,0 +1,13 @@
+include README.md LICENSE
+recursive-include docs *.md
+recursive-include examples *.py
+recursive-include tests *.py
+
+include SECURITY.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+recursive-include .github *.yml
+
+include FluxScript_Release.ipynb
+
+include TEST_REPORT.md