bond

defmodule Bond.MixProject do
  use Mix.Project

  @version "1.10.0"
  @source_url "https://github.com/jvoegele/bond"

  def project do
    [
      app: :bond,
      version: @version,
      elixir: "~> 1.16",
      elixirc_paths: elixirc_paths(Mix.env()),
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      dialyzer: [
        plt_local_path: "priv/plts",
        plt_add_apps: [:stream_data, :mix, :ex_unit],
        ignore_warnings: ".dialyzer_ignore.exs"
      ],
      test_coverage: [tool: ExCoveralls],

      # Hex
      description: "Design by Contract (DbC) for Elixir",
      package: package(),

      # Docs
      name: "Bond",
      source_url: @source_url,
      docs: docs()
    ]
  end

  def cli do
    [
      preferred_envs: [
        coveralls: :test,
        "coveralls.detail": :test,
        "coveralls.post": :test,
        "coveralls.html": :test
      ]
    ]
  end

  # Run "mix help compile.app" to learn about applications.
  def application do
    [
      extra_applications: [:logger]
    ]
  end

  # Specifies which paths to compile per environment.
  defp elixirc_paths(:test), do: ~w[lib test/support]
  defp elixirc_paths(_), do: ~w[lib]

  # Run "mix help deps" to learn about dependencies.
  defp deps do
    [
      {:telemetry, "~> 1.0"},
      # `stream_data` is optional: users who want property-based testing via
      # `Bond.PropertyTest` add it to their own deps; everyone else doesn't pay the cost.
      # Marked `optional: true` so it's available for Bond's own test suite (and to lib/
      # references guarded by `Code.ensure_loaded?/1`) without becoming a transitive dep
      # for downstream apps.
      {:stream_data, "~> 1.0", optional: true},
      {:credo, "~> 1.7", only: [:dev, :test], runtime: false},
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},
      {:ex_doc, "~> 0.34", only: [:dev, :test]},
      {:excoveralls, "~> 0.18", only: :test},
      # `norm` is used only by test/bond/norm_compat_test.exs to verify Bond's
      # `Kernel.@/1` override coexists with another library that also overrides
      # `@/1`. Norm uses the identical technique to Bond (import Kernel exc. @,
      # specific clause + catch-all forwarding), so it's the natural conflict
      # counterpart. Not a transitive dep — only_test.
      {:norm, "~> 0.13", only: :test}
    ]
  end

  defp package do
    [
      name: :bond,
      files: ["lib", "mix.exs", "README.md", "LICENSE", "CHANGELOG.md", ".formatter.exs"],
      maintainers: ["Jason Voegele"],
      licenses: ["Apache-2.0"],
      links: %{
        "GitHub" => @source_url,
        "Changelog" => "#{@source_url}/blob/main/CHANGELOG.md"
      }
    ]
  end

  defp docs do
    [
      main: "Bond",
      extras: [
        {"LICENSE", [title: "License"]},
        "CHANGELOG.md",
        "guides/getting-started.md",
        "guides/contract-inheritance.md",
        "guides/reusable-contracts.md",
        "guides/contracts-and-concurrency.md",
        "guides/testing-contracts.md",
        "guides/stability.md",
        "guides/public-api.md",
        "guides/overhead.md",
        "guides/faq.md",
        "guides/about.md",
        "guides/history.md"
      ],
      filter_modules: fn _module, meta ->
        # This allows us to tag modules as internal and exclude them from the API docs as follows:
        #   @moduledoc internal: true
        not Map.get(meta, :internal, false)
      end
    ]
  end
end