archiforge 0.1.0__tar.gz

archiforge-0.1.0/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: archiforge
+Version: 0.1.0
+Summary: A smart project scaffolding tool for developers
+Author-email: Abdullah <your-email@example.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click
+Requires-Dist: jinja2
+Requires-Dist: pyyaml
+
+# Archiforge 🛠️
+
+**Archiforge** is a multi-language project scaffolding engine. It helps developers "forge" standardized project structures for Python, JavaScript, Go, and more.
+
+## 🎯 Key Goals
+- **Multi-language Support**: Generate blueprints for any stack.
+- **Customizable**: Users can create their own project templates.
+- **CLI Driven**: Fast and intuitive command-line interface.
+
+## 📂 Structure
+- `src/archiforge/core`: The logic that builds the files.
+- `src/archiforge/blueprints`: Templates for different languages.

archiforge-0.1.0/README.md

@@ -0,0 +1,12 @@
+# Archiforge 🛠️
+
+**Archiforge** is a multi-language project scaffolding engine. It helps developers "forge" standardized project structures for Python, JavaScript, Go, and more.
+
+## 🎯 Key Goals
+- **Multi-language Support**: Generate blueprints for any stack.
+- **Customizable**: Users can create their own project templates.
+- **CLI Driven**: Fast and intuitive command-line interface.
+
+## 📂 Structure
+- `src/archiforge/core`: The logic that builds the files.
+- `src/archiforge/blueprints`: Templates for different languages.

archiforge-0.1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "archiforge"
+version = "0.1.0"
+authors = [
+  { name="Abdullah", email="your-email@example.com" },
+]
+description = "A smart project scaffolding tool for developers"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "click",
+    "jinja2",
+    "pyyaml",
+]
+
+[project.scripts]
+archiforge = "archiforge.cli.main:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]

archiforge-0.1.0/setup.cfg

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

archiforge-0.1.0/src/archiforge/cli/main.py

@@ -0,0 +1,102 @@
+import click
+import os
+import subprocess
+import time
+from archiforge.core.engine import ForgeEngine
+
+@click.group()
+def cli():
+    """Archiforge: أداة بناء المشاريع الذكية المتعددة اللغات 🛠️"""
+    pass
+
+@cli.command()
+@click.option('--name', prompt='Project Name', help='اسم المشروع الجديد')
+@click.option('--author', prompt='Author Name', help='اسم المبرمج')
+@click.option('--description', prompt='Description', help='وصف مختصر للمشروع')
+@click.option('--lang', default='python', help='اللغة المستخدمة')
+@click.option('--git-init', is_flag=True, help='تهيئة مستودع Git تلقائياً')
+@click.option('--include-tests', prompt='Include tests directory?', is_flag=True, default=False)
+@click.option('--with-db', prompt='Include Database (SQLAlchemy)?', is_flag=True, default=False)
+
+@click.option('--code', is_flag=True, help='Open the project in VS Code after forging')
+def create(name, author, description, lang, git_init, include_tests, with_db, code):
+
+    """إنشاء مشروع جديد مع شريط تقدم وتفاعل ذكي"""
+    
+    base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+    template_path = os.path.join(base_dir, "blueprints", lang)
+    output_path = os.path.join(os.getcwd(), name)
+    
+    if not os.path.exists(template_path):
+        click.secho(f"❌ Error: Template '{lang}' not found!", fg="red", bold=True)
+        return
+
+    if os.path.exists(output_path):
+
+        if not click.confirm(click.style(f"⚠️  The directory '{name}' already exists. Overwrite?", fg="yellow")):
+            click.echo("❌ Operation cancelled.")
+            return
+    if code:
+        click.echo(click.style("🖥️  Opening VS Code...", fg="cyan"))
+        try:
+            # أمر 'code .' يفتح المجلد الحالي في VS Code
+            subprocess.run(['code', output_path], shell=True)
+        except Exception as e:
+            click.secho(f"⚠️  Could not open VS Code: {e}", fg="yellow")
+    context = {
+        "project_name": name,
+        "author": author,
+        "description": description,
+        "include_tests": include_tests
+    }
+
+    try:
+        engine = ForgeEngine(template_path, output_path, context)
+        
+        # --- شريط التحميل الجمالي ---
+        click.echo(click.style(f"\n🚀 Starting the forge for '{name}'...", fg="magenta", bold=True))
+        
+        with click.progressbar(length=100, label='⚒️  Forging project structure') as bar:
+            # محاكاة خطوات العمل لجعل الشريط يبدو واقعياً
+            time.sleep(0.3)
+            bar.update(20)
+            
+            engine.forge() # العملية الحقيقية تحدث هنا
+            
+            time.sleep(0.3)
+            bar.update(80)
+        # ---------------------------
+
+        if git_init:
+            click.echo(click.style("⚓ Integrating Git repository...", fg="blue"))
+            os.chdir(output_path)
+            subprocess.run(['git', 'init'], check=True, capture_output=True)
+            subprocess.run(['git', 'add', '.'], check=True)
+            subprocess.run(['git', 'commit', '-m', 'Initial commit by Archiforge'], check=True, capture_output=True)
+            click.secho("✅ Git integration complete!", fg="green")
+
+        click.echo(click.style(f"\n✨ Project '{name}' is ready at: ", fg="green") + click.style(output_path, underline=True))
+
+    except Exception as e:
+        click.secho(f"💥 An unexpected error occurred: {e}", fg="red", bold=True)
+
+@cli.command()
+def list():
+    """عرض كافة القوالب المتاحة"""
+    current_dir = os.path.dirname(os.path.abspath(__file__))
+    base_dir = os.path.dirname(current_dir) # سيعود لمجلد archiforge داخل src
+    blueprints_path = os.path.join(base_dir, "blueprints")
+    
+    if not os.path.exists(blueprints_path):
+        click.secho("📂 No blueprints directory found.", fg="yellow")
+        return
+
+    blueprints = [d for d in os.listdir(blueprints_path) 
+                  if os.path.isdir(os.path.join(blueprints_path, d))]
+
+    click.secho("📂 Available Blueprints in Archiforge:", fg="cyan", bold=True)
+    for bp in blueprints:
+        click.echo(f"  - {bp}")
+
+if __name__ == "__main__":
+    cli()

