metupy-core 0.1.0__tar.gz

metupy_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+## MIT License
+
+Copyright (c) 2025-present PalembangPy Community
+
+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.

metupy_core-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: metupy-core
+Version: 0.1.0
+Summary: Lightweight Python Static Site & Documentation Generator — fast, component-driven, multi-language, zero JS build tools.
+Keywords: static-site-generator,documentation-generator,markdown-to-html,ssg,docs-as-code,i18n,python-framework,metupy
+Author-email: palembangPy <palembangpy@gmail.com>
+Maintainer-email: tomsdroid <tomsdroid007@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Documentation
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Requires-Dist: chardet>=7.6.0
+Requires-Dist: deep-translator>=1.11.0
+Requires-Dist: docutils>=0.23
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: lark>=1.3.1
+Requires-Dist: markdown>=3.5.0
+Requires-Dist: peewee>=4.4.0
+Requires-Dist: pluggy>=1.6.0
+Requires-Dist: pygments>=2.21.0
+Requires-Dist: pytest>=9.1.1
+Requires-Dist: pytest-cov>=7.1.0
+Project-URL: Documentation, https://docs.metupy.com/
+Project-URL: Homepage, https://metupy.com
+Project-URL: Issues, https://github.com/metupy/metupy-core/issues
+Project-URL: Repository, https://github.com/metupy/metupy-core
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/palembangpy/metupy/main/src/metupy/assets/metupy.png" alt="Metupy Logo" width="120" height="120">
+  <br>
+  <strong>Fast • Simple • Extensible</strong>
+  <br>
+  Core utilities and foundational components for Metupy static site generator.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/metupy-core?style=for-the-badge&color=blue" alt="PyPI Version">
+  <img src="https://img.shields.io/badge/tests-passing-green?style=for-the-badge" alt="Tests Passing">
+  <img src="https://img.shields.io/badge/python-3.9+-blue?style=for-the-badge" alt="Python Version">
+  <img src="https://img.shields.io/badge/license-MIT-yellow?style=for-the-badge" alt="License">
+</p>
+
+---
+
+
+### Metupy
+Metupy Core provides the essential building blocks used across the Metupy ecosystem:
+- **Signal** System — Event-driven hooks for plugins and lifecycle management
+- **Utilities** — File operations, path handling, port detection, date formatting, and more
+- **Writer** — Output writing, asset copying, and directory management
+
+### Installation
+
+```bash
+pip install metupy-core
+```
+
+### Quick Start
+
+```python
+from metupy_core.signal import on, emit
+from metupy_core.writer import write_output, copy_assets
+from metupy_core.utils import slugify, get_free_port
+```
+
+### Project Structure
+
+```bash
+src/metupy_core/
+├── __init__.py       # Package entry point & public API
+├── api.py             # High-level public interface
+├── cache.py           # Caching system & memory management
+├── components.py      # UI component blueprints
+├── config.py          # Configuration loading & validation
+├── contents.py        # Content processing & data models
+├── database.py        # Local database & storage layer
+├── exception.py       # Custom exceptions & error handling
+├── generators.py      # Static file & page generators
+├── i18n.py            # Internationalization & multi-language
+├── logging.py         # Logging setup & output formatting
+├── middleware.py      # Request/response middleware
+├── parsers.py         # Markdown & file parsers
+├── reader.py          # File system reading & watching
+├── renderer.py        # Template rendering engine
+├── server.py          # Development HTTP server
+├── setting.py         # User settings & defaults
+├── signal.py          # Event system & hooks
+├── utils.py           # Shared utilities & helpers
+└── writer.py          # File output & asset management
+
+```
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Made%20with-Python-3776AB?style=flat-square" alt="Made with Python">
+  <br><br>
+  MIT License — see LICENSE file for details
+</p>
+

metupy_core-0.1.0/README.md

