initstack 1.5.0__tar.gz

initstack-1.5.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: initstack
+Version: 1.5.0
+Summary: Universal, environment-aware project initializer
+Requires-Python: >=3.8
+Requires-Dist: jsonschema>=4.0.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

initstack-1.5.0/README.md

@@ -0,0 +1,20 @@
+# Initstack
+
+Initstack is a universal, environment-aware CLI tool for initializing project
+structures across multiple platforms.
+
+## Features
+- Works on Termux, Linux, RNX, macOS, WSL
+- No root required
+- User-space friendly
+- Offline templates
+- Simple and extensible
+
+## Philosophy
+Initstack adapts to your environment. It does not install system dependencies,
+require sudo, or assume a specific OS or package manager.
+
+## 🏷 Version
+Release: (v1.5.0)
+Stability: (Stable)
+Python: ≥ (3.8)

initstack-1.5.0/initstack/cli/commands.py

@@ -0,0 +1,95 @@
+import sys
+import os
+import platform
+
+from initstack.core.templates import list_templates, get_template
+from initstack.core.project import create_project
+
+
+# -------------------------
+# Command handlers
+# -------------------------
+
+def cmd_list(args):
+    print("ℹ Available templates:")
+    for name in list_templates():
+        print(f"  - {name}")
+
+
+def cmd_new(args):
+    template = get_template(args.template)
+    create_project(template, args.name)
+
+
+def cmd_doctor(args):
+    print("\n🩺 Initstack Doctor Report\n")
+
+    # Python
+    print(f"✔ Python executable: {sys.executable}")
+    print(f"✔ Python version: {platform.python_version()}")
+
+    # OS
+    print(f"✔ Platform: {platform.system().lower()}")
+
+    # Home directory
+    home = os.path.expanduser("~")
+    print(f"✔ Home directory: {home}")
+
+    # Plugin directory
+    plugin_dir = os.path.expanduser("~/.initstack/plugins")
+    print(f"\n🔌 Plugin directory: {plugin_dir}")
+
+    if not os.path.isdir(plugin_dir):
+        print("⚠ Plugin directory does not exist")
+        return
+
+    plugins = os.listdir(plugin_dir)
+    if not plugins:
+        print("⚠ No plugins installed")
+    else:
+        print("✔ Installed plugins:")
+        for p in plugins:
+            print(f"  - {p}")
+
+    print("\n✅ Doctor check complete\n")
+
+
+def cmd_self_update(args):
+    print("ℹ Self-update is not yet implemented")
+    print("ℹ Use: pip install --upgrade initstack")
+
+
+# -------------------------
+# Subcommand registration
+# -------------------------
+
+def build_parser(subparsers):
+    # list
+    p_list = subparsers.add_parser(
+        "list",
+        help="List available templates"
+    )
+    p_list.set_defaults(func=cmd_list)
+
+    # new
+    p_new = subparsers.add_parser(
+        "new",
+        help="Create a new project"
+    )
+    p_new.add_argument("template", help="Template name")
+    p_new.add_argument("name", help="Project directory name")
+    p_new.set_defaults(func=cmd_new)
+
+    # doctor
+    p_doctor = subparsers.add_parser(
+        "doctor",
+        help="Check environment health"
+    )
+    p_doctor.set_defaults(func=cmd_doctor)
+
+    # self-update
+    p_update = subparsers.add_parser(
+        "self-update",
+        help="Update initstack to the latest version"
+    )
+    p_update.set_defaults(func=cmd_self_update)

initstack-1.5.0/initstack/cli/main.py

