PyPI - pygitweb - Versions diffs - 0.1.0__py3-none-any.whl - Mend

pygitweb 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (95) hide show

pygitweb/__init__.py +22 -0
pygitweb/__meta__.py +9 -0
pygitweb/actions.py +1303 -0
pygitweb/addproject_permissions_test.py +114 -0
pygitweb/api/__init__.py +0 -0
pygitweb/api/action.py +20 -0
pygitweb/api/plugins/__init__.py +0 -0
pygitweb/api/plugins/project_zip.py +71 -0
pygitweb/api/project.py +67 -0
pygitweb/api/subpage.py +22 -0
pygitweb/auth.py +387 -0
pygitweb/auth.schema.json +106 -0
pygitweb/auth_config.py +243 -0
pygitweb/auth_oauth.py +343 -0
pygitweb/auth_test.py +390 -0
pygitweb/boards_permissions_test.py +113 -0
pygitweb/change_queue.py +110 -0
pygitweb/change_queue_routes_test.py +146 -0
pygitweb/change_queue_test.py +91 -0
pygitweb/comments_permissions_test.py +140 -0
pygitweb/config.py +185 -0
pygitweb/conftest.py +43 -0
pygitweb/dependencies.py +87 -0
pygitweb/formatting.py +182 -0
pygitweb/formatting_test.py +68 -0
pygitweb/git_helpers.py +454 -0
pygitweb/git_helpers_test.py +223 -0
pygitweb/gravatar.py +16 -0
pygitweb/gravatar_test.py +10 -0
pygitweb/hooks_install.py +278 -0
pygitweb/hooks_install_test.py +363 -0
pygitweb/hooks_permissions_test.py +116 -0
pygitweb/main.py +887 -0
pygitweb/merge_requests.py +230 -0
pygitweb/merge_requests_test.py +85 -0
pygitweb/mr_permissions_test.py +148 -0
pygitweb/password_hash.py +74 -0
pygitweb/password_hash_test.py +20 -0
pygitweb/permissions.py +209 -0
pygitweb/permissions_test.py +86 -0
pygitweb/plugin_loader.py +83 -0
pygitweb/projects.py +213 -0
pygitweb/projects_test.py +186 -0
pygitweb/sessions.py +73 -0
pygitweb/settings.py +412 -0
pygitweb/settings.schema.json +73 -0
pygitweb/settings_config.py +122 -0
pygitweb/settings_config_test.py +101 -0
pygitweb/settings_permissions_test.py +76 -0
pygitweb/static/blob-view.js +133 -0
pygitweb/static/board.js +839 -0
pygitweb/static/hook-install.js +53 -0
pygitweb/static/icons/cloud-down.svg +1 -0
pygitweb/static/icons/cloud-exclamation.svg +1 -0
pygitweb/static/icons/cloud-filled.svg +1 -0
pygitweb/static/icons/cloud-storm.svg +1 -0
pygitweb/static/icons/cloud-up.svg +1 -0
pygitweb/static/icons/cloud.svg +1 -0
pygitweb/static/logo.svg +44 -0
pygitweb/static/main.css +1210 -0
pygitweb/static/navbar-auth.js +82 -0
pygitweb/static/readme-render.js +174 -0
pygitweb/static/search-page.js +139 -0
pygitweb/static/summary-ref-switcher.js +130 -0
pygitweb/static/themes/solarized.css +34 -0
pygitweb/tasks.py +595 -0
pygitweb/tasks_permissions_test.py +137 -0
pygitweb/tasks_routes_test.py +430 -0
pygitweb/templates/addproject.html +174 -0
pygitweb/templates/blobdiff.html +57 -0
pygitweb/templates/board.html +31 -0
pygitweb/templates/board_card.html +44 -0
pygitweb/templates/commitdiff.html +57 -0
pygitweb/templates/hooks_summary_cell.html +37 -0
pygitweb/templates/login.html +37 -0
pygitweb/templates/merge_request_summary_cell.html +18 -0
pygitweb/templates/merge_request_tag.html +90 -0
pygitweb/templates/pagination.html +44 -0
pygitweb/templates/preamble.html +89 -0
pygitweb/templates/project_settings.html +13 -0
pygitweb/templates/pygit2_settings.html +12 -0
pygitweb/templates/pygitweb_settings.html +12 -0
pygitweb/templates/search.html +77 -0
pygitweb/templates/settings_form_field.html +27 -0
pygitweb/templates/table.html +15 -0
pygitweb/templates/user_profile.html +10 -0
pygitweb/templates_env.py +21 -0
pygitweb/timeline_cache.py +243 -0
pygitweb/validation.py +75 -0
pygitweb/validation_test.py +167 -0
pygitweb-0.1.0.dist-info/METADATA +165 -0
pygitweb-0.1.0.dist-info/RECORD +95 -0
pygitweb-0.1.0.dist-info/WHEEL +5 -0
pygitweb-0.1.0.dist-info/licenses/LICENSE +21 -0
pygitweb-0.1.0.dist-info/top_level.txt +1 -0

