chore: removing need for start_docker.sh instead use mix docker.compose up/down (#179)

Author: mjaric

README.md

@@ -222,9 +222,20 @@ If you do not have specific requirements on how you would like to start sql serv
 in docker, you can use script for this repo.
 
 ```bash
-$ ./docker-mssql.sh
+$ docker compose up -d --profile=<check_profile_in_compose>
 ```
 
+👉🏻 OR  you can let mix task to detect platform you are using and chose best option for you.
+
+```
+mix docker.compose up
+```
+
+you can see more details about options for `mix docker.compose` taks by running help `mix help docker.compose`
+
+
+it will do but in some cases you may want to use `mix docker.compose up` so it detects for you which platform you are using, so it will use appropriate image.
+
 If you prefer to install SQL Server directly on your computer, you can find
 installation instructions here:
 

docker-compose.yml

@@ -0,0 +1,54 @@
+services:
+  tds-mssql-amd64:
+    profiles: ["mssql_amd64"]
+    image: mcr.microsoft.com/mssql/server:2022-latest
+    platform: "linux/amd64"
+    container_name: tds-mssql-amd64
+    environment:
+      ACCEPT_EULA: "Y"
+      MSSQL_SA_PASSWORD: "some!Password"
+      MSSQL_PID: "Developer"
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "/opt/mssql-tools/bin/sqlcmd",
+          "-U",
+          "sa",
+          "-P",
+          "Password!",
+          "-Q",
+          "select 1",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    ports:
+      - "1433:1433"
+
+  tds-mssql-arm64:
+    profiles: ["mssql_arm64"]
+    image: mcr.microsoft.com/azure-sql-edge:latest
+    platform: "linux/arm64"
+    container_name: tds-mssql-arm64
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "/opt/mssql-tools/bin/sqlcmd",
+          "-U",
+          "sa",
+          "-P",
+          "Password!",
+          "-Q",
+          "select 1",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+    environment:
+      ACCEPT_EULA: "1"
+      MSSQL_SA_PASSWORD: "some!Password"
+      MSSQL_PID: "Developer"
+    ports:
+      - "1433:1433"

lib/mix/tasks/docker.compose.ex

@@ -0,0 +1,200 @@
+defmodule Mix.Tasks.Docker.Compose do
+  use Mix.Task
+
+  @shortdoc "Runs docker compose up/down via Mix with optional platform-aware profiles"
+
+  @default_compose "docker-compose.yml"
+  @amd64_profile "mssql_amd64"
+  @arm64_profile "mssql_arm64"
+
+  @moduledoc """
+  CLI wrapper around **docker compose** for starting and stopping development services.
+
+  ## Commands
+
+    - `mix docker.compose up`
+    - `mix docker.compose down`
+
+  The `up` command always runs in **detached mode** (`docker compose ... up -d`).
+  The `down` command stops all services (`docker compose ... down`).
+
+  ---
+
+  ## Options
+
+    - **`-f`, `--file PATH`**
+      Use a specific compose file instead of the default:
+
+          mix docker.compose up -f docker-compose.test.yml
+
+    - **`-p`, `--profile NAME`**
+      Use a specific compose profile:
+
+          mix docker.compose up --profile mssql_amd64
+
+  ---
+
+  ## Profile selection rules
+
+  If no `-f/--file` is provided:
+
+    - `docker-compose.yml` is used
+    - if no `--profile` is given:
+        - the profile is auto-selected based on host architecture:
+            - mssql_arm64 on ARM / Apple Silicon
+            - mssql_amd64 on x86_64
+    - if `--profile` is given:
+        - that profile is used explicitly
+
+  If `-f/--file` is provided:
+
+    - that compose file is used
+    - if no `--profile` is given:
+        - no `--profile` flag is passed to Docker
+    - if `--profile` is given:
+        - that profile is passed to Docker
+
+  ---
+
+  ## Examples
+
+  Basic usage (auto-selected profile):
+
+      mix docker.compose up
+      mix docker.compose down
+
+  Custom compose file:
+
+      mix docker.compose up -f docker-compose.test.yml
+      mix docker.compose down -f docker-compose.test.yml
+
+  Explicit profile:
+
+      mix docker.compose up --profile mssql_amd64
+  """
+
+  def run(args) do
+    {opts, rest, has_file?} = parse_args(args)
+
+    compose_file = opts[:file] || @default_compose
+    docker = find_docker!()
+
+    profile = select_profile(opts, has_file?)
+
+    case rest do
+      ["up"] ->
+        # up je UVEK detached
+        run_compose(docker, compose_file, profile, ["up"], true)
+
+      ["down"] ->
+        run_compose(docker, compose_file, profile, ["down"], false)
+
+      [] ->
+        Mix.shell().error("""
+        No command provided. Expected: up | down
+
+        Examples:
+            mix docker.compose up
+            mix docker.compose down
+            mix docker.compose up -f docker-compose.dev.yml
+        """)
+
+      unknown ->
+        Mix.shell().error("Unknown docker.compose command: #{inspect(unknown)}")
+    end
+  end
+
+  # --------------------------------------------------------------------
+  # Helpers
+  # --------------------------------------------------------------------
+
+  defp run_compose(docker, compose_file, profile, command, detach?) do
+    profile_info =
+      case profile do
+        nil -> "no profile"
+        p -> "profile=#{p}"
+      end
+
+    detach_info = if detach?, do: "detached", else: "attached"
+
+    IO.puts(
+      ">>> docker compose #{Enum.join(command, " ")} using #{compose_file} (#{profile_info}, #{detach_info})\n"
+    )
+
+    base_args = ["compose", "-f", compose_file]
+
+    args =
+      base_args
+      |> maybe_add_profile(profile)
+      # ["compose", "-f", ..., "up" | "down"]
+      |> Kernel.++(command)
+      |> maybe_add_detach(detach?)
+
+    # output ide direktno na STDOUT, ne koristimo ga u kodu
+    {_, status} = System.cmd(docker, args, into: IO.stream(:stdio, :line))
+
+    if status != 0 do
+      Mix.raise("docker compose #{Enum.join(command, " ")} failed with exit #{status}.")
+    end
+  end
+
+  defp maybe_add_profile(args, nil), do: args
+  defp maybe_add_profile(args, profile), do: args ++ ["--profile", profile]
+
+  defp maybe_add_detach(args, true), do: args ++ ["-d"]
+  defp maybe_add_detach(args, false), do: args
+
+  defp find_docker! do
+    case System.find_executable("docker") do
+      nil -> Mix.raise("Could not find `docker` executable in PATH")
+      path -> path
+    end
+  end
+
+  # vraćamo i flag da li je prosleđen :file (da znamo da li je custom ili default)
+  defp parse_args(args) do
+    {opts, rest, _invalid} =
+      OptionParser.parse(
+        args,
+        switches: [
+          file: :string,
+          profile: :string
+        ],
+        aliases: [
+          f: :file,
+          p: :profile
+        ]
+      )
+
+    has_file? = Keyword.has_key?(opts, :file)
+    {opts, rest, has_file?}
+  end
+
+  defp select_profile(opts, has_file?) do
+    case opts[:profile] do
+      # user eksplicitno prosledio profil → uvek koristimo
+      profile when is_binary(profile) ->
+        profile
+
+      # nema --profile
+      nil ->
+        if has_file? do
+          # custom -f → default je "bez profila"
+          nil
+        else
+          # default file → auto-detekcija arhitekture
+          arch =
+            :erlang.system_info(:system_architecture)
+            |> List.to_string()
+
+          cond do
+            String.contains?(arch, "arm") or String.contains?(arch, "aarch64") ->
+              @arm64_profile
+
+            true ->
+              @amd64_profile
+          end
+        end
+    end
+  end
+end

mix.exs

@@ -18,6 +18,9 @@ defmodule Tds.Mixfile do
         tds_encoding: [
           mode: if(Mix.env() == :prod, do: :release, else: :debug)
         ]
+      ],
+      preferred_cli_env: [
+        test: :test
       ]
     ]
   end
