Metadata-Version: 2.4
Name: metupy-core
Version: 0.1.4
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>

