From aabf0fc80fde069ea39f5775aea781d567ef8961 Mon Sep 17 00:00:00 2001
From: Colin Delahunty <72827203+colin99d@users.noreply.github.com>
Date: Wed, 29 Mar 2023 12:01:19 -0400
Subject: [PATCH] Feature/pkginstall (#4341)
* Added basic package building stuff
* Full mock 1
* Got the thing working Part 1
* Added some signing
* Got things working
* Starting M1 CI
* Got things looking better
* Made a fix to env vars
* Switched to correct env
* Made developer installation
* Updates
* More updates
* Trying again
* GOt things fixed
* GOt things fixed
* GOt things fixed
* GOt things fixed
* GOt things fixed
* GOt things fixed
* Trying to get signing to work
* Did some cleanup
* Did some cleanup
* Added fixes
* Fixed issues
* Updated Jereon library
* Updated Jereon library
* Remove temp fix
* Remove temp fix
* Updated things
* Added fixes
* Made one fix
* Added fixes
* Trying an ACTION
* Final fix
* Final fix
* Final fix
* More fixes
* Made small changes
* Made small changes
* Lets see how far we get
* Updated output format
* Trying to get signing to work
* Trying to get signing to work
* Trying to get signing to work
* Improved the command
* Added fixes
* Pls work
* Theo is a GOAT
* THeo is the BIGGEST GOAT
* Got more ready
* Maybe intel works now
* Renamed to correct thing
* Renamed to correct thing
* Updated singing
* Updated singing
* Added fix
* Added fix
* Added fix
* Cleaned some stuff
* Cleaned some stuff
* Cleaned some stuff
* Cleaned some stuff
* Cleaned some stuff
* Cleaned some stuff
* Cleaned some stuff
* Added fix
* Added fix
* Added fix
* Added fix
* Added fix
* Added fix
* Added fix
* Addede icon generation to CI
* Addede icon generation to CI
* Addede icon generation to CI
* Fixed
* Fixed
* Fixed
* Fixed
* Fixed
* Update macos_build.yml
* Update macos_build.yml
* Fixed
* Fixed
* Fixed
---
.github/workflows/intel_macos_build.yml | 200 ----------------
.github/workflows/m1_macos_build.yml | 205 -----------------
.github/workflows/macos_build.yml | 155 +++++++++++++
build/pyinstaller/build4mac.sh | 42 +---
build/pyinstaller/macOS/.gitignore | 1 +
build/pyinstaller/macOS/build-macos.sh | 215 ++++++++++++++++++
build/pyinstaller/macOS/darwin/Distribution | 36 +++
.../macOS/darwin/Resources/LICENSE.txt | 21 ++
.../darwin/Resources/background-light.png | Bin 0 -> 239891 bytes
.../macOS/darwin/Resources/background.png | Bin 0 -> 885357 bytes
.../macOS/darwin/Resources/banner.png | Bin 0 -> 14337 bytes
.../macOS/darwin/Resources/conclusion.html | 35 +++
.../macOS/darwin/Resources/uninstall.sh | 73 ++++++
.../macOS/darwin/Resources/welcome.html | 14 ++
.../macOS/darwin/scripts/postinstall | 3 +
.../OpenBB Terminal/OpenBB Terminal | 7 +-
16 files changed, 559 insertions(+), 448 deletions(-)
delete mode 100644 .github/workflows/intel_macos_build.yml
delete mode 100644 .github/workflows/m1_macos_build.yml
create mode 100644 .github/workflows/macos_build.yml
create mode 100644 build/pyinstaller/macOS/.gitignore
create mode 100755 build/pyinstaller/macOS/build-macos.sh
create mode 100644 build/pyinstaller/macOS/darwin/Distribution
create mode 100644 build/pyinstaller/macOS/darwin/Resources/LICENSE.txt
create mode 100644 build/pyinstaller/macOS/darwin/Resources/background-light.png
create mode 100644 build/pyinstaller/macOS/darwin/Resources/background.png
create mode 100644 build/pyinstaller/macOS/darwin/Resources/banner.png
create mode 100644 build/pyinstaller/macOS/darwin/Resources/conclusion.html
create mode 100644 build/pyinstaller/macOS/darwin/Resources/uninstall.sh
create mode 100644 build/pyinstaller/macOS/darwin/Resources/welcome.html
create mode 100644 build/pyinstaller/macOS/darwin/scripts/postinstall
diff --git a/.github/workflows/intel_macos_build.yml b/.github/workflows/intel_macos_build.yml
deleted file mode 100644
index fc1def70762..00000000000
--- a/.github/workflows/intel_macos_build.yml
+++ /dev/null
@@ -1,200 +0,0 @@
-name: Intel MacOS Build
-
-env:
- OPENBB_ENABLE_QUICK_EXIT: true
- OPENBB_LOG_COLLECT: false
- OPENBB_USE_ION: false
- OPENBB_USE_PROMPT_TOOLKIT: false
- OPENBB_FILE_OVERWRITE: true
- PIP_DEFAULT_TIMEOUT: 100
- PYTHONNOUSERSITE: 1
-
-on: workflow_dispatch
-
-concurrency:
- group: ${{ github.workflow }}-${{ github.ref }}
- cancel-in-progress: true
-
-jobs:
- Build:
- name: Intel MacOS Build
- runs-on: [self-hosted, macos, x64]
- steps:
- # Checkout repository main branch. this allows for the commit hashes to line up
- - name: Checkout
- uses: actions/checkout@v3
- - name: Git Log
- run: git log
- # Install create-dmg
- - name: Install create-dmg
- run: brew install create-dmg
- # The following commands to clear previous PATHS and restore to defaults since we have to maintain the instance ourselves
- - name: Clean Previous Path
- run: |
- export PATH=""
- export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
- echo $PATH
- # Set up caching for conda env so that the workflow runs quickly after the first time
- - name: Setup Conda Caching
- uses: actions/cache@v3
- with:
- path: ~/conda_pkgs_dir
- key: conda-macos-3-9-${{ hashFiles('build/conda/conda-3-9-env-full.yaml') }}
- # Set up miniconda using the environment yaml file within the repo
- - name: Setup Miniconda
- uses: conda-incubator/setup-miniconda@v2.2.0
- with:
- miniconda-version: "latest"
- auto-update-conda: true
- channels: conda-forge,defaults
- show-channel-urls: true
- channel-priority: flexible
- environment-file: build/conda/conda-3-9-env-full.yaml
- activate-environment: build_env
- use-only-tar-bz2: true # Needed for caching some reason
- - name: Install requirements
- run: |
- pip list
- python -m pip install -r requirements-full.txt
- - name: Install Specific Papermill
- run: |
- pip list
- pip uninstall papermill -y
- pip install git+https://github.com/nteract/papermill.git@main
- # This is basically the same as build4mac.sh
- - name: Build Bundle
- run: |
- pip list
- python -m PyInstaller build/pyinstaller/terminal.spec --clean
- osascript build/pyinstaller/setup_icons.applescript
- mkdir DMG
- cp -r build/pyinstaller/macOS_package_assets/* DMG/
- mv dist/OpenBBTerminal DMG/OpenBB\ Terminal/.OpenBB
- - name: Creating Keychain
- env:
- MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
- MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
- MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: | # when pushing to main, make to generate new cert, and utilize secrets to store new password, and identity
- echo "Decoding"
- echo $MACOS_CERTIFICATE | base64 --decode > certificate.p12
- echo "Creating Keychain"
- security create-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
- echo "Setting Default Keychain"
- security default-keychain -s build.keychain
- echo "Unlocking Keychain"
- security unlock-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
- echo "Importing Keychain"
- security import certificate.p12 -k build.keychain -P $MACOS_CERTIFICATE_PWD -T /usr/bin/codesign
- echo "Setting Partition List"
- security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k $MACOS_KEYCHAIN_PWD build.keychain
- - name: Codesign Specific Binaries
- env:
- MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
- MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
- MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: |
- echo "Code Signing SO Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*/*.so
- echo "Code Signing DYLIB Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/stan/lib/stan_math/lib/tbb/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/sklearn/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/scipy/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/xgboost/.dylibs/*.dylib
-
- echo "Code Signing Other Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/prophet_model.bin
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/diagnose
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/print
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stanc
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stansummary
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/pyarrow/plasma-store-server
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/protoc
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/protoc-3.13.0.0
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/torch_shm_manager
- echo "Code Sign OpenBB Executable File"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/OpenBBTerminal
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/OpenBBPlotsBackend
- - name: Create DMG
- run: create-dmg --volname "OpenBB Terminal" --volicon "images/dmg_volume.icns" --background "images/openbb_dmg_background.png" --icon "OpenBB Terminal" 190 250 --window-pos 190 120 --window-size 800 400 --icon-size 100 --text-size 14 --app-drop-link 600 250 --eula LICENSE --format UDZO --no-internet-enable "OpenBB Terminal".dmg DMG
- - name: Code Sign DMG Installer
- env:
- MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
- MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
- MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: |
- echo "Code Signing DMG Installer"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY OpenBB\ Terminal.dmg
- echo "Verify Signing"
- codesign --verify --deep --strict --verbose=2 OpenBB\ Terminal.dmg
- - name: Deleting Previous Keychain
- run: |
- echo "Deleting Previous Keychain to Clean Instance"
- rm -rf /Users/openbb/Library/Keychains/build.keychain-db
- - name: Clean up Build Artifacts
- run: |
- rm -rf build/terminal
- rm -rf dist
- rm -rf DMG
- - name: Notarize DMG
- env:
- NOTARIZE_APPLE_ID: ${{ secrets.NOTARIZE_APPLE_ID }}
- NOTARIZE_APPLE_PWD: ${{ secrets.NOTARIZE_APPLE_PWD }}
- NOTARIZE_APPLE_TEAM_ID: ${{ secrets.NOTARIZE_APPLE_TEAM_ID }}
- run: |
- xcrun notarytool submit OpenBB\ Terminal.dmg --apple-id "$NOTARIZE_APPLE_ID" --password "$NOTARIZE_APPLE_PWD" --team-id "$NOTARIZE_APPLE_TEAM_ID" --wait
- - name: Staple
- run: |
- xcrun stapler staple "OpenBB Terminal.dmg"
- - name: Save Build Artifact DMG
- uses: actions/upload-artifact@v3
- with:
- name: Intel MacOS DMG Artifact
- path: OpenBB\ Terminal.dmg
- - name: Convert & Mount DMG
- run: | # Remove the converting disc image at the end
- hdiutil convert OpenBB\ Terminal.dmg -format UDTO -o openbbterminal.cdr
- hdiutil attach openbbterminal.cdr
- rm -rf openbbterminal.cdr
- - name: Directory Change
- run: |
- cd
- cd /Volumes/OpenBB\ Terminal
- ls
- cp -R OpenBB\ Terminal ~/Desktop
- - name: Unmount DMG
- run: hdiutil detach /dev/disk2
-
- - name: Run Integration Tests
- run: |
- /Users/openbb/Desktop/OpenBB\ Terminal/.OpenBB/OpenBBTerminal -t -s forecast cryptocurrency reports alternative economy futures econometrics dashboards portfolio stocks/test_stocks_options_screen.openbb stocks/test_stocks_options.openbb forex etf stocks/test_stocks_fa.openbb > result.txt
- cat result.txt
- grep "================================ integration test summary ================================" result.txt -A100 | tail --bytes=2000 > failed_tests.txt
-
- - name: Upload summary to Slack
- uses: adrey/slack-file-upload-action@master
- with:
- token: ${{ secrets.SLACK_API_TOKEN }}
- initial_comment: "Intel MacOs Build Integration test summary"
- title: "Intel MacOs Build Integration test summary"
- path: failed_tests.txt
- channel: ${{ secrets.SLACK_CHANNEL_ID }}
-
- - name: Remove OpenBB Folder
- run: rm -rf /Users/openbb/Desktop/OpenBB\ Terminal
- - name: Remove OpenBB Exports Folder
- run: rm -rf ~/Desktop/OPENBB-exports
diff --git a/.github/workflows/m1_macos_build.yml b/.github/workflows/m1_macos_build.yml
deleted file mode 100644
index cb30f0b39d1..00000000000
--- a/.github/workflows/m1_macos_build.yml
+++ /dev/null
@@ -1,205 +0,0 @@
-name: M1 MacOS Build
-
-env:
- OPENBB_ENABLE_QUICK_EXIT: true
- OPENBB_LOG_COLLECT: false
- OPENBB_USE_ION: false
- OPENBB_USE_PROMPT_TOOLKIT: false
- OPENBB_FILE_OVERWRITE: true
- PIP_DEFAULT_TIMEOUT: 100
- PYTHONNOUSERSITE: 1
-
-on: workflow_dispatch
-
-concurrency:
- group: ${{ github.workflow }}-${{ github.ref }}
- cancel-in-progress: true
-
-jobs:
- Build:
- name: M1 MacOS Build
- runs-on: [self-hosted, macos, ARM64]
- steps:
- # Checkout repository main branch. this allows for the commit hashes to line up
- - name: Checkout
- uses: actions/checkout@v3
- - name: Git Log
- run: git log
- # Install create-dmg
- - name: Install create-dmg
- run: brew install create-dmg
- # The following commands to clear previous PATHS and restore to defaults since we have to maintain the instance ourselves
- - name: Clean Previous Path
- run: |
- export PATH=""
- export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
- echo $PATH
- # Set up caching for conda env so that the workflow runs quickly after the first time
- - name: Setup Conda Caching
- uses: actions/cache@v3
- with:
- path: ~/conda_pkgs_dir
- key: conda-macos-3-9-${{ hashFiles('build/conda/conda-3-9-env-full.yaml') }}
- # Set up miniconda using the environment yaml file within the repo
- - name: Setup Miniconda
- uses: conda-incubator/setup-miniconda@v2.2.0
- with:
- miniconda-version: "latest"
- auto-update-conda: true
- channels: conda-forge,defaults
- show-channel-urls: true
- channel-priority: flexible
- environment-file: build/conda/conda-3-9-env-full.yaml
- activate-environment: build_env
- auto-activate-base: false
- use-only-tar-bz2: true # Needed for caching some reason
-
- - name: Run Poetry
- run: |
- pip list
- python -m pip install -r requirements-full.txt
-
- - name: Install Specific Papermill
- run: |
- pip uninstall papermill -y
- pip install git+https://github.com/nteract/papermill.git@main
-
- # This is basically the same as build4mac.sh
- - name: Build Bundle
- run: |
- python -m PyInstaller build/pyinstaller/terminal.spec --clean
- osascript build/pyinstaller/setup_icons.applescript
- mkdir DMG
- cp -r build/pyinstaller/macOS_package_assets/* DMG/
- mv dist/OpenBBTerminal DMG/OpenBB\ Terminal/.OpenBB
- - name: Creating Keychain
- env:
- MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
- MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
- MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: | # when pushing to main, make to generate new cert, and utilize secrets to store new password, and identity
- echo "Ensuring Keychain with same name does not exist"
- rm -rf /Users/openbb/Library/Keychains/build.keychain-db
- echo "Decoding certificate"
- echo $MACOS_CERTIFICATE | base64 --decode > certificate.p12
- echo "Creating Keychain"
- security create-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
- echo "Setting Default Keychain"
- security default-keychain -s build.keychain
- echo "Unlocking Keychain"
- security unlock-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
- echo "Importing Keychain"
- security import certificate.p12 -k build.keychain -P $MACOS_CERTIFICATE_PWD -T /usr/bin/codesign
- echo "Setting Partition List"
- security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k $MACOS_KEYCHAIN_PWD build.keychain
- - name: Codesign Specific Binaries
- env:
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: |
- echo "Code Signing SO Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.so
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*/*.so
- echo "Code Signing DYLIB Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/stan/lib/stan_math/lib/tbb/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/sklearn/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/scipy/.dylibs/*.dylib
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/xgboost/.dylibs/*.dylib
- echo "Code Signing Other Files"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/prophet_model.bin
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/diagnose
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/print
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stanc
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stansummary
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/pyarrow/plasma-store-server
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/protoc
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/protoc-3.13.0.0
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/torch/bin/torch_shm_manager
- echo "Code Sign OpenBB Executable File"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/OpenBBTerminal
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY DMG/OpenBB\ Terminal/.OpenBB/OpenBBPlotsBackend
- - name: Create DMG
- run: create-dmg --volname "OpenBB Terminal" --volicon "images/dmg_volume.icns" --background "images/openbb_dmg_background.png" --icon "OpenBB Terminal" 190 250 --window-pos 190 120 --window-size 800 400 --icon-size 100 --text-size 14 --app-drop-link 600 250 --eula LICENSE --format UDZO --no-internet-enable "OpenBB Terminal".dmg DMG
- - name: Code Sign DMG Installer
- env:
- MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
- MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
- MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
- MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
- run: |
- echo "Code Signing DMG Installer"
- /usr/bin/codesign --deep --force --verify --verbose --options runtime --entitlements "build/pyinstaller/entitlements.plist" -s $MACOS_CODESIGN_IDENTITY OpenBB\ Terminal.dmg
- echo "Verify Signing"
- codesign --verify --deep --strict --verbose=2 OpenBB\ Terminal.dmg
- - name: Deleting Previous Keychain
- run: |
- echo "Deleting Previous Keychain to Clean Instance"
- rm -rf /Users/openbb/Library/Keychains/build.keychain-db
- - name: Clean up Build Artifacts
- run: |
- rm -rf build/terminal
- rm -rf dist
- rm -rf DMG
- - name: Notorize DMG
- env:
- NOTARIZE_APPLE_ID: ${{ secrets.NOTARIZE_APPLE_ID }}
- NOTARIZE_APPLE_PWD: ${{ secrets.NOTARIZE_APPLE_PWD }}
- NOTARIZE_APPLE_TEAM_ID: ${{ secrets.NOTARIZE_APPLE_TEAM_ID }}
- run: |
- xcrun notarytool submit OpenBB\ Terminal.dmg --apple-id "$NOTARIZE_APPLE_ID" --password "$NOTARIZE_APPLE_PWD" --team-id "$NOTARIZE_APPLE_TEAM_ID" --wait
- - name: Staple
- run: |
- xcrun stapler staple "OpenBB Terminal.dmg"
- - name: Clean up Build Artifacts
- run: |
- rm -rf build/terminal
- rm -rf dist
- rm -rf DMG
- - name: Save Build Artifact DMG
- uses: actions/upload-artifact@v3
- with:
- name: M1 MacOS DMG Artifact
- path: OpenBB\ Terminal.dmg
- - name: Convert & Mount DMG
- run: |
- hdiutil convert OpenBB\ Terminal.dmg -format UDTO -o openbbterminal.cdr
- hdiutil attach openbbterminal.cdr
- rm -rf openbbterminal.cdr
- - name: Directory Change
- run: |
- cd
- cd /Volumes/OpenBB\ Terminal
- ls
- cp -R OpenBB\ Terminal ~/Desktop
- - name: Unmount DMG
- run: hdiutil detach /dev/disk4
-
- - name: Run Integration Tests
- run: |
- /Users/openbb/Desktop/OpenBB\ Terminal/.OpenBB/OpenBBTerminal -t -s forecast cryptocurrency reports alternative economy futures econometrics dashboards portfolio stocks/test_stocks_options_screen.openbb stocks/test_stocks_options.openbb forex etf stocks/test_stocks_fa.openbb > result.txt
- cat result.txt
- grep "================================ integration test summary ================================" result.txt -A100 | tail --bytes=2000 > failed_tests.txt
-
- - name: Upload summary to Slack
- uses: adrey/slack-file-upload-action@master
- with:
- token: ${{ secrets.SLACK_API_TOKEN }}
- initial_comment: "M1 MacOs Build Integration test summary"
- title: "M1 MacOs Build Integration test summary"
- path: failed_tests.txt
- channel: ${{ secrets.SLACK_CHANNEL_ID }}
-
- - name: Remove OpenBB Folder
- run: rm -rf /Users/openbb/Desktop/OpenBB\ Terminal
- - name: Remove OpenBB Exports Folder
- run: rm -rf ~/Desktop/OPENBB-exports
diff --git a/.github/workflows/macos_build.yml b/.github/workflows/macos_build.yml
new file mode 100644
index 00000000000..8543f9ebe0e
--- /dev/null
+++ b/.github/workflows/macos_build.yml
@@ -0,0 +1,155 @@
+name: MacOS Build
+
+env:
+ OPENBB_ENABLE_QUICK_EXIT: true
+ OPENBB_LOG_COLLECT: false
+ OPENBB_USE_ION: false
+ OPENBB_USE_PROMPT_TOOLKIT: false
+ OPENBB_FILE_OVERWRITE: true
+ PIP_DEFAULT_TIMEOUT: 100
+ PYTHONNOUSERSITE: 1
+
+on: workflow_dispatch
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ Build:
+ name: MacOS Build
+ runs-on: ${{ matrix.items.os }}
+ strategy:
+ matrix:
+ items: [
+ {os: [self-hosted, macos, ARM64], name: "OpenBBM1.pkg"},
+ {os: [self-hosted, macos, x64], name: "OpenBBIntel.pkg"}
+ ]
+ steps:
+ # Checkout repository main branch. this allows for the commit hashes to line up
+ - name: Checkout
+ uses: actions/checkout@v3
+ - name: Git Log
+ run: git log
+ # The following commands to clear previous PATHS and restore to defaults since we have to maintain the instance ourselves
+ - name: Clean Previous Path
+ run: |
+ export PATH=""
+ export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+ echo $PATH
+ # Set up caching for conda env so that the workflow runs quickly after the first time
+ - name: Setup Conda Caching
+ uses: actions/cache@v3
+ with:
+ path: ~/conda_pkgs_dir
+ key: conda-macos-3-9-${{ hashFiles('build/conda/conda-3-9-env-full.yaml') }}
+ # Set up miniconda using the environment yaml file within the repo
+ - name: Setup Miniconda
+ uses: conda-incubator/setup-miniconda@v2.2.0
+ with:
+ miniconda-version: "latest"
+ auto-update-conda: true
+ channels: conda-forge,defaults
+ show-channel-urls: true
+ channel-priority: flexible
+ environment-file: build/conda/conda-3-9-env-full.yaml
+ activate-environment: build_env
+ auto-activate-base: false
+ use-only-tar-bz2: true # Needed for caching some reason
+
+ - name: Install Dependencies
+ run: |
+ pip list
+ python -m pip install -r requirements-full.txt
+ pip install openbb
+
+ - name: Build Bundle
+ run: build/pyinstaller/build4mac.sh
+ shell: bash
+ - name: Creating Application Keychain
+ env:
+ MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE }}
+ MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
+ MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
+ MACOS_CODESIGN_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
+ run: | # when pushing to main, make to generate new cert, and utilize secrets to store new password, and identity
+ echo "Ensuring Keychain with same name does not exist"
+ rm -rf /Users/openbb/Library/Keychains/build.keychain-db
+ echo "Decoding certificate"
+ echo $MACOS_CERTIFICATE | base64 --decode > certificate.p12
+ echo "Creating Keychain"
+ security create-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
+ echo "Setting Default Keychain"
+ security default-keychain -s build.keychain
+ echo "Unlocking Keychain"
+ security unlock-keychain -p $MACOS_KEYCHAIN_PWD build.keychain
+ echo "Importing Keychain"
+ security import certificate.p12 -k build.keychain -P $MACOS_CERTIFICATE_PWD -T /usr/bin/codesign
+ echo "Setting Partition List"
+ security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k $MACOS_KEYCHAIN_PWD build.keychain
+ - name: Create Signed Package
+ env:
+ APPLE_DEVELOPER_CERTIFICATE_ID: ${{ secrets.MACOS_INSTALLER_CODESIGN_IDENTITY }}
+ MACOS_CERTIFICATE_PWD: ${{ secrets.MACOS_CERTIFICATE_PWD }}
+ MACOS_KEYCHAIN_PWD: ${{ secrets.MACOS_KEYCHAIN_PWD }}
+ MACOS_INSTALLER_KEYCHAIN_PWD: ${{ secrets.MACOS_INSTALLER_KEYCHAIN_PWD }}
+ APPLE_SIGNING_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }}
+ run: |
+ security unlock-keychain -p $MACOS_INSTALLER_KEYCHAIN_PWD install.keychain
+ build/pyinstaller/macOS/build-macos.sh OpenBBTerminal 0.0.1
+ mv build/pyinstaller/macOS/target/pkg/OpenBBTerminalM1.pkg OpenBBTerminalM1.pkg
+ shell: bash
+ - name: Deleting Previous Keychain
+ run: |
+ echo "Deleting Previous Keychain to Clean Instance"
+ rm -rf /Users/openbb/Library/Keychains/build.keychain-db
+ - name: Clean up Build Artifacts
+ run: |
+ rm -rf build/terminal
+ rm -rf dist
+ rm -rf DMG
+ - name: Notorize DMG
+ env:
+ NOTARIZE_APPLE_ID: ${{ secrets.NOTARIZE_APPLE_ID }}
+ NOTARIZE_APPLE_PWD: ${{ secrets.NOTARIZE_APPLE_PWD }}
+ NOTARIZE_APPLE_TEAM_ID: ${{ secrets.NOTARIZE_APPLE_TEAM_ID }}
+ run: |
+ xcrun notarytool submit OpenBBTerminalM1.pkg --apple-id "$NOTARIZE_APPLE_ID" --password "$NOTARIZE_APPLE_PWD" --team-id "$NOTARIZE_APPLE_TEAM_ID" --wait
+ - name: Staple
+ run: |
+ xcrun stapler staple OpenBBTerminalM1.pkg
+ - name: Clean up Build Artifacts
+ run: |
+ rm -rf build/terminal
+ rm -rf dist
+ rm -rf DMG
+ - name: Save Build Artifact PKG
+ uses: actions/upload-artifact@v3
+ with:
+ name: ${{ matrix.items.name }}
+ path: OpenBBTerminalM1.pkg
+ - name: Get contents from PkgUtil
+ run: |
+ pkgutil --expand-full OpenBBTerminalM1.pkg extract/
+ rm -rf OpenBBTerminalM1.pkg
+
+ - name: Run Integration Tests
+ run: |
+ extract/OpenBBTerminal.pkg/Payload/Applications/OpenBB\ Terminal/.OpenBB/OpenBBTerminal -t -s forecast cryptocurrency reports alternative economy futures econometrics dashboards portfolio stocks/test_stocks_options_screen.openbb stocks/test_stocks_options.openbb forex etf stocks/test_stocks_fa.openbb > result.txt
+ cat result.txt
+ grep "================================ integration test summary ================================" result.txt -A100 | tail --bytes=2000 > failed_tests.txt
+
+ - name: Upload summary to Slack
+ uses: adrey/slack-file-upload-action@master
+ with:
+ token: ${{ secrets.SLACK_API_TOKEN }}
+ initial_comment: "M1 MacOs Build Integration test summary"
+ title: "M1 MacOs Build Integration test summary"
+ path: failed_tests.txt
+ channel: ${{ secrets.SLACK_CHANNEL_ID }}
+
+ - name: Remove OpenBB Folder
+ run: |
+ rm -rf /Users/openbb/Desktop/OpenBB\ Terminal
+ rm -rf ~/Desktop/OPENBB-exports
+ rm -rf extract/
diff --git a/build/pyinstaller/build4mac.sh b/build/pyinstaller/build4mac.sh
index bb8ed69c1b4..5f6758be10f 100755
--- a/build/pyinstaller/build4mac.sh
+++ b/build/pyinstaller/build4mac.sh
@@ -1,6 +1,8 @@
#!/bin/bash
DISK_IMAGE_NAME="OpenBB Terminal"
+SCRIPTPATH="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd -P )"
+BUNDLER_PATH="$SCRIPTPATH/macOS/build-macos.sh"
# exit when any command fails
set -e
@@ -12,7 +14,7 @@ rm -rf build/terminal && rm -rf dist && rm -rf DMG
rm -rf openbb_terminal/logs
# Running build
-pyinstaller build/pyinstaller/terminal.spec --clean
+pyinstaller build/pyinstaller/terminal.spec # --clean
# Assign icons to the built folder and launcher
osascript build/pyinstaller/setup_icons.applescript
@@ -23,41 +25,3 @@ mkdir DMG
# Copy relevant artifacts to the packaging folder
cp -r build/pyinstaller/macOS_package_assets/* DMG/
mv dist/OpenBBTerminal DMG/"$DISK_IMAGE_NAME"/.OpenBB
-
-osascript build/pyinstaller/setup_icons_post.applescript
-
-# Create a DMG with create-dmg
-#
-# NOTE:
-# Code signing and notarization requires adding the following:
-#
-# --codesign "Common name of the Developer certificate"
-# --format UDIF
-# --notarize "Notarization identity " see:
-# https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution/customizing_the_notarization_workflow
-
-if ! command -v create-dmg &> /dev/null
-then
- echo "create could not be found"
- echo "install create-dmg from brew or github"
- exit
-fi
-
-create-dmg \
- --volname "OpenBB Terminal" \
- --volicon "images/dmg_volume.icns" \
- --background "images/openbb_dmg_background.png" \
- --icon "OpenBB Terminal" 190 250 \
- --window-pos 190 120 \
- --window-size 800 400 \
- --icon-size 100 \
- --text-size 14 \
- --app-drop-link 600 250 \
- --eula LICENSE \
- --format UDZO \
- --no-internet-enable \
- "OpenBB Terminal".dmg DMG
-
-
-# Clean Up artifacts from this build
-rm -rf build/terminal && rm -rf dist && rm -rf DMG
diff --git a/build/pyinstaller/macOS/.gitignore b/build/pyinstaller/macOS/.gitignore
new file mode 100644
index 00000000000..2f7896d1d13
--- /dev/null
+++ b/build/pyinstaller/macOS/.gitignore
@@ -0,0 +1 @@
+target/
diff --git a/build/pyinstaller/macOS/build-macos.sh b/build/pyinstaller/macOS/build-macos.sh
new file mode 100755
index 00000000000..2a29a422523
--- /dev/null
+++ b/build/pyinstaller/macOS/build-macos.sh
@@ -0,0 +1,215 @@
+#!/bin/bash
+
+#Parameters
+SCRIPTPATH="$( cd -- "$(dirname "$0")" >/dev/null 2>&1 ; pwd -P )"
+TARGET_DIRECTORY="$SCRIPTPATH/target"
+BASE_DIRECTORY="$( cd -- "$(dirname "$1")" >/dev/null 2>&1 ; pwd -P )"
+APP_DIRECTORY="$BASE_DIRECTORY/DMG/OpenBB Terminal"
+BINARIES="$BASE_DIRECTORY/DMG/OpenBB\ Terminal/.OpenBB"
+ENTITLEMENTS="$BASE_DIRECTORY/build/pyinstaller/entitlements.plist"
+PRODUCT=${1}
+VERSION=${2}
+DATE=`date +%Y-%m-%d`
+TIME=`date +%H:%M:%S`
+LOG_PREFIX="[$DATE $TIME]"
+
+
+function printUsage() {
+ echo -e "\033[1mUsage:\033[0m"
+ echo "$0 [APPLICATION_NAME] [APPLICATION_VERSION]"
+ echo
+ echo -e "\033[1mOptions:\033[0m"
+ echo " -h (--help)"
+ echo
+ echo -e "\033[1mExample::\033[0m"
+ echo "$0 openbbpro 0.0.1"
+
+}
+
+#Argument validation
+if [ -z "$APPLE_DEVELOPER_CERTIFICATE_ID" ]; then
+ echo "APPLE_DEVELOPER_CERTIFICATE_ID environment variable is not set"
+ echo "Please run 'security find-identity -v', and then use the value for"
+ echo "the developer ID Installer (and NOT the Developer ID Application)"
+ exit 1
+fi
+if [[ "$1" == "-h" || "$1" == "--help" ]]; then
+ printUsage
+ exit 1
+fi
+if [ -z "$1" ]; then
+ echo "Please enter a valid application name for your application"
+ echo
+ printUsage
+ exit 1
+else
+ echo "Application Name : $1"
+fi
+if [[ "$2" =~ [0-9]+.[0-9]+.[0-9]+ ]]; then
+ echo "Application Version : $2"
+else
+ echo "Please enter a valid version for your application (format [0-9].[0-9].[0-9])"
+ echo
+ printUsage
+ exit 1
+fi
+if [ -z "$APPLE_SIGNING_IDENTITY" ]; then
+ echo "Please set the APPLE_SIGNING_IDENTITY environment variable"
+ exit 1
+fi
+
+#Functions
+go_to_dir() {
+ pushd $1 >/dev/null 2>&1
+}
+
+log_info() {
+ echo "${LOG_PREFIX}[INFO]" $1
+}
+
+log_warn() {
+ echo "${LOG_PREFIX}[WARN]" $1
+}
+
+log_error() {
+ echo "${LOG_PREFIX}[ERROR]" $1
+}
+
+deleteInstallationDirectory() {
+ log_info "Cleaning $TARGET_DIRECTORY directory."
+ rm -rf "$TARGET_DIRECTORY"
+
+ if [[ $? != 0 ]]; then
+ log_error "Failed to clean $TARGET_DIRECTORY directory" $?
+ exit 1
+ fi
+}
+
+signFiles() {
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*.so
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*.so
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*.so
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*/*.so
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.so
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*/*/*/*.so
+ echo "Code Signing DYLIB Files"
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*/*/*/*/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/pyarrow/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/.dylibs/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/scipy/.dylibs/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/xgboost/.dylibs/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/stan/lib/stan_math/lib/tbb/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/torch/.dylibs/*.dylib
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/sklearn/.dylibs/*.dylib
+ echo "Coce Signing LIB Files"
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/*.lib
+ echo "Code Signing Other Files"
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/prophet_model.bin
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/diagnose
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/print
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stanc
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/prophet/stan_model/cmdstan-2.26.1/bin/stansummary
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/pyarrow/plasma-store-server
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/torch/bin/protoc
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/torch/bin/protoc-3.13.0.0
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/torch/bin/torch_shm_manager
+ echo "Code Sign OpenBB Executable File"
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/OpenBBTerminal
+ codesign --deep --force --verify --verbose --options runtime --entitlements "$ENTITLEMENTS" -s "$APPLE_SIGNING_IDENTITY" build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/OpenBBPlotsBackend
+}
+
+createInstallationDirectory() {
+ if [ -d "${TARGET_DIRECTORY}" ]; then
+ deleteInstallationDirectory
+ fi
+ mkdir -pv "$TARGET_DIRECTORY"
+
+ if [[ $? != 0 ]]; then
+ log_error "Failed to create $TARGET_DIRECTORY directory" $?
+ exit 1
+ fi
+}
+
+copyDarwinDirectory(){
+ createInstallationDirectory
+ cp -r "$SCRIPTPATH/darwin" "${TARGET_DIRECTORY}/"
+ chmod -R 755 "${TARGET_DIRECTORY}/darwin/scripts"
+ chmod -R 755 "${TARGET_DIRECTORY}/darwin/Resources"
+ chmod 755 "${TARGET_DIRECTORY}/darwin/Distribution"
+}
+
+# This creates the target/darwin folder which contains the contents for formatting the installer
+# It also created the target/darkwinpkg folder which has the .app to install
+copyBuildDirectory() {
+ sed -i '' -e 's/__VERSION__/'${VERSION}'/g' "${TARGET_DIRECTORY}/darwin/scripts/postinstall"
+ sed -i '' -e 's/__PRODUCT__/'${PRODUCT}'/g' "${TARGET_DIRECTORY}/darwin/scripts/postinstall"
+ chmod -R 755 "${TARGET_DIRECTORY}/darwin/scripts/postinstall"
+
+ sed -i '' -e 's/__VERSION__/'${VERSION}'/g' "${TARGET_DIRECTORY}/darwin/Distribution"
+ sed -i '' -e 's/__PRODUCT__/'${PRODUCT}'/g' "${TARGET_DIRECTORY}/darwin/Distribution"
+ chmod -R 755 "${TARGET_DIRECTORY}/darwin/Distribution"
+
+ sed -i '' -e 's/__VERSION__/'${VERSION}'/g' "${TARGET_DIRECTORY}"/darwin/Resources/*.html
+ sed -i '' -e 's/__PRODUCT__/'${PRODUCT}'/g' "${TARGET_DIRECTORY}"/darwin/Resources/*.html
+ chmod -R 755 "${TARGET_DIRECTORY}/darwin/Resources/"
+
+ rm -rf "${TARGET_DIRECTORY}/darwinpkg"
+ mkdir -p "${TARGET_DIRECTORY}/darwinpkg"
+
+ mkdir -p "${TARGET_DIRECTORY}"/darwinpkg/Applications
+ cp -a "${APP_DIRECTORY}" "${TARGET_DIRECTORY}"/darwinpkg/Applications
+
+ rm -rf "${TARGET_DIRECTORY}/package"
+ mkdir -p "${TARGET_DIRECTORY}/package"
+ chmod -R 755 "${TARGET_DIRECTORY}/package"
+
+ rm -rf "${TARGET_DIRECTORY}/pkg"
+ mkdir -p "${TARGET_DIRECTORY}/pkg"
+ chmod -R 755 "${TARGET_DIRECTORY}/pkg"
+}
+
+# Creates the target/package folder. This includes a basic.pkg file with no formatting
+function buildPackage() {
+ log_info "Application installer package building started.(1/3)"
+ # For now I removed the --identifier
+ pkgbuild --version "${VERSION}" \
+ --scripts "${TARGET_DIRECTORY}/darwin/scripts" \
+ --root "${TARGET_DIRECTORY}/darwinpkg" \
+ --identifier "OpenBB Terminal" \
+ --ownership preserve \
+ "${TARGET_DIRECTORY}/package/${PRODUCT}.pkg"
+}
+
+# Creates the target/pkg folder. This includes the finished pkg file to let users download
+function buildProduct() {
+ log_info "Application installer product building started.(2/3)"
+ productbuild --distribution "${TARGET_DIRECTORY}/darwin/Distribution" \
+ --resources "${TARGET_DIRECTORY}/darwin/Resources" \
+ --package-path "${TARGET_DIRECTORY}/package" \
+ --sign "${APPLE_DEVELOPER_CERTIFICATE_ID}" \
+ "${TARGET_DIRECTORY}/pkg/$1"
+}
+
+function createInstaller() {
+ log_info "Application installer generation process started.(3 Steps)"
+ buildPackage
+ chmod -R 754 "${TARGET_DIRECTORY}/darwinpkg"
+ buildProduct OpenBBTerminalM1.pkg
+ log_info "Application installer generation steps finished."
+}
+
+#Main script
+log_info "Installer generating process started."
+
+copyDarwinDirectory
+copyBuildDirectory
+signFiles
+chmod 755 build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/.env
+# chmod -R 755 build/pyinstaller/macOS/target/darwinpkg/Applications/OpenBB\ Terminal/.OpenBB/
+createInstaller
+
+log_info "Installer generating process finished"
+exit 0
diff --git a/build/pyinstaller/macOS/darwin/Distribution b/build/pyinstaller/macOS/darwin/Distribution
new file mode 100644
index 00000000000..9e328d8662c
--- /dev/null
+++ b/build/pyinstaller/macOS/darwin/Distribution
@@ -0,0 +1,36 @@
+
+
+ __PRODUCT__
+
+
+
+
+
+
+
+
+
+
+
+
+
+ __PRODUCT__.pkg
+
+ __PRODUCT__.pkg
+
diff --git a/build/pyinstaller/macOS/darwin/Resources/LICENSE.txt b/build/pyinstaller/macOS/darwin/Resources/LICENSE.txt
new file mode 100644
index 00000000000..b366787995e
--- /dev/null
+++ b/build/pyinstaller/macOS/darwin/Resources/LICENSE.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2022 OpenBB Inc.
+
+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.
diff --git a/build/pyinstaller/macOS/darwin/Resources/background-light.png b/build/pyinstaller/macOS/darwin/Resources/background-light.png
new file mode 100644
index 0000000000000000000000000000000000000000..b0635239ac231072a16306c0c867fd1550d600ec
GIT binary patch
literal 239891
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'?yODlBuWgxaxX`={o&?dD!F>gFP
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