baridimob 0.1.0__tar.gz

baridimob-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BaridiMob SDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

baridimob-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+prune tests
+global-exclude __pycache__ *.py[cod]

baridimob-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: baridimob
+Version: 0.1.0
+Summary: Open-source Python SDK for BaridiMob (Algérie Poste)
+Author: BaridiMob SDK contributors
+License: MIT
+Project-URL: Homepage, https://github.com/baridimobsdk/baridimob
+Project-URL: Repository, https://github.com/baridimobsdk/baridimob
+Keywords: baridimob,algerie-poste,ccp,payment,sdk,algeria
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Dynamic: license-file
+
+# baridimob — Python SDK
+
+Open-source SDK for **BaridiMob** (Algérie Poste).
+
+> Work in progress — the public API is not stable yet.
+
+## Install
+
+```bash
+pip install baridimob
+```
+
+## Quickstart
+
+```python
+from baridimob import Config, FileStorage, create_client
+
+bm = create_client(Config(storage=FileStorage("./.baridimob/session.json")))
+
+result = bm.auth.login("your-login", "your-password")
+if result.state == "otp_required":
+    bm.auth.request_device_otp()
+    bm.auth.confirm_device("123456")
+
+accounts = bm.accounts.list()
+history = bm.accounts.transactions(accounts[0].number, page=1)
+
+pending = bm.transfers.send(1000, accounts[0].number, "00799999000000000000")
+# SMS is sent here; show the OTP screen, then:
+receipt = pending.confirm("123456")
+```
+
+The device is confirmed once. Later logins on the same machine reuse the stored
+device keys and need no OTP. Session expiry is handled automatically.
+
+## Status
+
+| Module | Status |
+|--------|--------|
+| core — signer, device keys, transport (form/JSON/binary), typed errors, storage | done (unit-tested) |
+| auth — login, device OTP, logout, automatic re-login | done |
+| accounts — list, detail, balance, history, find, iterate | done |
+| payments — verify, categories, providers, check + exec (card), dynamic FPE | done |
+| transfers — strategies, arm, request_otp, exec, send | done |
+| receipts — recent operations, PDF download | done |
+| profile — client identity and flags | done |
+| cards | planned |
+| cardless | planned |
+
+## Security
+
+- HTTPS is enforced. Plain `http://` is accepted only for `localhost` / `127.0.0.1`
+  or when `allow_insecure=True` is set explicitly.
+- The stored session is a live credential. Encrypt it at rest and never commit it.
+- Money movement always requires an OTP supplied by the caller.
+
+## Requirements
+
+- Python >= 3.10
+- `httpx`
+
+## License
+
+MIT

baridimob-0.1.0/README.md

@@ -0,0 +1,64 @@
+# baridimob — Python SDK
+
+Open-source SDK for **BaridiMob** (Algérie Poste).
+
+> Work in progress — the public API is not stable yet.
+
+## Install
+
+```bash
+pip install baridimob
+```
+
+## Quickstart
+
+```python
+from baridimob import Config, FileStorage, create_client
+
+bm = create_client(Config(storage=FileStorage("./.baridimob/session.json")))
+
+result = bm.auth.login("your-login", "your-password")
+if result.state == "otp_required":
+    bm.auth.request_device_otp()
+    bm.auth.confirm_device("123456")
+
+accounts = bm.accounts.list()
+history = bm.accounts.transactions(accounts[0].number, page=1)
+
+pending = bm.transfers.send(1000, accounts[0].number, "00799999000000000000")
+# SMS is sent here; show the OTP screen, then:
+receipt = pending.confirm("123456")
+```
+
+The device is confirmed once. Later logins on the same machine reuse the stored
+device keys and need no OTP. Session expiry is handled automatically.
+
+## Status
+
+| Module | Status |
+|--------|--------|
+| core — signer, device keys, transport (form/JSON/binary), typed errors, storage | done (unit-tested) |
+| auth — login, device OTP, logout, automatic re-login | done |
+| accounts — list, detail, balance, history, find, iterate | done |
+| payments — verify, categories, providers, check + exec (card), dynamic FPE | done |
+| transfers — strategies, arm, request_otp, exec, send | done |
+| receipts — recent operations, PDF download | done |
+| profile — client identity and flags | done |
+| cards | planned |
+| cardless | planned |
+
+## Security
+
+- HTTPS is enforced. Plain `http://` is accepted only for `localhost` / `127.0.0.1`
+  or when `allow_insecure=True` is set explicitly.
+- The stored session is a live credential. Encrypt it at rest and never commit it.
+- Money movement always requires an OTP supplied by the caller.
+
+## Requirements
+
+- Python >= 3.10
+- `httpx`
+
+## License
+
+MIT