@@ -39,7 +42,8 @@ defmodule Tds.Mixfile do
       {:ex_doc, "~> 0.19", only: :docs},
       {:excoding, "~> 0.1", optional: true, only: :test},
       {:tzdata, "~> 1.0", optional: true, only: :test},
-      {:table, "~> 0.1.0", optional: true}
+      {:table, "~> 0.1.0", optional: true},
+      {:credo, "~> 1.7", only: [:dev, :test], runtime: false}
     ]
   end
 

mix.lock

@@ -1,11 +1,14 @@
 %{
+  "bunt": {:hex, :bunt, "1.0.0", "081c2c665f086849e6d57900292b3a161727ab40431219529f13c4ddcf3e7a44", [:mix], [], "hexpm", "dc5f86aa08a5f6fa6b8096f0735c4e76d54ae5c9fa2c143e5a1fc7c1cd9bb6b5"},
   "castore": {:hex, :castore, "1.0.14", "4582dd7d630b48cf5e1ca8d3d42494db51e406b7ba704e81fbd401866366896a", [:mix], [], "hexpm", "7bc1b65249d31701393edaaac18ec8398d8974d52c647b7904d01b964137b9f4"},
   "certifi": {:hex, :certifi, "2.15.0", "0e6e882fcdaaa0a5a9f2b3db55b1394dba07e8d6d9bcad08318fb604c6839712", [:rebar3], [], "hexpm", "b147ed22ce71d72eafdad94f055165c1c182f61a2ff49df28bcc71d1d5b94a60"},
+  "credo": {:hex, :credo, "1.7.13", "126a0697df6b7b71cd18c81bc92335297839a806b6f62b61d417500d1070ff4e", [:mix], [{:bunt, "~> 0.2.1 or ~> 1.0", [hex: :bunt, repo: "hexpm", optional: false]}, {:file_system, "~> 0.2 or ~> 1.0", [hex: :file_system, repo: "hexpm", optional: false]}, {:jason, "~> 1.0", [hex: :jason, repo: "hexpm", optional: false]}], "hexpm", "47641e6d2bbff1e241e87695b29f617f1a8f912adea34296fb10ecc3d7e9e84f"},
   "db_connection": {:hex, :db_connection, "2.7.0", "b99faa9291bb09892c7da373bb82cba59aefa9b36300f6145c5f201c7adf48ec", [:mix], [{:telemetry, "~> 0.4 or ~> 1.0", [hex: :telemetry, repo: "hexpm", optional: false]}], "hexpm", "dcf08f31b2701f857dfc787fbad78223d61a32204f217f15e881dd93e4bdd3ff"},
   "decimal": {:hex, :decimal, "2.3.0", "3ad6255aa77b4a3c4f818171b12d237500e63525c2fd056699967a3e7ea20f62", [:mix], [], "hexpm", "a4d66355cb29cb47c3cf30e71329e58361cfcb37c34235ef3bf1d7bf3773aeac"},
   "earmark_parser": {:hex, :earmark_parser, "1.4.44", "f20830dd6b5c77afe2b063777ddbbff09f9759396500cdbe7523efd58d7a339c", [:mix], [], "hexpm", "4778ac752b4701a5599215f7030989c989ffdc4f6df457c5f36938cc2d2a2750"},
   "ex_doc": {:hex, :ex_doc, "0.38.2", "504d25eef296b4dec3b8e33e810bc8b5344d565998cd83914ffe1b8503737c02", [:mix], [{:earmark_parser, "~> 1.4.44", [hex: :earmark_parser, repo: "hexpm", optional: false]}, {:makeup_c, ">= 0.1.0", [hex: :makeup_c, repo: "hexpm", optional: true]}, {:makeup_elixir, "~> 0.14 or ~> 1.0", [hex: :makeup_elixir, repo: "hexpm", optional: false]}, {:makeup_erlang, "~> 0.1 or ~> 1.0", [hex: :makeup_erlang, repo: "hexpm", optional: false]}, {:makeup_html, ">= 0.1.0", [hex: :makeup_html, repo: "hexpm", optional: true]}], "hexpm", "732f2d972e42c116a70802f9898c51b54916e542cc50968ac6980512ec90f42b"},
   "excoding": {:hex, :excoding, "0.1.5", "779aab7fef0dfe57f2b1d41c1820fd66483e2b2a3ccd96805f1656d513910051", [:mix], [{:rustler, ">= 0.0.0", [hex: :rustler, repo: "hexpm", optional: true]}, {:rustler_precompiled, "~> 0.5", [hex: :rustler_precompiled, repo: "hexpm", optional: false]}], "hexpm", "db66ee44caf37528887e380a900dc5e234bd57925fc9d91e8c4b0d1ad1700ae1"},
+  "file_system": {:hex, :file_system, "1.1.1", "31864f4685b0148f25bd3fbef2b1228457c0c89024ad67f7a81a3ffbc0bbad3a", [:mix], [], "hexpm", "7a15ff97dfe526aeefb090a7a9d3d03aa907e100e262a0f8f7746b78f8f87a5d"},
   "hackney": {:hex, :hackney, "1.24.1", "f5205a125bba6ed4587f9db3cc7c729d11316fa8f215d3e57ed1c067a9703fa9", [:rebar3], [{:certifi, "~> 2.15.0", [hex: :certifi, repo: "hexpm", optional: false]}, {:idna, "~> 6.1.0", [hex: :idna, repo: "hexpm", optional: false]}, {:metrics, "~> 1.0.0", [hex: :metrics, repo: "hexpm", optional: false]}, {:mimerl, "~> 1.4", [hex: :mimerl, repo: "hexpm", optional: false]}, {:parse_trans, "3.4.1", [hex: :parse_trans, repo: "hexpm", optional: false]}, {:ssl_verify_fun, "~> 1.1.0", [hex: :ssl_verify_fun, repo: "hexpm", optional: false]}, {:unicode_util_compat, "~> 0.7.0", [hex: :unicode_util_compat, repo: "hexpm", optional: false]}], "hexpm", "f4a7392a0b53d8bbc3eb855bdcc919cd677358e65b2afd3840b5b3690c4c8a39"},
   "idna": {:hex, :idna, "6.1.1", "8a63070e9f7d0c62eb9d9fcb360a7de382448200fbbd1b106cc96d3d8099df8d", [:rebar3], [{:unicode_util_compat, "~> 0.7.0", [hex: :unicode_util_compat, repo: "hexpm", optional: false]}], "hexpm", "92376eb7894412ed19ac475e4a86f7b413c1b9fbb5bd16dccd57934157944cea"},
   "jason": {:hex, :jason, "1.4.4", "b9226785a9aa77b6857ca22832cffa5d5011a667207eb2a0ad56adb5db443b8a", [:mix], [{:decimal, "~> 1.0 or ~> 2.0", [hex: :decimal, repo: "hexpm", optional: true]}], "hexpm", "c5eb0cab91f094599f94d55bc63409236a8ec69a21a67814529e8d5f6cc90b3b"},