Adding unit test and github flows

Author: thiagoesteves

.github/workflows/pr-ci.yaml

@@ -0,0 +1,101 @@
+name: Jellyfish CI
+
+on:
+  pull_request:
+    branches: [main]
+
+env:
+  MIX_ENV: test
+  SHELL: /usr/bin/bash
+
+jobs:
+  setup:
+    name: Setup
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup BEAM
+        uses: erlef/setup-beam@v1
+        with:
+          otp-version: 28
+          elixir-version: 1.19.1
+
+      - name: Cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            _build
+            deps
+          key: |
+            jellyfish-${{ hashFiles('mix.lock') }}-2025-12-17
+          restore-keys: |
+            jellyfish-
+
+      - name: Install Elixir dependencies
+        run: mix do deps.get + compile --warnings-as-errors
+
+  test:
+    name: Test
+    needs: setup
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup BEAM
+        uses: erlef/setup-beam@v1
+        with:
+          otp-version: 28
+          elixir-version: 1.19.1
+
+      - name: Cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            _build
+            deps
+          key: |
+            jellyfish-${{ hashFiles('mix.lock') }}-2025-12-17
+          restore-keys: |
+            jellyfish-
+
+      - name: Run tests
+        run: mix test --warnings-as-errors
+
+  analysis:
+    name: Static Analysis
+    needs: setup
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup BEAM
+        uses: erlef/setup-beam@v1
+        with:
+          otp-version: 28
+          elixir-version: 1.19.1
+
+      - name: Cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            _build
+            deps
+          key: |
+            jellyfish-${{ hashFiles('mix.lock') }}-2025-12-17
+          restore-keys: |
+            jellyfish-
+
+      - name: Install Elixir dependencies
+        run: mix do deps.get + compile --warnings-as-errors
+
+      - name: Run mix deps.unlock
+        run: mix deps.unlock --check-unused
+
+      - name: Ex Doc
+        run: mix docs --failed
+
+      - name: Formatted
+        run: mix format --check-formatted

lib/jellyfish/cache.ex

@@ -0,0 +1,74 @@
+defmodule Jellyfish.Cache do
+  @moduledoc """
+  Provides process-dictionary-based caching for hot upgrade operations.
+
+  This module manages ephemeral state during the build process to track which
+  applications and dependencies have been processed for appup generation and copying.
+  The cache is scoped to the current Mix process and does not persist across builds.
+
+  ## Use Cases
+
+  - **Deduplication**: Ensures appup files are generated only once per dependency
+  - **Version Tracking**: Stores application version information for use across build tasks
+  - **Build Coordination**: Coordinates state between `GenAppup` and `CopyAppup` tasks
+  """
+
+  ### ==========================================================================
+  ### Public APIs
+  ### ==========================================================================
+
+  @doc """
+  Checks if this is the first time generating appup files for a library.
+
+  This function uses a boolean flag to track whether appup generation has been
+  triggered for a specific library. The first call returns `true` and sets the
+  flag to `false`, ensuring subsequent calls return `false`.
+  """
+  @spec first_run_gen_appup?(atom()) :: boolean()
+  def first_run_gen_appup?(lib), do: first_run?("libraries-gen-appup", lib)
+
+  @doc """
+  Checks if this is the first time copying appup files for a library.
+
+  Similar to `first_run_gen_appup?/1`, but tracks the copy operation separately.
+  This allows the build process to coordinate generation and copying as distinct phases.
+  """
+  @spec first_run_copy_appup?(atom()) :: boolean()
+  def first_run_copy_appup?(lib), do: first_run?("libraries-copy-appup", lib)
+
+  @doc """
+  Stores application version information in the process cache.
+
+  The version is stored as a map with a `:version` key, allowing for future
+  extension with additional metadata if needed.
+  """
+  @spec store_app_version(atom() | String.t(), String.t()) :: %{version: String.t()}
+  def store_app_version(app, version) do
+    Process.put(app, %{version: version})
+  end
+
+  @doc """
+  Retrieves application information from the cache.
+
+  Returns the data previously stored via `store_app_version/2`, or `nil` if
+  no data exists for the given application.
+  """
+  @spec get_app(atom() | String.t()) :: %{version: String.t()} | nil
+  def get_app(app), do: Process.get(app)
+
+  ### ==========================================================================
+  ### Private functions
+  ### ==========================================================================
+  defp first_run?(term, lib) do
+    # Retrieve the flag, defaulting to true if not set
+    data = Process.get({term, lib}, true)
+
+    # If this is the first run (true), mark it as false for next time
+    if data do
+      Process.put({term, lib}, false)
+    end
+
+    # Return the original value
+    data
+  end
+end

lib/jellyfish/releases/appups.ex lib/jellyfish/releases/appup.exlib/jellyfish/releases/appups.ex renamed to lib/jellyfish/releases/appup.ex

@@ -1,4 +1,4 @@
-defmodule Jellyfish.Releases.Appups do
+defmodule Jellyfish.Releases.Appup do
   @moduledoc """
   Generate appup files for hot upgrades
 

lib/jellyfish/tasks/compile/gen_appup.ex

@@ -7,7 +7,7 @@ defmodule Mix.Tasks.Compile.GenAppup do
   use Mix.Task.Compiler
 
   alias Jellyfish.Cache
-  alias Jellyfish.Releases.Appups
+  alias Jellyfish.Releases.Appup
 
   @recursive true
 
@@ -147,7 +147,7 @@ defmodule Mix.Tasks.Compile.GenAppup do
             end
         end
 
-      case Appups.make(app, v1, v2, v1_path, v2_path, _transforms = []) do
+      case Appup.make(app, v1, v2, v1_path, v2_path, _transforms = []) do
         {:error, _} = err ->
           err