From 709b605888c85b32d1ec68df794810b5a85e2e18 Mon Sep 17 00:00:00 2001
From: Alexander Goussas <goussasalexander@gmail.com>
Date: Mon, 26 Jan 2026 22:02:20 -0500
Subject: [PATCH] add DNS server structure

---
 .formatter.exs                 |  4 ++++
 .gitignore                     | 26 ++++++++++++++++++++++++++
 README.md                      | 21 +++++++++++++++++++++
 lib/dns_phrases.ex             | 18 ++++++++++++++++++
 lib/dns_phrases/application.ex | 20 ++++++++++++++++++++
 lib/dns_phrases/server.ex      | 29 +++++++++++++++++++++++++++++
 mix.exs                        | 29 +++++++++++++++++++++++++++++
 test/dns_phrases_test.exs      |  8 ++++++++
 test/test_helper.exs           |  1 +
 9 files changed, 156 insertions(+)
 create mode 100644 .formatter.exs
 create mode 100644 .gitignore
 create mode 100644 README.md
 create mode 100644 lib/dns_phrases.ex
 create mode 100644 lib/dns_phrases/application.ex
 create mode 100644 lib/dns_phrases/server.ex
 create mode 100644 mix.exs
 create mode 100644 test/dns_phrases_test.exs
 create mode 100644 test/test_helper.exs

diff --git a/.formatter.exs b/.formatter.exs
new file mode 100644
index 0000000..d2cda26
--- /dev/null
+++ b/.formatter.exs
@@ -0,0 +1,4 @@
+# Used by "mix format"
+[
+  inputs: ["{mix,.formatter}.exs", "{config,lib,test}/**/*.{ex,exs}"]
+]
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..9c04694
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,26 @@
+# The directory Mix will write compiled artifacts to.
+/_build/
+
+# If you run "mix test --cover", coverage assets end up here.
+/cover/
+
+# The directory Mix downloads your dependencies sources to.
+/deps/
+
+# Where third-party dependencies like ExDoc output generated docs.
+/doc/
+
+# Ignore .fetch files in case you like to edit your project deps locally.
+/.fetch
+
+# If the VM crashes, it generates a dump, let's ignore it too.
+erl_crash.dump
+
+# Also ignore archive artifacts (built via "mix archive.build").
+*.ez
+
+# Ignore package tarball (built via "mix hex.build").
+dns_phrases-*.tar
+
+# Temporary files, for example, from tests.
+/tmp/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..11826dc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# DnsPhrases
+
+**TODO: Add description**
+
+## Installation
+
+If [available in Hex](https://hex.pm/docs/publish), the package can be installed
+by adding `dns_phrases` to your list of dependencies in `mix.exs`:
+
+```elixir
+def deps do
+  [
+    {:dns_phrases, "~> 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/dns_phrases>.
+
diff --git a/lib/dns_phrases.ex b/lib/dns_phrases.ex
new file mode 100644
index 0000000..7d7be50
--- /dev/null
+++ b/lib/dns_phrases.ex
@@ -0,0 +1,18 @@
+defmodule DnsPhrases do
+  @moduledoc """
+  Documentation for `DnsPhrases`.
+  """
+
+  @doc """
+  Hello world.
+
+  ## Examples
+
+      iex> DnsPhrases.hello()
+      :world
+
+  """
+  def hello do
+    :world
+  end
+end
diff --git a/lib/dns_phrases/application.ex b/lib/dns_phrases/application.ex
new file mode 100644
index 0000000..75d94fd
--- /dev/null
+++ b/lib/dns_phrases/application.ex
@@ -0,0 +1,20 @@
+defmodule DnsPhrases.Application do
+  # See https://hexdocs.pm/elixir/Application.html
+  # for more information on OTP Applications
+  @moduledoc false
+
+  use Application
+
+  @impl true
+  def start(_type, _args) do
+    children = [
+      # TODO: Fetch the port from command line
+      {DnsPhrases.Server, [listen_port: 3069]}
+    ]
+
+    # See https://hexdocs.pm/elixir/Supervisor.html
+    # for other strategies and supported options
+    opts = [strategy: :one_for_one, name: DnsPhrases.Supervisor]
+    Supervisor.start_link(children, opts)
+  end
+end
diff --git a/lib/dns_phrases/server.ex b/lib/dns_phrases/server.ex
new file mode 100644
index 0000000..d022ca0
--- /dev/null
+++ b/lib/dns_phrases/server.ex
@@ -0,0 +1,29 @@
+defmodule DnsPhrases.Server do
+  use GenServer
+
+  defmodule State do
+    defstruct([:socket])
+  end
+
+  def start_link(opts) do
+    listen_port = Keyword.fetch!(opts, :listen_port)
+    GenServer.start_link(__MODULE__, listen_port, opts)
+  end
+
+  @impl GenServer
+  def init(listen_port) do
+    {:ok, socket} = :gen_udp.open(listen_port, mode: :binary, active: true)
+    {:ok, %State{socket: socket}}
+  end
+
+  @impl GenServer
+  def handle_info(
+        {:udp, socket, _ip, _port, data},
+        %State{socket: socket} = state
+      ) do
+    # TODO 1: Fetch random phrase
+    # TODO 2: Assemble DNS response as a TXT record containing the frame
+    # TODO 3: Reply to our client
+    {:noreply, state}
+  end
+end
diff --git a/mix.exs b/mix.exs
new file mode 100644
index 0000000..d7c6c26
--- /dev/null
+++ b/mix.exs
@@ -0,0 +1,29 @@
+defmodule DnsPhrases.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :dns_phrases,
+      version: "0.1.0",
+      elixir: "~> 1.17",
+      start_permanent: Mix.env() == :prod,
+      deps: deps()
+    ]
+  end
+
+  # Run "mix help compile.app" to learn about applications.
+  def application do
+    [
+      extra_applications: [:logger],
+      mod: {DnsPhrases.Application, []}
+    ]
+  end
+
+  # Run "mix help deps" to learn about dependencies.
+  defp deps do
+    [
+      # {:dep_from_hexpm, "~> 0.3.0"},
+      # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
+    ]
+  end
+end
diff --git a/test/dns_phrases_test.exs b/test/dns_phrases_test.exs
new file mode 100644
index 0000000..e550341
--- /dev/null
+++ b/test/dns_phrases_test.exs
@@ -0,0 +1,8 @@
+defmodule DnsPhrasesTest do
+  use ExUnit.Case
+  doctest DnsPhrases
+
+  test "greets the world" do
+    assert DnsPhrases.hello() == :world
+  end
+end
diff --git a/test/test_helper.exs b/test/test_helper.exs
new file mode 100644
index 0000000..869559e
--- /dev/null
+++ b/test/test_helper.exs
@@ -0,0 +1 @@
+ExUnit.start()
-- 
2.43.0