cripsy-binary-api 0.3.1__tar.gz

cripsy_binary_api-0.3.1/.env.example

@@ -0,0 +1,16 @@
+# Credenciales de IQ Option (cuenta demo).
+# Copiar a .env y completar. NUNCA commitear .env.
+
+IQOPTION_EMAIL = "tu-correo@ejemplo.com"
+IQOPTION_PASSWORD = "tu-contrasena"
+
+# --- Deriv (API moderna, segunda integración) ---
+# Sin estas claves la API funciona en modo público y gratuito: catálogo,
+# velas, ticks y cotización de payout.
+# Para operar hacen falta credenciales propias: PAT con scope `trade`
+# (o access token OAuth). `DERIV_APPID` solo es obligatorio con PAT.
+DERIV_TOKEN=
+DERIV_APPID=
+# Opcional: cuenta concreta (demo DOT…/VRTC…, real CR…). Si falta, se elige la
+# primera del tipo indicado en `DerivConfig.account`.
+DERIV_ACCOUNT_ID=

cripsy_binary_api-0.3.1/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  calidad:
+    name: Calidad (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - name: Formato
+        run: cargo fmt --check
+      - name: Clippy sin warnings
+        run: cargo clippy --all-targets -- -D warnings
+      - name: Tests
+        run: cargo test
+      - name: Build variante blocking
+        run: cargo build --no-default-features --features blocking
+
+  documentacion:
+    name: Documentacion navegable
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Generar HTML
+        run: cargo run --quiet --example build_docs -- --lang es --out docs/site
+      - uses: actions/upload-artifact@v4
+        with:
+          name: docs-site
+          path: docs/site

cripsy_binary_api-0.3.1/.github/workflows/wheels.yml

@@ -0,0 +1,111 @@
+name: Python wheels
+
+on:
+  workflow_dispatch:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  linux:
+    name: Wheel (${{ matrix.plataforma }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            plataforma: linux-x64
+            imagen: quay.io/pypa/manylinux2014_x86_64:latest
+          - os: ubuntu-24.04-arm
+            plataforma: linux-arm64
+            imagen: quay.io/pypa/manylinux2014_aarch64:latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Construir manylinux2014
+        run: |
+          docker run --rm -v "$PWD:/io" -w /io \
+            ${{ matrix.imagen }} \
+            bash -c '
+              set -euo pipefail
+              curl --proto "=https" --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal
+              . "$HOME/.cargo/env"
+              /opt/python/cp310-cp310/bin/python -m pip install --upgrade pip "maturin==1.16.0"
+              /opt/python/cp310-cp310/bin/python -m maturin build --release --out /io/dist --compatibility manylinux2014 --manifest-path /io/python/Cargo.toml
+            '
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.plataforma }}
+          path: dist/*.whl
+
+  wheels:
+    name: Wheel (${{ matrix.plataforma }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            plataforma: windows-x64
+          - os: windows-11-arm
+            plataforma: windows-arm64
+          - os: macos-15-intel
+            plataforma: macos-intel
+          - os: macos-latest
+            plataforma: macos-arm64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          args: --release --out dist --compatibility pypi --manifest-path python/Cargo.toml
+          manylinux: auto
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.plataforma }}
+          path: dist/*.whl
+
+  sdist:
+    name: Sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist --manifest-path python/Cargo.toml
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  release:
+    name: Adjuntar al release
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [wheels, linux, sdist]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+
+  # Publicacion en PyPI: pendiente de configurar el secreto PYPI_API_TOKEN.
+  # Cuando exista, descomentar este job (o usar trusted publishing con OIDC).
+  #
+  # publish:
+  #   name: Publicar en PyPI
+  #   if: startsWith(github.ref, 'refs/tags/')
+  #   needs: [wheels, linux, sdist]
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/download-artifact@v4
+  #       with: { path: dist, merge-multiple: true }
+  #     - uses: PyO3/maturin-action@v1
+  #       with: { command: upload, args: "--skip-existing dist/*" }
+  #       env:
+  #         MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

cripsy_binary_api-0.3.1/.gitignore

@@ -0,0 +1,22 @@
+# Rust
+/target
+
+# Secretos: NUNCA al repositorio
+.env
+.env.*
+!.env.example
+
+# Documentación navegable generada (scriptsuild_docs.ps1)
+/docs/site
+
+# Volcados de datos y capturas locales
+*.ndjson
+/data
+
+# Editores
+.idea
+.vscode
+python/dist/
+__pycache__/
+*.egg-info/
+python/target/

cripsy_binary_api-0.3.1/CHANGELOG.md

@@ -0,0 +1,162 @@
+# Historial de cambios
+
+Formato basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
+y versionado semántico.
+
+## [0.3.1] - 2026-11-09
+
+### Añadido
+
+- `Broker::iqoption_extras` como acceso opcional y compatible a las capacidades
+  exclusivas de IQ Option desde un `Box<dyn Broker>`; los adaptadores que no las
+  ofrecen devuelven `None`.
+- Binding Python: `buy_digital`, `buy_blitz` e `indicators`, con rechazo
+  explícito en Deriv en lugar de simular esas capacidades.
+- Wheels para Linux x64/arm64, Windows x64/arm64 y macOS Intel/arm64, además del
+  sdist.
+- Publicación en PyPI del paquete Python 0.3.1.
+
+### Cambiado
+
+- Documentación separada por bróker: `docs/iqoption/` y `docs/deriv/`, con
+  subcarpetas de cuenta, mercado, órdenes y operativa; Python y herramientas
+  tienen su propia carpeta.
+- Scripts globales en `scripts/` y verificadores/cargadores por bróker en
+  `scripts/iqoption/` y `scripts/deriv/`.
+- Assets fuera de `docs/`: el banner y el QR viven en `img/`.
+- El generador de documentación agrupa por bróker y ordena la navegación.
+
+### Corregido
+
+- La documentación de Deriv ya no afirma que el payout se consulte por importe:
+  `get_payout` usa activo y duración.
+- Enlaces y rutas de scripts actualizados tras la reorganización.
+
+## [0.3.0] - 2026-11-09
+
+### Añadido
+
+- Adaptador **Deriv** (API moderna): conexión OTP por REST, gateway público sin
+  credenciales, catálogo, velas, cotización de payout, compra y venta rise/fall,
+  cierre por `proposal_open_contract`, historial paginado y reconexión con OTP
+  nuevo más replay de suscripciones.
+- `Broker::subscribe_ticks` con entrega por `Event::PriceTick`; Deriv implementa
+  el stream nativo y el resto de adaptadores hereda un rechazo explícito.
+- `DerivConfig` con `Debug` redactado y sin serializar el token; límites de tasa
+  por clase al 80 % de lo documentado por el bróker.
+- `BrokerError` conserva su taxonomía; las capacidades no soportadas responden
+  con el mensaje del bróker o con el rechazo por defecto.
+
+### Cambiado (incompatible)
+
+- Las capacidades exclusivas de IQ Option (`buy_blitz`, `buy_digital_spot`,
+  indicadores técnicos, perfil de activo, live deals y comisiones) salen de
+  `Broker` y pasan a `IqOptionExtras`. En `IqOptionBroker` siguen disponibles
+  como métodos inherentes, por lo que el código que usa el tipo concreto no
+  cambia; quien las invocaba sobre `Box<dyn Broker>` debe usar
+  `Box<dyn IqOptionExtras>` o el tipo concreto.
+- Migración: `use cripsy_binary_api::broker::IqOptionExtras;` solo si se consume
+  el trait de forma genérica.
+
+### Documentado
+
+- Alcance del producto: operación rise/fall, datos para cualquier activo y
+  densidad de ticks nativa como diferencial; expansión futura fuera de alcance.
+- `docs/deriv/01_introduccion.es.md`: uso de Deriv, credenciales, límites y
+  diferencias con IQ Option.
+- Tabla de densidad medida por clase de activo y separación de los scripts de
+  verificación (`verificar_iqoption.ps1`, `verificar_deriv.ps1`,
+  `verificar_todo.ps1`).
+- Reconciliación de Deriv verificada en vivo: un cierre ocurrido durante 72 s
+  sin conexión se publica una sola vez, sin reenviar la orden.
+
+
+## [0.2.1] - 2026-11-09
+
+### Añadido
+
+- Prueba del recorrido multi-página de la reconciliación con historiales
+  simulados: encuentra cierres en páginas posteriores, corta al localizarlos y
+  respeta el límite de diez páginas.
+
+### Corregido
+
+- Cifras de verificación de la documentación embebida: la medición final de la
+  caída forzada es 4.938 ms sin conexión, con 34 comprobaciones y 0 fallos.
+
+## [0.2.0] - 2026-11-09
+
+### Añadido
+
+- Reconexión automática de la sesión: tras una caída del WebSocket la tarea
+  del socket reautentica, restaura perfil, balances y catálogo, y reproduce
+  las suscripciones antes de volver a despachar. Backoff exponencial con
+  saturación; un rechazo de credenciales no se reintenta.
+- `Event::Disconnected { motivo }` y `Event::Reconnected { intentos,
+  downtime_ms }` para que el consumidor distinga una caída de un cierre.
+- Registro de suscripciones (velas, live-deals, comisiones, price-splitter y
+  cierres de posición) que se usa como fuente del replay.
+- `BrokerError::NotConnected`: las llamadas fallan de inmediato mientras no
+  haya socket, en vez de encolarse para ejecutarse con datos obsoletos.
+- `TransportConfig::cola_salida` (256 por defecto): capacidad de la cola de
+  salida del socket.
+- Reconciliación al reconectar: las órdenes abiertas cuyo cierre ocurrió sin
+  conexión se recuperan del historial de posiciones (paginado, hasta 10 páginas
+  de 100) y se publican como `Event::OrderClosed`, sin reenviar nada al bróker.
+- `IqOptionBroker::simular_caida_de_conexion` (marcado `#[doc(hidden)]`) para
+  ejercitar la recuperación en pruebas de resiliencia.
+- La verificación viva incluye una caída forzada del socket con comprobación de
+  `Disconnected`, `Reconnected`, operativa posterior y replay de suscripciones.
+- `docs/iqoption/04_operativa/02_reconexion.es.md` con el diseño y los límites del
+  supervisor de sesión, más la sección de continuidad del README.
+- `Broker::buy_blitz` con `BuyBlitzRequest`: la duración viaja en segundos y el
+  payout se puede indicar de forma explícita. `buy_binary` deja de transportar
+  segundos en `expiration_minutes` y delega el blitz en la nueva petición.
+- `AccountType::Unknown` para los tipos de balance que el adaptador no reconoce.
+- `Event::EventsLost { count }`: informa de la pérdida de continuidad del bus de
+  eventos sin cerrar el stream.
+- Reintentos con backoff en el handshake del WebSocket.
+- Documento de limitaciones conocidas en `docs/01_introduccion.es.md` y en el
+  README.
+
+### Corregido
+
+- `switch_account` propaga el error del refresco de balances y comprueba que el
+  balance solicitado quede activo antes de actualizar la sesión; ya no devuelve
+  `Ok(())` cuando el bróker no confirmó el cambio.
+- Un tipo de balance desconocido se mapea a `AccountType::Unknown` en lugar de
+  interpretarse como cuenta real.
+- `get_account_type` devuelve error si la sesión no está inicializada, en vez de
+  asumir cuenta de práctica.
+- El router retira las solicitudes que expiran y no registra receptores para los
+  mensajes que no esperan respuesta (suscripciones).
+- Al cerrarse el socket se descartan las solicitudes pendientes, de modo que
+  ninguna espera queda colgada hasta su timeout.
+- Las suscripciones a velas cuyos streams fueron soltados se retiran en el
+  siguiente despacho de velas.
+- Documentación corregida: `get_operation_result` lee la caché local (no hace
+  consulta remota), `get_payout` devuelve el payout del catálogo y la densidad
+  de ticks se describe con la medición real, sin afirmar ausencia de límite.
+
+### Cambiado (incompatible)
+
+- `Event` pasa a ser `#[non_exhaustive]` e incorpora variantes nuevas: los
+  `match` exhaustivos sobre `Event` deben añadir un brazo `_`.
+- La cola de salida del socket deja de ser ilimitada; una ráfaga superior a
+  `TransportConfig::cola_salida` aplica presión al productor.
+- Migración: sustituir los `match` exhaustivos sobre `Event` y, si se construye
+  `TransportConfig` con literal de struct, añadir `cola_salida`.
+
+## [0.1.0] - 2026-11-08
+
+### Añadido
+
+- Cliente Rust para la API de IQ Option con núcleo `async` y fachada `blocking`.
+- Trait `Broker` multibróker y dominio tipado.
+- Sesión, perfil, balances y cambio de cuenta.
+- Catálogo de activos con metadatos operativos.
+- Velas históricas, descarga paginada, stream multi-tamaño y ticks nativos.
+- Órdenes clásicas (turbo/binary), digitales v2, blitz v2 y venta anticipada.
+- Resultados por evento con caché, historial de posiciones, perfil del activo,
+  comisiones y live-deals.
+- Ejemplos ejecutables, scripts de verificación y documentación navegable.