feat: implement sycon python lib

* SYC-95 : create public python lib and associates tests/workflow

* SYC-95 : fix workflow file

* SYC-95 : fix workflow file

* SYC-95 : fix README error

* SYC-95 : chare Exceptions class in libs

* SYC-95 : add Exceptions in init

* SYC-95: Updating link to swagger in README.md

* SYC-95 : fix RPP

---------

Co-authored-by: Salim-Sycon <salim.khallouki@sycon.fr>

Author: mat-lgr

.github/workflows/ci_api_lib.yml

@@ -0,0 +1,46 @@
+name: CI — Run tests on API python lib
+
+on:
+  pull_request: {}
+  workflow_dispatch: {}
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python (ensure python3 is available)
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Show Python info
+        run: |
+          python --version
+          which python
+          pip --version
+
+      - name: Make run_tests.sh executable
+        run: |
+            cd libs/SyconApi
+            chmod +x ./run_tests.sh
+
+      - name: Run tests script
+        env:
+          CI: "true"   
+        run: |
+            cd libs/SyconApi
+            ./run_tests.sh
+
+      - name: Upload coverage HTML
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: libs/SyconApi/htmlcov

.gitignore

@@ -0,0 +1,8 @@
+# auto generated
+.venv
+.pycache
+.pytest_cache
+htmlcov
+.coverage
+__pycache__
+SyconApi.egg-info

README.md

@@ -43,7 +43,7 @@ L’API utilise un **jeton JWT** transmis dans l’en-tête `Authorization` et u
 
 ## 3) Utiliser Swagger UI (pas à pas)
 
-1. Ouvrez : <https://hello-sycon.github.io/sycon-api-production/>.
+1. Ouvrez : <https://hello-sycon.github.io/sycon-api/>.
 2. Cliquez **Authorize** et collez votre valeur `Bearer <JWT>` dans le champ prévu.
 3. Utilisez la **recherche** pour trouver un endpoint par nom ou par tag (« API auth », « Data API »).
 4. Dépliez un endpoint, cliquez **Try it out**, renseignez les paramètres, puis **Execute**.

libs/SyconApi/README.md

@@ -0,0 +1,115 @@
+# SyconApi
+
+Lightweight Python client for the Sycon cloud API — concise, synchronous wrapper to authenticate and fetch device lists and raw device data.
+
+## Install
+
+```bash
+# HTTPS
+pip install "git+https://github.com/Hello-sycon/sycon-api.git@SyconApi-v$VERSION#subdirectory=libs/SyconApi"
+
+#SSH
+pip install "git+ssh://git@github.com/Hello-sycon/sycon-api.git@SyconApi-v$VERSION#subdirectory=libs/SyconApi"
+```
+
+>[!NOTE]
+>To select the $VERSION variable, you can see the release associate to tag section in github repository
+
+## Quick example
+
+```py
+from sycon_api import SyconApi
+
+client = SyconApi(username="me@example.com", password="secret", debug=False)
+
+# authenticate (normally called automatically by methods that need a token)
+client.authenticate()
+
+# list devices
+devices = client.get_devices_list()
+print(devices)
+
+# get data for a single device
+data = client.get_data_from_device(
+    device_id="device-123",
+    field=SyconApi.SyconApiDataFields.TEMPERATURE_CELSIUS,
+    start_date="2025-10-03T12:30:00.000Z",
+    end_date="2025-10-03T13:30:00.000Z",
+    head_limit=100,
+)
+print(data)
+
+# get data for multiple devices (use tuple — function is cached)
+devices_data = client.get_data_from_devices(
+    devices_id=("device-123", "device-456"),
+    field=SyconApi.SyconApiDataFields.CO2_PPM,
+    start_date="2025-10-03T12:30:00.000Z",
+    end_date="2025-10-03T13:30:00.000Z",
+    head_limit=10,
+)
+print(devices_data)
+
+# get data for all devices (uses get_devices_list internally)
+all_data = client.get_data_from_all_devices(
+    field=SyconApi.SyconApiDataFields.HUMIDITY_PERCENT,
+    start_date="2025-10-03T12:30:00.000Z",
+    end_date="2025-10-03T13:30:00.000Z",
+    head_limit=10,
+)
+print(all_data)
+```
+
+## Public API (concise)
+
+All methods below belong to `SyconApi` (no leading underscore).
+
+### Constructor / properties
+
+* `SyconApi(username: str, password: str, debug: bool = False, debug_level: int = SyconApiLogLevel.DEBUG.value) -> SyconApi`
+  Create client. Pass `debug=True` to enable logger.
+* `username` — property, configured username.
+* `token` — property, current token (may be `None` until authenticated).
+
+### Enums
+
+* `SyconApi.SyconApiDataFields` — data field constants (e.g. `TEMPERATURE_CELSIUS`, `CO2_PPM`, `HUMIDITY_PERCENT`, ...).
+* `SyconApi.SyconApiV1Route` — endpoints (LOGIN, RENEW, CHECK, DEVICES, DATA).
+* `SyconApi.SyconApiLogLevel` — log levels.
+
+### Exceptions you may catch
+
+* `SyconApiInvalidParametersException` — invalid argument(s).
+* `SyconApiMissingParametersException` — required parameter missing.
+* `SyconApiBadResponseException` — 4xx HTTP response or invalid JSON where JSON is expected.
+* `SyconApiServerErrorResponseException` — 5xx HTTP response.
+
+### Main methods
+
+* `authenticate() -> None`
+  Authenticate with username/password. On success the client `token` is set from response headers.
+
+* `renew_token() -> None`
+  Renew token using current token. Raises `SyconApiBadResponseException` if no `Authorization` header in response.
+
+* `check_token() -> bool`
+  Check if current token is still valid. Returns `True` on HTTP 200.
+
+* `get_devices_list() -> Optional[Dict[str, Any]]`
+  Return devices list (parsed JSON) on HTTP 200. Raises `SyconApiBadResponseException` if response JSON is invalid.
+
+* `get_data_from_device(device_id: str, field: SyconApiDataFields, start_date: str, end_date: str, head_limit: Optional[int] = None, tail_limit: Optional[int] = None, external_sensor_id: Optional[str] = None) -> Optional[Dict[str, Any]]`
+  Fetch raw data for a single device. Returns a `dict` if response JSON parsed, otherwise `None`. Validates date format (ISO-8601 instant) and requires exactly one of `head_limit` / `tail_limit`.
+
+* `get_data_from_devices(devices_id: Tuple[str], field: SyconApiDataFields, start_date: str, end_date: str, head_limit: Optional[int] = None, tail_limit: Optional[int] = None, external_sensor_id: Optional[str] = None) -> Optional[Dict[str, Any]]`
+  Fetch raw data for multiple devices. **Important:** `devices_id` must be an **immutable tuple** (function is cached via `lru_cache`). Returns a dict mapping `device_id` → response body (dict or raw text).
+
+* `get_data_from_all_devices(field: SyconApiDataFields, start_date: str, end_date: str, head_limit: Optional[int] = None, tail_limit: Optional[int] = None, external_sensor_id: Optional[str] = None) -> Optional[Dict[str, Any]]`
+  Fetch data for all devices returned by `get_devices_list()`. Skips device entries that do not have an `"id"` key.
+
+## Notes & best practices
+
+* **Dates:** use strict ISO-8601 instant format: `YYYY-MM-DDTHH:MM:SS[.ms]Z` (example: `2025-10-03T12:30:00.000Z`). Invalid format raises `SyconApiInvalidParametersException`.
+* **Head/Tail limits:** exactly one of `head_limit` or `tail_limit` must be provided (not both). Limits are capped to `k_size_batch_limit` (default 10000).
+* **Caching:** `get_data_from_devices` and `get_data_from_device` are cached (`lru_cache`). For cached calls, ensure all arguments are hashable (use `tuple` for device lists). You can clear the cache with e.g. `SyconApi.get_data_from_devices.cache_clear()`.
+* **Errors:** 4xx responses raise `SyconApiBadResponseException`; 5xx raise `SyconApiServerErrorResponseException`. Network-level errors (requests exceptions) will propagate.
+* **Logging:** enable `debug=True` in the constructor to activate the internal logger.

