refactor: rename juggler => blend

.gitignore

@@ -20,7 +20,7 @@ erl_crash.dump
 *.ez
 
 # Ignore package tarball (built via "mix hex.build").
-juggler-*.tar
+blend-*.tar
 
 # Temporary files, for example, from tests.
 /tmp/

README.md

@@ -1,22 +1,22 @@
-# Juggler
+# Blend
 
 Generates and maintains multiple lockfiles so that you can test your elixir app
 against different variations of your dependencies
 
 ## Installation
 
 If [available in Hex](https://hex.pm/docs/publish), the package can be installed
-by adding `juggler` to your list of dependencies in `mix.exs`:
+by adding `blend` to your list of dependencies in `mix.exs`:
 
 ```elixir
 def deps do
   [
-    {:juggler, "~> 0.1.0"}
+    {:blend, "~> 0.1.0"}
   ]
 end
 ```
 
 Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
 and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
-be found at <https://hexdocs.pm/juggler>.
+be found at <https://hexdocs.pm/blend>.
 

lib/blend.ex

@@ -0,0 +1,80 @@
+defmodule Blend do
+  require Logger
+
+  @moduledoc """
+  Documentation for `Blend`.
+  """
+
+  @blend_dir "blend"
+  @blendfile_path "blend.exs"
+  @blendfile_template """
+  # Example for testing against 1.x and 2.x of some dependency
+  # %{
+  #   "dep-name-1-0": [{:dep_name, "~> 1.0"}],
+  #   "dep-name-2-0": [{:dep_name, "~> 2.0"}],
+  # }
+  """
+
+  def init do
+    case File.read(@blendfile_path) do
+      {:ok, _} ->
+        Logger.info("#{@blendfile_path} file already exists, doing nothing")
+
+      {:error, :enoent} ->
+        File.write(@blendfile_path, @blendfile_template)
+        Logger.info("Successfully created #{@blendfile_path} file")
+    end
+  end
+
+  def within(blend_id, fun) do
+    with_project(blend_id, blend_deps(blend_id), fun)
+  end
+
+  def blends do
+    case File.read(@blendfile_path) do
+      {:ok, contents} ->
+        case Code.eval_string(contents) do
+          {%{} = map, _} ->
+            map
+
+          _ ->
+            raise "Couldn't find a map defining your blends in #{@blendfile_path} file"
+        end
+
+      {:error, :enoent} ->
+        raise "Couldn't find a #{@blendfile_path} file"
+    end
+  end
+
+  defp blend_deps(blend_id) do
+    blends() |> Map.fetch!(blend_id)
+  end
+
+  defp with_project(blend_id, deps, fun) do
+    :ok =
+      Mix.ProjectStack.push(
+        Blend.TmpProject,
+        Mix.Project.config()
+        |> Keyword.merge(
+          app: blend_id,
+          deps:
+            deps
+            |> Enum.reduce(
+              Mix.Project.config()[:deps],
+              fn dep, acc ->
+                acc
+                |> List.keystore(elem(dep, 0), 0, dep)
+              end
+            ),
+          lockfile: "#{@blend_dir}/#{blend_id}.mix.lock",
+          build_path: "#{@blend_dir}/_build/#{blend_id}",
+          deps_path: "#{@blend_dir}/deps/#{blend_id}"
+        ),
+        "nofile"
+      )
+
+    fun.()
+  after
+    Mix.ProjectStack.pop()
+  end
+end

lib/mix/tasks/blend/get.ex

@@ -0,0 +1,18 @@
+defmodule Mix.Tasks.Blend.Get do
+  use Mix.Task
+
+  @shortdoc "Generates lockfiles from blend.exs"
+
+  @impl true
+  def run(args) do
+    Blend.blends()
+    |> Enum.map(fn {blend_id, _deps} ->
+      Blend.within(
+        blend_id,
+        fn ->
+          Mix.Task.rerun("deps.get", args)
+        end
+      )
+    end)
+  end
+end

lib/mix/tasks/blend/init.ex

@@ -0,0 +1,10 @@
+defmodule Mix.Tasks.Blend.Init do
+  use Mix.Task
+
+  @shortdoc "Initializes an empty blend.exs file"
+
+  @impl true
+  def run(_args) do
+    Blend.init()
+  end
+end

mix.exs

@@ -1,9 +1,9 @@
-defmodule Juggler.MixProject do
+defmodule Blend.MixProject do
   use Mix.Project
 
   def project do
     [
-      app: :juggler,
+      app: :blend,
       version: "0.1.0",
       elixir: "~> 1.15",
       start_permanent: Mix.env() == :prod,

test/juggler_test.exs → test/blend_test.exs

@@ -1,6 +1,6 @@
-defmodule JugglerTest do
+defmodule BlendTest do
   use ExUnit.Case
-  doctest Juggler
+  doctest Blend
 
   @tmp_path Path.expand("../tmp", __DIR__)
 
@@ -10,32 +10,32 @@ defmodule JugglerTest do
     :ok
   end
 
-  test "init/0 generates juggles file" do
+  test "init/0 generates blend file" do
     File.cd!(
       @tmp_path,
       fn ->
-        refute File.exists?("juggles.exs")
-        assert Juggler.init() == :ok
-        assert File.exists?("juggles.exs")
+        refute File.exists?("blend.exs")
+        Mix.Task.run("blend.init")
+        assert File.exists?("blend.exs")
       end
     )
   end
 
-  test "juggler.get task" do
+  test "blend.get task" do
     File.cd!(
       @tmp_path,
       fn ->
         File.write(
-          "juggles.exs",
+          "blend.exs",
           """
           %{
             "jason-1-0": [{:jason, "~> 1.0"}]
           }
           """
         )
 
-        Mix.Task.run("juggler.get")
-        File.exists?("juggler/jason-1-0.mix.lock")
+        Mix.Task.run("blend.get")
+        File.exists?("blend/jason-1-0.mix.lock")
       end
     )