Style/add ruff

.github/workflows/docker.yml

@@ -20,16 +20,15 @@ jobs:
       matrix:
         architecture:
           - linux/amd64
-          # - linux/arm64
     steps:
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Docker meta
         id: meta
         uses: docker/metadata-action@v4
         with:
-          images: linbreux/wikmd
+          images: Jerakin/wikmd
           tags: |
             type=ref,event=pr
             type=ref,event=tag
@@ -39,9 +38,9 @@ jobs:
         run: echo "Creating Docker image ${{ steps.meta.outputs.tags }}"
 
       - name: Build & export
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
-          file: docker/Dockerfile
+          file: Dockerfile
           push: false
           tags: ${{ steps.meta.outputs.tags }}
           outputs: type=docker,dest=/tmp/wikmd.tar
@@ -62,7 +61,7 @@ jobs:
     name: "test-${{ matrix.tag }}"
     steps:
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Download artifact
         uses: actions/download-artifact@v2
@@ -96,16 +95,20 @@ jobs:
       - name: Assert wikmd status
         run: curl -I localhost:5000 2>&1 | awk '/HTTP\// {print $2}' | grep -w "200\|301"
 
+      # Check that wikmd is rendering
+      - name: Check wikmd rendering status
+        run: curl -s localhost:5000 | grep -w "What is it?"
+
   publish:
     # Publish if official repo and push to 'main' or new tag
     if: |
-      github.repository == 'Linbreux/wikmd' &&
+      github.repository == 'Jerakin/wikmd' &&
       (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/'))
     runs-on: ubuntu-latest
     needs: [build, test]
     steps:
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to DockerHub
         uses: docker/login-action@v2
@@ -114,8 +117,9 @@ jobs:
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
       - name: Publish
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v5
         with:
-          file: docker/Dockerfile
+          file: Dockerfile
+          platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ needs.build.outputs.wikmd_tags }}

.github/workflows/main.yml

@@ -21,15 +21,16 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install flake8 pytest
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        pip install .[test]
     - name: Test with pytest
       run: |
-        python -m pytest -v 
+        python -m pytest
 
     - name: Start wikmd
-      run: python wiki.py &
-
+      run: |
+        cd src
+        python -m wikmd.wiki &
+
     - name: screenshots-ci-action
       uses: flameddd/screenshots-ci-action@master
       with:

.gitignore

@@ -96,15 +96,12 @@ dmypy.json
 # Cython debug symbols
 cython_debug/
 
+# Generated plugin files
+src/wikmd/plugins/draw/drawings/*
+!src/wikmd/plugins/draw/drawings/.gitkeep
+
+
 # Personal wiki pages
 wiki/*
-wiki/src/*
-
-!wiki/Features.md
-!wiki/How to use the wiki.md
-!wiki/Markdown cheatsheet.md
-!wiki/Using the version control system.md
-!wiki/homepage.md
-!wiki/src
 
 temp/*

docker/README.md → DOCKER.md

@@ -2,18 +2,14 @@
 
 [wikmd](https://github.com/Linbreux/wikmd) is a file based wiki that uses markdown.
 
-This repo provides Docker files that are loosely based on those of the [linuxserver](https://www.linuxserver.io/) community.
-
-Docker files are available for arm, arm64 and amd64.
-
 ## Usage
 
 Here are some example snippets to help you get started creating a container.
 
 Build the image,
 
 ```bash
-docker build -t linbreux/wikmd:latest -f docker/Dockerfile .
+docker build -t linbreux/wikmd:latest -f Dockerfile .
 ```
 
 ### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))

Dockerfile

@@ -0,0 +1,66 @@
+FROM python:3.9-alpine3.17 as python-base
+
+# Prevents Python from writing pyc files.
+ENV PYTHONDONTWRITEBYTECODE=1
+
+# Keeps Python from buffering stdout and stderr to avoid situations where
+# the application crashes without emitting any logs due to buffering.
+ENV PYTHONUNBUFFERED=1
+
+# We will be installing venv
+ENV VIRTUAL_ENV="/venv"
+
+# Create a non-privileged user that the app will run under.
+# See https://docs.docker.com/go/dockerfile-user-best-practices/
+ARG UID=10001
+RUN adduser \
+    --disabled-password \
+    --gecos "" \
+    --home "/nonexistent" \
+    --shell "/sbin/nologin" \
+    --no-create-home \
+    --uid "${UID}" \
+    appuser
+
+
+# Add project path to python path, this to ensure we can reach it from anywhere
+WORKDIR /code
+ENV PYTHONPATH="/code:$PYTHONPATH"
+
+# prepare the virtual env
+ENV PATH="$VIRTUAL_ENV/bin:$PATH"
+RUN python -m venv $VIRTUAL_ENV
+
+# BUILDER
+FROM python-base as python-builder
+
+# Install our dependencies
+RUN apk update
+RUN apk add git
+RUN apk add pandoc
+RUN apk add build-base linux-headers
+
+# Python dependencies
+WORKDIR /code
+
+COPY pyproject.toml /code
+
+# Copy the py project and use a package to convert our pyproject.toml file into a requirements file
+# We can not install the pyproject with pip as that would install the project and we only
+# wants to install the project dependencies.
+RUN python -m pip install toml-to-requirements==0.2.0
+RUN toml-to-req --toml-file pyproject.toml
+
+RUN python -m pip install --no-cache-dir --upgrade -r ./requirements.txt
+
+# Copy our source content over
+COPY ./src/wikmd /code/wikmd
+
+# Change the directory to the root.
+WORKDIR /
+
+# Expose the port that the application listens on.
+EXPOSE 5000
+
+# Run the application.
+CMD ["python", "-m", "wikmd.wiki"]

README.md

@@ -7,7 +7,7 @@ It’s a file-based wiki that aims to simplicity. Instead of storing the data in
 
 To view the documents in the browser, the document is converted to html.
 
-![preview](static/images/readme-img.png)
+![preview](src/wikmd/static/images/readme-img.png)
 
 ## Features
 
@@ -31,6 +31,10 @@ To view the documents in the browser, the document is converted to html.
 
 Detailed installation instruction can be found [here](https://linbreux.github.io/wikmd/installation.html).
 
+## Development
+
+Instructions on the easiest way to develop on the project can be found [here](https://linbreux.github.io/wikmd/development.html).
+
 ## Plugins & Knowledge graph (beta)
 
 More info can be found in the [docs](https://linbreux.github.io/wikmd/knowledge%20graph.html).