archiforge-0.1.0/src/archiforge/core/engine.py

@@ -0,0 +1,81 @@
+import os
+import yaml
+import subprocess
+from jinja2 import Template
+
+class ForgeEngine:
+    def __init__(self, template_path, output_path, context):
+        """
+        template_path: مسار مجلد القالب
+        output_path: مسار المشروع الجديد المراد إنشاؤه
+        context: البيانات (الاسم، المؤلف، الوصف)
+        """
+        self.template_path = template_path
+        self.output_path = output_path
+        self.context = context
+
+    def load_structure(self):
+        """تحميل ومعالجة ملف structure.yaml كقالب Jinja2 أولاً"""
+        yaml_file = os.path.join(self.template_path, "structure.yaml")
+        if not os.path.exists(yaml_file):
+            raise FileNotFoundError(f"Missing structure.yaml in {self.template_path}")
+            
+        with open(yaml_file, 'r', encoding='utf-8') as f:
+            raw_yaml = f.read()
+        
+        # السحر هنا: معالجة الـ YAML نفسه كقالب قبل تحويله لبيانات
+        rendered_yaml = Template(raw_yaml).render(self.context)
+        return yaml.safe_load(rendered_yaml)
+
+    def forge(self):
+        """الوظيفة الأساسية لبناء المشروع"""
+        structure = self.load_structure()
+        
+        # التأكد من إنشاء المجلد الرئيسي للمشروع أولاً
+        if not os.path.exists(self.output_path):
+            os.makedirs(self.output_path, exist_ok=True)
+            print(f"🏗️  Created project root: {self.output_path}")
+
+        # 1. إنشاء المجلدات الفرعية المذكورة في القالب
+        for folder in structure.get('directories', []):
+            rendered_folder = Template(folder).render(self.context)
+            path = os.path.join(self.output_path, rendered_folder)
+            os.makedirs(path, exist_ok=True)
+            print(f"📁 Created directory: {path}")
+
+        # 2. إنشاء الملفات وتعبئة محتواها
+        for file_info in structure.get('files', []):
+            rendered_path = Template(file_info['path']).render(self.context)
+            rendered_content = Template(file_info['content']).render(self.context)
+            
+            full_path = os.path.join(self.output_path, rendered_path)
+            
+            # التأكد من وجود المجلد الأب للملف (في حال كان ملفاً عميقاً)
+            os.makedirs(os.path.dirname(full_path), exist_ok=True)
+            
+            with open(full_path, 'w', encoding='utf-8') as f:
+                f.write(rendered_content)
+            print(f"📄 Created file: {full_path}")
+
+        # 3. تنفيذ أوامر ما بعد البناء
+        self.run_post_commands(structure.get('post_commands', []))
+        
+        print(f"\n✅ Archiforge: Project '{self.context['project_name']}' forged successfully!")
+
+    def run_post_commands(self, commands):
+        """تنفيذ أوامر مثل git init أو npm install"""
+        if not commands:
+            return
+        
+        original_dir = os.getcwd()
+        os.chdir(self.output_path)
+        
+        for cmd in commands:
+            rendered_cmd = Template(cmd).render(self.context)
+            print(f"⚡ Running: {rendered_cmd}...")
+            try:
+                subprocess.run(rendered_cmd, shell=True, check=True)
+            except subprocess.CalledProcessError as e:
+                print(f"⚠️  Command failed: {e}")
+        
+        os.chdir(original_dir)

archiforge-0.1.0/src/archiforge.egg-info/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: archiforge
+Version: 0.1.0
+Summary: A smart project scaffolding tool for developers
+Author-email: Abdullah <your-email@example.com>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click
+Requires-Dist: jinja2
+Requires-Dist: pyyaml
+
+# Archiforge 🛠️
+
+**Archiforge** is a multi-language project scaffolding engine. It helps developers "forge" standardized project structures for Python, JavaScript, Go, and more.
+
+## 🎯 Key Goals
+- **Multi-language Support**: Generate blueprints for any stack.
+- **Customizable**: Users can create their own project templates.
+- **CLI Driven**: Fast and intuitive command-line interface.
+
+## 📂 Structure
+- `src/archiforge/core`: The logic that builds the files.
+- `src/archiforge/blueprints`: Templates for different languages.

archiforge-0.1.0/src/archiforge.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/archiforge/__init__.py
+src/archiforge.egg-info/PKG-INFO
+src/archiforge.egg-info/SOURCES.txt
+src/archiforge.egg-info/dependency_links.txt
+src/archiforge.egg-info/entry_points.txt
+src/archiforge.egg-info/requires.txt
+src/archiforge.egg-info/top_level.txt
+src/archiforge/cli/main.py
+src/archiforge/core/engine.py

archiforge-0.1.0/src/archiforge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

archiforge-0.1.0/src/archiforge.egg-info/entry_points.txt

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

archiforge-0.1.0/src/archiforge.egg-info/requires.txt

@@ -0,0 +1,3 @@
+click
+jinja2
+pyyaml

archiforge-0.1.0/src/archiforge.egg-info/top_level.txt

@@ -0,0 +1 @@
+archiforge