baridimob-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "baridimob"
+version = "0.1.0"
+description = "Open-source Python SDK for BaridiMob (Algérie Poste)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "BaridiMob SDK contributors" }]
+keywords = ["baridimob", "algerie-poste", "ccp", "payment", "sdk", "algeria"]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/baridimobsdk/baridimob"
+Repository = "https://github.com/baridimobsdk/baridimob"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

baridimob-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

baridimob-0.1.0/src/baridimob/__init__.py

@@ -0,0 +1,148 @@
+from .client import BaridiMob, Config, create_client
+from .errors import (
+    AccountLockedError,
+    ApiResultError,
+    BaridiMobError,
+    DeviceConfirmationRequiredError,
+    DeviceFlowError,
+    ExpiredOtpError,
+    HashedRetryError,
+    InvalidCredentialsError,
+    InvalidOtpError,
+    InvalidSignatureError,
+    NetworkError,
+    PasswordExpiredError,
+    RegistrationRequiredError,
+    ServerError,
+    SessionExpiredError,
+    TermsRequiredError,
+    TimeoutError,
+    TooManyAttemptsError,
+)
+from .keys import (
+    DEVKEY_ALGORITHM,
+    DEVKEY_ALGORITHM_HASH,
+    DeviceKeys,
+    algorithm_hash,
+    derive_devkey,
+    generate_device_keys,
+    sha256_hex,
+)
+from .parse import (
+    day_bounds,
+    is_within_bounds,
+    parse_account,
+    parse_accounts,
+    parse_dynamic_groups,
+    parse_dynamic_operation,
+    parse_dynamic_step,
+    parse_history,
+    parse_payment_categories,
+    parse_payment_providers,
+    parse_profile,
+    parse_recent_operations,
+    parse_timestamp,
+    parse_transaction,
+    to_date_param,
+)
+from .sign import INITIAL_STAMP, sign_json_body, sign_params
+from .storage import FileStorage, MemoryStorage
+from .types import (
+    Account,
+    DynamicGroup,
+    DynamicOperationInfo,
+    DynamicOperationRef,
+    DynamicStep,
+    DynamicStepInput,
+    HistoryPage,
+    LoginResult,
+    PaymentCategory,
+    PaymentCheckResult,
+    PaymentExecResult,
+    PaymentProvider,
+    Profile,
+    ProviderParam,
+    RecentOperation,
+    SessionStorage,
+    StoredSession,
+    Transaction,
+    TransferArmResult,
+    TransferExecResult,
+    TransferPending,
+    VerifyPaymentResult,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "BaridiMob",
+    "Config",
+    "create_client",
+    "Account",
+    "AccountLockedError",
+    "ApiResultError",
+    "BaridiMobError",
+    "DeviceConfirmationRequiredError",
+    "DeviceFlowError",
+    "DEVKEY_ALGORITHM",
+    "DEVKEY_ALGORITHM_HASH",
+    "DeviceKeys",
+    "DynamicGroup",
+    "DynamicOperationInfo",
+    "DynamicOperationRef",
+    "DynamicStep",
+    "DynamicStepInput",
+    "ExpiredOtpError",
+    "FileStorage",
+    "HashedRetryError",
+    "HistoryPage",
+    "INITIAL_STAMP",
+    "InvalidCredentialsError",
+    "InvalidOtpError",
+    "InvalidSignatureError",
+    "LoginResult",
+    "MemoryStorage",
+    "NetworkError",
+    "PasswordExpiredError",
+    "PaymentCategory",
+    "PaymentCheckResult",
+    "PaymentExecResult",
+    "PaymentProvider",
+    "Profile",
+    "ProviderParam",
+    "RecentOperation",
+    "RegistrationRequiredError",
+    "ServerError",
+    "SessionExpiredError",
+    "SessionStorage",
+    "StoredSession",
+    "TermsRequiredError",
+    "TimeoutError",
+    "TooManyAttemptsError",
+    "Transaction",
+    "TransferArmResult",
+    "TransferExecResult",
+    "TransferPending",
+    "VerifyPaymentResult",
+    "algorithm_hash",
+    "day_bounds",
+    "derive_devkey",
+    "generate_device_keys",
+    "is_within_bounds",
+    "parse_account",
+    "parse_accounts",
+    "parse_dynamic_groups",
+    "parse_dynamic_operation",
+    "parse_dynamic_step",
+    "parse_history",
+    "parse_payment_categories",
+    "parse_payment_providers",
+    "parse_profile",
+    "parse_recent_operations",
+    "parse_timestamp",
+    "parse_transaction",
+    "sha256_hex",
+    "sign_json_body",
+    "sign_params",
+    "to_date_param",
+]