diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 00000000000..d4bb2cbb9ed --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,20 @@ +# Minimal makefile for Sphinx documentation +# + +# You can set these variables from the command line, and also +# from the environment for the first two. +SPHINXOPTS ?= +SPHINXBUILD ?= sphinx-build +SOURCEDIR = . +BUILDDIR = _build + +# Put it first so that "make" without argument is like "make help". +help: + @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +.PHONY: help Makefile + +# Catch-all target: route all unknown targets to Sphinx using the new +# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). +%: Makefile + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/code.rst b/docs/code.rst new file mode 100644 index 00000000000..0b281a2ff1a --- /dev/null +++ b/docs/code.rst @@ -0,0 +1,318 @@ +Class library and code comments +====================================== + +Root level files +---------------------------------- + +.. automodule:: gamestonk_terminal.feature_flags + :members: +.. automodule:: gamestonk_terminal.helper_funcs + :members: +.. automodule:: gamestonk_terminal.main_helper + :members: +.. automodule:: gamestonk_terminal.menu + :members: +.. automodule:: gamestonk_terminal.reddit_helpers + :members: +.. automodule:: gamestonk_terminal.res_menu + :members: +.. automodule:: gamestonk_terminal.test_helper + :members: +.. automodule:: gamestonk_terminal.thought_of_the_day + :members: +.. automodule:: gamestonk_terminal.config_neural_network_models + :members: +.. automodule:: gamestonk_terminal.config_plot + :members: +.. automodule:: gamestonk_terminal.config_terminal + :members: +.. automodule:: gamestonk_terminal.dataframe_helpers + :members: + + +Technical analysis +------------------- + +.. automodule:: gamestonk_terminal.technical_analysis.finbrain_view + :members: +.. automodule:: gamestonk_terminal.technical_analysis.finviz_view + :members: +.. automodule:: gamestonk_terminal.technical_analysis.momentum + :members: +.. automodule:: gamestonk_terminal.technical_analysis.overlap + :members: +.. automodule:: gamestonk_terminal.technical_analysis.ta_controller + :members: +.. automodule:: gamestonk_terminal.technical_analysis.tradingview_view + :members: +.. automodule:: gamestonk_terminal.technical_analysis.trend_indicators + :members: +.. automodule:: gamestonk_terminal.technical_analysis.trendline_api + :members: +.. automodule:: gamestonk_terminal.technical_analysis.volatility + :members: +.. automodule:: gamestonk_terminal.technical_analysis.volume + :members: + + +Stock screener +-------------- + +.. automodule:: gamestonk_terminal.screener.finviz_view + :members: +.. automodule:: gamestonk_terminal.screener.screener_controller + :members: +.. automodule:: gamestonk_terminal.screener.yahoo_finance_view + :members: + + +Residual analysis +----------------- + +.. automodule:: gamestonk_terminal.residuals_analysis.ra_controller + :members: +.. automodule:: gamestonk_terminal.residuals_analysis.residuals_api + :members: +.. automodule:: gamestonk_terminal.residuals_analysis.residuals_model + :members: + + +Prediction techniques +--------------------- + +.. automodule:: gamestonk_terminal.prediction_techniques.arima + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.ets + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.fbprophet + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.knn + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.neural_networks + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.pred_controller + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.pred_helper + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.regression + :members: +.. automodule:: gamestonk_terminal.prediction_techniques.sma + :members: + + +Portfolio optimization +---------------------- + +.. automodule:: gamestonk_terminal.portfolio_optimization.optimizer_helper + :members: +.. automodule:: gamestonk_terminal.portfolio_optimization.optimizer_view + :members: +.. automodule:: gamestonk_terminal.portfolio_optimization.po_controller + :members: + + + +Behavioural analysis +-------------------- + +.. automodule:: gamestonk_terminal.behavioural_analysis.ba_controller + :members: +.. automodule:: gamestonk_terminal.behavioural_analysis.finbrain_view + :members: +.. automodule:: gamestonk_terminal.behavioural_analysis.google_view + :members: +.. automodule:: gamestonk_terminal.behavioural_analysis.reddit_view + :members: +.. automodule:: gamestonk_terminal.behavioural_analysis.stocktwits_view + :members: +.. automodule:: gamestonk_terminal.behavioural_analysis.twitter_view + :members: + +Comparison analysis +-------------------- + +.. automodule:: gamestonk_terminal.comparison_analysis.ca_controller + :members: +.. automodule:: gamestonk_terminal.comparison_analysis.finbrain_view + :members: +.. automodule:: gamestonk_terminal.comparison_analysis.finviz_compare_view + :members: +.. automodule:: gamestonk_terminal.comparison_analysis.market_watch_view + :members: +.. automodule:: gamestonk_terminal.comparison_analysis.yahoo_finance_view + :members: + + +Cryptocurrency +-------------- + +.. automodule:: gamestonk_terminal.cryptocurrency.coinmarketcap_view + :members: +.. automodule:: gamestonk_terminal.cryptocurrency.crypto_controller + :members: +.. automodule:: gamestonk_terminal.cryptocurrency.crypto_helper + :members: + + +Discovery +--------- + +.. automodule:: gamestonk_terminal.discovery.alpha_vantage_view + :members: +.. automodule:: gamestonk_terminal.discovery.ark_model + :members: +.. automodule:: gamestonk_terminal.discovery.ark_view + :members: +.. automodule:: gamestonk_terminal.discovery.disc_controller + :members: +.. automodule:: gamestonk_terminal.discovery.fidelity_model + :members: +.. automodule:: gamestonk_terminal.discovery.fidelity_view + :members: +.. automodule:: gamestonk_terminal.discovery.finra_ats_view + :members: +.. automodule:: gamestonk_terminal.discovery.finviz_view + :members: +.. automodule:: gamestonk_terminal.discovery.marketbeat_model + :members: +.. automodule:: gamestonk_terminal.discovery.marketbeat_view + :members: +.. automodule:: gamestonk_terminal.discovery.seeking_alpha_model + :members: +.. automodule:: gamestonk_terminal.discovery.seeking_alpha_view + :members: +.. automodule:: gamestonk_terminal.discovery.short_interest_model + :members: +.. automodule:: gamestonk_terminal.discovery.short_interest_view + :members: +.. automodule:: gamestonk_terminal.discovery.simply_wallst_view + :members: +.. automodule:: gamestonk_terminal.discovery.spachero_view + :members: +.. automodule:: gamestonk_terminal.discovery.unusual_whales_view + :members: +.. automodule:: gamestonk_terminal.discovery.yahoo_finance_view + :members: + +Due diligence +------------- + +.. automodule:: gamestonk_terminal.due_diligence.business_insider_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.dd_controller + :members: +.. automodule:: gamestonk_terminal.due_diligence.financial_modeling_prep_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.finra_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.finviz_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.market_watch_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.news_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.quandl_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.reddit_view + :members: +.. automodule:: gamestonk_terminal.due_diligence.sec_view + :members: + +Econ +----- + +.. automodule:: gamestonk_terminal.econ.econ_controller + :members: +.. automodule:: gamestonk_terminal.econ.fred_view + :members: +.. automodule:: gamestonk_terminal.econ.vix_view + :members: + +Exploratory data analysis +------------------------- + +.. automodule:: gamestonk_terminal.exploratory_data_analysis.eda_api + :members: +.. automodule:: gamestonk_terminal.exploratory_data_analysis.eda_controller + :members: + +Forex +----- + +.. automodule:: gamestonk_terminal.forex.fx_controller + :members: +.. automodule:: gamestonk_terminal.forex.fx_view + :members: + +Fundamental analysis +-------------------- + +.. automodule:: gamestonk_terminal.fundamental_analysis.alpha_vantage_controller + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.alpha_vantage_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.business_insider_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.fa_controller + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.financial_modeling_prep_controller + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.financial_modeling_prep_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.finviz_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.market_watch_model + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.market_watch_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.yahoo_finance_view + :members: +.. automodule:: gamestonk_terminal.fundamental_analysis.yield_curve_model + :members: + +Options +------- + +.. automodule:: gamestonk_terminal.options.chains_view + :members: +.. automodule:: gamestonk_terminal.options.op_controller + :members: +.. automodule:: gamestonk_terminal.options.op_scrape_view + :members: +.. automodule:: gamestonk_terminal.options.volume_helper + :members: +.. automodule:: gamestonk_terminal.options.volume_view + :members: + +Papermill +--------- + +.. automodule:: gamestonk_terminal.papermill.due_diligence_view + :members: +.. automodule:: gamestonk_terminal.papermill.econ_data_helper + :members: +.. automodule:: gamestonk_terminal.papermill.econ_data_view + :members: +.. automodule:: gamestonk_terminal.papermill.papermill_controller + :members: + +Portfolio +---------- + +.. automodule:: gamestonk_terminal.portfolio.ally_api + :members: +.. automodule:: gamestonk_terminal.portfolio.alp_api + :members: +.. automodule:: gamestonk_terminal.portfolio.dg_api + :members: +.. automodule:: gamestonk_terminal.portfolio.port_controller + :members: +.. automodule:: gamestonk_terminal.portfolio.portfolio_helpers + :members: +.. automodule:: gamestonk_terminal.portfolio.rh_api + :members: + + + + + diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 00000000000..e6b3543efd0 --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,58 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Path setup -------------------------------------------------------------- + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +import os +import sys +import sphinx_rtd_theme +sys.path.insert(0, os.path.abspath('.')) +sys.path.insert(0, os.path.join(os.path.abspath('.'), '..')) + + +# -- Project information ----------------------------------------------------- + +project = 'Gamestonk Terminal' +copyright = '2021, Gamestonk Terminal Contributors' +author = 'Gamestonk Terminal Contributors' + + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = ['myst_parser', + 'sphinx.ext.autodoc', + 'sphinx.ext.napoleon', + 'sphinx.ext.viewcode', + 'sphinx_rtd_theme' + ] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path. +exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] + + +# -- Options for HTML output ------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# +html_theme = 'sphinx_rtd_theme' + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 00000000000..72622f8c19d --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,21 @@ +.. Gamestonk Terminal documentation master file, created by + sphinx-quickstart on Thu Apr 29 21:54:05 2021. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to Gamestonk Terminal's documentation! +============================================== + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + + code + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` diff --git a/docs/make.bat b/docs/make.bat new file mode 100644 index 00000000000..2119f51099b --- /dev/null +++ b/docs/make.bat @@ -0,0 +1,35 @@ +@ECHO OFF + +pushd %~dp0 + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set SOURCEDIR=. +set BUILDDIR=_build + +if "%1" == "" goto help + +%SPHINXBUILD% >NUL 2>NUL +if errorlevel 9009 ( + echo. + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx + echo.installed, then set the SPHINXBUILD environment variable to point + echo.to the full path of the 'sphinx-build' executable. Alternatively you + echo.may add the Sphinx directory to PATH. + echo. + echo.If you don't have Sphinx installed, grab it from + echo.http://sphinx-doc.org/ + exit /b 1 +) + +%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +goto end + +:help +%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% + +:end +popd diff --git a/docs/requirements.txt b/docs/requirements.txt new file mode 100644 index 00000000000..03b37ebfa52 --- /dev/null +++ b/docs/requirements.txt @@ -0,0 +1,3 @@ +sphinx +myst-parser +sphinx-rtd-theme \ No newline at end of file