add github actions (#2)

* add github actions
* readme updates
* documenting some details

Author: elcritch

.github/workflows/build-full.yml

@@ -0,0 +1,46 @@
+on:
+  push:
+    tags:
+      - 'v*' # Triggers on version tags
+
+jobs:
+  tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        nimversion:
+          - '2.x'
+        os:
+          - ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: iffy/install-nim@v4
+      with:
+        version: ${{ matrix.nimversion }}
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Get tag version
+      id: get_version
+      run: |
+        git config --global user.email "atlas-tests-bot@nim-lang.org"
+        git config --global user.name "Atlas Tests Bot"
+        # Strip the 'v' prefix from the tag
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+    - name: Build Tests
+      run: |
+        nim atlasTestsCreate
+
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      with:
+        name: Release ${{ steps.get_version.outputs.version }}
+        tag_name: v${{ steps.get_version.outputs.version }}
+        draft: false
+        prerelease: false
+        generate_release_notes: true
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/build-release.yml

@@ -0,0 +1,44 @@
+
+on:
+  push:
+    branches:
+    - "main"
+  pull_request:
+    branches:
+    - "*"
+
+jobs:
+  tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        nimversion:
+          - '2.x'
+        os:
+          - ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: iffy/install-nim@v4
+      with:
+        version: ${{ matrix.nimversion }}
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Get version
+      id: get_version
+      run: |
+        git config --global user.email "atlas-tests-bot@nim-lang.org"
+        git config --global user.name "Atlas Tests Bot"
+        VERSION=$(nim --verbosity:0 atlasTestsVersion)
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+    
+    - name: Build Tests
+      run: |
+        nim --verbosity:0 atlasTestsVersion
+        nim atlasTestsCreate
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: atlas-tests
+        path: atlas-tests.zip

README.md

@@ -1,2 +1,18 @@
 # atlas-tests
 Persistent Atlas tests.
+
+To generate an update atlas-tests.zip run:
+
+    nim atlasTestsCreate
+
+This will create a couple of folders needed for testing Atlas's workspaces:
+
+    atlas-tests/ws_generate/buildGraph
+    atlas-tests/ws_generate/buildGraphNoGitTags
+    atlas-tests/ws_generate/manifest.txt
+    atlas-tests/ws_generate/<org>/<repo>...
+    atlas-tests/ws_generate/readme.md
+    atlas-tests/ws_ingtegration/manifest.txt
+    atlas-tests/ws_ingtegration/<org>/<repo>...
+
+The file `atlas-tests/ws_generate/readme.md` should not be modified as it's contents are used as a sanity check in Atlas `tester.nim`.

config.nims

@@ -12,8 +12,13 @@ task atlasTestsCreate, "Create a atlas-tests zipped cache":
 task atlasTestsSetup, "Setup atlas-tests from a cached zip":
   exec "nim c -r downloadTestRepos"
 
+task clean, "Clean all":
+  rmDir("atlas-tests/ws_generated")
+  rmDir("atlas-tests/ws_integration")
+
 task cleanDist, "Clean all":
-  rmDir("atlas-tests")
+  rmDir("atlas-tests/working")
+  rmDir("atlas-tests/working")
   mkDir("atlas-tests")
   writeFile("atlas-tests/.gitkeep", "")
   for item in walkDir("."):

createTestReposZip.nim

@@ -7,6 +7,5 @@ import downloadTestRepos
 runWsGenerated()
 runWsIntegration()
 
-withDir "atlas-tests":
-  let zipfile = "atlas-tests.zip"
-  exec "zip -ru $1 ws_generated/ ws_integration/" % [zipfile]
+let zipfile = "atlas-tests.zip"
+exec "zip -ru $1 atlas-tests/ws_generated/ atlas-tests/ws_integration/" % [zipfile]

wsIntegration.nim

@@ -38,6 +38,9 @@ proc runWsIntegration*() =
         repos.add(repo)
 
 proc getRepoUrls(): seq[string] =
+  ## these were gathered after running `--full --keepWorkspace use https://github.com/zedeus/nitter`
+  ## the urls should be cleaned up, e.g. remove `.git` at the ends
+  ## the `githttpserver` will handle routing `.git` urls during the test runs
   let repos = dedent"""
   https://github.com/timotheecour/asynctools
   https://github.com/disruptek/bump