use uv and create a package

Author: honzajavorek

.github/dependabot.yml

@@ -3,7 +3,13 @@ updates:
 - package-ecosystem: pip
   directory: "/"
   schedule:
-    interval: daily
-    time: "08:00"
-    timezone: Europe/Prague
-  open-pull-requests-limit: 10
+    interval: weekly
+  open-pull-requests-limit: 1
+  groups:
+    python:
+      patterns: ["*"]
+- package-ecosystem: github-actions
+  directory: "/"
+  schedule:
+    interval: weekly
+  open-pull-requests-limit: 1

.github/workflows/check_links.yml

@@ -11,15 +11,10 @@ jobs:
       issues: write  # required for peter-evans/create-issue-from-file
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/checkout@v3
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.12"
-      - name: Install dependencies
-        run: python -m pip install -r requirements.txt
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
       - name: Build documentation
-        run: sphinx-build -nWaE . _build
+        run: uv run sphinx-build -nWaE . _build
       - name: Link Checker
         id: lychee
         uses: lycheeverse/lychee-action@v2

.github/workflows/generate_grants.yml

@@ -9,15 +9,11 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: "3.12"
-    - name: Install dependencies
-      run: python -m pip install -r requirements.txt
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
     - name: Generate the list of grants
-      run: python _scripts/generate_grants.py > ./operations/grants.rst
+      run: uv run python _scripts/generate_grants.py > ./operations/grants.rst
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     - name: Create PR

.github/workflows/test.yml

@@ -6,14 +6,10 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: "3.12"
-    - name: Install dependencies
-      run: python -m pip install -r requirements.txt
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
     - name: Test
-      run: pytest
+      run: uv run pytest
     - name: Build documentation
-      run: sphinx-build -nWaE . _build
+      run: uv run sphinx-build -nWaE . _build

.readthedocs.yml

@@ -5,7 +5,7 @@ build:
     python: "3.12"
 python:
   install:
-    - requirements: requirements.txt
+    - method: pip
 sphinx:
   configuration: conf.py
   fail_on_warning: true

CONTRIBUTING.rst

@@ -13,16 +13,15 @@ Abyste něco změnili v textech, nemusíte nic instalovat. Obsah lze upravovat o
 Instalace
 ---------
 
-Když toho upravujete víc, nebo máte zálusk na nějaké složitější kejkle, je lepší mít materiály nainstalované na svém počítači. Projekt vyžaduje Python 3.12.
+Když toho upravujete víc, nebo máte zálusk na nějaké složitější kejkle, je lepší mít materiály nainstalované na svém počítači. Bude k tomu potřeba `uv <https://docs.astral.sh/uv/>`_:
 
 #. Stáhněte projekt: ``git clone https://github.com/pyvec/docs.pyvec.org.git``
-#. Vytvořte si a aktivujte virtuální prostředí
-#. Nainstalujte do prostředí závislosti: ``python -m pip install -r requirements.txt``
+#. Nainstalujte: ``uv sync --group=dev``
 
 Běžná práce
 -----------
 
-#. Ve virtuálním prostředí spusťte projekt: ``sphinx-autobuild . _build``
+#. Ve virtuálním prostředí spusťte projekt: ``uv sphinx-autobuild . _build``
 #. Otevřete si v prohlížeči `<http://127.0.0.1:8000>`_
 #. V editoru upravujete texty a v prohlížeči si kontrolujete výsledek
 #. Projekt zastavíte v terminálu pomocí :kbd:`Ctrl+C`
@@ -102,4 +101,4 @@ V adresáři ``_scripts`` je skript ``generate_grants.py``, který:
 * vygeneruje soubor ``operations/grants.rst`` z dat na `pyvec/money <https://github.com/pyvec/money>`_ a ze šablony ``operations/grants.rst``,
 * commitne a pushne jej přes Git do repozitáře.
 
-Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues a tento skript hlasování archivuje sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s `pyvec/money <https://github.com/pyvec/money>`_ něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen automatizovaný přepis. Skript započítává pouze hlasy od členů výboru (podle souboru ``board.yml``).
+Hlasování o grantech probíhá :ref:`pomocí reakcí <jak-hlasovani>` na GitHub Issues a tento skript hlasování archivuje sem do dokumentace pro účely jednoduššího vyhledávání, zálohy, kdyby se s `pyvec/money <https://github.com/pyvec/money>`_ něco stalo, a pro nějakou historickou evidenci. Kanonickým zdrojem pravdy ale zůstává hlasování přímo na GitHub Issues, toto je jen automatizovaný přepis. Skript započítává pouze hlasy od členů výboru (podle souboru ``src/pyvec_docs/board.yml``).

