hugoifier 0.1.0__tar.gz

hugoifier-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CONFLICT LLC. All rights reserved.
+
+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.

hugoifier-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include requirements.txt
+recursive-include hugoifier *.py

hugoifier-0.1.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: hugoifier
+Version: 0.1.0
+Summary: AI-powered Hugo theme converter with Decap CMS integration
+Author: CONFLICT LLC
+License-Expression: MIT
+Project-URL: Homepage, https://hugoifier.dev
+Project-URL: Documentation, https://hugoifier.dev
+Project-URL: Repository, https://github.com/ConflictHQ/hugoifier
+Project-URL: Issues, https://github.com/ConflictHQ/hugoifier/issues
+Keywords: hugo,cms,decap,static-site,theme,ai,converter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.5.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: google-generativeai>=0.3.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.3.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# Hugoifier (AI-Powered Theme Converter)
+
+A utility that takes your HTML template/website or Hugo them and generates a production-ready Hugo theme with Decap CMS integration. 
+
+## What is it?
+
+Hugoifier is a Python-based utility that:
+
+- Converts any HTML/JS/CSS theme into a Hugo-compatible theme using AI.
+- Extracts layout data into structured files (`data/*.yaml` or `data/*.json`) to make the theme editable via Decap CMS.
+- Generates and wires Decap CMS into the Hugo setup, making it fully ready for content management.
+- Uses OpenAI's efficient AI models to analyze theme files and determine the best Hugo template tag placements.
+
+## Core Features & Workflow
+
+### Step 1: AI-Powered HTML Conversion
+
+- Uses GPT-4-Turbo to analyze an HTML theme and suggest where Hugo template tags (`{{ .Title }}`, `{{ .Content }}`, etc.) should be placed.
+- Identifies partials (e.g., `header.html`, `footer.html`) and reusable elements.
+- Converts all hardcoded links, images, and text into Hugo-friendly components.
+
+### Step2 2: Decap CMS Integration
+
+- Extracts the site structure elements (navigation, hero sections, footers) into YAML/JSON files in Hugo's `data/` directory.
+- Generates a Decap CMS `config.yml` file with proper collections for pages, posts, and layout elements.
+- Ensures the generated theme is fully editable via Decap CMS.
+
+### Step3 3: Automation & Deployment
+
+- Provides a Python CLI tool to automate the entire conversion process.
+- Offer interactive mode for customization and auto mode for full automation.
+- Ensure themes are deployable on Cloudflare Pages CMS setups.
+- Deploy the CMS on Cloudflare Pages.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.11.4
+- Hugo extended version
+- OpenAI API key
+- Cloudflare account (for deployment)
+
+### Installation
+
+1. **Clone the repository:**
+
+   ```bash
+   git clone https://github.com/yourusername/hugo-ifier.git
+   ```
+
+2. **Install the required Python packages:**
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## Usage
+
+Run the CLI tool to start the conversion process:
+
+```bash
+python cli.py convert --input theme.html --output hugo-theme
+```

hugoifier-0.1.0/README.md

@@ -0,0 +1,64 @@
+# Hugoifier (AI-Powered Theme Converter)
+
+A utility that takes your HTML template/website or Hugo them and generates a production-ready Hugo theme with Decap CMS integration. 
+
+## What is it?
+
+Hugoifier is a Python-based utility that:
+
+- Converts any HTML/JS/CSS theme into a Hugo-compatible theme using AI.
+- Extracts layout data into structured files (`data/*.yaml` or `data/*.json`) to make the theme editable via Decap CMS.
+- Generates and wires Decap CMS into the Hugo setup, making it fully ready for content management.
+- Uses OpenAI's efficient AI models to analyze theme files and determine the best Hugo template tag placements.
+
+## Core Features & Workflow
+
+### Step 1: AI-Powered HTML Conversion
+
+- Uses GPT-4-Turbo to analyze an HTML theme and suggest where Hugo template tags (`{{ .Title }}`, `{{ .Content }}`, etc.) should be placed.
+- Identifies partials (e.g., `header.html`, `footer.html`) and reusable elements.
+- Converts all hardcoded links, images, and text into Hugo-friendly components.
+
+### Step2 2: Decap CMS Integration
+
+- Extracts the site structure elements (navigation, hero sections, footers) into YAML/JSON files in Hugo's `data/` directory.
+- Generates a Decap CMS `config.yml` file with proper collections for pages, posts, and layout elements.
+- Ensures the generated theme is fully editable via Decap CMS.
+
+### Step3 3: Automation & Deployment
+
+- Provides a Python CLI tool to automate the entire conversion process.
+- Offer interactive mode for customization and auto mode for full automation.
+- Ensure themes are deployable on Cloudflare Pages CMS setups.
+- Deploy the CMS on Cloudflare Pages.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.11.4
+- Hugo extended version
+- OpenAI API key
+- Cloudflare account (for deployment)
+
+### Installation
+
+1. **Clone the repository:**
+
+   ```bash
+   git clone https://github.com/yourusername/hugo-ifier.git
+   ```
+
+2. **Install the required Python packages:**
+
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## Usage
+
+Run the CLI tool to start the conversion process:
+
+```bash
+python cli.py convert --input theme.html --output hugo-theme
+```