pygitweb/templates/preamble.html ADDED Viewed

@@ -0,0 +1,89 @@
+<!DOCTYPE html><html><head><title>{{title | default('PyGitWeb')}}</title>
+<script>document.documentElement.setAttribute('data-bs-theme', window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'); window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', function(e){ document.documentElement.setAttribute('data-bs-theme', e.matches ? 'dark' : 'light'); });</script>
+<link rel="icon" href="/static/logo.svg" type="image/svg+xml">
+<script id="Highlight-script" async src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
+<script id="MathJax-script" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.2/es5/tex-chtml.min.js"></script>
+<script id="GraphViz-script" async src="https://cdnjs.cloudflare.com/ajax/libs/viz.js/1.8.2/viz.js"></script>
+<script id="diff2html-script" async src="https://cdn.jsdelivr.net/npm/diff2html/bundles/js/diff2html-ui.min.js"></script>
+<script id="Showdown-script" async src="https://cdnjs.cloudflare.com/ajax/libs/showdown/2.1.0/showdown.js"></script>
+<script id="tabler-script" async src="https://cdn.jsdelivr.net/npm/@tabler/core@1.0.0-beta17/dist/js/tabler.min.js"></script>
+<link href=" https://cdn.jsdelivr.net/npm/diff2html@3.4.56/bundles/css/diff2html.min.css " rel="stylesheet">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@300..700&family=Fira+Mono:wght@400;500;700&family=Fira+Sans:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/core@1.0.0-beta17/dist/css/tabler.min.css">
+<link rel="stylesheet" href="/static/main.css"/>
+<script src="/static/navbar-auth.js" defer></script>
+</head><body>
+<div class="page">
+  <aside class="navbar navbar-vertical navbar-expand-sm position-fixed">
+    <div class="container-fluid d-flex flex-column vh-100 overflow-y-auto">
+      <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#sidebar-menu" aria-controls="sidebar-menu" aria-expanded="false" aria-label="Toggle navigation">
+        <span class="navbar-toggler-icon"></span>
+      </button>
+      <h1 class="navbar-brand navbar-brand-autodark py-3">
+        <a href="/" class="d-flex align-items-center text-reset">
+          <img src="/static/logo.svg" width="32" height="32" alt="Logo" class="navbar-brand-image me-2" style="object-fit: contain;">
+          <span class="nav-link-title">{{ site_name | default('PyGitWeb') }}</span>
+        </a>
+      </h1>
+      <div class="collapse navbar-collapse flex-grow-1" id="sidebar-menu">
+        <ul class="navbar-nav pt-lg-3">
+          <li class="nav-item">
+            <a class="nav-link" href="/">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-folder" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 4h4l3 3h7a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2v-11a2 2 0 0 1 2 -2z" /></svg></span>
+              <span class="nav-link-title">Projects</span>
+            </a>
+          </li>
+          <li class="nav-item">
+            <a class="nav-link" href="/addproject">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-plus" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 5l0 14" /><path d="M5 12l14 0" /></svg></span>
+              <span class="nav-link-title">Add project</span>
+            </a>
+          </li>
+          <li class="nav-item">
+            <a class="nav-link" href="/activity">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-activity"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 12h4l3 8l4 -16l3 8h4" /></svg></span>
+              <span class="nav-link-title">Activity</span>
+            </a>
+          </li>
+          <li class="nav-item">
+            <a class="nav-link" href="#">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-messages"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M21 14l-3 -3h-7a1 1 0 0 1 -1 -1v-6a1 1 0 0 1 1 -1h9a1 1 0 0 1 1 1v10" /><path d="M14 15v2a1 1 0 0 1 -1 1h-7l-3 3v-10a1 1 0 0 1 1 -1h2" /></svg></span>
+              <span class="nav-link-title">Discussions</span>
+            </a>
+          </li>
+          <li class="nav-item">
+            <a class="nav-link" href="#">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-checklist" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 11l3 3l8 -8" /><path d="M20 12v6a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2v-12a2 2 0 0 1 2 -2h9" /></svg></span>
+              <span class="nav-link-title">Tasks</span>
+            </a>
+          </li>
+          <li class="nav-item dropdown">
+            <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" data-bs-auto-close="outside" aria-expanded="false" role="button">
+              <span class="nav-link-icon"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-settings" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M10.325 4.317c.426 -1.756 2.924 -1.756 3.35 0a1.724 1.724 0 0 0 2.573 1.066c1.543 -.94 3.31 .826 2.37 2.37a1.724 1.724 0 0 0 1.065 2.572c1.756 .426 1.756 2.924 0 3.35a1.724 1.724 0 0 0 -1.066 2.573c.94 1.543 -.826 3.31 -2.37 2.37a1.724 1.724 0 0 0 -2.572 1.065c-.426 1.756 -2.924 1.756 -3.35 0a1.724 1.724 0 0 0 -2.573 -1.066c-1.543 .94 -3.31 -.826 -2.37 -2.37a1.724 1.724 0 0 0 -1.065 -2.572c-1.756 -.426 -1.756 -2.924 0 -3.35a1.724 1.724 0 0 0 1.066 -2.573c-.94 -1.543 .826 -3.31 2.37 -2.37c1 .608 2.296 .07 2.572 -1.065z" /><path d="M9 12a3 3 0 1 0 6 0a3 3 0 0 0 -6 0" /></svg></span>
+              <span class="nav-link-title">Settings</span>
+            </a>
+            <div class="dropdown-menu dropdown-menu-column dropdown-menu-column-1">
+              <a class="dropdown-item" href="/settings/pygitweb">PyGitWeb</a>
+              <a class="dropdown-item" href="/settings/pygit2">PyGit2</a>
+            </div>
+          </li>
+        </ul>
+      </div>
+      <div class="navbar-user mt-auto py-3 px-3 border-top" id="navbar-user" data-logged-in="false">
+        <a class="d-flex align-items-center text-reset text-decoration-none w-100" id="navbar-user-link" href="/login" aria-label="Account">
+          <span class="avatar avatar-sm bg-secondary me-2 d-flex align-items-center justify-content-center" id="navbar-user-avatar">
+            <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-user" width="22" height="22" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M8 7a4 4 0 1 0 8 0a4 4 0 0 0 -8 0" /><path d="M6 21v-2a4 4 0 0 1 4 -4h4a4 4 0 0 1 4 4v2" /></svg>
+          </span>
+          <div class="d-none d-xl-block text-start">
+            <div class="navbar-user-name text-body">Guest</div>
+            <div class="navbar-user-meta text-muted small">Not signed in</div>
+          </div>
+        </a>
+      </div>
+    </div>
+  </aside>
+  <div class="page-wrapper">
+    <div class="page-body">
+      <div class="container-xl">

