deriweave-python 0.3.0__tar.gz → 0.4.0__tar.gz

deriweave_python-0.4.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: deriweave-python
+Version: 0.4.0
+Summary: Compatibility imports for DeriWeave; install deriweave for new projects
+Author: DeriWeave contributors
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: deriweave<0.5,>=0.4.0
+Provides-Extra: numpy
+Requires-Dist: deriweave[numpy]<0.5,>=0.4.0; extra == "numpy"
+Provides-Extra: test
+Requires-Dist: deriweave[test]<0.5,>=0.4.0; extra == "test"
+Provides-Extra: release
+Requires-Dist: deriweave[release]<0.5,>=0.4.0; extra == "release"
+Description-Content-Type: text/markdown
+
+# deriweave-python 0.4.0 : compatibilité avec DeriWeave
+
+Le nom principal du projet est désormais **deriweave**.
+
+Pour un nouveau projet :
+
+```bash
+python -m pip install deriweave
+```
+
+```python
+import deriweave as dw
+```
+
+Pour mettre à jour une installation historique sans changer les imports :
+
+```bash
+python -m pip install --upgrade deriweave-python
+```
+
+```python
+import deriweave_py as dw
+```
+
+Ce paquet installe DeriWeave 0.4.x et conserve les imports historiques, y compris
+composition, structured et _core. Les anciens et nouveaux imports désignent les
+mêmes classes, expressions et fonctions ; un seul moteur natif est chargé.
+Ce paquet de compatibilité est en Python pur. La wheel native du paquet principal
+cible CPython 3.12 sur Windows x64 ; les autres configurations construisent
+DeriWeave depuis les sources avec un compilateur C++20 et CMake.
+
+Projet principal : https://pypi.org/project/deriweave/

deriweave_python-0.4.0/README.md

@@ -0,0 +1,32 @@
+# deriweave-python 0.4.0 : compatibilité avec DeriWeave
+
+Le nom principal du projet est désormais **deriweave**.
+
+Pour un nouveau projet :
+
+```bash
+python -m pip install deriweave
+```
+
+```python
+import deriweave as dw
+```
+
+Pour mettre à jour une installation historique sans changer les imports :
+
+```bash
+python -m pip install --upgrade deriweave-python
+```
+
+```python
+import deriweave_py as dw
+```
+
+Ce paquet installe DeriWeave 0.4.x et conserve les imports historiques, y compris
+composition, structured et _core. Les anciens et nouveaux imports désignent les
+mêmes classes, expressions et fonctions ; un seul moteur natif est chargé.
+Ce paquet de compatibilité est en Python pur. La wheel native du paquet principal
+cible CPython 3.12 sur Windows x64 ; les autres configurations construisent
+DeriWeave depuis les sources avec un compilateur C++20 et CMake.
+
+Projet principal : https://pypi.org/project/deriweave/

deriweave_python-0.4.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["scikit-build-core>=1.0"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "deriweave-python"
+version = "0.4.0"
+description = "Compatibility imports for DeriWeave; install deriweave for new projects"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "DeriWeave contributors"}]
+dependencies = ["deriweave>=0.4.0,<0.5"]
+
+[project.optional-dependencies]
+numpy = ["deriweave[numpy]>=0.4.0,<0.5"]
+test = ["deriweave[test]>=0.4.0,<0.5"]
+release = ["deriweave[release]>=0.4.0,<0.5"]
+
+[tool.scikit-build]
+minimum-version = "1.0"
+wheel.cmake = false
+wheel.packages = ["src/deriweave_py"]
+
+[tool.scikit-build.sdist]
+inclusion-mode = "explicit"
+include = ["/pyproject.toml", "/README.md", "/LICENSE", "/src/**"]
+exclude = ["**/__pycache__/**", "**/*.pyc", "/dist/**", "/build/**"]

deriweave_python-0.4.0/src/deriweave_py/__init__.py

@@ -0,0 +1,9 @@
+"""Compatibility imports for applications using the former deriweave_py name."""
+import sys as _sys
+from deriweave import *
+from deriweave import __all__, __version__, _core, composition, structured
+
+# Reuse the actual modules, classes and extension; never load a second engine.
+_sys.modules[__name__ + "._core"] = _core
+_sys.modules[__name__ + ".composition"] = composition
+_sys.modules[__name__ + ".structured"] = structured

deriweave_python-0.4.0/src/deriweave_py/_core.pyi

@@ -0,0 +1 @@
+from deriweave._core import *

deriweave_python-0.4.0/src/deriweave_py/composition.py

@@ -0,0 +1,2 @@
+"""Type-checker forwarding module; runtime imports alias deriweave.composition."""
+from deriweave.composition import *