libs/SyconApi/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=69.5.1", "wheel>=0.43"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "SyconApi"
+version = "0.1.0"
+description = "Sycon python api to users"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [ { name = "Sycon", email = "dev@sycon.fr" } ]
+dependencies = [
+  "requests>=2.32,<3.0",
+  "tenacity>=9.0.0,<10.0.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["sycon_api"]

libs/SyconApi/pytest.ini

@@ -0,0 +1,5 @@
+# pytest.ini
+[pytest]
+minversion = 7.0
+addopts = -ra
+testpaths = tests

libs/SyconApi/run_tests.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Usage: ./run_tests.sh [pytest args...]
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$REPO_ROOT"
+
+if [ ! -f pyproject.toml ]; then
+  echo "ERROR: pyproject.toml not found. Lance le script depuis la racine du repo." >&2
+  exit 1
+fi
+
+VENV_DIR=".venv"
+PYTHON_CMD="${PYTHON:-python3}"
+
+echo ">>> Using Python: $($PYTHON_CMD --version 2>&1 | tr -d '\n')"
+# create venv if missing
+if [ ! -d "$VENV_DIR" ]; then
+  echo ">>> Creating virtualenv in $VENV_DIR ..."
+  $PYTHON_CMD -m venv "$VENV_DIR"
+fi
+
+# activate venv
+# shellcheck source=/dev/null
+. "$VENV_DIR/bin/activate"
+
+echo ">>> Upgrading pip / setuptools / wheel ..."
+pip install -U pip setuptools wheel >/dev/null
+
+echo ">>> Installing package editable (pip install -e .) ..."
+if pip install -e . >/dev/null 2>&1; then
+  echo ">>> Package installed editable."
+else
+  echo ">>> Warning: pip install -e . failed — falling back to PYTHONPATH=src"
+  export PYTHONPATH="$REPO_ROOT/src:${PYTHONPATH:-}"
+fi
+
+echo ">>> Installing test deps (pytest, pytest-cov, requests-mock) ..."
+pip install -U pytest pytest-cov requests-mock >/dev/null
+
+# run pytest with coverage; forward any user args
+PYTEST_ARGS=( --cov=sycon_api --cov-report=term-missing --cov-report=html -q )
+if [ "$#" -ne 0 ]; then
+  PYTEST_ARGS+=( "$@" )
+fi
+
+echo ">>> Running pytest ..."
+pytest "${PYTEST_ARGS[@]}"
+EXIT_CODE=$?
+
+echo
+echo ">>> Done. Coverage HTML report: $REPO_ROOT/htmlcov/index.html"
+echo ">>> Return code: $EXIT_CODE"
+exit $EXIT_CODE

libs/SyconApi/src/sycon_api/__init__.py

@@ -0,0 +1,10 @@
+from .sycon_api import ( SyconApi,
+                        SyconApiBadResponseException,
+                        SyconApiInvalidParametersException,
+                        SyconApiMissingParametersException,
+                        SyconApiServerErrorResponseException)
+__all__ = ["SyconApi",
+           "SyconApiInvalidParametersException", 
+           "SyconApiMissingParametersException",
+           "SyconApiBadResponseException",
+           "SyconApiServerErrorResponseException"]