brvm 0.1.0__tar.gz

brvm-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: brvm
+Version: 0.1.0
+Summary: Bibliothèque Python open-source pour scraper et analyser les données de la BRVM
+Author-email: Naofal <votre.email@example.com>
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: html5lib>=1.1
+Requires-Dist: pydantic>=2.4.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: pdfplumber>=0.11.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+
+# BRVM Python Package 📈��
+
+[![Python Versions](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+Une bibliothèque Python open-source robuste pour scraper et analyser les données de la **Bourse Régionale des Valeurs Mobilières (BRVM)**.  
+Conçue pour les analystes financiers, les développeurs et les data scientists, elle s'inspire du format `yfinance` en renvoyant directement des objets `pandas.DataFrame` propres et standardisés.
+
+Les données sont extraites et croisées à partir de multiples sources fiables (Site officiel BRVM, Sika Finance, RichBourse, UMOA-Titres) avec un système de fallback automatique en cas d'indisponibilité d'une source.
+
+## 🔥 Fonctionnalités & Univers Couvert
+
+- **Actions (Equities) & Indices** : Cotations en temps réel (EOD), historiques complets OHLCV, liste des tickers validés.
+- **Obligations (Bonds)** : Prise en charge des obligations cotées à la BRVM.
+- **Profils & Fondamentaux** : Informations d'entreprises, ratios financiers annuels (PER, ROE, Rendement de Dividende, Capitalisation).
+- **Corporate Actions** : Historiques des dividendes, actualités des entreprises (Sika Finance), extraction du Bulletin Officiel de la Cote (BOC).
+- **Marché Primaire (UMOA-Titres)** : Courbe des taux souverains, historique et calendrier des adjudications (Bons et Obligations du Trésor).
+- **⚡ Cache SQLite Local** : Accélération des requêtes redondantes via une base de données locale respectueuse des API distantes.
+
+## 📦 Installation
+
+Pour installer la version de développement directement depuis GitHub :
+
+```bash
+git clone https://github.com/Naofal03/brvm.git
+cd brvm
+pip install -e "."
+```
+*(Le package sera bientôt disponible sur PyPI via `pip install brvm`)*
+
+## 🚀 Utilisation Courante (API Complète)
+
+Toutes les méthodes exposées renvoient soit des dictionnaires Python, soit des `pandas.DataFrame` prêts à l'analyse.
+
+### 1. Actions, Indices et Obligations
+```python
+import brvm
+
+# a. Lister tous les instruments (Actions, Indices, Obligations)
+df_tickers = brvm.get_tickers()
+print(df_tickers.head())
+
+# b. Obtenir la dernière cotation officielle détaillée EOD d'une action
+cours = brvm.get_quote("SNTS")
+print(f"Sonatel - Clôture : {cours['close']} XOF, Volume : {cours['volume']}")
+
+# c. Récupérer l'historique complet OHLCV (Open, High, Low, Close, Volume)
+df_historique = brvm.get_history("SNTS", start="2023-01-01", end="2024-01-01")
+print(df_historique)
+
+# d. Récupérer l'historique d'un indice (ex: BRVM Composite)
+df_index = brvm.get_index_history("BRVM-COMP")
+```
+
+### 2. Fondamentaux & Corporate Actions
+```python
+# a. Profil de l'entreprise (Secteur, activité, capitalisation...)
+profil = brvm.get_company_info("SNTS")
+
+# b. Historique des ratios financiers (PER, ROE, Rendements)
+df_fondamentaux = brvm.get_fundamentals_history("SNTS")
+
+# c. Historique complet des dividendes
+df_div = brvm.get_dividends("SNTS")
+
+# d. Actualités et articles de presse (via Sika Finance)
+news = brvm.get_news("SNTS")
+print(news[0]['title'], "-", news[0]['url'])
+
+# e. Récupérer le Bulletin Officiel de la Cote (BOC) du jour
+df_boc = brvm.get_latest_boc()
+```
+
+### 3. Marché Primaire (UMOA-Titres)
+```python
+# a. Récupérer la dernière Courbe des Taux (matrice des taux Zéro-Coupon)
+courbe_taux = brvm.get_yield_curve()
+
+# b. Consulter les résultats récents d'adjudications du marché primaire
+historique_emissions = brvm.get_adjudications_history(limit=10)
+
+# c. Consulter le calendrier des prochaines émissions de l'UEMOA
+calendrier = brvm.get_adjudications_calendar(limit=5)
+```
+
+## 🛠️ Format des Données Temporelles (Standard OHLCV)
+La méthode `get_history` obéit à la standardisation suivante :
+- **Absence de Nulls intempestifs** : Les NaN pour Open/High/Low n'existent que pour les jours où le `trading_status` est "NC" (Non Coté).  
+- **Forward Fill** : Les jours sans transaction voient leur cours précédent reporté sur la valeur de clôture (`close`), le volume tombant à `0`.
+- Colonnes fixes : `[date, open, high, low, close, adj_close, volume, value, trading_status]`.
+
+## ⚙️ Gestion du Cache Local
+Par défaut, le package utilise une base de données cache `~/.brvm_cache.db` pour éviter d'inonder les serveurs de la BRVM. 
+- Les séries temporelles (EOD) expirent après **12 heures**.
+- Les données structurelles (Tickers, Fondamentaux) expirent après **7 jours**.
+
+Si vous souhaitez forcer un appel réseau frais :
+```python
+brvm.disable_cache()
+brvm.get_history("SNTS")  # Requête réseau obligée
+brvm.enable_cache()       # Réactivation du système
+```
+
+## 🧪 Tests et Contribution
+Le package demande une stricte couverture de tests (>80%). Pour lancer les tests en environnement de dev :
+
+```bash
+pip install -e ".[dev]"
+pytest --cov=brvm
+```
+
+## 📄 Licence
+Ce projet est mis à disposition sous licence Open-Source MIT.

brvm-0.1.0/README.md

@@ -0,0 +1,113 @@
+# BRVM Python Package 📈��
+
+[![Python Versions](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+Une bibliothèque Python open-source robuste pour scraper et analyser les données de la **Bourse Régionale des Valeurs Mobilières (BRVM)**.  
+Conçue pour les analystes financiers, les développeurs et les data scientists, elle s'inspire du format `yfinance` en renvoyant directement des objets `pandas.DataFrame` propres et standardisés.
+
+Les données sont extraites et croisées à partir de multiples sources fiables (Site officiel BRVM, Sika Finance, RichBourse, UMOA-Titres) avec un système de fallback automatique en cas d'indisponibilité d'une source.
+
+## 🔥 Fonctionnalités & Univers Couvert
+
+- **Actions (Equities) & Indices** : Cotations en temps réel (EOD), historiques complets OHLCV, liste des tickers validés.
+- **Obligations (Bonds)** : Prise en charge des obligations cotées à la BRVM.
+- **Profils & Fondamentaux** : Informations d'entreprises, ratios financiers annuels (PER, ROE, Rendement de Dividende, Capitalisation).
+- **Corporate Actions** : Historiques des dividendes, actualités des entreprises (Sika Finance), extraction du Bulletin Officiel de la Cote (BOC).
+- **Marché Primaire (UMOA-Titres)** : Courbe des taux souverains, historique et calendrier des adjudications (Bons et Obligations du Trésor).
+- **⚡ Cache SQLite Local** : Accélération des requêtes redondantes via une base de données locale respectueuse des API distantes.
+
+## 📦 Installation
+
+Pour installer la version de développement directement depuis GitHub :
+
+```bash
+git clone https://github.com/Naofal03/brvm.git
+cd brvm
+pip install -e "."
+```
+*(Le package sera bientôt disponible sur PyPI via `pip install brvm`)*
+
+## 🚀 Utilisation Courante (API Complète)
+
+Toutes les méthodes exposées renvoient soit des dictionnaires Python, soit des `pandas.DataFrame` prêts à l'analyse.
+
+### 1. Actions, Indices et Obligations
+```python
+import brvm
+
+# a. Lister tous les instruments (Actions, Indices, Obligations)
+df_tickers = brvm.get_tickers()
+print(df_tickers.head())
+
+# b. Obtenir la dernière cotation officielle détaillée EOD d'une action
+cours = brvm.get_quote("SNTS")
+print(f"Sonatel - Clôture : {cours['close']} XOF, Volume : {cours['volume']}")
+
+# c. Récupérer l'historique complet OHLCV (Open, High, Low, Close, Volume)
+df_historique = brvm.get_history("SNTS", start="2023-01-01", end="2024-01-01")
+print(df_historique)
+
+# d. Récupérer l'historique d'un indice (ex: BRVM Composite)
+df_index = brvm.get_index_history("BRVM-COMP")
+```
+
+### 2. Fondamentaux & Corporate Actions
+```python
+# a. Profil de l'entreprise (Secteur, activité, capitalisation...)
+profil = brvm.get_company_info("SNTS")
+
+# b. Historique des ratios financiers (PER, ROE, Rendements)
+df_fondamentaux = brvm.get_fundamentals_history("SNTS")
+
+# c. Historique complet des dividendes
+df_div = brvm.get_dividends("SNTS")
+
+# d. Actualités et articles de presse (via Sika Finance)
+news = brvm.get_news("SNTS")
+print(news[0]['title'], "-", news[0]['url'])
+
+# e. Récupérer le Bulletin Officiel de la Cote (BOC) du jour
+df_boc = brvm.get_latest_boc()
+```
+
+### 3. Marché Primaire (UMOA-Titres)
+```python
+# a. Récupérer la dernière Courbe des Taux (matrice des taux Zéro-Coupon)
+courbe_taux = brvm.get_yield_curve()
+
+# b. Consulter les résultats récents d'adjudications du marché primaire
+historique_emissions = brvm.get_adjudications_history(limit=10)
+
+# c. Consulter le calendrier des prochaines émissions de l'UEMOA
+calendrier = brvm.get_adjudications_calendar(limit=5)
+```
+
+## 🛠️ Format des Données Temporelles (Standard OHLCV)
+La méthode `get_history` obéit à la standardisation suivante :
+- **Absence de Nulls intempestifs** : Les NaN pour Open/High/Low n'existent que pour les jours où le `trading_status` est "NC" (Non Coté).  
+- **Forward Fill** : Les jours sans transaction voient leur cours précédent reporté sur la valeur de clôture (`close`), le volume tombant à `0`.
+- Colonnes fixes : `[date, open, high, low, close, adj_close, volume, value, trading_status]`.
+
+## ⚙️ Gestion du Cache Local
+Par défaut, le package utilise une base de données cache `~/.brvm_cache.db` pour éviter d'inonder les serveurs de la BRVM. 
+- Les séries temporelles (EOD) expirent après **12 heures**.
+- Les données structurelles (Tickers, Fondamentaux) expirent après **7 jours**.
+
+Si vous souhaitez forcer un appel réseau frais :
+```python
+brvm.disable_cache()
+brvm.get_history("SNTS")  # Requête réseau obligée
+brvm.enable_cache()       # Réactivation du système
+```
+
+## 🧪 Tests et Contribution
+Le package demande une stricte couverture de tests (>80%). Pour lancer les tests en environnement de dev :
+
+```bash
+pip install -e ".[dev]"
+pytest --cov=brvm
+```
+
+## 📄 Licence
+Ce projet est mis à disposition sous licence Open-Source MIT.

brvm-0.1.0/brvm/__init__.py

@@ -0,0 +1,31 @@
+"""Public package exports for the BRVM Python library."""
+
+from .core import (
+    get_company_info,
+    get_dividends,
+    get_fundamentals_history,
+    get_history,
+    get_index_history,
+    get_quote,
+    get_tickers,
+)
+from .exceptions import (
+    BRVMError,
+    DataValidationError,
+    InvalidSymbolError,
+    SourceUnavailableError,
+)
+
+__all__ = [
+    "BRVMError",
+    "DataValidationError",
+    "InvalidSymbolError",
+    "SourceUnavailableError",
+    "get_company_info",
+    "get_dividends",
+    "get_fundamentals_history",
+    "get_history",
+    "get_index_history",
+    "get_quote",
+    "get_tickers",
+]

brvm-0.1.0/brvm/cache.py

@@ -0,0 +1,223 @@
+import sqlite3
+import logging
+import os
+import sqlite3
+import pandas as pd
+from datetime import datetime, timedelta
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+# Options par défaut
+DEFAULT_CACHE_DIR = Path.home() / ".brvm_cache.db"
+TTL_EOD = timedelta(hours=12)
+TTL_STATIC = timedelta(days=7)
+
+_USE_CACHE = True
+
+def disable_cache():
+    """Désactive le cache de manière globale."""
+    global _USE_CACHE
+    _USE_CACHE = False
+    logger.info("BRVM cache disabled.")
+
+def enable_cache():
+    """Réactive le cache de manière globale."""
+    global _USE_CACHE
+    _USE_CACHE = True
+    logger.info("BRVM cache enabled.")
+
+def is_cache_enabled():
+    """Vérifie si le cache est actif."""
+    return _USE_CACHE
+
+def get_db_path() -> Path:
+    """Récupère le chemin du cache."""
+    # Override via var env
+    env_path = os.environ.get("BRVM_CACHE_DIR")
+    if env_path:
+        return Path(env_path)
+    return DEFAULT_CACHE_DIR
+
+def _get_connection() -> sqlite3.Connection:
+    """Ouvre et gère la connexion locale."""
+    path = get_db_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    conn = sqlite3.connect(path, check_same_thread=False)
+    # Active la vérification des foreign keys
+    conn.execute("PRAGMA foreign_keys = 1")
+    return conn
+
+def init_db():
+    conn = _get_connection()
+    c = conn.cursor()
+    # Métadonnées cache pour gérer le TTL
+    c.execute('''
+        CREATE TABLE IF NOT EXISTS cache_meta (
+            key TEXT PRIMARY KEY,
+            updated_at TIMESTAMP NOT NULL
+        )
+    ''')
+    # Tickers
+    c.execute('''
+        CREATE TABLE IF NOT EXISTS tickers (
+            id TEXT PRIMARY KEY,
+            nom_entreprise TEXT,
+            secteur_activite TEXT,
+            type_instrument TEXT
+        )
+    ''')
+    # Historique de cotations
+    c.execute('''
+        CREATE TABLE IF NOT EXISTS daily_quotes (
+            date TIMESTAMP,
+            ticker_id TEXT,
+            open REAL,
+            high REAL,
+            low REAL,
+            close REAL,
+            adj_close REAL,
+            volume INTEGER CHECK(volume >= 0),
+            value REAL,
+            trading_status TEXT,
+            PRIMARY KEY (date, ticker_id),
+            FOREIGN KEY (ticker_id) REFERENCES tickers(id) ON DELETE CASCADE
+        )
+    ''')
+    # Fondamentaux
+    c.execute('''
+        CREATE TABLE IF NOT EXISTS fundamentals (
+            ticker_id TEXT,
+            annee_fiscale INTEGER,
+            per REAL,
+            rendement_dividende REAL,
+            capitalisation REAL,
+            roe REAL,
+            PRIMARY KEY (ticker_id, annee_fiscale),
+            FOREIGN KEY (ticker_id) REFERENCES tickers(id) ON DELETE CASCADE
+        )
+    ''')
+    # Dividendes
+    c.execute('''
+        CREATE TABLE IF NOT EXISTS dividends (
+            ticker_id TEXT,
+            date_detachement TIMESTAMP,
+            montant_net REAL,
+            PRIMARY KEY (ticker_id, date_detachement),
+            FOREIGN KEY (ticker_id) REFERENCES tickers(id) ON DELETE CASCADE
+        )
+    ''')
+    conn.commit()
+    conn.close()
+
+def _set_updated(key: str):
+    conn = _get_connection()
+    c = conn.cursor()
+    c.execute(
+        "INSERT OR REPLACE INTO cache_meta (key, updated_at) VALUES (?, ?)", 
+        (key, datetime.now())
+    )
+    conn.commit()
+    conn.close()
+
+def _check_valid(key: str, ttl: timedelta) -> bool:
+    if not is_cache_enabled():
+        return False
+        
+    conn = _get_connection()
+    c = conn.cursor()
+    c.execute("SELECT updated_at FROM cache_meta WHERE key = ?", (key,))
+    row = c.fetchone()
+    conn.close()
+    
+    if not row:
+        return False
+        
+    try:
+        updated_at = datetime.fromisoformat(row[0] if isinstance(row[0], str) else str(row[0]))
+        return datetime.now() - updated_at < ttl
+    except Exception:
+        return False
+
+# ----- Operations sur le Tickers Cache -----
+def cache_set_tickers(df: pd.DataFrame):
+    if not is_cache_enabled(): return
+    conn = _get_connection()
+    lock_path = str(get_db_path()) + ".lock"
+    # Simple to_sql save, ignoring FK constraints temporarily for initial load or just parsing properly
+    # A plus sûr: utiliser to_sql avec if_exists="replace" si c'est pour l'API. Or, la table est définie custom.
+    # Pour garder la structure du CC:
+    try:
+        df_copy = df.copy()
+        if 'symbol' in df_copy.columns:
+            df_copy = df_copy.rename(columns={'symbol': 'id'})
+        
+        # On ne stocke que les colonnes prévues (simplification).
+        # Normalement on utilise REPLACE pour gérer les doublons SQLite
+        # pandas to_sql doesn't support REPLACE directly on all sqlite versions natively without extra dialect args.
+        # So we delete and insert.
+        c = conn.cursor()
+        c.execute("DELETE FROM tickers")
+        df_copy.to_sql("tickers", conn, if_exists="append", index=False)
+        _set_updated("tickers")
+    except Exception as e:
+        logger.warning(f"Failed to cache tickers: {e}")
+    finally:
+        conn.close()
+
+def cache_get_tickers() -> pd.DataFrame:
+    if not _check_valid("tickers", TTL_STATIC):
+        return None
+    try:
+        conn = _get_connection()
+        df = pd.read_sql("SELECT * FROM tickers", conn)
+        conn.close()
+        # Remapper id -> symbol si convention interne
+        df = df.rename(columns={'id': 'symbol'})
+        return df if not df.empty else None
+    except Exception:
+        return None
+
+# ----- Operations sur le Quotes Cache -----
+def cache_set_history(symbol: str, df: pd.DataFrame):
+    if not is_cache_enabled() or df.empty: return
+    conn = _get_connection()
+    try:
+        c = conn.cursor()
+        c.execute("DELETE FROM daily_quotes WHERE ticker_id = ?", (symbol,))
+        
+        df_copy = df.copy()
+        df_copy['ticker_id'] = symbol
+        # Ensure date format as string or datetime
+        df_copy['date'] = pd.to_datetime(df_copy['date'])
+        
+        # Safe insert
+        df_copy.to_sql("daily_quotes", conn, if_exists="append", index=False)
+        _set_updated(f"history_{symbol}")
+    except Exception as e:
+        logger.warning(f"Failed to cache history for {symbol}: {e}")
+    finally:
+        conn.close()
+
+def cache_get_history(symbol: str) -> pd.DataFrame:
+    if not _check_valid(f"history_{symbol}", TTL_EOD):
+        return None
+    try:
+        conn = _get_connection()
+        df = pd.read_sql("SELECT * FROM daily_quotes WHERE ticker_id = ? ORDER BY date ASC", conn, params=(symbol,))
+        conn.close()
+        
+        if df.empty:
+            return None
+            
+        df['date'] = pd.to_datetime(df['date']).dt.date
+        df = df.drop(columns=['ticker_id'])
+        return df
+    except Exception:
+        return None
+
+# Initialisation 
+try:
+    init_db()
+except Exception as e:
+    logger.warning(f"Cache DB init failed: {e}")

brvm-0.1.0/brvm/client.py

@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+import logging
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any
+
+import certifi
+
+try:
+    from tenacity import retry, retry_if_exception_type, stop_after_attempt, wait_exponential
+except ModuleNotFoundError:  # pragma: no cover - fallback for bare environments
+    def retry(*args: Any, **kwargs: Any):  # type: ignore[override]
+        def decorator(func: Any) -> Any:
+            return func
+
+        return decorator
+
+    def retry_if_exception_type(*args: Any, **kwargs: Any) -> None:
+        return None
+
+    def stop_after_attempt(*args: Any, **kwargs: Any) -> None:
+        return None
+
+    def wait_exponential(*args: Any, **kwargs: Any) -> None:
+        return None
+
+if TYPE_CHECKING:
+    import httpx
+
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+    "Accept-Language": "fr-FR,fr;q=0.9,en;q=0.8",
+}
+
+_client_singleton: "BRVMClient | None" = None
+
+
+def _load_httpx() -> Any:
+    import httpx
+
+    return httpx
+
+
+class BRVMClient:
+    """HTTP client shared by source adapters."""
+
+    def __init__(
+        self,
+        *,
+        timeout: float = 20.0,
+        headers: Mapping[str, str] | None = None,
+    ) -> None:
+        httpx = _load_httpx()
+        merged_headers = {**DEFAULT_HEADERS, **dict(headers or {})}
+        self._httpx = httpx
+        self._session = httpx.Client(
+            headers=merged_headers,
+            timeout=timeout,
+            verify=certifi.where(),
+        )
+        self._insecure_session = httpx.Client(
+            headers=merged_headers,
+            timeout=timeout,
+            verify=False,
+        )
+
+    @retry(
+        stop=stop_after_attempt(3),
+        wait=wait_exponential(multiplier=1, min=1, max=8),
+        retry=retry_if_exception_type(Exception),
+        reraise=True,
+    )
+    def get(
+        self, url: str, *, params: Mapping[str, Any] | None = None
+    ) -> "httpx.Response":
+        logger.debug("GET %s params=%s", url, params)
+        response = self._request_with_tls_fallback("GET", url, params=params)
+        response.raise_for_status()
+        return response
+
+    @retry(
+        stop=stop_after_attempt(3),
+        wait=wait_exponential(multiplier=1, min=1, max=8),
+        retry=retry_if_exception_type(Exception),
+        reraise=True,
+    )
+    def post(
+        self, url: str, *, data: Mapping[str, Any] | None = None
+    ) -> "httpx.Response":
+        logger.debug("POST %s", url)
+        response = self._request_with_tls_fallback("POST", url, data=data)
+        response.raise_for_status()
+        return response
+
+    def close(self) -> None:
+        self._session.close()
+        self._insecure_session.close()
+
+    def __enter__(self) -> "BRVMClient":
+        return self
+
+    def __exit__(self, exc_type: object, exc: object, tb: object) -> None:
+        self.close()
+
+    def _request_with_tls_fallback(
+        self,
+        method: str,
+        url: str,
+        *,
+        params: Mapping[str, Any] | None = None,
+        data: Mapping[str, Any] | None = None,
+    ) -> "httpx.Response":
+        try:
+            return self._session.request(method, url, params=params, data=data)
+        except Exception as exc:
+            if "CERTIFICATE_VERIFY_FAILED" not in str(exc):
+                raise
+
+            logger.warning(
+                "TLS verification failed for %s; retrying with certificate checks disabled.",
+                url,
+            )
+            return self._insecure_session.request(method, url, params=params, data=data)
+
+
+def get_brvm_session() -> BRVMClient:
+    global _client_singleton
+    if _client_singleton is None:
+        _client_singleton = BRVMClient()
+    return _client_singleton