hugoifier-0.1.0/hugoifier/__init__.py

@@ -0,0 +1,3 @@
+"""Hugoifier — AI-powered Hugo theme converter with Decap CMS integration."""
+
+__version__ = "0.1.0"

hugoifier-0.1.0/hugoifier/cli.py

@@ -0,0 +1,127 @@
+"""
+Hugo-ifier CLI Tool
+
+Usage examples:
+  python cli.py complete themes/revolve-hugo
+  python cli.py complete themes/revolve-hugo --output /tmp/my-site
+  HUGOIFIER_BACKEND=openai python cli.py complete themes/revolve-hugo
+  python cli.py analyze themes/revolve-hugo
+  python cli.py hugoify themes/revolve-hugo
+  python cli.py decapify output/revolve-hugo
+"""
+
+import argparse
+import logging
+import sys
+
+from .utils.analyze import analyze
+from .utils.cloudflare import configure_cloudflare
+from .utils.complete import complete
+from .utils.decapify import decapify
+from .utils.deploy import deploy
+from .utils.hugoify import hugoify
+from .utils.parser import parse
+from .utils.translate import translate
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Hugo-ifier — AI-powered Hugo theme converter",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=__doc__,
+    )
+    parser.add_argument(
+        '--backend', choices=['anthropic', 'openai', 'google'],
+        help='AI backend to use (overrides HUGOIFIER_BACKEND env var)',
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    # complete — full pipeline
+    complete_parser = subparsers.add_parser("complete", help="Run the full pipeline (analyze → hugoify → decap)")
+    complete_parser.add_argument("path", help="Path to the theme directory")
+    complete_parser.add_argument("--output", "-o", help="Output directory (default: output/{theme-name})")
+    complete_parser.add_argument("--cms-name", default=None, help="Whitelabel CMS name")
+    complete_parser.add_argument("--cms-logo", default=None, help="Whitelabel logo URL")
+    complete_parser.add_argument("--cms-color", default=None, help="Whitelabel top-bar hex color")
+
+    # analyze
+    analyze_parser = subparsers.add_parser("analyze", help="Analyze a theme and report structure")
+    analyze_parser.add_argument("path", help="Path to the theme")
+
+    # hugoify
+    hugoify_parser = subparsers.add_parser("hugoify", help="Convert HTML to Hugo theme (or validate existing Hugo theme)")
+    hugoify_parser.add_argument("path", help="Path to HTML file or theme directory")
+
+    # decapify
+    decapify_parser = subparsers.add_parser("decapify", help="Add Decap CMS to an assembled Hugo site")
+    decapify_parser.add_argument("path", help="Path to the Hugo site directory")
+    decapify_parser.add_argument("--cms-name", default=None, help="Whitelabel CMS name (default: 'Content Manager')")
+    decapify_parser.add_argument("--cms-logo", default=None, help="Whitelabel logo URL")
+    decapify_parser.add_argument("--cms-color", default=None, help="Whitelabel top-bar hex color")
+
+    # translate
+    translate_parser = subparsers.add_parser("translate", help="Translate content to another language")
+    translate_parser.add_argument("path", help="Path to the content file")
+    translate_parser.add_argument("--target-language", default="Spanish", help="Target language (default: Spanish)")
+
+    # parse / lint
+    parser_parser = subparsers.add_parser("parser", help="Parse and lint (stub)")
+    parser_parser.add_argument("path", help="Path to the theme")
+
+    # deploy (stub)
+    deploy_parser = subparsers.add_parser("deploy", help="Deploy to Cloudflare (stub)")
+    deploy_parser.add_argument("path", help="Path to the site")
+    deploy_parser.add_argument("zone", help="Cloudflare zone")
+
+    # cloudflare (stub)
+    cloudflare_parser = subparsers.add_parser("cloudflare", help="Configure Cloudflare (stub)")
+    cloudflare_parser.add_argument("path", help="Path to the site")
+    cloudflare_parser.add_argument("zone", help="Cloudflare zone")
+
+    args = parser.parse_args()
+
+    logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+
+    # Override backend if specified on command line
+    if args.backend:
+        import config as cfg
+        cfg.BACKEND = args.backend
+
+    try:
+        if args.command == "complete":
+            result = complete(
+                args.path,
+                output_dir=args.output,
+                cms_name=args.cms_name,
+                cms_logo=args.cms_logo,
+                cms_color=args.cms_color,
+            )
+            print(result)
+        elif args.command == "analyze":
+            print(analyze(args.path))
+        elif args.command == "hugoify":
+            print(hugoify(args.path))
+        elif args.command == "decapify":
+            print(decapify(
+                args.path,
+                cms_name=args.cms_name,
+                cms_logo=args.cms_logo,
+                cms_color=args.cms_color,
+            ))
+        elif args.command == "translate":
+            print(translate(args.path, target_language=args.target_language))
+        elif args.command == "parser":
+            print(parse(args.path))
+        elif args.command == "deploy":
+            print(deploy(args.path, args.zone))
+        elif args.command == "cloudflare":
+            print(configure_cloudflare(args.path, args.zone))
+        else:
+            parser.print_help()
+    except (ValueError, EnvironmentError) as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

hugoifier-0.1.0/hugoifier/config.py

@@ -0,0 +1,90 @@
+"""
+Multi-backend AI configuration.
+
+Set HUGOIFIER_BACKEND env var to switch backends:
+  anthropic  (default) — claude-sonnet-4-6
+  openai               — gpt-4-turbo
+  google               — gemini-1.5-pro
+
+Model can be overridden per-backend:
+  ANTHROPIC_MODEL, OPENAI_MODEL, GOOGLE_MODEL
+"""
+
+import os
+
+BACKEND = os.getenv('HUGOIFIER_BACKEND', 'anthropic').lower()
+
+# Anthropic settings
+ANTHROPIC_API_KEY = os.getenv('ANTHROPIC_API_KEY')
+ANTHROPIC_MODEL = os.getenv('ANTHROPIC_MODEL', 'claude-sonnet-4-6')
+
+# OpenAI settings
+OPENAI_API_KEY = os.getenv('OPENAI_API_KEY')
+OPENAI_MODEL = os.getenv('OPENAI_MODEL', 'gpt-4-turbo')
+
+# Google settings
+GOOGLE_API_KEY = os.getenv('GOOGLE_API_KEY')
+GOOGLE_MODEL = os.getenv('GOOGLE_MODEL', 'gemini-1.5-pro')
+
+MAX_TOKENS = int(os.getenv('HUGOIFIER_MAX_TOKENS', '4096'))
+
+
+def call_ai(prompt: str, system: str = "You are a helpful Hugo theme conversion assistant.") -> str:
+    """
+    Call the configured AI backend and return the response text.
+    This is the single entry point for all AI calls in the codebase.
+    """
+    if BACKEND == 'anthropic':
+        return _call_anthropic(prompt, system)
+    elif BACKEND == 'openai':
+        return _call_openai(prompt, system)
+    elif BACKEND == 'google':
+        return _call_google(prompt, system)
+    else:
+        raise ValueError(
+            f"Unknown backend: {BACKEND!r}. "
+            "Set HUGOIFIER_BACKEND to 'anthropic', 'openai', or 'google'."
+        )
+
+
+def _call_anthropic(prompt: str, system: str) -> str:
+    if not ANTHROPIC_API_KEY:
+        raise EnvironmentError("ANTHROPIC_API_KEY is not set")
+    import anthropic
+    client = anthropic.Anthropic(api_key=ANTHROPIC_API_KEY)
+    message = client.messages.create(
+        model=ANTHROPIC_MODEL,
+        max_tokens=MAX_TOKENS,
+        system=system,
+        messages=[{"role": "user", "content": prompt}],
+    )
+    return message.content[0].text
+
+
+def _call_openai(prompt: str, system: str) -> str:
+    if not OPENAI_API_KEY:
+        raise EnvironmentError("OPENAI_API_KEY is not set")
+    from openai import OpenAI
+    client = OpenAI(api_key=OPENAI_API_KEY)
+    response = client.chat.completions.create(
+        model=OPENAI_MODEL,
+        messages=[
+            {"role": "system", "content": system},
+            {"role": "user", "content": prompt},
+        ],
+        max_tokens=MAX_TOKENS,
+    )
+    return response.choices[0].message.content.strip()
+
+
+def _call_google(prompt: str, system: str) -> str:
+    if not GOOGLE_API_KEY:
+        raise EnvironmentError("GOOGLE_API_KEY is not set")
+    import google.generativeai as genai
+    genai.configure(api_key=GOOGLE_API_KEY)
+    model = genai.GenerativeModel(
+        model_name=GOOGLE_MODEL,
+        system_instruction=system,
+    )
+    response = model.generate_content(prompt)
+    return response.text

hugoifier-0.1.0/hugoifier/utils/analyze.py

@@ -0,0 +1,87 @@
+"""
+Analyzes a Hugo theme or raw HTML theme and reports structure + recommendations.
+"""
+
+import logging
+import os
+
+from ..config import call_ai
+from .theme_finder import find_hugo_theme, find_raw_html_files
+
+SYSTEM = "You are an expert Hugo theme developer analyzing themes for conversion."
+
+
+def analyze(path: str) -> str:
+    logging.info(f"Analyzing {path} ...")
+
+    info = find_hugo_theme(path)
+
+    if info:
+        return _analyze_hugo_theme(info)
+    else:
+        return _analyze_raw_html(path)
+
+
+def _analyze_hugo_theme(info: dict) -> str:
+    theme_dir = info['theme_dir']
+    theme_name = info['theme_name']
+    example_site = info['example_site']
+
+    # Collect layout files
+    layouts = []
+    for root, dirs, files in os.walk(os.path.join(theme_dir, 'layouts')):
+        for f in files:
+            if f.endswith('.html'):
+                rel = os.path.relpath(os.path.join(root, f), theme_dir)
+                layouts.append(rel)
+
+    # Collect content types from exampleSite
+    content_types = []
+    if example_site:
+        content_dir = os.path.join(example_site, 'content')
+        if os.path.isdir(content_dir):
+            content_types = [
+                d for d in os.listdir(content_dir)
+                if os.path.isdir(os.path.join(content_dir, d))
+            ]
+
+    report = [
+        f"Theme: {theme_name}",
+        f"Theme dir: {theme_dir}",
+        f"Layouts ({len(layouts)}):",
+        *[f"  {layout}" for layout in sorted(layouts)],
+        f"Content types: {content_types}",
+        f"ExampleSite: {example_site or 'none'}",
+        "",
+        "Status: Already a Hugo theme. Use 'complete' to assemble a working site.",
+    ]
+    return "\n".join(report)
+
+
+def _analyze_raw_html(path: str) -> str:
+    html_files = find_raw_html_files(path)
+    if not html_files:
+        return f"No HTML files found at {path}"
+
+    # Read main HTML file for AI analysis
+    main = next(
+        (f for f in html_files if os.path.basename(f).lower() == 'index.html'),
+        html_files[0],
+    )
+    with open(main, 'r', errors='replace') as f:
+        html = f.read()[:20000]
+
+    prompt = f"""Analyze this HTML theme file and provide:
+1. Identified reusable components (header, footer, nav, sidebar, etc.)
+2. Recommended Hugo template tags for dynamic content
+3. Suggested partial splits
+4. Content sections that should be data/ YAML files for Decap CMS
+
+HTML:
+{html}"""
+
+    try:
+        return call_ai(prompt, SYSTEM)
+    except Exception as e:
+        logging.error(f"AI analysis failed: {e}")
+        return f"HTML theme with {len(html_files)} files. AI analysis failed: {e}"

hugoifier-0.1.0/hugoifier/utils/cloudflare.py

@@ -0,0 +1,31 @@
+"""
+Configures and deploys a Hugo site to Cloudflare, handling page creation,
+DNS settings, and deployment via the Cloudflare API.
+"""
+
+import logging
+
+
+# Function to configure and deploy to Cloudflare
+def configure_cloudflare(path, zone):
+    logging.info(f"Starting Cloudflare configuration for {path} in zone {zone}...")
+    try:
+        # Placeholder logic for Cloudflare configuration
+        # This could involve API calls to Cloudflare to create pages, set DNS, etc.
+        logging.info("Creating Cloudflare page...")
+        # Example API call to create a page
+        # cloudflare_api.create_page(path, zone)
+
+        logging.info("Deploying site...")
+        # Example API call to deploy the site
+        # cloudflare_api.deploy_site(path, zone)
+
+        logging.info("Configuring DNS settings...")
+        # Example API call to configure DNS
+        # cloudflare_api.configure_dns(path, zone)
+
+        logging.info("Cloudflare configuration complete.")
+        return "Cloudflare configuration complete"
+    except Exception as e:
+        logging.error(f"Error during Cloudflare configuration: {e}")
+        return "Cloudflare configuration failed"