pygitweb/templates/project_settings.html ADDED Viewed

@@ -0,0 +1,13 @@
+<h1 class="page-title">Project settings: {{ project_title }}</h1>
+<p class="text-muted">Repository config (local and worktree only).</p>
+<div class="card">
+  <div class="card-body">
+    <form action="{{ submit_url }}" method="post" class="needs-validation" novalidate>
+      {{ table_html | safe }}
+      <div class="form-footer mt-3">
+        <button type="submit" class="btn btn-primary">Save</button>
+        <a href="{{ cancel_url }}" class="btn btn-ghost-secondary">Cancel</a>
+      </div>
+    </form>
+  </div>
+</div>

pygitweb/templates/pygit2_settings.html ADDED Viewed

@@ -0,0 +1,12 @@
+<h1 class="page-title">PyGit2 settings</h1>
+<div class="card">
+  <div class="card-body">
+    <form action="/settings/pygit2/submit" method="post" class="needs-validation" novalidate>
+      {{ form_body | safe }}
+      <div class="form-footer">
+        <button type="submit" class="btn btn-primary">Save</button>
+        <a href="/" class="btn btn-ghost-secondary">Cancel</a>
+      </div>
+    </form>
+  </div>
+</div>

pygitweb/templates/pygitweb_settings.html ADDED Viewed

