Simplify setup process with uv (#71)

Now uv will handle python installation, dependencies and tasks so we
don't need to install many things separately

Also remove sketchviz git submodule in favor of installing using NPM,
now we just need to run npm install. A task defined inside
pyproject.toml will expose a environment variable to point into the
installed package inside node_modules

README and GitHub deploy workflow were updated as well with the new
changes

Author: erickgnavar

.github/workflows/deploy-site.yml

@@ -1,3 +1,4 @@
+---
 name: Deploy Python Perú to GitHub Pages
 
 on:
@@ -10,14 +11,13 @@ permissions:
 
 jobs:
   deploy:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
-        with:
-          submodules: true
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.13' 
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
       - name: Set Locale
         run: |
           sudo apt-get update && sudo apt-get install tzdata locales -y && sudo locale-gen es_ES.UTF-8
@@ -29,16 +29,16 @@ jobs:
           locale
           locale -c -k LC_NUMERIC
           localectl status
-      - name: Install Dependencies
-        run: |
-          pip install -r requirements.txt
       - name: Install graphviz
         run: |
           sudo apt-get install graphviz nodejs npm
-          sudo ./bin/install-sketchviz.sh
+      - name: Install Dependencies
+        run: |
+          uv sync
+          npm install
       - name: Build Blog
         run: |
-          ablog build
+          uv run poe build
       - name: Publish to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}

.gitignore

@@ -215,3 +215,5 @@ _website/
 # python.pe
 _static/images/gravatar/
 _static/images/sketchviz/
+
+node_modules/

.gitmodules

@@ -1,64 +1,73 @@
 # Python Peru's Website
 
+## Install build tools
 
 To build, first you need to install graphviz:
 
 1. macOS with Homebrew
+
 ```sh
 brew install graphviz
 ```
 
 2. macOS with MacPorts
+
 ```sh
 sudo port install graphviz
 ```
 
 3. apt-based Linux distribution
+
 ```sh
 sudo apt install graphviz
 ```
 
 Then make sure you have installed node and npm
 
 1. macOS with Homebrew
+
 ```sh
 brew install node
 ```
 
 2. macOS with MacPorts
+
 ```sh
 sudo port install nodejs21 npm10
 ```
 
 3. apt-based Linux distribution
+
 ```sh
 sudo apt install nodejs npm
 ```
 
 Install sketchviz
-```sh
-sudo ./bin/install-sketchviz.sh
-```
-
-Make sure you have Python 3.12 installed. Then install `poetry`:
 
 ```sh
-pip install -U poetry
+npm i
 ```
 
+Install `uv`, follow the instructions in their documentation https://docs.astral.sh/uv/getting-started/installation/,
+`uv` will handle all the dependencies and the python installation as well. So we don't need to install `python`
+separately.
+
 Then install all the necessary packages (make sure to change to the root directory of the project):
 
-```sh
-poetry install
+```shell
+uv sync
 ```
 
+## Building the site
+
 You can build the html files of the blog by running the following command:
 
-```sh
-poetry run ablog build
+```shell
+uv run poe build
 ```
 
 Then you can serve the files locally using this command:
+
 ```sh
-poetry run ablog serve
+uv run ablog serve
 ```

README.md

@@ -67,7 +67,9 @@ def run(self):
         filename = h.digest().hex()
         filename = f"{filename}{FILENAME_EXT}"
         save_path = os.path.join(save_path, filename)
-        subprocess.run(["sketchviz", temp_name, save_path], check=True)
+        # TODO: add a proper way to alert user when this binary is not found
+        binary_path = os.environ.get("SKETCHVIZ_BINARY")
+        subprocess.run([binary_path, temp_name, save_path], check=True)
         os.remove(temp_name)
         logger.info(f"Sketchviz: Created SVG image: {save_path}")