site: rebuild manual de la web [2026-04-24 16:53]

Author: TFariasMath

apps/web_sensor/.formatter.exs

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

apps/web_sensor/.gitignore

@@ -0,0 +1,24 @@
+# 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/
+
+# Temporary files, for example, from tests.
+/tmp/
+
+# 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").
+web_sensor-*.tar
+

apps/web_sensor/README.md

@@ -0,0 +1,21 @@
+# WebSensor
+
+**TODO: Add description**
+
+## Installation
+
+If [available in Hex](https://hex.pm/docs/publish), the package can be installed
+by adding `web_sensor` to your list of dependencies in `mix.exs`:
+
+```elixir
+def deps do
+  [
+    {:web_sensor, "~> 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/web_sensor>.
+

apps/web_sensor/lib/sensor_web.ex

@@ -0,0 +1,58 @@
+defmodule SensorWeb do
+  @moduledoc """
+  Componente de percepción digital. Transforma datos del entorno
+  web (APIs, HTML) en perceptos estructurados para un agente.
+  """
+
+  @doc """
+  Obtiene el precio actual de Bitcoin desde la API pública de CoinGecko.
+  Retorna un mapa con el percepto estructurado.
+  """
+  def precio_bitcoin do
+    url = "https://api.coingecko.com/api/v3/simple/price" <>
+          "?ids=bitcoin&vs_currencies=usd&include_24hr_change=true"
+
+    case Req.get(url) do
+      {:ok, %{status: 200, body: body}} ->
+        btc = body["bitcoin"]
+        {:ok, %{
+          asset: "bitcoin",
+          precio_usd: btc["usd"],
+          cambio_24h: Float.round((btc["usd_24h_change"] || 0.0) * 1.0, 2),
+          timestamp: DateTime.utc_now()
+        }}
+
+      {:ok, %{status: status}} ->
+        {:error, "HTTP #{status}"}
+
+      {:error, exception} ->
+        {:error, Exception.message(exception)}
+    end
+  end
+
+  @doc """
+  Sensor genérico: extrae texto de una página web usando un selector CSS.
+  """
+  def scrape_texto(url, selector) do
+    case Req.get(url) do
+      {:ok, %{status: 200, body: html}} when is_binary(html) ->
+        texto =
+          html
+          |> Floki.parse_document!()
+          |> Floki.find(selector)
+          |> Floki.text()
+          |> String.trim()
+
+        {:ok, texto}
+
+      {:ok, %{status: _status, body: body}} when is_map(body) ->
+        {:ok, inspect(body)}
+
+      {:ok, %{status: status}} ->
+        {:error, "HTTP #{status}"}
+
+      {:error, exception} ->
+        {:error, Exception.message(exception)}
+    end
+  end
+end

apps/web_sensor/lib/web_sensor.ex

@@ -0,0 +1,18 @@
+defmodule WebSensor do
+  @moduledoc """
+  Documentation for `WebSensor`.
+  """
+
+  @doc """
+  Hello world.
+
+  ## Examples
+
+      iex> WebSensor.hello()
+      :world
+
+  """
+  def hello do
+    :world
+  end
+end

apps/web_sensor/mix.exs

@@ -0,0 +1,24 @@
+defmodule WebSensor.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :web_sensor,
+      version: "0.1.0",
+      elixir: "~> 1.18",
+      start_permanent: Mix.env() == :prod,
+      deps: deps()
+    ]
+  end
+
+  def application do
+    [extra_applications: [:logger]]
+  end
+
+  defp deps do
+    [
+      {:req, "~> 0.5.0"},
+      {:floki, "~> 0.37.0"}
+    ]
+  end
+end

apps/web_sensor/mix.lock

@@ -0,0 +1,12 @@
+%{
+  "finch": {:hex, :finch, "0.21.0", "b1c3b2d48af02d0c66d2a9ebfb5622be5c5ecd62937cf79a88a7f98d48a8290c", [:mix], [{:mime, "~> 1.0 or ~> 2.0", [hex: :mime, repo: "hexpm", optional: false]}, {:mint, "~> 1.6.2 or ~> 1.7", [hex: :mint, repo: "hexpm", optional: false]}, {:nimble_options, "~> 0.4 or ~> 1.0", [hex: :nimble_options, repo: "hexpm", optional: false]}, {:nimble_pool, "~> 1.1", [hex: :nimble_pool, repo: "hexpm", optional: false]}, {:telemetry, "~> 0.4 or ~> 1.0", [hex: :telemetry, repo: "hexpm", optional: false]}], "hexpm", "87dc6e169794cb2570f75841a19da99cfde834249568f2a5b121b809588a4377"},
+  "floki": {:hex, :floki, "0.37.1", "d7aaee758c8a5b4a7495799a4260754fec5530d95b9c383c03b27359dea117cf", [:mix], [], "hexpm", "673d040cb594d31318d514590246b6dd587ed341d3b67e17c1c0eb8ce7ca6f04"},
+  "hpax": {:hex, :hpax, "1.0.3", "ed67ef51ad4df91e75cc6a1494f851850c0bd98ebc0be6e81b026e765ee535aa", [:mix], [], "hexpm", "8eab6e1cfa8d5918c2ce4ba43588e894af35dbd8e91e6e55c817bca5847df34a"},
+  "jason": {:hex, :jason, "1.4.4", "b9226785a9aa77b6857ca22832cffa5d5011a667207eb2a0ad56adb5db443b8a", [:mix], [{:decimal, "~> 1.0 or ~> 2.0", [hex: :decimal, repo: "hexpm", optional: true]}], "hexpm", "c5eb0cab91f094599f94d55bc63409236a8ec69a21a67814529e8d5f6cc90b3b"},
+  "mime": {:hex, :mime, "2.0.7", "b8d739037be7cd402aee1ba0306edfdef982687ee7e9859bee6198c1e7e2f128", [:mix], [], "hexpm", "6171188e399ee16023ffc5b76ce445eb6d9672e2e241d2df6050f3c771e80ccd"},
+  "mint": {:hex, :mint, "1.7.1", "113fdb2b2f3b59e47c7955971854641c61f378549d73e829e1768de90fc1abf1", [:mix], [{:castore, "~> 0.1.0 or ~> 1.0", [hex: :castore, repo: "hexpm", optional: true]}, {:hpax, "~> 0.1.1 or ~> 0.2.0 or ~> 1.0", [hex: :hpax, repo: "hexpm", optional: false]}], "hexpm", "fceba0a4d0f24301ddee3024ae116df1c3f4bb7a563a731f45fdfeb9d39a231b"},
+  "nimble_options": {:hex, :nimble_options, "1.1.1", "e3a492d54d85fc3fd7c5baf411d9d2852922f66e69476317787a7b2bb000a61b", [:mix], [], "hexpm", "821b2470ca9442c4b6984882fe9bb0389371b8ddec4d45a9504f00a66f650b44"},
+  "nimble_pool": {:hex, :nimble_pool, "1.1.0", "bf9c29fbdcba3564a8b800d1eeb5a3c58f36e1e11d7b7fb2e084a643f645f06b", [:mix], [], "hexpm", "af2e4e6b34197db81f7aad230c1118eac993acc0dae6bc83bac0126d4ae0813a"},
+  "req": {:hex, :req, "0.5.17", "0096ddd5b0ed6f576a03dde4b158a0c727215b15d2795e59e0916c6971066ede", [:mix], [{:brotli, "~> 0.3.1", [hex: :brotli, repo: "hexpm", optional: true]}, {:ezstd, "~> 1.0", [hex: :ezstd, repo: "hexpm", optional: true]}, {:finch, "~> 0.17", [hex: :finch, repo: "hexpm", optional: false]}, {:jason, "~> 1.0", [hex: :jason, repo: "hexpm", optional: false]}, {:mime, "~> 2.0.6 or ~> 2.1", [hex: :mime, repo: "hexpm", optional: false]}, {:nimble_csv, "~> 1.0", [hex: :nimble_csv, repo: "hexpm", optional: true]}, {:plug, "~> 1.0", [hex: :plug, repo: "hexpm", optional: true]}], "hexpm", "0b8bc6ffdfebbc07968e59d3ff96d52f2202d0536f10fef4dc11dc02a2a43e39"},
+  "telemetry": {:hex, :telemetry, "1.4.1", "ab6de178e2b29b58e8256b92b382ea3f590a47152ca3651ea857a6cae05ac423", [:rebar3], [], "hexpm", "2172e05a27531d3d31dd9782841065c50dd5c3c7699d95266b2edd54c2dafa1c"},
+}

apps/web_sensor/test/test_helper.exs

@@ -0,0 +1 @@
+ExUnit.start()

apps/web_sensor/test/web_sensor_test.exs

@@ -0,0 +1,8 @@
+defmodule WebSensorTest do
+  use ExUnit.Case
+  doctest WebSensor
+
+  test "greets the world" do
+    assert WebSensor.hello() == :world
+  end
+end

apps/web_sensor/test_sensor.exs

@@ -0,0 +1,9 @@
+IO.puts "--- Probando Sensor Web (Bitcoin) ---"
+case SensorWeb.precio_bitcoin() do
+  {:ok, percepto} ->
+    IO.puts "✅ ÉXITO"
+    IO.inspect(percepto)
+  {:error, razon} ->
+    IO.puts "❌ ERROR"
+    IO.puts "Razón: #{inspect(razon)}"
+end