add readme

.docker/Dockerfile

@@ -6,22 +6,19 @@ RUN getuto
 
 RUN emerge-webrsync
 
+RUN mkdir -p /var/cache/distfiles/git3-src && chown portage:portage /var/cache/distfiles/git3-src
+
+ENV EGIT_OVERRIDE_REPO_MESONBUILD_MESON=https://jturnerusa.dev/cgit/meson
+
 RUN emerge \
     =dev-lang/rust-bin-9999 \
+    =dev-build/meson-9999::gentoo \
     llvm-core/clang \
     llvm-core/lld \
     dev-vcs/git \
     sys-process/parallel \
     net-libs/nodejs
 
-RUN git clone https://jturnerusa.dev/cgit/ebuilds/ /var/db/repos/spawns
-
-COPY etc/portage/repos.conf /etc/portage/
-
-RUN mkdir -p /var/cache/distfiles/git3-src && chown portage:portage /var/cache/distfiles/git3-src
-
-RUN emerge =dev-build/meson-9999::spawns
-
 RUN useradd -m gentooligan
 
 USER gentooligan

.gitea/workflows/gentoo-utils.yml

@@ -15,61 +15,55 @@ jobs:
     runs-on: ubuntu-latest
     continue-on-error: true
     steps:
+      - name: Checkout repo
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
       - name: Restore git cache
         uses: actions/cache@v4
         with:
           path: .git
           key: gitea-repo-${{ gitea.repository }}-${{ gitea.ref }}
 
-      - name: Checkout repo
-        uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
-
-      - name: Check for changes before building
+      - name: Detect Changes
+        uses: dorny/paths-filter@v3
         id: image-changes
-        # build image only if 1. changes are detected or 2. an image for the working branch doesnt exist
+        with:
+          filters: |
+            docker:
+              - ".docker/**"
+
+      - name: Metadata
+        id: metadata
         run: |
           branch_name="${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}"
           default_branch_name="${{ gitea.event.repository.default_branch }}"
           image_tag=latest
-          comparison_hash="${{ gitea.event.before }}"
-
-          if [[ "$branch_name" != "$default_branch_name" ]]; then
-            image_tag=$branch_name
-          fi
-          # slugify
-          image_tag="$(echo "$image_tag" | sed -E 's/[^a-zA-Z0-9]/-/g')"
-
-          # rebase breaks gitea.event.before, so check to make sure the hash provided exists
-          if ! git merge-base --is-ancestor $comparison_hash $branch_name >/dev/null 2>&1; then
-            comparison_hash=$(git merge-base origin/$default_branch_name $branch_name)
-          fi
-            
-          if ! git diff $comparison_hash ${{ gitea.sha }} --no-patch --exit-code .docker; then
-            build_image=true
-          else
-            if ! docker manifest inspect ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${image_tag} >/dev/null 2>&1; then
-              build_image=true
-            else
-              build_image=false
+          if [[ $default_branch_name != $branch_name ]]; then
+            this_image_tag="$(echo "$branch_name" | sed -E 's/[^a-zA-Z0-9]/-/g')"
+            echo "steps... ${{ steps.image-changes.outputs.docker }}"
+            if [[ ${{ steps.image-changes.outputs.docker }} == true ]] || docker manifest inspect ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${this_image_tag} >/dev/null 2>&1; then
+                image_tag=$this_image_tag
             fi
+          else
+            build_image=true
           fi
 
           echo "default_branch_name=$default_branch_name" >> $GITEA_OUTPUT
           echo "branch_name=$branch_name" >> $GITEA_OUTPUT
           echo "image_tag=$image_tag" >> $GITEA_OUTPUT
-          echo "comparison_hash=$comparison_hash" >> $GITEA_OUTPUT
-          echo "build_image=$build_image" >> $GITEA_OUTPUT
+          echo "build_image=${build_image:-${{ steps.image-changes.outputs.docker }}}" >> $GITEA_OUTPUT
           cat $GITEA_OUTPUT
+
       - name: Set up Docker buildx
-        if: steps.image-changes.outputs.build_image == 'true'
+        if: steps.metadata.outputs.build_image == 'true'
         uses: docker/setup-buildx-action@v3
         with:
           driver-opts: network=runners-net
 
       - name: Log in to Github Container Registry
-        if: steps.image-changes.outputs.build_image == 'true'
+        if: steps.metadata.outputs.build_image == 'true'
         uses: docker/login-action@v3
         with:
           registry: ${{ vars.REGISTRY_URL }}
