added screenshot action

Author: jakubdotpy3d

.github/scripts/take_screenshot.py

@@ -0,0 +1,100 @@
+import os
+from pathlib import Path
+from typing import Tuple
+from PIL import Image
+from selenium import webdriver
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+def setup_driver(cookie_value: str) -> webdriver.Chrome:
+    """Set up a headless Chrome WebDriver and authenticate with a session cookie.
+
+    Args:
+        cookie_value (str): The session cookie value for authentication.
+
+    Returns:
+        webdriver.Chrome: Configured Chrome WebDriver instance.
+    """
+    options = Options()
+    options.add_argument('--headless=new')
+    options.add_argument('--window-size=1920,1080')
+    driver = webdriver.Chrome(options=options)
+    driver.get('https://adventofcode.com')
+    driver.add_cookie(
+        {'name': 'session', 'value': cookie_value.lstrip('session='), 'domain': 'adventofcode.com'}
+    )
+    return driver
+
+
+def crop_image(
+    input_path: str, output_path: str, crop_box: Tuple[int, int, int, int] = (0, 0, 640, 621)
+) -> None:
+    """Crop an image to the specified dimensions and save it to the output path.
+
+    Args:
+        input_path (str): Path to the input image file.
+        output_path (str): Path to save the cropped image.
+        crop_box (Tuple[int, int, int, int], optional):
+            The cropping box defined as (left, upper, right, lower).
+            Defaults to (0, 0, 640, 621).
+    """
+    with Image.open(input_path) as img:
+        cropped = img.crop(crop_box)
+        cropped.save(output_path)
+
+
+def take_screenshot(driver: webdriver.Chrome, url: str, selector: str, output_name: str) -> None:
+    """Capture a screenshot of a web element specified by a CSS selector and crop it.
+
+    Args:
+        driver (webdriver.Chrome): The WebDriver instance used to navigate and take screenshots.
+        url (str): The URL of the web page to capture.
+        selector (str): The CSS selector of the element to capture.
+        output_name (str): Path to save the screenshot.
+    """
+    driver.get(url)
+    element = WebDriverWait(driver, 10).until(
+        EC.presence_of_element_located((By.CSS_SELECTOR, selector))
+    )
+    element.screenshot(output_name)
+    crop_image(output_name, output_name)
+
+
+def get_year() -> str:
+    """Determine the year based on the parent folder name.
+
+    Returns:
+        str: The year extracted from the folder name.
+    """
+    folder_name = Path(__file__).parents[2].name
+    return folder_name.split('aoc')[1]
+
+
+def main() -> None:
+    """Main entry point for the script.
+
+    Sets up the environment, captures a screenshot, and ensures proper cleanup of resources.
+    """
+    os.makedirs('screenshots', exist_ok=True)
+    cookie = os.getenv('COOKIE')
+    if not cookie:
+        raise ValueError('COOKIE environment variable is not set.')
+
+    driver = setup_driver(cookie)
+    year = get_year()
+    try:
+        take_screenshot(
+            driver,
+            f'https://adventofcode.com/{year}',
+            'body > main > pre',
+            'screenshots/aoc-screenshot.png',
+        )
+    finally:
+        driver.quit()
+
+
+if __name__ == '__main__':
+    main()

.github/workflows/update_readme.yml

@@ -0,0 +1,45 @@
+name: Update Screenshot in README
+
+on:
+  push:
+    branches:
+      - master
+
+  workflow_dispatch:
+
+jobs:
+  update-readme:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install the project
+        run: uv sync --group actions --all-extras --dev
+
+      - name: Install Chrome
+        uses: browser-actions/setup-chrome@v1
+        with:
+          chrome-version: stable
+
+      - name: Install Chrome WebDriver
+        uses: nanasess/setup-chromedriver@v2
+
+      - name: Start Chrome Driver
+        run: |
+          chromedriver --version
+          chrome --version
+
+      - name: Take Screenshot
+        env:
+          COOKIE: ${{ secrets.COOKIE }}
+        run: |
+          uv run .github/scripts/take_screenshot.py
+
+      - name: Commit and Push Changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "Update screenshot in README"
+          file_pattern: screenshots/*.png

.python-version

@@ -0,0 +1 @@
+3.13

README.md

@@ -3,6 +3,8 @@ advent of code 2023
 
 https://adventofcode.com/2023
 
+![Advent of Code Screenshot](screenshots/aoc-screenshot.png)
+
 ### about
 
 https://adventofcode.com/2023/about

pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "aoc2023"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "networkx>=3.4.2",
+    "pytest~=7.4.3",
+    "shapely~=2.0.2",
+]
+
+[tool.uv.sources]
+support = { path = "support" }
+
+[dependency-groups]
+actions = [
+    "pillow>=11.1.0",
+    "selenium>=4.27.1",
+]