From 2add2ff1a395ca177f186213bb4c4f6a08a70a3c Mon Sep 17 00:00:00 2001 From: Danglewood <85772166+deeleeramone@users.noreply.github.com> Date: Mon, 10 Jun 2024 14:18:37 -0700 Subject: [PATCH 1/4] fix broken urls --- website/content/cli/configuration.md | 4 +-- website/content/cli/data-sources.md | 2 +- website/content/cli/installation.md | 31 ++++++++++++------- .../extensions.mdx | 0 4 files changed, 23 insertions(+), 14 deletions(-) rename website/content/platform/{developer_guide => user_guides}/extensions.mdx (100%) diff --git a/website/content/cli/configuration.md b/website/content/cli/configuration.md index 9ade9e69d4b5..90216554af7b 100644 --- a/website/content/cli/configuration.md +++ b/website/content/cli/configuration.md @@ -18,12 +18,12 @@ import HeadTitle from '@site/src/components/General/HeadTitle.tsx'; -In addition to the OpenBB Platform's `user_settings.json` file, described [here](/platform/usage/settings_and_environment_variables), there are settings and environment variables affecting the CLI only. +In addition to the OpenBB Platform's `user_settings.json` file, described [here](/platform/user_guides/settings_and_environment_variables), there are settings and environment variables affecting the CLI only. :::important API credentials are defined in the `user_settings.json` file. -Find all data providers [here](/platform/extensions/data_extensions), and manage all your credentials directly on the [OpenBB Hub](https://my.openbb.co/app/platform/credentials). +Find all data providers [here](/platform/user_guides/extensions), and manage all your credentials directly on the [OpenBB Hub](https://my.openbb.co/app/platform/credentials). Define default data sources by following the pattern outlined [here](data-sources) ::: diff --git a/website/content/cli/data-sources.md b/website/content/cli/data-sources.md index aa79329da1f2..7ded01b8bea7 100644 --- a/website/content/cli/data-sources.md +++ b/website/content/cli/data-sources.md @@ -26,7 +26,7 @@ Many commands have multiple data sources associated with it. This page describes :::important API credentials are defined in the `user_settings.json` file. -Find all data providers [here](/platform/extensions/data_extensions), and manage all your credentials directly on the [OpenBB Hub](https://my.openbb.co/app/platform/credentials). +Find all data providers [here](/platform/user_guides/extensions/), and manage all your credentials directly on the [OpenBB Hub](https://my.openbb.co/app/platform/credentials). ::: ## Data Source In-Command diff --git a/website/content/cli/installation.md b/website/content/cli/installation.md index b26cb5166590..abde7a52b966 100644 --- a/website/content/cli/installation.md +++ b/website/content/cli/installation.md @@ -25,9 +25,24 @@ The OpenBB Platform CLI is a wrapper around the [Platform](/platform), and shoul Please refer to the [OpenBB Platform install documentation](/platform/installation) for instructions and more information. :::info -If the OpenBB Platform is not already installed, the `openbb-cli` package will install the default components. +If the OpenBB Platform is not already installed, the `openbb-cli` package will install all available components. ::: +### Windows + +The machine may need to have an installation of Visual C++ Build Tools available. Download the elements highlighted in the images below. + +
+"Microsoft Visual C++ 14.0 or greater is required" + +Download and install [C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/), restart the machine, then continue. + +![image](https://github.com/OpenBB-finance/OpenBBTerminal/assets/85772166/ceb57be0-6dae-42f2-aca6-bf62ce7d6135) + +![image](https://github.com/OpenBB-finance/OpenBBTerminal/assets/85772166/f8aef8fc-a080-4164-bd36-460714ec44f3) + +
+ ### Linux Requirements Linux users will need to take additional steps prior to installation. @@ -71,26 +86,20 @@ Welcome to OpenBB Platform CLI v1.0.0 Follow the instructions [here](/platform/installation#source) to clone the GitHub repo and install the OpenBB Platform from the source code. -Next, navigate into the folder: `~/OpenBBTerminal/cli` +Next, navigate into the folder: `~/OpenBBTerminal/openbb_platform` :::tip -The Python environment should have `toml` and `poetry` installed. +The Python environment should have `poetry` installed. ```bash -pip install toml poetry +pip install poetry ``` ::: Finally, enter: ```console -poetry install -``` - -Alternatively, install locally with `pip`: - -```bash -pip install -e . +python dev_install.py -e --cli ``` ## Installing New Modules diff --git a/website/content/platform/developer_guide/extensions.mdx b/website/content/platform/user_guides/extensions.mdx similarity index 100% rename from website/content/platform/developer_guide/extensions.mdx rename to website/content/platform/user_guides/extensions.mdx From b3190d81e7519f95c0f236b3c82636c1ba7909d0 Mon Sep 17 00:00:00 2001 From: Danglewood <85772166+deeleeramone@users.noreply.github.com> Date: Mon, 10 Jun 2024 14:23:01 -0700 Subject: [PATCH 2/4] couple more --- website/content/platform/developer_guide/index.mdx | 2 +- website/content/platform/user_guides/add_toolkit_extension.mdx | 2 +- website/content/platform/user_guides/basic_syntax.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/website/content/platform/developer_guide/index.mdx b/website/content/platform/developer_guide/index.mdx index 70b8518ec01b..04af71994a8b 100644 --- a/website/content/platform/developer_guide/index.mdx +++ b/website/content/platform/developer_guide/index.mdx @@ -62,4 +62,4 @@ Optional extras are not included with the base installation, and these include: - Toolkit extensions - CLI Terminal -Refer to [Extensions](/platform/developer_guide/extensions) for the list of extensions hosted in the OpenBB GitHub repository that can be installed independently. +Refer to [Extensions](/platform/user_guides/extensions) for the list of extensions hosted in the OpenBB GitHub repository that can be installed independently. diff --git a/website/content/platform/user_guides/add_toolkit_extension.mdx b/website/content/platform/user_guides/add_toolkit_extension.mdx index 9e8636a29637..4446f63bdccf 100644 --- a/website/content/platform/user_guides/add_toolkit_extension.mdx +++ b/website/content/platform/user_guides/add_toolkit_extension.mdx @@ -24,7 +24,7 @@ import HeadTitle from "@site/src/components/General/HeadTitle.tsx"; -Before adding a new toolkit extension and router path to the OpenBB Platform using a supplied template, it is important to understand the difference between a toolkit and a provider extension. You can find more information on this [here](/platform/developer_guide/extensions). +Before adding a new toolkit extension and router path to the OpenBB Platform using a supplied template, it is important to understand the difference between a toolkit and a provider extension. You can find more information on this [here](/platform/user_guides/extensions). ## How To Create A Router Extension diff --git a/website/content/platform/user_guides/basic_syntax.mdx b/website/content/platform/user_guides/basic_syntax.mdx index eb9db88c8a49..b030c5a66e99 100644 --- a/website/content/platform/user_guides/basic_syntax.mdx +++ b/website/content/platform/user_guides/basic_syntax.mdx @@ -80,7 +80,7 @@ Provider coverage can be ascertained with the command below: obb.coverage.providers ``` -Refer to, [Data Extensions](/platform/developer_guide/extensions), for instructions on installing data provider extensions. +Refer to, [Data Extensions](/platform/user_guides/extensions), for instructions on installing data provider extensions. ## Symbol From 05157fe84b6bcebd3ac37a488d9c9b60b9a42fcf Mon Sep 17 00:00:00 2001 From: Danglewood <85772166+deeleeramone@users.noreply.github.com> Date: Mon, 10 Jun 2024 15:46:23 -0700 Subject: [PATCH 3/4] remove poetry install openbb_platform from docs generation. --- .github/workflows/deploy-gh-pages.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/workflows/deploy-gh-pages.yml b/.github/workflows/deploy-gh-pages.yml index bde7ca3ca0bd..c2469ac4041f 100644 --- a/.github/workflows/deploy-gh-pages.yml +++ b/.github/workflows/deploy-gh-pages.yml @@ -50,10 +50,8 @@ jobs: - name: Generate Platform Markdown run: | - poetry install -C openbb_platform --no-interaction source openbb_platform/.venv/bin/activate pip install -U poetry - pip install toml python openbb_platform/dev_install.py -e all python -c "import openbb; openbb.build()" python website/generate_platform_v4_markdown.py From 6f118c4156642866e5a9773feb2ac200d4dcc91b Mon Sep 17 00:00:00 2001 From: Danglewood <85772166+deeleeramone@users.noreply.github.com> Date: Mon, 10 Jun 2024 15:49:55 -0700 Subject: [PATCH 4/4] Try it this way. --- .github/workflows/deploy-gh-pages.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/deploy-gh-pages.yml b/.github/workflows/deploy-gh-pages.yml index c2469ac4041f..51116d012fa8 100644 --- a/.github/workflows/deploy-gh-pages.yml +++ b/.github/workflows/deploy-gh-pages.yml @@ -50,6 +50,7 @@ jobs: - name: Generate Platform Markdown run: | + poetry install -C openbb_platform --no-interaction -E all source openbb_platform/.venv/bin/activate pip install -U poetry python openbb_platform/dev_install.py -e all