mix.exs

defmodule Snmpkit.MixProject do
  use Mix.Project

  def project do
    [
      app: :snmpkit,
      version: "1.4.0",
      elixir: "~> 1.18",
      start_permanent: Mix.env() == :prod,
      elixirc_paths: elixirc_paths(Mix.env()),
      test_pattern: "**/*_test.exs",
      test_coverage: [tool: ExCoveralls],
      compilers: [:yecc] ++ Mix.compilers(),
      deps: deps(),
      dialyzer: dialyzer(),
      aliases: aliases(),

      # Hex package metadata
      description: description(),
      package: package(),
      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, :crypto, :parsetools],
      mod: {Snmpkit.Application, []}
    ]
  end

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

  # Run "mix help deps" to learn about dependencies.
  defp deps do
    [
      # Core dependencies
      {:jason, "~> 1.4"},
      {:yaml_elixir, "~> 2.9", optional: true},
      {:telemetry, "~> 1.0", optional: true},

      # Development and test dependencies
      {:ex_doc, "~> 0.29", only: :dev, runtime: false},
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},
      {:credo, "~> 1.7", only: [:dev, :test], runtime: false},
      {:excoveralls, "~> 0.18", only: :test},
      {:benchee, "~> 1.1", only: [:dev, :test]},
      {:stream_data, "~> 0.5", only: :test}
    ]
  end

  defp aliases do
    [
      # Static checks used in CI: formatting, credo (strict), dialyzer
      lint: ["format --check-formatted", "credo --strict", "dialyzer"]
    ]
  end

  defp description do
    """
    A comprehensive SNMP toolkit for Elixir featuring a unified API, pure Elixir
    implementation, and powerful device simulation. Perfect for network monitoring,
    testing, and development with support for SNMP operations, MIB management,
    and realistic device simulation.
    """
  end

  defp package do
    [
      name: "snmpkit",
      maintainers: ["SnmpKit Team"],
      licenses: ["MIT"],
      links: %{
        "GitHub" => "https://github.com/awksedgreep/snmpkit",
        "Documentation" => "https://hexdocs.pm/snmpkit"
      },
      files: ~w(lib priv/walks src mix.exs README.md LICENSE.md)
    ]
  end

  defp docs do
    [
      main: "api-reference",
      extras: [
        "README.md",
        "CONTRIBUTING.md",
        "LICENSE",
        "docs/mib-guide.md",
        "docs/testing-guide.md",
        "docs/unified-api-guide.md",
        "docs/enriched-output-migration.md",
        "docs/concurrent-multi.md",
        "docs/v1.4.0-release-notes.md",
        "docs/v1.3.24-release-notes.md",
        "docs/v1.3.23-release-notes.md",
        "docs/v1.3.22-release-notes.md",
        "docs/v1.3.21-release-notes.md",
        "TIMEOUT_DOCUMENTATION.md",
        "docs/v0.2.0-release-notes.md",
        "docs/v0.3.0-release-notes.md",
        "docs/v0.3.1-release-notes.md",
        "docs/v0.3.2-release-notes.md",
        "docs/v0.3.3-release-notes.md",
        "docs/v0.3.4-release-notes.md",
        "docs/v0.3.5-release-notes.md",
        "docs/v0.4.0-release-notes.md",
        "livebooks/01_quickstart.livemd",
        "livebooks/02_snmp_operations.livemd",
        "livebooks/03_mib_management.livemd",
        "livebooks/04_device_simulation.livemd",
        "livebooks/05_high_performance.livemd",
        "examples/README.md"
      ],
      groups_for_modules: [
        "Core API": [
          SnmpKit,
          SnmpKit.SNMP,
          SnmpKit.MIB,
          SnmpKit.Sim
        ],
        "SNMP Protocol": [
          SnmpKit.SnmpLib,
          SnmpKit.SnmpLib.ASN1,
          SnmpKit.SnmpLib.Types,
          SnmpKit.SnmpLib.PDU,
          SnmpKit.SnmpLib.PDU.Builder,
          SnmpKit.SnmpLib.PDU.Constants,
          SnmpKit.SnmpLib.PDU.Decoder,
          SnmpKit.SnmpLib.PDU.Encoder,
          SnmpKit.SnmpLib.PDU.V3Encoder,
          SnmpKit.SnmpLib.OID,
          SnmpKit.SnmpLib.Transport,
          SnmpKit.SnmpLib.Manager,
          SnmpKit.SnmpLib.Walker,
          SnmpKit.SnmpLib.HostParser,
          SnmpKit.SnmpLib.Error,
          SnmpKit.SnmpLib.ErrorHandler,
          SnmpKit.SnmpLib.Utils
        ],
        "SNMPv3 Security": [
          SnmpKit.SnmpLib.Security,
          SnmpKit.SnmpLib.Security.Auth,
          SnmpKit.SnmpLib.Security.Keys,
          SnmpKit.SnmpLib.Security.Priv,
          SnmpKit.SnmpLib.Security.USM
        ],
        "MIB Support": [
          SnmpKit.MibParser,
          SnmpKit.SnmpMgr.MIB,
          SnmpKit.SnmpLib.MIB,
          SnmpKit.SnmpLib.MIB.Compiler,
          SnmpKit.SnmpLib.MIB.Parser,
          SnmpKit.SnmpLib.MIB.Registry
        ],
        "Network Management": [
          SnmpKit.SnmpMgr,
          SnmpKit.SnmpMgr.Config,
          SnmpKit.SnmpMgr.Core,
          SnmpKit.SnmpMgr.Walk,
          SnmpKit.SnmpMgr.Bulk,
          SnmpKit.SnmpMgr.Table,
          SnmpKit.SnmpMgr.Multi,
          SnmpKit.SnmpMgr.MultiV2,
          SnmpKit.SnmpMgr.Format,
          SnmpKit.SnmpMgr.Target,
          SnmpKit.SnmpMgr.Types,
          SnmpKit.SnmpMgr.Stream,
          SnmpKit.SnmpMgr.AdaptiveWalk
        ],
        "Manager Infrastructure": [
          SnmpKit.SnmpMgr.Engine,
          SnmpKit.SnmpMgr.EngineV2,
          SnmpKit.SnmpMgr.Router,
          SnmpKit.SnmpMgr.CircuitBreaker,
          SnmpKit.SnmpMgr.Metrics,
          SnmpKit.SnmpMgr.SocketManager,
          SnmpKit.SnmpMgr.RequestIdGenerator,
          SnmpKit.SnmpMgr.Supervisor,
          SnmpKit.SnmpLib.Pool,
          SnmpKit.SnmpLib.Cache,
          SnmpKit.SnmpLib.Monitor,
          SnmpKit.SnmpLib.Dashboard,
          SnmpKit.SnmpLib.Config
        ],
        "Device Simulation": [
          SnmpKit.SnmpSim,
          SnmpKit.SnmpSim.Device,
          SnmpKit.SnmpSim.ProfileLoader,
          SnmpKit.SnmpSim.WalkParser,
          SnmpKit.SnmpSim.Config,
          SnmpKit.SnmpSim.SafeFile,
          SnmpKit.SnmpSim.OIDTree,
          SnmpKit.SnmpSim.ValueSimulator,
          SnmpKit.SnmpSim.TimePatterns,
          SnmpKit.SnmpSim.MIB.SharedProfiles,
          SnmpKit.SnmpSim.MIB.BehaviorAnalyzer,
          SnmpKit.SnmpSim.Core.Server,
          SnmpKit.SnmpSim.Device.OidHandler,
          SnmpKit.SnmpSim.Device.PduProcessor,
          SnmpKit.SnmpSim.Device.WalkPduProcessor,
          SnmpKit.SnmpSim.Device.ModemUpgrade,
          SnmpKit.SnmpSim.ErrorInjector,
          SnmpKit.SnmpSim.LazyDevicePool,
          SnmpKit.SnmpSim.DeviceDistribution,
          SnmpKit.SnmpSim.CorrelationEngine
        ],
        "Testing Support": [
          SnmpKit.TestSupport
        ]
      ]
    ]
  end

  defp dialyzer do
    [
      plt_file: {:no_warn, "priv/plts/dialyzer.plt"},
      plt_add_apps: [:mix, :ex_unit],
      ignore_warnings: ".dialyzer_ignore.exs",
      flags: [
        :error_handling,
        :underspecs,
        :unknown
      ]
    ]
  end
end