_scripts/generate_grants.py

@@ -1,70 +1,21 @@
 import os
-import re
-from datetime import date
 from operator import itemgetter
 from pathlib import Path
 
 import requests
-import strictyaml as yaml
 from jinja2 import Template
 
+from pyvec_docs.board import BOARD_HISTORY
+from pyvec_docs.grants import get_lock_date, get_votes, remove_comments, to_date
+
 
 GITHUB_TOKEN = os.getenv("GITHUB_TOKEN")
 GITHUB_API_HEADERS = {
     "Accept": "application/vnd.github.squirrel-girl-preview",
     "Authorization": f"token {GITHUB_TOKEN}",
 }
 GITHUB_API_URL = "https://api.github.com/repos/pyvec/money/issues"
-REACTIONS_MAPPING = {"+1": "ano", "-1": "ne", "eyes": "zdržel(a) se"}
-CONTENT_PATH = Path(__file__).parent.parent
-
-BOARD_HISTORY_SCHEMA = yaml.Seq(
-    yaml.Map(
-        {
-            "from": yaml.Datetime(),
-            "members": yaml.MapPattern(yaml.Str(), yaml.Str()),
-        }
-    )
-)
-BOARD_HISTORY_PATH = Path(__file__).parent.parent / "board.yml"
-BOARD_HISTORY = sorted(
-    yaml.load(BOARD_HISTORY_PATH.read_text(), BOARD_HISTORY_SCHEMA).data,
-    key=itemgetter("from"),
-    reverse=True,
-)
-
-
-def to_date(iso_datetime_string):
-    iso_date_string, _ = iso_datetime_string.split("T")
-    return date.fromisoformat(iso_date_string)
-
-
-def remove_comments(html):
-    return re.sub(r"<!--[^<]+-->", "", html).strip()
-
-
-def get_board_member_name(username, voted_at, board_history=None):
-    board_history = board_history or BOARD_HISTORY
-    for board in board_history:  # sorted from the most recent
-        if voted_at > board["from"].date():
-            return board["members"].get(username)
-    return None
-
-
-def get_votes(reactions, voted_at, board_history=None):
-    for reaction in reactions:
-        username = reaction["user"]["login"]
-        name = get_board_member_name(username, voted_at, board_history)
-        if name:  # else not reaction from a board member
-            text = REACTIONS_MAPPING.get(reaction["content"])
-            if text:
-                yield {"name": name, "text": text}
-
-
-def get_lock_date(events):
-    for event in reversed(events):
-        if event["event"] == "locked":
-            return to_date(event["created_at"])
+CONTENT_PATH = Path(__file__).parent.parent.parent.parent
 
 
 if __name__ == "__main__":
@@ -103,7 +54,7 @@ def get_lock_date(events):
 
         res = requests.get(issue["reactions"]["url"], headers=GITHUB_API_HEADERS)
         res.raise_for_status()
-        votes = list(get_votes(res.json(), voted_at))
+        votes = list(get_votes(res.json(), voted_at, BOARD_HISTORY))
 
         grants.append(
             {

conf.py

@@ -1,13 +1,6 @@
 # Configuration file for the Sphinx documentation builder
 
 import os
-import sys
-
-
-# -- Environment -------------------------------------------------------------
-
-# Explicitly put the extensions directory to Python path
-sys.path.append(os.path.abspath("_extensions"))
 
 
 # -- Project information -----------------------------------------------------
@@ -32,9 +25,9 @@
     "sphinx.ext.todo",
     "sphinx.ext.githubpages",
     "sphinxemoji.sphinxemoji",
-    "slack",
-    "twitter",
-    "gh_repo",
+    "pyvec_docs.ext.slack",
+    "pyvec_docs.ext.twitter",
+    "pyvec_docs.ext.gh_repo",
     "myst_parser",
 ]
 
@@ -69,6 +62,8 @@
     ".github",
     ".pytest_cache",
     ".ruff_cache",
+    "src",
+    "tests",
 ]
 
 # The name of the Pygments (syntax highlighting) style to use.