Function contributions_generate_image

src/plugins/github/github_contributions.py:25–56

(plugin_instance, settings, device_config)

"""

def contributions_generate_image(plugin_instance, settings, device_config):
    dimensions = device_config.get_resolution()
    if device_config.get_config("orientation") == "vertical":
        dimensions = dimensions[::-1]

    api_key = device_config.load_env_key("GITHUB_SECRET")
    if not api_key:
        raise RuntimeError("GitHub API Key not configured.")

    colors = settings.get("contributionColor[]")
    github_username = settings.get("githubUsername")
    if not github_username:
        raise RuntimeError("GitHub username is required.")

    data = fetch_contributions(github_username, api_key)
    grid, month_positions = parse_contributions(data, colors)
    metrics = calculate_metrics(data)

    template_params = {
        "username": github_username,
        "grid": grid,
        "month_positions": month_positions,
        "metrics": metrics,
        "plugin_settings": settings
    }

    return plugin_instance.render_image(
        dimensions,
        "github_contributions.html",
        "github.css",
        template_params
    )

# -------------------------
# Helper functions