mkdocs-roadmap 1.3.1__tar.gz

mkdocs_roadmap-1.3.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include mkdocs_roadmap/roadmap.advanced.md.j2
+include README.md
+

mkdocs_roadmap-1.3.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: mkdocs-roadmap
+Version: 1.3.1
+Summary: MkDocs plugin for rendering roadmap.yml files to roadmap.md files
+Home-page: https://github.com/SierraSoftworks/roadmap
+Author: SierraSoftworks
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: mkdocs>=1.0
+Requires-Dist: jinja2>=2.10
+Requires-Dist: pyyaml>=5.1
+Dynamic: home-page
+Dynamic: requires-python
+
+# MkDocs Roadmap Plugin
+
+The MkDocs Roadmap plugin allows you to define `roadmap.yml` files in your MkDocs project and automatically generate corresponding `roadmap.md` files during the build process. This plugin uses Jinja2 templates based on the advanced roadmap template to render beautiful, styled roadmap documentation.
+
+## Installation
+
+Install the plugin using pip:
+
+```bash
+pip install mkdocs-roadmap
+```
+
+Or install from source:
+
+```bash
+cd tools/mkdocs-roadmap
+pip install .
+```
+
+## Usage
+
+### Configuration
+
+Add the plugin to your `mkdocs.yml` configuration file:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - path/to/roadmap.yml
+        - another/path/to/roadmap.yml
+```
+
+The `roadmaps` configuration option is a list of paths to `roadmap.yml` files relative to your `docs_dir`. The plugin will:
+
+1. Read each `roadmap.yml` file
+2. Render it using the Jinja2 template
+3. Generate a corresponding `roadmap.md` file in the same location (replacing `.yml` or `.yaml` with `.md`)
+
+### Example
+
+If you have a `roadmap.yml` file at `docs/roadmap.yml`, configure it like this:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - roadmap.yml
+```
+
+This will generate `docs/roadmap.md` during the build process, which you can then reference in your `nav` configuration:
+
+```yaml
+nav:
+  - Home: index.md
+  - Roadmap: roadmap.md
+```
+
+### Roadmap File Format
+
+The plugin expects roadmap files to follow the roadmap schema. See the main [roadmap documentation](https://roadmap.sierrasoftworks.com/) for details on the schema.
+
+Example `roadmap.yml`:
+
+```yaml
+title: Example Road Map
+description: |
+    This is an example of what a road map might look like.
+
+authors:
+  - name: Benjamin Pannell
+    email: contact@sierrasoftworks.com
+
+timeline:
+  - date: 2021-04-21
+    title: Project Start
+    description: This is when we will start working on the project, get the team ready!
+
+objectives:
+  - title: Market Dominance
+    description: |
+      Provide actionable analytics drawn from big data to improve our brand identity in
+      the advertainment sector, maximizing clickbait and establishing ourselves as a disruptor
+      in this industry.
+
+milestones:
+  - id: team
+    title: Build the Team
+    description: We don't yet have anyone, that's not gonna work...
+    deliverables:
+      - title: Team Lead
+        state: TODO
+        requirement: MUST
+        description: This person needs to know enough about this domain to be able to run with the project.
+
+      - title: Senior Engineer 1
+      - title: Intern 1..50
+        description: This should be cheaper than hiring a proper team (right?).
+
+  - id: done
+    title: Finish the Project
+    description: We don't need other milestones, do we?
+    dependencies:
+      - team
+    deliverables:
+      - title: MVP
+        description: Who needs a polished product? Let's just ship the MVP and call it done.
+      - title: Marketing
+      - title: VC Funding
+      - title: Yacht
+        reference: https://lmgtfy.app/?q=yacht&t=i
+```
+
+## Development
+
+To develop or modify the plugin:
+
+1. Clone the repository
+2. Navigate to `tools/mkdocs-roadmap`
+3. Install in development mode: `pip install -e .`
+4. Make your changes
+5. Test with your MkDocs project

mkdocs_roadmap-1.3.1/README.md

@@ -0,0 +1,122 @@
+# MkDocs Roadmap Plugin
+
+The MkDocs Roadmap plugin allows you to define `roadmap.yml` files in your MkDocs project and automatically generate corresponding `roadmap.md` files during the build process. This plugin uses Jinja2 templates based on the advanced roadmap template to render beautiful, styled roadmap documentation.
+
+## Installation
+
+Install the plugin using pip:
+
+```bash
+pip install mkdocs-roadmap
+```
+
+Or install from source:
+
+```bash
+cd tools/mkdocs-roadmap
+pip install .
+```
+
+## Usage
+
+### Configuration
+
+Add the plugin to your `mkdocs.yml` configuration file:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - path/to/roadmap.yml
+        - another/path/to/roadmap.yml
+```
+
+The `roadmaps` configuration option is a list of paths to `roadmap.yml` files relative to your `docs_dir`. The plugin will:
+
+1. Read each `roadmap.yml` file
+2. Render it using the Jinja2 template
+3. Generate a corresponding `roadmap.md` file in the same location (replacing `.yml` or `.yaml` with `.md`)
+
+### Example
+
+If you have a `roadmap.yml` file at `docs/roadmap.yml`, configure it like this:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - roadmap.yml
+```
+
+This will generate `docs/roadmap.md` during the build process, which you can then reference in your `nav` configuration:
+
+```yaml
+nav:
+  - Home: index.md
+  - Roadmap: roadmap.md
+```
+
+### Roadmap File Format
+
+The plugin expects roadmap files to follow the roadmap schema. See the main [roadmap documentation](https://roadmap.sierrasoftworks.com/) for details on the schema.
+
+Example `roadmap.yml`:
+
+```yaml
+title: Example Road Map
+description: |
+    This is an example of what a road map might look like.
+
+authors:
+  - name: Benjamin Pannell
+    email: contact@sierrasoftworks.com
+
+timeline:
+  - date: 2021-04-21
+    title: Project Start
+    description: This is when we will start working on the project, get the team ready!
+
+objectives:
+  - title: Market Dominance
+    description: |
+      Provide actionable analytics drawn from big data to improve our brand identity in
+      the advertainment sector, maximizing clickbait and establishing ourselves as a disruptor
+      in this industry.
+
+milestones:
+  - id: team
+    title: Build the Team
+    description: We don't yet have anyone, that's not gonna work...
+    deliverables:
+      - title: Team Lead
+        state: TODO
+        requirement: MUST
+        description: This person needs to know enough about this domain to be able to run with the project.
+
+      - title: Senior Engineer 1
+      - title: Intern 1..50
+        description: This should be cheaper than hiring a proper team (right?).
+
+  - id: done
+    title: Finish the Project
+    description: We don't need other milestones, do we?
+    dependencies:
+      - team
+    deliverables:
+      - title: MVP
+        description: Who needs a polished product? Let's just ship the MVP and call it done.
+      - title: Marketing
+      - title: VC Funding
+      - title: Yacht
+        reference: https://lmgtfy.app/?q=yacht&t=i
+```
+
+## Development
+
+To develop or modify the plugin:
+
+1. Clone the repository
+2. Navigate to `tools/mkdocs-roadmap`
+3. Install in development mode: `pip install -e .`
+4. Make your changes
+5. Test with your MkDocs project

mkdocs_roadmap-1.3.1/mkdocs_roadmap/__init__.py

@@ -0,0 +1,153 @@
+"""
+MkDocs plugin for rendering roadmap.yml files to roadmap.md files.
+"""
+
+from mkdocs.plugins import BasePlugin
+from mkdocs.config import config_options
+from mkdocs.config.base import Config
+import os
+import yaml
+import jinja2
+from pathlib import Path
+from typing import Dict, Any
+
+
+def state_color(state: str) -> str:
+    """Convert state to color."""
+    colors = {
+        "TODO": "#aaa",
+        "DOING": "#63B2EB",
+        "DONE": "#3EAF7C",
+        "SKIP": "#F65BD2",
+    }
+    return colors.get(state, "#aaa")
+
+
+def requirement_color(requirement: str) -> str:
+    """Convert requirement to color."""
+    colors = {
+        "MUST": "#E06446",
+        "SHOULD": "#E0AF2F",
+        "MAY": "#3ABDE0",
+    }
+    return colors.get(requirement, "#888")
+
+
+def date_format(date_value) -> str:
+    """Format date to YYYY-MM-DD format."""
+    from datetime import datetime, date
+
+    if isinstance(date_value, (datetime, date)):
+        return date_value.strftime("%Y-%m-%d")
+    elif isinstance(date_value, str):
+        # Try to parse common date formats
+        try:
+            # Try ISO format first
+            dt = datetime.fromisoformat(date_value.replace('Z', '+00:00'))
+            return dt.strftime("%Y-%m-%d")
+        except ValueError:
+            # If that fails, try other common formats
+            for fmt in ["%Y-%m-%d", "%Y/%m/%d", "%d/%m/%Y"]:
+                try:
+                    dt = datetime.strptime(date_value, fmt)
+                    return dt.strftime("%Y-%m-%d")
+                except ValueError:
+                    continue
+    return str(date_value)
+
+
+class RoadmapPlugin(BasePlugin):
+    """MkDocs plugin for rendering roadmap.yml files."""
+
+    config_scheme = (
+        ('roadmaps', config_options.Type(list, default=[])),
+    )
+
+    def __init__(self):
+        super().__init__()
+        self.template = None
+
+    def on_config(self, config: Config, **kwargs) -> Config:
+        """Load the Jinja2 template when config is loaded."""
+        template_path = Path(__file__).parent / "roadmap.advanced.md.j2"
+        with open(template_path, 'r') as f:
+            template_content = f.read()
+
+        # Create Jinja2 environment with custom filters
+        env = jinja2.Environment(
+            loader=jinja2.DictLoader({'roadmap': template_content}),
+            autoescape=False
+        )
+        env.filters['state_color'] = state_color
+        env.filters['requirement_color'] = requirement_color
+        env.filters['date_format'] = date_format
+
+        self.template = env.get_template('roadmap')
+        return config
+
+    def on_files(self, files, config: Config, **kwargs):
+        """Process roadmap.yml files and generate .md files."""
+        docs_dir = Path(config['docs_dir'])
+
+        # Get roadmap files from config
+        roadmap_files = self.config.get('roadmaps', [])
+
+        for roadmap_file in roadmap_files:
+            roadmap_path = docs_dir / roadmap_file
+
+            if not roadmap_path.exists():
+                continue
+
+            # Read and parse YAML
+            with open(roadmap_path, 'r') as f:
+                roadmap_data = yaml.safe_load(f)
+
+            # Handle empty or invalid YAML
+            if roadmap_data is None:
+                roadmap_data = {}
+
+            # Ensure defaults are set
+            roadmap_data.setdefault('authors', [])
+            roadmap_data.setdefault('timeline', [])
+            roadmap_data.setdefault('objectives', [])
+            roadmap_data.setdefault('milestones', [])
+            roadmap_data.setdefault('title', 'Roadmap')
+            roadmap_data.setdefault('description', '')
+
+            # Set defaults for deliverables
+            for milestone in roadmap_data.get('milestones', []):
+                for deliverable in milestone.get('deliverables', []):
+                    if 'requirement' not in deliverable:
+                        deliverable['requirement'] = 'SHOULD'
+                    if 'state' not in deliverable:
+                        deliverable['state'] = 'TODO'
+
+            # Render template - pass roadmap_data as root context to match Go template structure
+            rendered = self.template.render(**roadmap_data)
+
+            # Determine output path (replace .yml/.yaml with .md)
+            output_path = roadmap_path.with_suffix('.md')
+
+            # Write output
+            with open(output_path, 'w') as f:
+                f.write(rendered)
+
+            # Add the generated .md file to MkDocs files if it doesn't exist
+            rel_path = str(output_path.relative_to(docs_dir))
+            # Normalize path separators for cross-platform compatibility
+            rel_path = rel_path.replace('\\', '/')
+
+            # Check if file already exists in files list
+            existing_files = [f.src_path for f in files]
+            if rel_path not in existing_files:
+                from mkdocs.structure.files import File
+                file_obj = File(
+                    path=rel_path,
+                    src_dir=str(docs_dir),
+                    dest_dir=config['site_dir'],
+                    use_directory_urls=config['use_directory_urls']
+                )
+                files.append(file_obj)
+
+        return files
+

mkdocs_roadmap-1.3.1/mkdocs_roadmap/roadmap.advanced.md.j2

@@ -0,0 +1,78 @@
+# {{ title }}
+
+{% if authors %}
+<div style="display: flex; flex-direction: row; background: rgba(200, 200, 200, 0.15); padding: 1rem; border-radius: 6px; margin-bottom: 2rem;">
+<div style="vertical-align: middle; font-size: 0.7rem; line-height: 1.8rem; opacity: 0.6;">Authored by</div>
+{% for author in authors %}
+<div style="margin-left: 1rem; padding-left: 1rem; border-left: 1px solid rbga(200, 200, 200, 0.5);">
+    <h5 style="font-size: 0.8rem; margin: 0;">{{ author.name }}</h5>
+    {% if author.contact %}<p style="font-size: 0.6rem; margin: 0;">{{ author.contact }}</p>{% endif %}
+</div>
+{% endfor %}
+</div>
+{% endif %}
+
+
+{% if description %}{{ description }}{% endif %}
+
+{% if timeline %}
+## Important Dates
+
+<div style="border-left: 4px solid gray; border-radius: 0 4px 4px 0; background: rgba(200, 200, 200, 0.15); margin: 2rem auto; padding: 1rem 2rem; position: relative; text-align: center; margin-left: 7rem;">
+{% for entry in timeline %}
+<div style="text-align: left; position: relative; padding-bottom: 1rem; margin-bottom: 1rem;">
+<div style="position: absolute; left: -10rem; text-align: right; font-size: 0.9rem; font-weight: 700; opacity: 0.7; min-width: 6rem; top: 2px;">{{ entry.date | date_format }}</div>
+
+<h3>{{ entry.title }}</h3>
+{% if entry.description %}{{ entry.description }}{% endif %}
+
+<div style="position: absolute; box-shadow: 0 0 0 4px gray; left: -2.5rem; background: #444; border-radius: 50%; height: 11px; width: 11px; top: 5px;"></div>
+</div>
+{% endfor %}
+</div>
+{% endif %}
+
+{% if objectives %}
+## Objectives
+{% for objective in objectives %}
+### {{ objective.title }}
+{% if objective.description %}{{ objective.description }}{% endif %}
+
+{% endfor %}
+{% endif %}
+
+{% if milestones %}
+## Milestones
+
+<div style="border-left: 4px solid gray; border-radius: 0 4px 4px 0; background: rgba(200, 200, 200, 0.15); margin: 2rem auto; padding: 1rem 2rem; position: relative; text-align: center; margin-left: 7rem;">
+{% for milestone in milestones %}
+<div style="text-align: left; position: relative; padding-bottom: 1rem; margin-bottom: 1rem;">
+<div style="position: absolute; left: -10rem; text-align: right; font-size: 0.9rem; font-weight: 700; opacity: 0.7; min-width: 6rem; top: 2px;">M{{ loop.index }}</div>
+
+<h3>{{ milestone.title }}</h3>
+{% if milestone.description %}{{ milestone.description }}{% endif %}
+
+{% if milestone.deliverables %}
+{% for deliverable in milestone.deliverables %}
+<div style="position: relative; border-radius: 4px; box-shadow: 2px 2px 10px rgba(0,0,0,0.3); background-color: rgba(0, 0, 0, 0.1); padding: 10px; 20px; margin: 2rem 0; padding-left: 20px;">
+<div style="position: absolute; top: 0; left: 0; bottom: 0; width: 8px; border-radius: 4px 0 0 4px; background-color: {{ deliverable.state | default('TODO') | state_color }}"></div>
+<h4 style="margin-top: 0">
+<span style="float: right; margin: 0;">{{ deliverable.state | default('TODO') }}</span>
+
+{{ deliverable.title }}
+{% if deliverable.requirement %}<span style="display: inline; font-size: 90%; padding: 3px 5px; border-radius: 4px; background-color: {{ deliverable.requirement | requirement_color }}; color: white; margin: 0 2px;"> {{ deliverable.requirement }}</span>{% endif %}
+</h4>
+
+{% if deliverable.description %}{{ deliverable.description }}{% endif %}
+
+{% if deliverable.reference %}[Read more &rarr;]({{ deliverable.reference }}){% endif %}
+</div>
+{% endfor %}
+{% endif %}
+
+<div style="position: absolute; box-shadow: 0 0 0 4px gray; left: -2.5rem; background: #444; border-radius: 50%; height: 11px; width: 11px; top: 5px;"></div>
+</div>
+{% endfor %}
+</div>
+{% endif %}
+

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: mkdocs-roadmap
+Version: 1.3.1
+Summary: MkDocs plugin for rendering roadmap.yml files to roadmap.md files
+Home-page: https://github.com/SierraSoftworks/roadmap
+Author: SierraSoftworks
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: mkdocs>=1.0
+Requires-Dist: jinja2>=2.10
+Requires-Dist: pyyaml>=5.1
+Dynamic: home-page
+Dynamic: requires-python
+
+# MkDocs Roadmap Plugin
+
+The MkDocs Roadmap plugin allows you to define `roadmap.yml` files in your MkDocs project and automatically generate corresponding `roadmap.md` files during the build process. This plugin uses Jinja2 templates based on the advanced roadmap template to render beautiful, styled roadmap documentation.
+
+## Installation
+
+Install the plugin using pip:
+
+```bash
+pip install mkdocs-roadmap
+```
+
+Or install from source:
+
+```bash
+cd tools/mkdocs-roadmap
+pip install .
+```
+
+## Usage
+
+### Configuration
+
+Add the plugin to your `mkdocs.yml` configuration file:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - path/to/roadmap.yml
+        - another/path/to/roadmap.yml
+```
+
+The `roadmaps` configuration option is a list of paths to `roadmap.yml` files relative to your `docs_dir`. The plugin will:
+
+1. Read each `roadmap.yml` file
+2. Render it using the Jinja2 template
+3. Generate a corresponding `roadmap.md` file in the same location (replacing `.yml` or `.yaml` with `.md`)
+
+### Example
+
+If you have a `roadmap.yml` file at `docs/roadmap.yml`, configure it like this:
+
+```yaml
+plugins:
+  - roadmap:
+      roadmaps:
+        - roadmap.yml
+```
+
+This will generate `docs/roadmap.md` during the build process, which you can then reference in your `nav` configuration:
+
+```yaml
+nav:
+  - Home: index.md
+  - Roadmap: roadmap.md
+```
+
+### Roadmap File Format
+
+The plugin expects roadmap files to follow the roadmap schema. See the main [roadmap documentation](https://roadmap.sierrasoftworks.com/) for details on the schema.
+
+Example `roadmap.yml`:
+
+```yaml
+title: Example Road Map
+description: |
+    This is an example of what a road map might look like.
+
+authors:
+  - name: Benjamin Pannell
+    email: contact@sierrasoftworks.com
+
+timeline:
+  - date: 2021-04-21
+    title: Project Start
+    description: This is when we will start working on the project, get the team ready!
+
+objectives:
+  - title: Market Dominance
+    description: |
+      Provide actionable analytics drawn from big data to improve our brand identity in
+      the advertainment sector, maximizing clickbait and establishing ourselves as a disruptor
+      in this industry.
+
+milestones:
+  - id: team
+    title: Build the Team
+    description: We don't yet have anyone, that's not gonna work...
+    deliverables:
+      - title: Team Lead
+        state: TODO
+        requirement: MUST
+        description: This person needs to know enough about this domain to be able to run with the project.
+
+      - title: Senior Engineer 1
+      - title: Intern 1..50
+        description: This should be cheaper than hiring a proper team (right?).
+
+  - id: done
+    title: Finish the Project
+    description: We don't need other milestones, do we?
+    dependencies:
+      - team
+    deliverables:
+      - title: MVP
+        description: Who needs a polished product? Let's just ship the MVP and call it done.
+      - title: Marketing
+      - title: VC Funding
+      - title: Yacht
+        reference: https://lmgtfy.app/?q=yacht&t=i
+```
+
+## Development
+
+To develop or modify the plugin:
+
+1. Clone the repository
+2. Navigate to `tools/mkdocs-roadmap`
+3. Install in development mode: `pip install -e .`
+4. Make your changes
+5. Test with your MkDocs project

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+mkdocs_roadmap/__init__.py
+mkdocs_roadmap/roadmap.advanced.md.j2
+mkdocs_roadmap.egg-info/PKG-INFO
+mkdocs_roadmap.egg-info/SOURCES.txt
+mkdocs_roadmap.egg-info/dependency_links.txt
+mkdocs_roadmap.egg-info/entry_points.txt
+mkdocs_roadmap.egg-info/requires.txt
+mkdocs_roadmap.egg-info/top_level.txt

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[mkdocs.plugins]
+roadmap = mkdocs_roadmap:RoadmapPlugin

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/requires.txt

@@ -0,0 +1,3 @@
+mkdocs>=1.0
+jinja2>=2.10
+pyyaml>=5.1

mkdocs_roadmap-1.3.1/mkdocs_roadmap.egg-info/top_level.txt

@@ -0,0 +1 @@
+mkdocs_roadmap

mkdocs_roadmap-1.3.1/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mkdocs-roadmap"
+version = "1.3.1"
+description = "MkDocs plugin for rendering roadmap.yml files to roadmap.md files"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    {name = "SierraSoftworks"}
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "mkdocs>=1.0",
+    "jinja2>=2.10",
+    "pyyaml>=5.1",
+]
+
+[dependency-groups]
+dev = [
+    "mkdocs>=1.0",
+    "jinja2>=2.10",
+    "pyyaml>=5.1",
+]
+
+[project.entry-points."mkdocs.plugins"]
+roadmap = "mkdocs_roadmap:RoadmapPlugin"
+
+[tool.setuptools]
+packages = ["mkdocs_roadmap"]
+
+[tool.setuptools.package-data]
+mkdocs_roadmap = ["roadmap.advanced.md.j2"]
+

mkdocs_roadmap-1.3.1/setup.cfg

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

mkdocs_roadmap-1.3.1/setup.py

@@ -0,0 +1,40 @@
+"""Setup script for mkdocs-roadmap plugin."""
+
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="mkdocs-roadmap",
+    version="1.3.1",
+    author="SierraSoftworks",
+    description="MkDocs plugin for rendering roadmap.yml files to roadmap.md files",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/SierraSoftworks/roadmap",
+    packages=find_packages(),
+    include_package_data=True,
+    package_data={
+        'mkdocs_roadmap': ['roadmap.advanced.md.j2'],
+    },
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
+    ],
+    python_requires=">=3.7",
+    # Dependencies are defined in pyproject.toml to avoid duplication
+    entry_points={
+        "mkdocs.plugins": [
+            "roadmap = mkdocs_roadmap:RoadmapPlugin",
+        ],
+    },
+)