FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.
C++ ai-agentsalgorithmic-tradingbloomberg-terminalcppfinancefinancial-marketsfintechgood-first-issueinvestmentinvestment-researchmachine-learningopensourcepythonqtquantitative-financestock-markettrading
mac build
tilakpatel22cc64a8f5b0a2
diff --git a/.github/workflows/build-macos-installer.yml b/.github/workflows/build-macos-installer.ymlnew file mode 100644index 000000000..c0061bcd5--- /dev/null+++ b/.github/workflows/build-macos-installer.yml@@ -0,0 +1,221 @@+name: Build macOS Installer (Apple Silicon)++on:+ workflow_dispatch:+ push:+ tags:+ - 'v*'++env:+ BUILD_TYPE: Release+ QT_VERSION: "6.8.3"+ QT_MODULES: "qtcharts qtwebsockets qtmultimedia"+ QT_IFW_VERSION: "4.7"+ QT_IFW_TOOL: "tools_ifw"+ APP_NAME: FinceptTerminal++jobs:+ build:+ name: macOS arm64 Installer+ runs-on: macos-15++ steps:+ - name: Checkout+ uses: actions/checkout@v4+ with:+ submodules: recursive++ # ── ccache ────────────────────────────────────────────────────────────+ - name: Set up ccache+ uses: hendrikmuhs/ccache-action@v1+ with:+ key: macos-arm64-installer-${{ env.QT_VERSION }}+ max-size: 500M++ # ── Install build tools ───────────────────────────────────────────────+ - name: Install build tools+ run: brew install ninja cmake++ # ── Install Qt 6.8.3 (official installer, includes private headers) ──+ - name: Install Qt ${{ env.QT_VERSION }}+ uses: jurplel/install-qt-action@v4+ with:+ version: ${{ env.QT_VERSION }}+ arch: clang_64+ modules: ${{ env.QT_MODULES }}+ cache: true+ cache-key-prefix: qt-macos-arm64-installer++ # ── Install Qt Installer Framework ────────────────────────────────────+ # Uses --break-system-packages because macOS Sequoia (PEP 668) blocks+ # system-wide pip installs without it.+ - name: Install Qt Installer Framework+ run: |+ pip3 install --break-system-packages aqtinstall+ aqt install-tool mac desktop ${{ env.QT_IFW_TOOL }} \+ --outputdir "${{ runner.temp }}/qtifw"+ IFW_DIR="${{ runner.temp }}/qtifw/Tools/QtInstallerFramework/${{ env.QT_IFW_VERSION }}"+ echo "QT_IFW_DIR=${IFW_DIR}" >> "$GITHUB_ENV"+ echo "PATH=${IFW_DIR}/bin:${PATH}" >> "$GITHUB_ENV"+ echo "QtIFW installed:"+ ls "${IFW_DIR}/bin/" || true++ # ── Configure CMake ───────────────────────────────────────────────────+ - name: Configure CMake+ working-directory: fincept-qt+ run: |+ cmake -B build \+ -G Ninja \+ -DCMAKE_BUILD_TYPE=${{ env.BUILD_TYPE }} \+ -DCMAKE_PREFIX_PATH="${QT_ROOT_DIR}" \+ -DCMAKE_OSX_ARCHITECTURES=arm64 \+ -DCMAKE_C_COMPILER_LAUNCHER=ccache \+ -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \+ -DFINCEPT_BUILD_INSTALLER=ON \+ -DDEPLOY_QT=ON++ # ── Build ─────────────────────────────────────────────────────────────+ - name: Build+ working-directory: fincept-qt+ run: cmake --build build --config ${{ env.BUILD_TYPE }} --parallel $(sysctl -n hw.logicalcpu)++ # ── Verify binary ─────────────────────────────────────────────────────+ - name: Verify binary+ working-directory: fincept-qt+ run: |+ if [ -f "build/${{ env.APP_NAME }}" ]; then+ BINARY="build/${{ env.APP_NAME }}"+ elif [ -f "build/${{ env.APP_NAME }}.app/Contents/MacOS/${{ env.APP_NAME }}" ]; then+ BINARY="build/${{ env.APP_NAME }}.app/Contents/MacOS/${{ env.APP_NAME }}"+ else+ echo "ERROR: binary not found"+ find build -maxdepth 3 -name "${{ env.APP_NAME }}*" || true+ exit 1+ fi+ echo "Binary: $BINARY ($(du -sh "$BINARY" | cut -f1))"+ file "$BINARY"+ lipo -info "$BINARY"++ # ── Package .app bundle (macdeployqt + Python + resources) ────────────+ - name: Package .app bundle+ working-directory: fincept-qt+ run: |+ set -euo pipefail+ MACDEPLOYQT="${QT_ROOT_DIR}/bin/macdeployqt"+ BUILD_DIR="build"+ DIST_DIR="dist"+ mkdir -p "${DIST_DIR}"++ # Locate or create .app bundle+ if [ -d "${BUILD_DIR}/${{ env.APP_NAME }}.app" ]; then+ APP_BUNDLE="${BUILD_DIR}/${{ env.APP_NAME }}.app"+ else+ APP_BUNDLE="${BUILD_DIR}/${{ env.APP_NAME }}.app"+ mkdir -p "${APP_BUNDLE}/Contents/MacOS"+ cp "${BUILD_DIR}/${{ env.APP_NAME }}" "${APP_BUNDLE}/Contents/MacOS/${{ env.APP_NAME }}"+ chmod +x "${APP_BUNDLE}/Contents/MacOS/${{ env.APP_NAME }}"+ cat > "${APP_BUNDLE}/Contents/Info.plist" <<'PLIST'+ <?xml version="1.0" encoding="UTF-8"?>+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">+ <plist version="1.0"><dict>+ <key>CFBundleExecutable</key><string>FinceptTerminal</string>+ <key>CFBundleIdentifier</key><string>in.fincept.terminal</string>+ <key>CFBundleName</key><string>FinceptTerminal</string>+ <key>CFBundlePackageType</key><string>APPL</string>+ <key>CFBundleShortVersionString</key><string>4.0.0</string>+ <key>NSHighResolutionCapable</key><true/>+ </dict></plist>+ PLIST+ fi++ # macdeployqt — bundles all Qt frameworks + plugins + fixes rpaths+ echo "Running macdeployqt..."+ "${MACDEPLOYQT}" "${APP_BUNDLE}" -always-overwrite 2>&1 || true++ # Embed Python 3.12 framework+ PY_PREFIX="$(brew --prefix [email protected] 2>/dev/null || brew --prefix python3)"+ PY_FRAMEWORK="${PY_PREFIX}/Frameworks/Python.framework"+ BUNDLE_FRAMEWORKS="${APP_BUNDLE}/Contents/Frameworks"+ mkdir -p "${BUNDLE_FRAMEWORKS}"+ if [ -d "${PY_FRAMEWORK}" ]; then+ echo "Embedding Python.framework..."+ cp -R "${PY_FRAMEWORK}" "${BUNDLE_FRAMEWORKS}/"+ ln -sf "../Frameworks/Python.framework/Versions/3.12/bin/python3.12" \+ "${APP_BUNDLE}/Contents/MacOS/python3" 2>/dev/null || true+ else+ echo "WARNING: Python.framework not found — skipping embed"+ fi++ # Copy resources and Python analytics scripts+ cp -r resources "${APP_BUNDLE}/Contents/Resources/" 2>/dev/null || true+ cp -r scripts "${APP_BUNDLE}/Contents/Resources/scripts" 2>/dev/null || true++ # Stage to dist/ for CPack / DMG packaging+ cp -r "${APP_BUNDLE}" "${DIST_DIR}/"++ # Diagnostics+ echo "=== Bundle size ===" && du -sh "${DIST_DIR}/${{ env.APP_NAME }}.app"+ echo "=== Qt frameworks ===" && ls "${DIST_DIR}/${{ env.APP_NAME }}.app/Contents/Frameworks/" | grep -i qt || true++ # ── Generate installer via CPack IFW ──────────────────────────────────+ # Falls back to DMG if binarycreator is unavailable.+ - name: Generate Installer+ working-directory: fincept-qt/build+ run: |+ set -euo pipefail+ export PATH="${QT_IFW_DIR}/bin:${PATH}"++ if command -v binarycreator &>/dev/null; then+ echo "Running CPack IFW..."+ cpack -G IFW --verbose+ echo "=== Generated IFW installer ==="+ ls -lh ${{ env.APP_NAME }}-*-setup* 2>/dev/null || ls -lh *.app *.dmg 2>/dev/null || true+ else+ echo "::warning::binarycreator not found — falling back to DMG via hdiutil"+ STAGING="$(mktemp -d)/dmg_staging"+ mkdir -p "${STAGING}"+ cp -r "../dist/${{ env.APP_NAME }}.app" "${STAGING}/"+ hdiutil create \+ -volname "${{ env.APP_NAME }}" \+ -srcfolder "${STAGING}" \+ -ov -format UDZO \+ "${{ env.APP_NAME }}-macOS-arm64.dmg"+ echo "=== Generated DMG ==="+ ls -lh ${{ env.APP_NAME }}-*.dmg+ fi++ # ── Upload installer artifact ─────────────────────────────────────────+ - name: Upload Installer+ uses: actions/upload-artifact@v4+ with:+ name: FinceptTerminal-macOS-arm64-installer+ path: |+ fincept-qt/build/FinceptTerminal-*-setup*+ fincept-qt/build/FinceptTerminal-*.dmg+ retention-days: 30++ # ── Release: attach installer to GitHub Release ──────────────────────────+ release:+ needs: build+ runs-on: ubuntu-latest+ name: Attach macOS Installer to Release+ if: "!cancelled() && needs.build.result == 'success' && startsWith(github.ref, 'refs/tags/')"+ permissions:+ contents: write++ steps:+ - name: Download installer artifact+ uses: actions/download-artifact@v4+ with:+ name: FinceptTerminal-macOS-arm64-installer+ path: installer++ - name: List installer files+ run: find installer -type f | sort++ - name: Attach to GitHub Release+ uses: softprops/action-gh-release@v2+ with:+ tag_name: ${{ github.ref_name }}+ files: installer/**+ fail_on_unmatched_files: falsediff --git a/fincept-qt/CMakeLists.txt b/fincept-qt/CMakeLists.txtindex 5b9759249..cebcd6650 100644--- a/fincept-qt/CMakeLists.txt+++ b/fincept-qt/CMakeLists.txt@@ -89,36 +89,75 @@ endif()include(FetchContent)set(CMAKE_SKIP_INSTALL_RULES TRUE CACHE BOOL "" FORCE)-# ── QXlsx (Excel file I/O) ────────────────────────────────────────────────────-FetchContent_Declare(- QXlsx- GIT_REPOSITORY https://github.com/QtExcel/QXlsx.git- GIT_TAG v1.4.9- SOURCE_SUBDIR QXlsx-)-FetchContent_MakeAvailable(QXlsx)+# ── Qt6::GuiPrivate availability check ───────────────────────────────────────+# QXlsx requires Qt6::GuiPrivate (uses private/qzipreader_p.h internally).+# The official Qt installer (jurplel/install-qt-action, aqtinstall) always+# includes private headers. System Qt packages require an extra package:+# Ubuntu/Debian : sudo apt-get install qt6-base-private-dev+# Fedora : sudo dnf install qt6-qtbase-private-devel+# Arch Linux : qt6-base (private headers included by default)+# macOS Homebrew: included by default+# When private headers are absent, QXlsx is disabled and Excel export shows+# a "not available" message rather than crashing or failing to build.+find_package(Qt6 QUIET COMPONENTS GuiPrivate)+if(Qt6GuiPrivate_FOUND)+ set(FINCEPT_HAS_PRIVATE_HEADERS TRUE)+else()+ set(FINCEPT_HAS_PRIVATE_HEADERS FALSE)+ message(WARNING+ "\n"+ " Qt6::GuiPrivate not found — Excel export (QXlsx) will be disabled.\n"+ " To enable it, install Qt6 private headers:\n"+ " Ubuntu/Debian : sudo apt-get install qt6-base-private-dev\n"+ " Fedora : sudo dnf install qt6-qtbase-private-devel\n"+ " Arch Linux : qt6-base (already includes private headers)\n"+ " macOS Homebrew: already included\n"+ " CI/official : jurplel/install-qt-action always includes them\n"+ )+endif()-# QXlsx uses implicit const char* -> QString conversions which are banned by Qt6's-# strict cast macros. Undefine them for this third-party target only (GCC/Clang: -U,-# MSVC: /U). These macros are set by Qt6's cmake config, not by us globally.-if(MSVC)- target_compile_options(QXlsx PRIVATE- /UQT_NO_CAST_FROM_ASCII /UQT_NO_CAST_FROM_BYTEARRAY- /UQT_NO_CAST_TO_ASCII /UQT_NO_URL_CAST_FROM_STRING+# ── QXlsx (Excel file I/O) ────────────────────────────────────────────────────+# Only fetched and built when Qt6::GuiPrivate is available.+# A stub INTERFACE target is created when unavailable so all+# target_link_libraries(... QXlsx::QXlsx) calls still compile cleanly.+if(FINCEPT_HAS_PRIVATE_HEADERS)+ FetchContent_Declare(+ QXlsx+ GIT_REPOSITORY https://github.com/QtExcel/QXlsx.git+ GIT_TAG 3192b808a283f8eb18c97b9a087bf085054e9bb0 # v1.4.9+ SOURCE_SUBDIR QXlsx+ GIT_SHALLOW TRUE)+ FetchContent_MakeAvailable(QXlsx)++ # QXlsx uses implicit const char* -> QString conversions which are banned+ # by Qt6's strict cast macros. Undefine them for this target only.+ if(MSVC)+ target_compile_options(QXlsx PRIVATE+ /UQT_NO_CAST_FROM_ASCII /UQT_NO_CAST_FROM_BYTEARRAY+ /UQT_NO_CAST_TO_ASCII /UQT_NO_URL_CAST_FROM_STRING+ )+ else()+ target_compile_options(QXlsx PRIVATE+ -UQT_NO_CAST_FROM_ASCII -UQT_NO_CAST_FROM_BYTEARRAY+ -UQT_NO_CAST_TO_ASCII -UQT_NO_URL_CAST_FROM_STRING+ )+ endif()else()- target_compile_options(QXlsx PRIVATE- -UQT_NO_CAST_FROM_ASCII -UQT_NO_CAST_FROM_BYTEARRAY- -UQT_NO_CAST_TO_ASCII -UQT_NO_URL_CAST_FROM_STRING- )+ # Stub target — satisfies target_link_libraries without pulling in QXlsx+ add_library(QXlsx_stub INTERFACE)+ add_library(QXlsx::QXlsx ALIAS QXlsx_stub)endif()+# NOTE: FINCEPT_HAS_QXLSX compile definition is applied to FinceptTerminal+# after add_executable() — see the target_compile_definitions block below.# ── QSimpleUpdater (cross-platform auto-update) ──────────────────────────────set(QSIMPLE_UPDATER_BUILD_TESTS OFF CACHE BOOL "" FORCE)FetchContent_Declare(QSimpleUpdaterGIT_REPOSITORY https://github.com/alex-spataru/QSimpleUpdater.git- GIT_TAG master+ GIT_TAG ff0cb7caae05ef381a09f212b90329ff7b7b9ab9 # master @ 2026-04-11+ GIT_SHALLOW TRUE)FetchContent_MakeAvailable(QSimpleUpdater)# QSimpleUpdater's CMakeLists builds a proper STATIC library target with@@ -128,7 +167,8 @@ FetchContent_MakeAvailable(QSimpleUpdater)FetchContent_Declare(md4cGIT_REPOSITORY https://github.com/mity/md4c.git- GIT_TAG release-0.5.2+ GIT_TAG 729e6b8b320caa96328968ab27d7db2235e4fb47 # release-0.5.2+ GIT_SHALLOW TRUE)FetchContent_MakeAvailable(md4c)# md4c builds md4c (parser) and md4c-html (HTML renderer) as static libs.@@ -155,15 +195,16 @@ endforeach()# ── QGeoView (interactive map widget with OSM tiles) ─────────────────────────# PATCH_COMMAND removes -framework AGL which was deleted in macOS 14 (Sonoma).-# QGeoView's CMakeLists links it unconditionally; we strip it before configure.-# sed -i '' is macOS BSD sed syntax; on Linux sed -i (no argument) is used —-# the || true ensures it is a no-op on platforms where the pattern isn't found.+# Uses a portable CMake script instead of sed (sed is unavailable in MSVC+# Developer Command Prompt on Windows and is fragile across platforms).FetchContent_Declare(QGeoViewGIT_REPOSITORY https://github.com/AmonRaNet/QGeoView.git- GIT_TAG master- PATCH_COMMAND- sed -i.bak "s/AGL//g" <SOURCE_DIR>/lib/CMakeLists.txt || true+ GIT_TAG 4b2c52c80940e1073c259ded1a57df83036ba1c9 # master @ 2026-04-11+ GIT_SHALLOW TRUE+ PATCH_COMMAND ${CMAKE_COMMAND}+ -DFILE=<SOURCE_DIR>/lib/CMakeLists.txt+ -P "${CMAKE_CURRENT_SOURCE_DIR}/cmake/patches/qgeoview_remove_agl.cmake")set(QGV_BUILD_SAMPLES OFF CACHE BOOL "" FORCE)set(QGV_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)@@ -182,7 +223,7 @@ set(QAPPLICATION_CLASS QApplication CACHE STRING "" FORCE)FetchContent_Declare(SingleApplicationGIT_REPOSITORY https://github.com/itay-grudev/SingleApplication.git- GIT_TAG v3.5.4+ GIT_TAG a8da87d78238ac9ac92d2cda41793d4879c188b3 # v3.5.4GIT_SHALLOW TRUEUPDATE_DISCONNECTED TRUE)@@ -200,7 +241,7 @@ set(QT_VERSION_MAJOR 6 CACHE STRING "" FORCE)FetchContent_Declare(QtADSGIT_REPOSITORY https://github.com/githubuser0xFFFF/Qt-Advanced-Docking-System.git- GIT_TAG 4.5.0+ GIT_TAG 87cffe5d40307c61141c88b88c10c5e7d181d880 # 4.5.0GIT_SHALLOW TRUEUPDATE_DISCONNECTED TRUE)@@ -1528,6 +1569,11 @@ if(WIN32)endif()endif()+# ── Optional feature compile definitions (applied after add_executable) ──────+if(FINCEPT_HAS_PRIVATE_HEADERS)+ target_compile_definitions(FinceptTerminal PRIVATE FINCEPT_HAS_QXLSX)+endif()+if(HAS_WEBSOCKETS)target_link_libraries(FinceptTerminal PRIVATE Qt6::WebSockets)target_compile_definitions(FinceptTerminal PRIVATE HAS_QT_WEBSOCKETS)@@ -1842,3 +1888,26 @@ if(FINCEPT_BUILD_INSTALLER)DEPENDS "com.fincept.terminal.core")endif() # FINCEPT_BUILD_INSTALLER++# ── Build configuration summary ──────────────────────────────────────────────+message(STATUS "")+message(STATUS "============================================================")+message(STATUS " Fincept Terminal ${CMAKE_PROJECT_VERSION} — build summary")+message(STATUS "============================================================")+message(STATUS " Qt version : ${Qt6Core_VERSION}")+message(STATUS " Build type : ${CMAKE_BUILD_TYPE}")+message(STATUS " Platform : ${CMAKE_SYSTEM_NAME} ${CMAKE_SYSTEM_PROCESSOR}")+message(STATUS " Compiler : ${CMAKE_CXX_COMPILER_ID} ${CMAKE_CXX_COMPILER_VERSION}")+message(STATUS "------------------------------------------------------------")+message(STATUS " Excel export : ${FINCEPT_HAS_PRIVATE_HEADERS} (Qt6::GuiPrivate / QXlsx)")+if(DEFINED HAS_WEBSOCKETS)+message(STATUS " WebSockets : ${HAS_WEBSOCKETS}")+endif()+if(DEFINED HAS_MULTIMEDIA)+message(STATUS " Multimedia : ${HAS_MULTIMEDIA}")+endif()+if(DEFINED HAS_TTS)+message(STATUS " TextToSpeech : ${HAS_TTS}")+endif()+message(STATUS "============================================================")+message(STATUS "")diff --git a/fincept-qt/cmake/patches/qgeoview_remove_agl.cmake b/fincept-qt/cmake/patches/qgeoview_remove_agl.cmakenew file mode 100644index 000000000..78f20b1c6--- /dev/null+++ b/fincept-qt/cmake/patches/qgeoview_remove_agl.cmake@@ -0,0 +1,41 @@+# qgeoview_remove_agl.cmake+# Portable patch script — removes -framework AGL from QGeoView's CMakeLists.+#+# Background: AGL (Apple OpenGL) framework was removed in macOS 14 (Sonoma).+# QGeoView links it unconditionally in lib/CMakeLists.txt which causes a+# linker error on macOS 14+: ld: framework 'AGL' not found+#+# This script is invoked via PATCH_COMMAND in FetchContent_Declare:+# PATCH_COMMAND ${CMAKE_COMMAND} -DFILE=<SOURCE_DIR>/lib/CMakeLists.txt+# -P .../qgeoview_remove_agl.cmake+#+# It uses only CMake built-ins so it works identically on Windows, macOS, Linux.++if(NOT DEFINED FILE)+ message(FATAL_ERROR "qgeoview_remove_agl.cmake: FILE variable not set")+endif()++if(NOT EXISTS "${FILE}")+ message(STATUS "qgeoview_remove_agl: ${FILE} not found — skipping patch")+ return()+endif()++file(READ "${FILE}" _content)++# Check if AGL is present before patching (idempotent — safe to run twice)+string(FIND "${_content}" "AGL" _agl_pos)+if(_agl_pos EQUAL -1)+ message(STATUS "qgeoview_remove_agl: AGL not found in ${FILE} — already patched or not needed")+ return()+endif()++# Remove all occurrences of AGL framework reference forms:+# -framework AGL (common CMakeLists form)+# AGL (bare token in a list)+string(REPLACE "-framework AGL" "" _content "${_content}")+string(REPLACE " AGL " " " _content "${_content}")+string(REPLACE "\nAGL\n" "\n" _content "${_content}")+string(REPLACE "(AGL)" "()" _content "${_content}")++file(WRITE "${FILE}" "${_content}")+message(STATUS "qgeoview_remove_agl: patched ${FILE} — removed AGL framework reference")diff --git a/fincept-qt/src/screens/excel/ExcelScreen.cpp b/fincept-qt/src/screens/excel/ExcelScreen.cppindex 3279fa954..367fae211 100644--- a/fincept-qt/src/screens/excel/ExcelScreen.cpp+++ b/fincept-qt/src/screens/excel/ExcelScreen.cpp@@ -16,7 +16,9 @@#include <QTabBar>#include <QVBoxLayout>+#ifdef FINCEPT_HAS_QXLSX#include <xlsxdocument.h>+#endifnamespace fincept::screens {@@ -190,6 +192,7 @@ void ExcelScreen::on_import() {if (path.isEmpty())return;+#ifdef FINCEPT_HAS_QXLSXQXlsx::Document xlsx(path);QStringList sheet_names = xlsx.sheetNames();if (sheet_names.isEmpty()) {@@ -240,6 +243,12 @@ void ExcelScreen::on_import() {// Register with File Manager so it appears in the Files tabservices::FileManagerService::instance().import_file(path, "excel");+#else+ QMessageBox::information(this, "Excel Import",+ "Excel (.xlsx) import requires Qt6 private headers.\n"+ "This build was compiled without QXlsx support.\n\n"+ "CSV files can still be imported via the toolbar.");+#endif}// ─────────────────────────────────────────────────────────────────────────────@@ -247,6 +256,7 @@ void ExcelScreen::on_import() {// ─────────────────────────────────────────────────────────────────────────────void ExcelScreen::on_export() {+#ifdef FINCEPT_HAS_QXLSXQString path = QFileDialog::getSaveFileName(this, "Export as XLSX", file_name_, "Excel Files (*.xlsx)");if (path.isEmpty())return;@@ -300,6 +310,12 @@ void ExcelScreen::on_export() {} else {LOG_ERROR("ExcelScreen", "Failed to save XLSX file");}+#else+ QMessageBox::information(this, "Excel Export",+ "Excel (.xlsx) export requires Qt6 private headers.\n"+ "This build was compiled without QXlsx support.\n\n"+ "CSV export is still available via the toolbar.");+#endif}// ─────────────────────────────────────────────────────────────────────────────