@@ -0,0 +1,12 @@
+<h1 class="page-title">PyGitWeb settings</h1>
+<div class="card">
+  <div class="card-body">
+    <form action="/settings/pygitweb/submit" method="post" class="needs-validation" novalidate>
+      {{ form_body | safe }}
+      <div class="form-footer">
+        <button type="submit" class="btn btn-primary">Save</button>
+        <a href="/" class="btn btn-ghost-secondary">Cancel</a>
+      </div>
+    </form>
+  </div>
+</div>

pygitweb/templates/search.html ADDED Viewed

@@ -0,0 +1,77 @@
+{# Search UI page. Expects: project, project_enc, project_url, search_api_url. #}
+<h1 class="page-title d-flex align-items-center gap-2">
+  <a href="{{ project_url }}" class="text-reset">{{ project }}</a>
+  <span class="text-muted">/</span>
+  <span>search</span>
+</h1>
+<div class="card mb-3">
+  <div class="card-body">
+    <form id="search-form" class="search-container" autocomplete="off" onsubmit="return false;">
+      <input
+        id="search-patterns"
+        class="form-control search"
+        type="text"
+        spellcheck="false"
+        autocomplete="off"
+        placeholder="Search regex (e.g. TODO|FIXME)..."
+        aria-label="Search pattern"
+      >
+      <details id="search-advanced" class="mt-2">
+        <summary>Advanced options</summary>
+        <div class="row g-2 mt-1">
+          <div class="col-md-6">
+            <label class="form-label" for="search-paths">Paths (relative, comma separated)</label>
+            <input id="search-paths" class="form-control" type="text" placeholder="src,docs">
+            <div class="form-hint">Restricted to the project tree.</div>
+          </div>
+          <div class="col-md-6">
+            <label class="form-label" for="search-globs">Globs (comma separated)</label>
+            <input id="search-globs" class="form-control" type="text" placeholder="*.py,*.md,!**/vendor/**">
+          </div>
+          <div class="col-md-3">
+            <label class="form-label" for="search-sort">Sort</label>
+            <select id="search-sort" class="form-select">
+              <option value="">(none)</option>
+              <option value="Path">Path</option>
+              <option value="-Path">Path (reverse)</option>
+              <option value="LastModified">Last modified</option>
+              <option value="-LastModified">Last modified (reverse)</option>
+              <option value="LastAccessed">Last accessed</option>
+              <option value="-LastAccessed">Last accessed (reverse)</option>
+              <option value="Created">Created</option>
+              <option value="-Created">Created (reverse)</option>
+            </select>
+          </div>
+          <div class="col-md-3">
+            <label class="form-label" for="search-max-count">Max matches per file</label>
+            <input id="search-max-count" class="form-control" type="number" min="1" value="25">
+          </div>
+          <div class="col-md-3 align-self-end">
+            <label class="form-check">
+              <input id="search-heading" class="form-check-input" type="checkbox" checked>
+              <span class="form-check-label">Heading (group by file)</span>
+            </label>
+          </div>
+          <div class="col-md-3 align-self-end">
+            <label class="form-check">
+              <input id="search-multiline" class="form-check-input" type="checkbox">
+              <span class="form-check-label">Multiline</span>
+            </label>
+          </div>
+        </div>
+      </details>
+    </form>
+  </div>
+</div>
+<div id="search-status" class="search-status text-muted mb-2" aria-live="polite"></div>
+<div id="search-results" class="search-results" role="region" aria-label="Search results"></div>
+<script>
+  window.SEARCH_PROJECT = {{ project | tojson }};
+  window.SEARCH_API_URL = {{ search_api_url | tojson }};
+</script>
+<script src="/static/search-page.js"></script>

pygitweb/templates/settings_form_field.html ADDED Viewed

@@ -0,0 +1,27 @@
+{% if kind == "bool" %}
+<div class="mb-3">
+  <div class="form-check">
+    <input type="checkbox" class="form-check-input" id="{{ safe_name }}" name="{{ field_name }}" value="on"{% if checked %} checked{% endif %}>
+    <label class="form-check-label" for="{{ safe_name }}">{{ name }}</label>
+  </div>
+  <small class="form-hint text-muted">{{ hint_text }}</small>
+</div>
+{% elif kind == "number" %}
+<div class="mb-3">
+  <label class="form-label" for="{{ safe_name }}">{{ name }}</label>
+  <input type="number" {% if number_step %}step="{{ number_step }}" {% endif %}class="form-control" id="{{ safe_name }}" name="{{ field_name }}" value="{{ str_val }}">
+  <small class="form-hint text-muted">{{ hint_text }}</small>
+</div>
+{% elif kind == "readonly" %}
+<div class="mb-3">
+  <label class="form-label" for="{{ safe_name }}">{{ name }}</label>
+  <input type="text" class="form-control bg-secondary" id="{{ safe_name }}" name="{{ field_name }}" value="{{ str_val }}" readonly>
+  <small class="form-hint text-muted">{{ hint_text }}</small>
+</div>
+{% else %}
+<div class="mb-3">
+  <label class="form-label" for="{{ safe_name }}">{{ name }}</label>
+  <input type="text" class="form-control" id="{{ safe_name }}" name="{{ field_name }}" value="{{ str_val }}">
+  <small class="form-hint text-muted">{{ hint_text }}</small>
+</div>
+{% endif %}

pygitweb/templates/table.html ADDED Viewed

@@ -0,0 +1,15 @@
+<table class="table table-vcenter card-table">
+<thead>
+<tr>{% for col in cols %}
+<th>{{col}}</th>
+{% endfor %}
+</tr>
+</thead>
+<tbody>{% for row in rows %}
+<tr>{% for cell in row %}
+<td>{{ cell | safe }}</td>
+{% endfor %}
+</tr>
+{% endfor %}
+</tbody>
+</table>

pygitweb/templates/user_profile.html ADDED Viewed

@@ -0,0 +1,10 @@
+<h1 class="page-title">Account</h1>
+<div class="card">
+  <div class="card-body">
+    <p class="mb-1"><strong>Username</strong></p>
+    <p class="text-muted mb-4">{{ username | e }}</p>
+    <p class="mb-0">
+      <a class="btn btn-outline-secondary" href="/logout?next=/">Sign out</a>
+    </p>
+  </div>
+</div>

pygitweb/templates_env.py ADDED Viewed

@@ -0,0 +1,21 @@
+"""Shared Jinja2 environment and preamble/postamble for pygitweb templates."""
+from jinja2 import Environment, PackageLoader, select_autoescape
+env = Environment(
+	loader=PackageLoader("pygitweb", "templates"),
+	autoescape=select_autoescape(enabled_extensions=("html", "xml"), default_for_string=True),
+	trim_blocks=True,
+	lstrip_blocks=True,
+)
+PREAMBLE = env.get_template("preamble.html")
+POSTAMBLE = """</div></div></div></body></html>"""
+_ESCAPE_TEMPLATE = env.from_string("{{ value|e }}")
+def jinja_escape(value: str | None) -> str | None:
+	if value is None:
+		return None
+	return _ESCAPE_TEMPLATE.render(value=value)

pygitweb/timeline_cache.py ADDED Viewed

@@ -0,0 +1,243 @@
+"""
+Per-project timeline cache for recent repository activity.
+"""
+from __future__ import annotations
+import os
+import threading
+from typing import Literal, TypedDict
+import pygit2
+from pygitweb.config import settings
+from pygitweb.projects import git_get_projects_list
+TIMELINE_CACHE_SIZE: int = 10
+TIMELINE_CACHE_TOTAL_EVENTS: int = 200
+TIMELINE_CACHE_BATCH_SIZE: int = 5
+class TimelineEvent(TypedDict):
+	timestamp: int
+	oid: str
+	kind: Literal["commit", "ref"]
+	description: str | None
+class TimelineProjectEvent(TypedDict):
+	project: str
+	event: TimelineEvent
+PROJECT_TIMELINE_CACHE: dict[str, list[TimelineEvent]] = {}
+_TIMELINE_CACHE_LOCK = threading.Lock()
+_TIMELINE_WARMING: bool = False
+def _commit_description(commit: pygit2.Commit) -> str | None:
+	if not commit.message:
+		return None
+	first_line: str = commit.message.splitlines()[0].strip()
+	return first_line or None
+def _collect_commit_events(repo: pygit2.Repository) -> list[TimelineEvent]:
+	start_points: list[pygit2.Oid | str] = []
+	for ref_name in repo.references:
+		if not ref_name.startswith("refs/heads/"):
+			continue
+		try:
+			resolved: pygit2.Reference = repo.references[ref_name].resolve()
+			oid: pygit2.Oid | str = resolved.target
+			start_points.append(oid)
+		except (KeyError, pygit2.GitError, ValueError):
+			continue
+	if not start_points:
+		try:
+			head_ref: pygit2.Reference = repo.head
+			start_points.append(head_ref.target)
+		except (pygit2.GitError, ValueError, KeyError):
+			pass
+	if not start_points:
+		return []
+	walker: pygit2.Walker = repo.walk(
+		start_points[0],
+		pygit2.enums.SortMode(pygit2.GIT_SORT_TIME | pygit2.GIT_SORT_TOPOLOGICAL),
+	)
+	for oid in start_points[1:]:
+		try:
+			walker.push(oid)
+		except (pygit2.GitError, ValueError):
+			continue
+	events: list[TimelineEvent] = []
+	seen: set[str] = set()
+	for commit in walker:
+		commit_oid: str = str(commit.id)
+		if commit_oid in seen:
+			continue
+		seen.add(commit_oid)
+		events.append({
+			"timestamp": commit.commit_time,
+			"oid": commit_oid,
+			"kind": "commit",
+			"description": _commit_description(commit),
+		})
+	return events
+def _collect_ref_events(repo: pygit2.Repository) -> list[TimelineEvent]:
+	events: list[TimelineEvent] = []
+	for ref_name in repo.references:
+		if not ref_name.startswith("refs/tags/"):
+			continue
+		try:
+			ref_obj: pygit2.Reference = repo.references[ref_name].resolve()
+			oid_str: str = str(ref_obj.target)
+			obj = repo[ref_obj.target]
+		except (KeyError, pygit2.GitError, ValueError):
+			continue
+		if isinstance(obj, pygit2.Tag):
+			tag_tagger = obj.tagger
+			timestamp: int = tag_tagger.time if tag_tagger else 0
+			description: str | None = ref_name.replace("refs/tags/", "", 1)
+		elif isinstance(obj, pygit2.Commit):
+			timestamp = obj.commit_time
+			description = ref_name.replace("refs/tags/", "", 1)
+		else:
+			continue
+		events.append({
+			"timestamp": timestamp,
+			"oid": oid_str,
+			"kind": "ref",
+			"description": description or None,
+		})
+	return events
+def build_project_timeline_cache(project: str, max_events: int = TIMELINE_CACHE_SIZE) -> list[TimelineEvent]:
+	try:
+		repo: pygit2.Repository = pygit2.Repository(os.path.join(settings.PROJECTROOT, project))
+	except (pygit2.GitError, OSError, ValueError):
+		return []
+	commit_events: list[TimelineEvent] = _collect_commit_events(repo)
+	ref_events: list[TimelineEvent] = _collect_ref_events(repo)
+	all_events: list[TimelineEvent] = commit_events + ref_events
+	all_events.sort(key=lambda event: (event["timestamp"], event["oid"]), reverse=True)
+	return all_events[:max_events]
+def warm_timeline_cache() -> None:
+	global PROJECT_TIMELINE_CACHE, _TIMELINE_WARMING
+	with _TIMELINE_CACHE_LOCK:
+		_TIMELINE_WARMING = True
+	try:
+		new_cache: dict[str, list[TimelineEvent]] = {}
+		projects = git_get_projects_list(
+			filter_path="",
+			paranoid=settings.STRICT_EXPORT,
+			export_ok=settings.EXPORT_OK,
+		)
+		project_names: list[str] = []
+		project_event_pool: dict[str, list[TimelineEvent]] = {}
+		for project_entry in projects:
+			project_name = project_entry.get("path")
+			if not isinstance(project_name, str) or not project_name:
+				continue
+			project_names.append(project_name)
+			try:
+				project_event_pool[project_name] = build_project_timeline_cache(
+					project_name,
+					max_events=TIMELINE_CACHE_TOTAL_EVENTS,
+				)
+			except (pygit2.GitError, OSError, ValueError, KeyError):
+				project_event_pool[project_name] = []
+		for project_name in project_names:
+			new_cache[project_name] = []
+		selected_events: list[TimelineProjectEvent] = []
+		next_index_by_project: dict[str, int] = {project_name: 0 for project_name in project_names}
+		for project_name in project_names:
+			if len(selected_events) >= TIMELINE_CACHE_TOTAL_EVENTS:
+				break
+			project_events = project_event_pool.get(project_name, [])
+			if not project_events:
+				continue
+			selected_events.append({"project": project_name, "event": project_events[0]})
+			next_index_by_project[project_name] = 1
+		while len(selected_events) < TIMELINE_CACHE_TOTAL_EVENTS:
+			candidate_projects: list[str] = [
+				project_name
+				for project_name in project_names
+				if next_index_by_project[project_name] < len(project_event_pool.get(project_name, []))
+			]
+			if not candidate_projects:
+				break
+			best_project: str = max(
+				candidate_projects,
+				key=lambda project_name: (
+					project_event_pool[project_name][next_index_by_project[project_name]]["timestamp"],
+					project_event_pool[project_name][next_index_by_project[project_name]]["oid"],
+					project_name,
+				),
+			)
+			start_index = next_index_by_project[best_project]
+			remaining_global = TIMELINE_CACHE_TOTAL_EVENTS - len(selected_events)
+			remaining_project = len(project_event_pool[best_project]) - start_index
+			take_count = min(TIMELINE_CACHE_BATCH_SIZE, remaining_global, remaining_project)
+			for offset in range(take_count):
+				selected_events.append({
+					"project": best_project,
+					"event": project_event_pool[best_project][start_index + offset],
+				})
+			next_index_by_project[best_project] = start_index + take_count
+		for item in selected_events:
+			new_cache[item["project"]].append(item["event"])
+		with _TIMELINE_CACHE_LOCK:
+			PROJECT_TIMELINE_CACHE = new_cache
+	finally:
+		with _TIMELINE_CACHE_LOCK:
+			_TIMELINE_WARMING = False
+def warm_timeline_cache_async() -> bool:
+	global _TIMELINE_WARMING
+	with _TIMELINE_CACHE_LOCK:
+		if _TIMELINE_WARMING:
+			return False
+		_TIMELINE_WARMING = True
+	thread = threading.Thread(target=warm_timeline_cache, daemon=True)
+	thread.start()
+	return True
+def clear_timeline_cache_async() -> bool:
+	global PROJECT_TIMELINE_CACHE
+	with _TIMELINE_CACHE_LOCK:
+		PROJECT_TIMELINE_CACHE = {}
+	return True
+def get_all_timeline_events() -> list[TimelineProjectEvent]:
+	events: list[TimelineProjectEvent] = []
+	with _TIMELINE_CACHE_LOCK:
+		cache_snapshot = {
+			project_name: list(project_events) for project_name, project_events in PROJECT_TIMELINE_CACHE.items()
+		}
+	for project_name, project_events in cache_snapshot.items():
+		for event in project_events:
+			events.append({"project": project_name, "event": event})
+	events.sort(
+		key=lambda item: (item["event"]["timestamp"], item["event"]["oid"], item["project"]),
+		reverse=True,
+	)
+	return events

pygitweb/validation.py ADDED Viewed

@@ -0,0 +1,75 @@
+"""
+Validation: pathname, ref format, refname, project, action; repo discovery via pygit2.
+Ported from gitweb/gitweb.perl (is_valid_pathname, is_valid_ref_format, is_valid_refname,
+is_valid_project, is_valid_action). Repo check uses pygit2.discover_repository..
+"""
+from __future__ import annotations
+import os
+import re
+from collections.abc import Callable
+import pygit2
+def is_valid_pathname(input_path: str | None) -> bool:
+	"""No '.', '..' as path elements, no null, no doubled slashes. Port of is_valid_pathname."""
+	if input_path is None:
+		return False
+	if "\0" in input_path:
+		return False
+	parts = input_path.strip("/").split("/")
+	return all(p not in ("", ".", "..") for p in parts)
+def is_valid_ref_format(input_ref: str | None) -> bool:
+	"""Git-check-ref-format rules: no /., no .., no control/space/special at start/end. Port of is_valid_ref_format."""
+	if input_ref is None:
+		return False
+	if "/." in input_ref or input_ref.startswith(".") or ".." in input_ref:
+		return False
+	if input_ref.endswith("/") or input_ref.endswith(".lock"):
+		return False
+	# No ASCII control, space, ~^:?*[
+	return not re.search(r"[\x00-\x20\x7f ~^:?*\[\]]", input_ref)
+def check_export_ok(
+	git_dir: str,
+	export_ok: str = "",
+	export_auth_hook: Callable[[str], bool] | None = None,
+	across_fs: bool = False,
+) -> bool:
+	"""True if path is a git repo (via pygit2.discover_repository) and optional export_ok file / auth hook pass."""
+	if not os.path.isdir(git_dir):
+		return False
+	try:
+		discovered = pygit2.discover_repository(git_dir, across_fs)
+		if not discovered:
+			return False
+	except (KeyError, pygit2.GitError, OSError):
+		return False
+	if export_ok and not os.path.isfile(os.path.join(git_dir, export_ok)):
+		return False
+	return not export_auth_hook or export_auth_hook(git_dir)
+def is_valid_project(
+	project: str | None,
+	projectroot: str,
+	export_ok: str,
+	strict_export: bool,
+	project_in_list: Callable[[str], bool],
+) -> bool:
+	"""Pathname valid, dir exists, export_ok, and (if strict) in project list. Port of is_valid_project."""
+	if project is None:
+		return False
+	if not is_valid_pathname(project):
+		return False
+	full = os.path.join(projectroot, project)
+	if not os.path.isdir(full):
+		return False
+	if not check_export_ok(full, export_ok):
+		return False
+	return not strict_export or project_in_list(project)