@@ -0,0 +1,19 @@
+import argparse
+import platform
+
+from initstack.cli.commands import build_parser
+
+
+def main():
+    print(f"ℹ Initstack running on: {platform.system().lower()}")
+
+    parser = argparse.ArgumentParser(
+        prog="initstack",
+        description="Universal, environment-aware project initializer"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    build_parser(subparsers)
+
+    args = parser.parse_args()
+    args.func(args)

initstack-1.5.0/initstack/core/environment.py

@@ -0,0 +1,11 @@
+# initstack/core/environment.py
+import os
+import platform
+
+def detect_environment():
+    if "TERMUX_VERSION" in os.environ or os.path.exists("/data/data/com.termux"):
+        return "termux"
+    if os.environ.get("RNX_WORKSPACE"):
+        return "rnx"
+    system = platform.system().lower()
+    return system

initstack-1.5.0/initstack/core/filesystem.py

@@ -0,0 +1,9 @@
+# initstack/core/filesystem.py
+import os
+
+def create_structure(base_path, structure):
+    for path, content in structure.items():
+        full = os.path.join(base_path, path)
+        os.makedirs(os.path.dirname(full), exist_ok=True)
+        with open(full, "w", encoding="utf-8") as f:
+            f.write(content)

initstack-1.5.0/initstack/core/gitutils.py

@@ -0,0 +1,22 @@
+import subprocess
+import os
+import shutil
+from datetime import datetime
+
+def init_git_repo(path):
+    subprocess.run(["git", "init"], cwd=path)
+
+def add_license(path, license_name, author):
+    src = os.path.join(
+        os.path.dirname(__file__), "..", "licenses", f"{license_name}.txt"
+    )
+    dst = os.path.join(path, "LICENSE")
+
+    with open(src, "r") as f:
+        content = f.read()
+
+    content = content.replace("{{year}}", str(datetime.now().year))
+    content = content.replace("{{author}}", author)
+
+    with open(dst, "w") as f:
+        f.write(content)

initstack-1.5.0/initstack/core/plugins.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+import json
+
+PLUGIN_DIRS = [
+    Path.cwd() / ".initstack/templates",
+    Path.home() / ".initstack/templates"
+]
+
+def load_plugins():
+    plugins = {}
+
+    for base in PLUGIN_DIRS:
+        if not base.exists():
+            continue
+
+        for tpl in base.iterdir():
+            cfg = tpl / "template.json"
+            if cfg.exists():
+                with open(cfg) as f:
+                    data = json.load(f)
+                plugins[data["name"]] = (tpl, data)
+
+    return plugins

initstack-1.5.0/initstack/core/project.py

@@ -0,0 +1,37 @@
+import os
+from pathlib import Path
+
+
+def create_project(template: dict, project_name: str):
+    """
+    Create a project directory structure from a template definition.
+    """
+    root = Path(project_name)
+
+    if root.exists():
+        raise FileExistsError(f"Directory '{project_name}' already exists")
+
+    print(f"📁 Creating project: {project_name}")
+    root.mkdir(parents=True)
+
+    structure = template.get("structure", {})
+
+    _create_structure(root, structure)
+
+    print("✅ Project created successfully")
+
+
+def _create_structure(base: Path, structure: dict):
+    for name, content in structure.items():
+        path = base / name
+
+        if isinstance(content, dict):
+            path.mkdir(parents=True, exist_ok=True)
+            _create_structure(path, content)
+
+        elif isinstance(content, str):
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.write_text(content, encoding="utf-8")
+
+        else:
+            raise ValueError(f"Invalid structure item: {name}")

initstack-1.5.0/initstack/core/schema/__init__.py

@@ -0,0 +1,6 @@
+import json
+from pathlib import Path
+
+template_schema = json.load(
+    open(Path(__file__).parent / "template.schema.json")
+)

initstack-1.5.0/initstack/core/schema.py

@@ -0,0 +1,12 @@
+TEMPLATE_SCHEMA = {
+    "type": "object",
+    "required": ["name", "version", "files"],
+    "properties": {
+        "name": {"type": "string"},
+        "version": {"type": "string"},
+        "files": {
+            "type": "object",
+            "additionalProperties": {"type": "string"}
+        }
+    }
+}

initstack-1.5.0/initstack/core/templates.py

@@ -0,0 +1,108 @@
+import json
+import os
+from pathlib import Path
+from jsonschema import validate, ValidationError
+
+# Built-in templates directory
+BUILTIN_DIR = Path(__file__).parent / "builtin"
+
+# User plugin directory
+PLUGIN_DIR = Path(os.path.expanduser("~/.initstack/plugins"))
+
+# Load JSON schema
+from initstack.core.schema import template_schema
+
+
+def _load_template_from_dir(template_dir: Path):
+    """
+    Load and validate a template from a directory.
+    Expects template.json inside the directory.
+    """
+    template_file = template_dir / "template.json"
+
+    if not template_file.exists():
+        return None
+
+    try:
+        with open(template_file, "r", encoding="utf-8") as f:
+            data = json.load(f)
+    except Exception as e:
+        print(f"⚠ Failed to parse {template_file}: {e}")
+        return None
+
+    # Schema validation
+    try:
+        validate(instance=data, schema=template_schema)
+    except ValidationError as e:
+        print(f"⚠ Invalid template.json in {template_dir.name}: {e.message}")
+        return None
+
+    # Name consistency
+    name = data.get("name")
+    if not name:
+        print(f"⚠ Template in {template_dir} missing 'name'")
+        return None
+
+    return name, data
+
+
+def load_builtin_templates():
+    templates = {}
+
+    if not BUILTIN_DIR.exists():
+        return templates
+
+    for item in BUILTIN_DIR.iterdir():
+        if not item.is_dir():
+            continue
+
+        result = _load_template_from_dir(item)
+        if result:
+            name, data = result
+            templates[name] = data
+
+    return templates
+
+
+def load_plugins():
+    templates = {}
+
+    if not PLUGIN_DIR.exists():
+        return templates
+
+    for item in PLUGIN_DIR.iterdir():
+        if not item.is_dir():
+            continue
+
+        result = _load_template_from_dir(item)
+        if result:
+            name, data = result
+            templates[name] = data
+
+    return templates
+
+
+def list_templates():
+    """
+    Return sorted list of all available template names.
+    """
+    templates = {}
+    templates.update(load_builtin_templates())
+    templates.update(load_plugins())
+
+    return sorted(templates.keys())
+
+
+def get_template(name: str):
+    """
+    Return template structure by name.
+    Raises ValueError if not found.
+    """
+    templates = {}
+    templates.update(load_builtin_templates())
+    templates.update(load_plugins())
+
+    if name not in templates:
+        raise ValueError(f"Unknown template: {name}")
+
+    return templates[name]

initstack-1.5.0/initstack/utils/config.py

@@ -0,0 +1,12 @@
+# initstack/utils/config.py
+import os
+import yaml
+
+CONFIG_FILE = "initstack.yaml"
+
+def load_config():
+    if not os.path.exists(CONFIG_FILE):
+        return {}
+
+    with open(CONFIG_FILE, "r") as f:
+        return yaml.safe_load(f) or {}

initstack-1.5.0/initstack/utils/output.py

@@ -0,0 +1,13 @@
+# initstack/utils/output.py
+import os
+
+PLAIN = os.environ.get("INITSTACK_PLAIN") == "1"
+
+def info(msg):
+    print(msg if PLAIN else f"ℹ {msg}")
+
+def success(msg):
+    print(msg if PLAIN else f"✅ {msg}")
+
+def error(msg):
+    print(msg if PLAIN else f"❌ {msg}")

initstack-1.5.0/initstack.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: initstack
+Version: 1.5.0
+Summary: Universal, environment-aware project initializer
+Requires-Python: >=3.8
+Requires-Dist: jsonschema>=4.0.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

initstack-1.5.0/initstack.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+README.md
+setup.py
+initstack/__init__.py
+initstack.egg-info/PKG-INFO
+initstack.egg-info/SOURCES.txt
+initstack.egg-info/dependency_links.txt
+initstack.egg-info/entry_points.txt
+initstack.egg-info/requires.txt
+initstack.egg-info/top_level.txt
+initstack/cli/__init__.py
+initstack/cli/commands.py
+initstack/cli/main.py
+initstack/core/__init__.py
+initstack/core/environment.py
+initstack/core/filesystem.py
+initstack/core/gitutils.py
+initstack/core/plugins.py
+initstack/core/project.py
+initstack/core/schema.py
+initstack/core/templates.py
+initstack/core/schema/__init__.py
+initstack/utils/__init__.py
+initstack/utils/config.py
+initstack/utils/output.py

initstack-1.5.0/initstack.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

initstack-1.5.0/initstack.egg-info/entry_points.txt

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

initstack-1.5.0/initstack.egg-info/requires.txt

@@ -0,0 +1 @@
+jsonschema>=4.0.0

initstack-1.5.0/initstack.egg-info/top_level.txt

@@ -0,0 +1 @@
+initstack

initstack-1.5.0/setup.cfg

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

initstack-1.5.0/setup.py

@@ -0,0 +1,18 @@
+# setup.py
+from setuptools import setup, find_packages
+
+setup(
+    name="initstack",
+    version="1.5.0",
+    description="Universal, environment-aware project initializer",
+    packages=find_packages(),
+    install_requires=[
+        "jsonschema>=4.0.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "initstack=initstack.cli.main:main",
+        ]
+    },
+    python_requires=">=3.8",
+)