deriweave_python-0.4.0/src/deriweave_py/structured.py

@@ -0,0 +1,2 @@
+"""Type-checker forwarding module; runtime imports alias deriweave.structured."""
+from deriweave.structured import *

deriweave_python-0.3.0/.gitattributes

@@ -1,6 +0,0 @@
-# Native patch checksums must survive Windows checkouts.
-* text=auto eol=lf
-*.bat text eol=crlf
-*.png binary
-*.jpg binary
-*.pdf binary

deriweave_python-0.3.0/.github/workflows/tests.yml

@@ -1,42 +0,0 @@
-name: Build and test
-
-on:
-  push:
-  pull_request:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  validate:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest]
-        python: ["3.10", "3.12", "3.14"]
-        openmp: ["OFF"]
-        include:
-          - os: ubuntu-latest
-            python: "3.12"
-            openmp: "ON"
-          - os: windows-latest
-            python: "3.12"
-            openmp: "ON"
-    runs-on: ${{ matrix.os }}
-    timeout-minutes: 30
-    env:
-      CMAKE_BUILD_PARALLEL_LEVEL: "4"
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-python@v6
-        with:
-          python-version: ${{ matrix.python }}
-      - name: Install development dependencies
-        run: python -m pip install "scikit-build-core>=1.0" "pybind11>=3.0,<4" "pytest>=8" "numpy>=1.23" "build>=1.2" "twine>=6"
-      - name: Build and install the native extension; run C++ suites
-        run: python tools/build_local.py --openmp ${{ matrix.openmp }} --tests
-      - name: Build distributions and test the wheel in a fresh environment
-        run: python tools/check_distribution.py --tests
-      - name: Check release metadata
-        run: python -c "import glob, subprocess, sys; subprocess.run([sys.executable, '-m', 'twine', 'check', '--strict', *glob.glob('dist/*.whl'), *glob.glob('dist/*.tar.gz')], check=True)"

deriweave_python-0.3.0/.gitignore