@@ -0,0 +1,70 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/palembangpy/metupy/main/src/metupy/assets/metupy.png" alt="Metupy Logo" width="120" height="120">
+  <br>
+  <strong>Fast • Simple • Extensible</strong>
+  <br>
+  Core utilities and foundational components for Metupy static site generator.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/metupy-core?style=for-the-badge&color=blue" alt="PyPI Version">
+  <img src="https://img.shields.io/badge/tests-passing-green?style=for-the-badge" alt="Tests Passing">
+  <img src="https://img.shields.io/badge/python-3.9+-blue?style=for-the-badge" alt="Python Version">
+  <img src="https://img.shields.io/badge/license-MIT-yellow?style=for-the-badge" alt="License">
+</p>
+
+---
+
+
+### Metupy
+Metupy Core provides the essential building blocks used across the Metupy ecosystem:
+- **Signal** System — Event-driven hooks for plugins and lifecycle management
+- **Utilities** — File operations, path handling, port detection, date formatting, and more
+- **Writer** — Output writing, asset copying, and directory management
+
+### Installation
+
+```bash
+pip install metupy-core
+```
+
+### Quick Start
+
+```python
+from metupy_core.signal import on, emit
+from metupy_core.writer import write_output, copy_assets
+from metupy_core.utils import slugify, get_free_port
+```
+
+### Project Structure
+
+```bash
+src/metupy_core/
+├── __init__.py       # Package entry point & public API
+├── api.py             # High-level public interface
+├── cache.py           # Caching system & memory management
+├── components.py      # UI component blueprints
+├── config.py          # Configuration loading & validation
+├── contents.py        # Content processing & data models
+├── database.py        # Local database & storage layer
+├── exception.py       # Custom exceptions & error handling
+├── generators.py      # Static file & page generators
+├── i18n.py            # Internationalization & multi-language
+├── logging.py         # Logging setup & output formatting
+├── middleware.py      # Request/response middleware
+├── parsers.py         # Markdown & file parsers
+├── reader.py          # File system reading & watching
+├── renderer.py        # Template rendering engine
+├── server.py          # Development HTTP server
+├── setting.py         # User settings & defaults
+├── signal.py          # Event system & hooks
+├── utils.py           # Shared utilities & helpers
+└── writer.py          # File output & asset management
+
+```
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Made%20with-Python-3776AB?style=flat-square" alt="Made with Python">
+  <br><br>
+  MIT License — see LICENSE file for details
+</p>

