refactor!: introduce opinionated api

.formatter.exs

@@ -1,4 +1,5 @@
 # Used by "mix format"
 [
+  import_deps: [:ecto],
   inputs: ["{mix,.formatter}.exs", "{config,lib,test,examples}/**/*.{ex,exs}"]
 ]

.gitignore

@@ -13,4 +13,6 @@ erl_crash.dump
 hex.config
 *.ez
 uof_messages-*.tar
-*~
+*~
+\#*
+.\#*

README.md

@@ -14,8 +14,7 @@
 Elixir client for Betradar's Unified Odds Feed (UOF) HTTP API.
 
 This project implements Betradar's Custom Bet, Probability, Recovery and Sports
-APIs, which can be found in the `UOF.API.{CustomBet, Probability, Recovery,
-Sports}` modules, respectively.
+APIs.
 
 
 ## Get Started
@@ -36,7 +35,7 @@ to use.
 Fetch all available fixtures.
 
 ```elixir
-fixtures = UOF.API.Sports.fixtures
+{:ok, fixtures} = UOF.API.Fixtures.all()
 ```
 
 Given a list fixtures, count how many of them there are.

config/test.exs

@@ -0,0 +1,5 @@
+import Config
+
+config :uof_api,
+  base_url: "https://localhost",
+  auth_token: "a-secret-goes-here"

lib/uof/api.ex

@@ -0,0 +1,125 @@
+defmodule UOF.API do
+  @moduledoc """
+  Utilities used by the different APIs implemented by this client.
+  """
+  use Tesla, only: [:get, :post], docs: false
+
+  plug(Tesla.Middleware.BaseUrl, Application.get_env(:uof_api, :base_url))
+
+  plug(Tesla.Middleware.Headers, [
+    {"accept", "application/xml"},
+    {"content-type", "application/xml"},
+    {"x-access-token", Application.get_env(:uof_api, :auth_token)}
+  ])
+
+  # plug(Tesla.Middleware.XML, convention: BadgerFish)
+  plug(Tesla.Middleware.XML, engine: Saxy)
+
+  # https://docs.betradar.com/display/BD/UOF+-+Language+Support
+  @supported_languages [
+    # Albanian
+    "sqi",
+    # Amharic
+    "am",
+    # Arabic
+    "aa",
+    # Azerbaijan
+    "aze",
+    # Bosnian
+    "bs",
+    # Brazilian Portuguese
+    "br",
+    # Bulgarian
+    "bg",
+    # Burmese
+    "my",
+    # Chinese (simplified)
+    "zh",
+    # Chinese (traditional)
+    "zht",
+    # Croation
+    "hr",
+    # Czech
+    "cs",
+    # Danish
+    "da",
+    # Dutch
+    "nl",
+    # English
+    "en",
+    # Estonian
+    "et",
+    # Finnish
+    "fi",
+    # French
+    "fr",
+    # Georgian
+    "ka",
+    # German
+    "de",
+    # Greek
+    "el",
+    # Hebrew
+    "heb",
+    # Hindi
+    "hi",
+    # Hungarian
+    "hu",
+    # Indonesian
+    "Id",
+    # Italian
+    "it",
+    # Japanese
+    "ja",
+    # Kazakh
+    "kaz",
+    # Khmer
+    "km",
+    # Korean
+    "ko",
+    # Latvian
+    "lv",
+    # Lithuanian
+    "lt",
+    # Macedonian
+    "ml",
+    # Macedonian Cyrillic
+    "mk",
+    # Malay
+    "ms",
+    # Norwegian
+    "no",
+    # Persian/Farsi
+    "fa",
+    # Polish
+    "pl",
+    # Portuguese
+    "pt",
+    # Romanian
+    "ro",
+    # Russian
+    "ru",
+    # Serbian
+    "sr",
+    # Serbian Latin
+    "srl",
+    # Slovak
+    "sk",
+    # Slovenian
+    "sl",
+    # Spanish
+    "es",
+    # Swahili
+    "sw",
+    # Swedish
+    "se",
+    # Thai
+    "th",
+    # Turkish
+    "tr",
+    # Ukrainian
+    "ukr",
+    # Vietnamese
+    "vi"
+  ]
+end