@@ -1,18 +0,0 @@
-/.venv/
-/build/
-/_skbuild/
-*.egg-info/
-__pycache__/
-.pytest_cache/
-/.audit/
-/dist/
-*.pyd
-*.so
-
-# Keep the pinned engine and Eigen headers in source control for pip install .
-/vendor/*
-!/vendor/deriweave/
-!/vendor/eigen-source/
-/vendor/eigen-source/*
-!/vendor/eigen-source/Eigen/
-!/vendor/eigen-source/COPYING*

deriweave_python-0.3.0/CHANGELOG.md

@@ -1,14 +0,0 @@
-# Changelog
-
-## 0.3.0 — 2026-11-07
-
-- Six native models and reusable expressions, with autocalls and separate LSM training/evaluation.
-- Native paths, deterministic contract evaluation, moment diagnostics, NumPy interoperability and type information.
-- Numerical portability fixes validated on Windows/MSVC and Linux/GCC; details in docs/AUDIT.md.
-- Self-contained sources with an explicit archive whitelist and sequential Windows CPython 3.12 wheel; native dependencies are retained in source control.
-- Source preparation reuses existing headers without compiling Eigen and patches new engine sources before installing them.
-- Development builds install the actual extension they validate; clean-environment distribution checks are reproducible.
-
-## 0.2.0
-
-Initial Python bindings with six models, declarative compositions and historical pricing helpers.

deriweave_python-0.3.0/CMakeLists.txt

@@ -1,60 +0,0 @@
-cmake_minimum_required(VERSION 3.20)
-project(DeriWeavePython VERSION 0.3.0 LANGUAGES CXX)
-
-option(DERIWEAVE_PY_BUILD_TESTS "Build native tests and the Python reference executable" OFF)
-option(DERIWEAVE_ENABLE_OPENMP "Enable native OpenMP pricing (runtime required)" OFF)
-if(NOT DEFINED DERIWEAVE_SOURCE_DIR)
-  if(DEFINED ENV{DERIWEAVE_CPP_DIR} AND NOT "$ENV{DERIWEAVE_CPP_DIR}" STREQUAL "")
-    set(DERIWEAVE_SOURCE_DIR "$ENV{DERIWEAVE_CPP_DIR}" CACHE PATH "DeriWeave C++ sources")
-  else()
-    set(DERIWEAVE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/vendor/deriweave" CACHE PATH "DeriWeave C++ sources")
-  endif()
-endif()
-if(NOT EXISTS "${DERIWEAVE_SOURCE_DIR}/CMakeLists.txt")
-  message(FATAL_ERROR "DeriWeave C++ sources missing. Run python prepare_windows.py or set DERIWEAVE_SOURCE_DIR.")
-endif()
-find_package(Eigen3 3.4 QUIET NO_MODULE)
-if(NOT Eigen3_FOUND)
-  set(DERIWEAVE_EIGEN_INCLUDE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/vendor/eigen-source")
-  if(NOT EXISTS "${DERIWEAVE_EIGEN_INCLUDE_DIR}/Eigen/Core")
-    message(FATAL_ERROR "Eigen 3.4+ missing. Install Eigen or run python prepare_windows.py.")
-  endif()
-  include(CMakePackageConfigHelpers)
-  set(Eigen3_DIR "${CMAKE_CURRENT_BINARY_DIR}/eigen-package")
-  file(MAKE_DIRECTORY "${Eigen3_DIR}")
-  configure_file(cmake/Eigen3Config.cmake.in "${Eigen3_DIR}/Eigen3Config.cmake" @ONLY)
-  write_basic_package_version_file("${Eigen3_DIR}/Eigen3ConfigVersion.cmake"
-    VERSION 3.4.0 COMPATIBILITY SameMajorVersion ARCH_INDEPENDENT)
-  find_package(Eigen3 3.4 REQUIRED NO_MODULE)
-endif()
-set(DERIWEAVE_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
-set(DERIWEAVE_BUILD_TESTS ${DERIWEAVE_PY_BUILD_TESTS} CACHE BOOL "" FORCE)
-if(DERIWEAVE_PY_BUILD_TESTS)
-  include(CTest)
-endif()
-find_package(Python COMPONENTS Interpreter Development.Module REQUIRED)
-set(PYBIND11_FINDPYTHON ON)
-find_package(pybind11 3.0 CONFIG REQUIRED)
-add_subdirectory("${DERIWEAVE_SOURCE_DIR}" "${CMAKE_CURRENT_BINARY_DIR}/deriweave_cpp" EXCLUDE_FROM_ALL)
-pybind11_add_module(_core NO_EXTRAS bindings/module.cpp bindings/composition.cpp)
-target_compile_features(_core PRIVATE cxx_std_20)
-target_link_libraries(_core PRIVATE DeriWeave::deriweave_core)
-install(TARGETS _core LIBRARY DESTINATION deriweave_py COMPONENT python RUNTIME DESTINATION deriweave_py COMPONENT python)
-install(FILES "${DERIWEAVE_SOURCE_DIR}/LICENSE" DESTINATION deriweave_py/licenses
-        RENAME DeriWeave-LICENSE COMPONENT python)
-if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/vendor/eigen-source/COPYING.MPL2")
-  install(FILES vendor/eigen-source/COPYING.MPL2 vendor/eigen-source/COPYING.BSD
-                vendor/eigen-source/COPYING.MINPACK vendor/eigen-source/COPYING.README
-          DESTINATION deriweave_py/licenses COMPONENT python)
-endif()
-if(DERIWEAVE_PY_BUILD_TESTS)
-  add_custom_target(native_tests)
-  get_property(_native_targets DIRECTORY "${DERIWEAVE_SOURCE_DIR}" PROPERTY BUILDSYSTEM_TARGETS)
-  foreach(_target IN LISTS _native_targets)
-    if(_target MATCHES "_tests$")
-      add_dependencies(native_tests "${_target}")
-    endif()
-  endforeach()
-  add_executable(native_reference tests/native_reference.cpp)
-  target_link_libraries(native_reference PRIVATE DeriWeave::deriweave_core)
-endif()

deriweave_python-0.3.0/INSTALL_WINDOWS.bat

@@ -1,36 +0,0 @@
-@echo off
-setlocal
-cd /d "%~dp0"
-where cl >nul 2>&1
-if errorlevel 1 (
-    echo ERROR: Open an x64 Native Tools Command Prompt for Visual Studio.
-    exit /b 1
-)
-where cmake >nul 2>&1
-if errorlevel 1 (
-    if exist "%ProgramFiles%\CMake\bin\cmake.exe" set "PATH=%ProgramFiles%\CMake\bin;%PATH%"
-)
-where cmake >nul 2>&1
-if errorlevel 1 (
-    echo ERROR: CMake is required.
-    exit /b 1
-)
-if not exist ".venv\Scripts\python.exe" (
-    py -3 -m venv .venv
-    if errorlevel 1 exit /b 1
-)
-call ".venv\Scripts\activate.bat"
-python prepare_windows.py
-if errorlevel 1 exit /b 1
-python -m pip install ".[test]"
-if errorlevel 1 exit /b 1
-python tools\build_local.py --tests
-if errorlevel 1 exit /b 1
-python -m pytest -q
-if errorlevel 1 exit /b 1
-for %%f in (examples\*.py) do (
-    python "%%f"
-    if errorlevel 1 exit /b 1
-)
-echo SUCCESS: installation, native tests, Python tests and examples passed.
-endlocal

deriweave_python-0.3.0/PKG-INFO

@@ -1,211 +0,0 @@
-Metadata-Version: 2.4
-Name: deriweave-python
-Version: 0.3.0
-Summary: Composable derivatives pricing with the native DeriWeave C++20 engine
-Keywords: derivatives,monte-carlo,quantitative-finance,pricing
-Author: DeriWeave contributors
-License-Expression: MIT
-License-File: LICENSE
-Requires-Python: >=3.10
-Provides-Extra: numpy
-Requires-Dist: numpy>=1.23; extra == "numpy"
-Provides-Extra: test
-Requires-Dist: pytest>=8; extra == "test"
-Requires-Dist: numpy>=1.23; extra == "test"
-Requires-Dist: build>=1.2; extra == "test"
-Requires-Dist: scikit-build-core>=1.0; extra == "test"
-Requires-Dist: pybind11<4,>=3.0; extra == "test"
-Provides-Extra: release
-Requires-Dist: build>=1.2; extra == "release"
-Requires-Dist: twine>=6; extra == "release"
-Description-Content-Type: text/markdown
-
-# DeriWeavePython 0.3.0
-
-Contrats financiers composables en Python, avec **DeriWeave C++20** pour la
-simulation, les cashflows, les statistiques et Longstaff-Schwartz.
-Les descriptions Python sont réutilisables ; aucun callback Python ne s'exécute
-dans les boucles Monte Carlo.
-
-Six modèles, expressions imbriquées, barrières discrètes, autocalls avec mémoire
-et politiques LSM sont disponibles. La documentation détaillée accompagne
-l'archive source : `docs/guide.md`, `docs/coverage.md` et `docs/AUDIT.md`.
-
-## Installation avec pip
-
-~~~bash
-python -m pip install deriweave-python
-~~~
-
-La wheel prête à l'emploi cible **CPython 3.12, Windows x64**. Pour les autres
-configurations, pip construit depuis les sources : un compilateur C++20 et
-CMake sont alors nécessaires. La construction Linux/GCC est vérifiée sur Python 3.12.
-NumPy est facultatif pour le pricing ; pour les matrices et diagnostics de chemin :
-
-~~~bash
-python -m pip install "deriweave-python[numpy]"
-~~~
-
-## Installer la wheel Windows fournie
-
-Pour **CPython 3.12, Windows x64**, la wheel de `dist/` s'installe sans
-compilateur C++. Dans un environnement virtuel activé :
-
-~~~bat
-python -m pip install dist\deriweave_python-0.3.0-cp312-cp312-win_amd64.whl
-python examples\demo.py
-~~~
-
-Le nom du paquet est `deriweave-python`, l'import est `deriweave_py`.
-La wheel et les sources permettent aussi une installation à partir d'un fichier
-local. Les instructions de maintenance et de publication figurent dans
-`docs/release.md`, inclus dans l'archive source.
-
-## Compiler et installer sous Windows
-
-Prérequis : Python 64 bits 3.10+, MSVC C++20 et CMake 3.20+.
-Validation sur Python 3.12.3, MSVC 19.51 et pybind11 3.1.0.
-Ouvrir une **x64 Native Tools Command Prompt** de Visual Studio :
-
-~~~bat
-python -m venv .venv
-.venv\Scripts\activate
-python -m pip install .
-~~~
-
-Réutiliser le .venv existant sans le recréer si souhaité.
-Le moteur et les en-têtes Eigen sont inclus dans les sources et conservés par
-les règles Git du projet : un checkout complet suffit pour `pip install .`.
-CMake n'a pas besoin du réseau ; pip peut télécharger le backend de construction.
-Pour une copie privée de ses dépendances, `python prepare_windows.py` récupère
-uniquement les sources manquantes, sur Windows ou Linux. Il réutilise les sources
-existantes et ne compile pas Eigen. Les corrections vérifiées par empreintes sont
-appliquées avant d'installer une nouvelle copie du moteur.
-
-Avec NumPy et les tests :
-
-~~~bat
-python -m pip install ".[test]"
-python tools\build_local.py --tests
-python -m pytest -q
-~~~
-
-`tools/build_local.py` installe le binaire qu'il construit avant de lancer les
-tests natifs ; les appels Python suivants utilisent donc cette compilation.
-INSTALL_WINDOWS.bat automatise préparation, installation, tests et exemples.
-
-## Installation Linux
-
-Avec Python, venv, les en-têtes de développement Python, un compilateur C++20 et
-CMake installés :
-
-~~~bash
-python3 -m venv .venv
-. .venv/bin/activate
-python -m pip install .
-~~~
-
-Un Eigen 3.4+ installé est prioritaire ; les en-têtes inclus servent de repli.
-La validation Linux/GCC et ses limites figurent dans le rapport d'audit.
-
-## Premier prix
-
-~~~python
-import deriweave_py as dw
-
-asset = dw.Asset("AAPL")
-product = dw.Product(dw.Call(dw.Spot(asset, 1.0), 100), payment_date=1.05)
-market = dw.Market({"AAPL": 100}, rate=0.03, dividend_yields={"AAPL": 0.02})
-model = dw.BlackScholes(0.20)
-settings = dw.SimulationSettings(n_simulations=20_000, seed=42, antithetic=True)
-result = dw.price(product, market=market, model=model, settings=settings)
-print(result.price, result.standard_error, result.confidence_interval_95)
-~~~
-
-L'observation à 1.0 et le paiement à 1.05 restent distincts.
-20 000 observations antithétiques produisent 40 000 trajectoires.
-
-## Produits composables
-
-~~~python
-import deriweave_py as dw
-
-observations = [
-    dw.Basket([dw.Spot("A", t), dw.Spot("B", t)], [0.5, 0.5])
-    for t in [0.25, 0.5, 0.75, 1.0]
-]
-product = dw.Product(dw.Call(dw.Average(observations), 105), payment_date=1.0)
-result = dw.price(product, market=dw.Market({"A": 100, "B": 110}, 0.03),
-                  model=dw.BlackScholes([0.20, 0.25], [[1, 0.4], [0.4, 1]]))
-print(result.price)
-~~~
-
-Un call sur panier diffère d'un panier de calls. Les moyennes imbriquées
-conservent leur ordre et leurs observations répétées.
-
-## Exercice anticipé
-
-~~~python
-import deriweave_py as dw
-
-t = dw.ExerciseTime
-contract = dw.American(
-    payoff=dw.Put(dw.Spot("A", t), 100),
-    states=[dw.Spot("A", t)], start=0, maturity=1,
-)
-market = dw.Market({"A": 100}, 0.03)
-model = dw.BlackScholes(0.20)
-policy = dw.train_longstaff_schwartz(
-    contract, market=market, model=model,
-    settings=dw.LsmSettings(training_paths=4000, seed=7919,
-                            max_exercise_time_step=1/12),
-)
-result = dw.price(policy, market=market, model=model,
-                  settings=dw.SimulationSettings(n_simulations=6000, seed=42))
-print(result.price, policy.exercise_dates)
-~~~
-
-L'entraînement reste séparé de l'évaluation. Sous Heston, utiliser au minimum
-spot et variance comme états pour une vanille. L'intervalle de confiance est
-conditionnel à la politique apprise.
-
-## Vérifier une distribution
-
-Après installation de `.[test,release]` et construction de la référence C++ avec
-`python tools/build_local.py --tests` :
-
-~~~bash
-python tools/check_distribution.py --tests
-~~~
-
-Cette commande construit la wheel depuis l'archive source, contrôle ses contenus
-et installe la wheel dans un venv neuf. Elle vérifie d'abord le pricing sans
-NumPy, puis exécute tous les tests Python et les cinq exemples.
-`--no-isolation` réutilise les dépendances de construction déjà installées.
-
-## Exemples et OpenMP
-
-~~~bash
-python examples/demo.py
-python examples/composition_demo.py
-python examples/models_demo.py
-python examples/structured_demo.py
-python examples/exercise_demo.py
-python tools/memory_check.py
-~~~
-
-OpenMP est désactivé par défaut. Pour l'activer :
-
-~~~bash
-python -m pip install . -Ccmake.define.DERIWEAVE_ENABLE_OPENMP=ON
-~~~
-
-Utiliser ensuite SimulationSettings(use_openmp=True, num_threads=4).
-dw.build_info() indique les capacités réelles du binaire.
-Le runtime du compilateur est requis : vcomp140.dll sous MSVC, libgomp avec GCC.
-La wheel séquentielle évite cette dépendance.
-
-Les fonctions historiques european, asian et basket restent disponibles.
-Base : [DeriWeave 0.1.0](https://github.com/AmineFendi94/DeriWeave),
-commit 8e54378b0800c936e22c2abca0afaca751c73888, avec les corrections de portabilité
-documentées dans l'audit. Licence MIT ; Eigen conserve ses licences.