@@ -77,26 +71,32 @@ jobs:
           password: ${{ secrets.CI_BOT_TOKEN }}
 
       - name: Build and push
-        if: steps.image-changes.outputs.build_image == 'true'
+        if: steps.metadata.outputs.build_image == 'true'
         uses: docker/build-push-action@v6
         with:
           push: true
-          tags: ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${{ steps.image-changes.outputs.image_tag }}
+          tags: ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${{ steps.metadata.outputs.image_tag }}
           context: "{{defaultContext}}:.docker"
           cache-from: type=gha
           cache-to: type=gha,mode=max
     outputs:
-      image_tag: ${{ steps.image-changes.outputs.image_tag }}
+      image_tag: ${{ steps.metadata.outputs.image_tag }}
 
   build:
     runs-on: gentoo
     env:
-      CC: 'clang'
-      CXX: 'clang++'
+      CC: "clang"
+      CXX: "clang++"
     needs: build-oci-image
     container:
       image: ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${{ needs.build-oci-image.outputs.image_tag }}
     steps:
+      - name: Restore git cache
+        uses: actions/cache@v4
+        with:
+          path: build
+          key: gitea-repo-${{ gitea.repository }}-${{ gitea.ref }}
+
       - name: Checkout repo
         uses: actions/checkout@v5
 
@@ -110,12 +110,17 @@ jobs:
   test:
     runs-on: gentoo
     env:
-      CC: 'clang'
-      CXX: 'clang++'
+      CC: "clang"
+      CXX: "clang++"
     needs: [build-oci-image, build]
     container:
       image: ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${{ needs.build-oci-image.outputs.image_tag }}
     steps:
+      - name: Restore git cache
+        uses: actions/cache@v4
+        with:
+          path: build
+          key: gitea-repo-${{ gitea.repository }}-${{ gitea.ref }}
       - name: Checkout repo
         uses: actions/checkout@v5
 
@@ -128,13 +133,18 @@ jobs:
   fuzz:
     runs-on: gentoo
     env:
-      CC: 'clang'
-      CXX: 'clang++'
+      CC: "clang"
+      CXX: "clang++"
       FUZZER_TIMEOUT_S: 300
     needs: [build-oci-image, build]
     container:
       image: ${{ vars.REGISTRY_URL }}/${{ gitea.repository }}:${{ needs.build-oci-image.outputs.image_tag }}
     steps:
+      - name: Restore git cache
+        uses: actions/cache@v4
+        with:
+          path: build
+          key: gitea-repo-${{ gitea.repository }}-${{ gitea.ref }}
       - name: Checkout repo
         uses: actions/checkout@v5
 

README.org

@@ -0,0 +1,50 @@
+#+title: Gentoo Utils
+
+* Getting Started
+
+Gentoo Utils must be compiled from source currently. See the compiling from source section for more information.
+
+* Development :development:contributing:
+
+There are two main avenues for development:
+- compiling normally using packages via portage
+- using the podman container
+
+** Development without using a podman container
+*** Install Build Prerequisites
+- dev-lang/rust-bin-9999
+- llvm-core/clang
+- llvm-core/lld
+- sys-process/parallel (Needed for =check.sh=)
+- dev-build/meson
+
+Install build deps:
+#+begin_src bash :noeval
+emerge -a dev-lang/rust-bin-9999 \
+    llvm-core/clang \
+    llvm-core/lld \
+    sys-process/parallel
+#+end_src
+
+Compiling this project currently requires using a patched meson. Install patched meson:
+#+begin_src bash :noeval
+EGIT_OVERRIDE_REPO_MESONBUILD_MESON=https://jturnerusa.dev/cgit/meson emerge -a =dev-build/meson-9999::gentoo
+#+end_src
+
+** Development using a podman container
+The podman image comes with all the tools required to compile gentoo-utils.
+
+Clone the repo
+#+begin_src bash :noeval
+git clone https://git.epenguin.net/gentoo-utils/gentoo-utils.git
+cd gentoo-utils
+#+end_src
+
+Run the check script:
+#+begin_src bash :noeval
+podman run --rm --userns=keep-id -v $PWD:/workspace git.epenguin.net/gentoo-utils/gentoo-utils:latest ./check.sh
+#+end_src
+
+
+* Resources
+pms-utils spec link