lib/uof/api/competitors.ex

@@ -0,0 +1,21 @@
+defmodule UOF.API.Competitors do
+  use Ecto.Schema
+  import Ecto.Changeset
+  import UOF.API.EctoHelpers
+
+  def show(id, lang \\ "en") do
+    case UOF.API.get("/sports/#{lang}/competitors/#{id}/profile.xml") do
+      {:ok, %_{status: 200, body: resp}} ->
+        resp
+        |> UOF.API.Utils.xml_to_map()
+        |> Map.get("competitor_profile")
+        |> bubble_up("jerseys", "jersey")
+        |> bubble_up("players", "player")
+        |> UOF.API.Competitors.CompetitorProfile.changeset()
+        |> apply
+
+      {:error, _} = error ->
+        error
+    end
+  end
+end

lib/uof/api/competitors/competitor.ex

@@ -0,0 +1,41 @@
+defmodule UOF.API.Competitors.Competitor do
+  @moduledoc false
+  use Ecto.Schema
+  import Ecto.Changeset
+
+  @primary_key false
+
+  embedded_schema do
+    field :id
+    field :name
+    field :state
+    field :country
+    field :country_code
+    field :abbreviation
+    field :qualifier
+    field :virtual
+    field :gender
+    field :short_name
+    embeds_one :sport, UOF.API.Sports.Sport
+    embeds_one :category, UOF.API.Sports.Category
+    # embeds_many, :reference_id
+  end
+
+  def changeset(model \\ %__MODULE__{}, params) do
+    model
+    |> cast(params, [
+      :id,
+      :name,
+      :state,
+      :country,
+      :country_code,
+      :abbreviation,
+      :qualifier,
+      :virtual,
+      :gender,
+      :short_name
+    ])
+    |> cast_embed(:sport)
+    |> cast_embed(:category)
+  end
+end

lib/uof/api/competitors/competitor_profile.ex

@@ -0,0 +1,25 @@
+defmodule UOF.API.Competitors.CompetitorProfile do
+  @moduledoc false
+  use Ecto.Schema
+  import Ecto.Changeset
+
+  @primary_key false
+
+  embedded_schema do
+    embeds_one :competitor, UOF.API.Competitors.Competitor
+    embeds_one :manager, UOF.API.Competitors.Manager
+    embeds_one :venue, UOF.API.Venues.Venue
+    embeds_many :jerseys, UOF.API.Competitors.Jersey
+    embeds_many :players, UOF.API.Players.Player
+  end
+
+  def changeset(model \\ %__MODULE__{}, params) do
+    model
+    |> cast(params, [])
+    |> cast_embed(:competitor)
+    |> cast_embed(:manager)
+    |> cast_embed(:venue)
+    |> cast_embed(:jerseys)
+    |> cast_embed(:players)
+  end
+end

lib/uof/api/competitors/jersey.ex

@@ -0,0 +1,34 @@
+defmodule UOF.API.Competitors.Jersey do
+  @moduledoc false
+  use Ecto.Schema
+  import Ecto.Changeset
+
+  @primary_key false
+
+  embedded_schema do
+    field :type
+    field :base
+    field :sleeve
+    field :number
+    field :stripes, :boolean
+    field :horizontal_stripes, :boolean
+    field :squares, :boolean
+    field :split, :boolean
+    field :shirt_type
+  end
+
+  def changeset(model \\ %__MODULE__{}, params) do
+    model
+    |> cast(params, [
+      :type,
+      :base,
+      :sleeve,
+      :number,
+      :stripes,
+      :horizontal_stripes,
+      :squares,
+      :split,
+      :shirt_type
+    ])
+  end
+end

lib/uof/api/competitors/manager.ex

@@ -0,0 +1,24 @@
+defmodule UOF.API.Competitors.Manager do
+  @moduledoc false
+  use Ecto.Schema
+  import Ecto.Changeset
+
+  @primary_key false
+
+  embedded_schema do
+    field :id
+    field :name
+    field :country_code
+    field :nationality
+  end
+
+  def changeset(model \\ %__MODULE__{}, params) do
+    model
+    |> cast(params, [
+      :id,
+      :name,
+      :country_code,
+      :nationality
+    ])
+  end
+end