metupy_core-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "metupy-core"
+version = "0.1.0"
+description = "Lightweight Python Static Site & Documentation Generator — fast, component-driven, multi-language, zero JS build tools."
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = [
+    "static-site-generator",
+    "documentation-generator",
+    "markdown-to-html",
+    "ssg",
+    "docs-as-code",
+    "i18n",
+    "python-framework",
+    "metupy",
+]
+
+authors = [
+    { name = "palembangPy", email = "palembangpy@gmail.com" }
+]
+maintainers = [
+    { name = "tomsdroid", email = "tomsdroid007@gmail.com" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Documentation",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "chardet>=7.6.0",
+    "deep-translator>=1.11.0",
+    "docutils>=0.23",
+    "jinja2>=3.1.6",
+    "lark>=1.3.1",
+    "markdown>=3.5.0",
+    "peewee>=4.4.0",
+    "pluggy>=1.6.0",
+    "pygments>=2.21.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+]
+
+[project.urls]
+Homepage = "https://metupy.com"
+Documentation = "https://docs.metupy.com/"
+Repository = "https://github.com/metupy/metupy-core"
+Issues = "https://github.com/metupy/metupy-core/issues"
+
+[build-system]
+requires = ["flit-core>=3.10,<4"]
+build-backend = "flit_core.buildapi"

metupy_core-0.1.0/src/metupy_core/__init__.py

@@ -0,0 +1,178 @@
+"""
+Metupy Core
+~~~~~~~~~~~
+
+Static site generator with multi-format content, AST-based templating,
+and plugin-friendly architecture.
+
+Supported formats: .pym, .py, .md, .rst
+License: MIT
+"""
+
+__version__ = "0.1.0"
+__author__ = "Metupy Team"
+__license__ = "MIT"
+
+# ─── Core Exports ───
+
+from .logging import log, setup_logging
+from .setting import Setting, load_setting, NavItem
+from .signal import on, off, emit, connect, disconnect, list_signals, reset
+from .utils import (
+    get_free_port,
+    watch_directory,
+    ensure_dir,
+    clean_dir,
+    copy_file,
+    slugify,
+    format_date,
+    file_hash,
+    get_ext,
+    is_binary_file,
+    walk_files,
+    relative_path,
+)
+from .reader import (
+    FileReader,
+    read_file,
+    read_and_parse,
+    detect_format,
+    normalize_content,
+    is_supported,
+    SUPPORTED_EXTENSIONS,
+)
+from .parsers import (
+    ParsedContent,
+    BaseParser,
+    PymParser,
+    MarkdownParser,
+    RestructuredTextParser,
+    PythonParser,
+    get_parser_for_file,
+    parse_file,
+)
+from .renderer import (
+    RenderContext,
+    BaseRenderer,
+    PymRenderer,
+    MarkdownRenderer,
+    RestructuredTextRenderer,
+    PythonRenderer,
+    Renderer,
+    render_content,
+)
+from .writer import (
+    write_output,
+    write_binary,
+    copy_assets,
+    ensure_dir as ensure_output_dir,
+    clean_directory,
+    get_output_path,
+)
+from .middleware import (
+    Middleware,
+    MiddlewareStack,
+    CORSMiddleware,
+    LoggingMiddleware,
+    SecurityMiddleware,
+    RateLimitMiddleware,
+    CacheMiddleware,
+    GZipMiddleware,
+    DatabaseMiddleware,
+)
+from .server import (
+    MetupyServer,
+    LiveReloadHandler,
+    wsgi_app,
+    asgi_app,
+    run_server,
+)
+from .page import Page, LayoutManager, ComponentRegistry, Theme
+
+# ─── Convenience Aliases ───
+
+__all__ = [
+    # Core
+    "__version__",
+    "log",
+    "setup_logging",
+    # Settings
+    "Setting",
+    "load_setting",
+    "NavItem",
+    # Signals
+    "on",
+    "off",
+    "emit",
+    "connect",
+    "disconnect",
+    "list_signals",
+    "reset",
+    # Utils
+    "get_free_port",
+    "watch_directory",
+    "ensure_dir",
+    "clean_dir",
+    "copy_file",
+    "slugify",
+    "format_date",
+    "file_hash",
+    "get_ext",
+    "is_binary_file",
+    "walk_files",
+    "relative_path",
+    # Reader
+    "FileReader",
+    "read_file",
+    "read_and_parse",
+    "detect_format",
+    "normalize_content",
+    "is_supported",
+    "SUPPORTED_EXTENSIONS",
+    # Parsers
+    "ParsedContent",
+    "BaseParser",
+    "PymParser",
+    "MarkdownParser",
+    "RestructuredTextParser",
+    "PythonParser",
+    "get_parser_for_file",
+    "parse_file",
+    # Renderer
+    "RenderContext",
+    "BaseRenderer",
+    "PymRenderer",
+    "MarkdownRenderer",
+    "RestructuredTextRenderer",
+    "PythonRenderer",
+    "Renderer",
+    "render_content",
+    # Writer
+    "write_output",
+    "write_binary",
+    "copy_assets",
+    "ensure_output_dir",
+    "clean_directory",
+    "get_output_path",
+    # Middleware
+    "Middleware",
+    "MiddlewareStack",
+    "CORSMiddleware",
+    "LoggingMiddleware",
+    "SecurityMiddleware",
+    "RateLimitMiddleware",
+    "CacheMiddleware",
+    "GZipMiddleware",
+    "DatabaseMiddleware",
+    # Server
+    "MetupyServer",
+    "LiveReloadHandler",
+    "wsgi_app",
+    "asgi_app",
+    "run_server",
+    # Page / Theme / Components
+    "Page",
+    "LayoutManager",
+    "ComponentRegistry",
+    "Theme",
+]