From fb69120bed68a8a2b3d47661aa928952471e2668 Mon Sep 17 00:00:00 2001 From: Theodore Aptekarev Date: Wed, 16 Oct 2024 06:39:00 +0200 Subject: [PATCH] Create OpenBB Platform Installer with conda constructor (#6587) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * add snowflake integration video (#6339) * [HotFix] Fix broken URLs in docs page. (#6368) * Fix broken URLs * use full URL to other docs pages. * [Release] 4.2.0 (#6422) * [Docs] Remove Reference to `to_chart` in OBBject. (#6096) * remove reference to to_chart in OBBject. * put chart description back in OBBject properties * [Feature] - Create openbb assets folder (#6101) * create openbb assets folder * fix unittest * rebuild --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * [BugFix] Fixes to_df() where the date series contains multiple TZ-offsets. (#6099) * allow mixed utc offset in a tz-aware date column * enforce ascending from all providers for price.historical * fix tests * add comments and apply treatment to basemodel_from_df before JSON output * yfinance consistency * add unit test * add unit test * better test * ruff --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Update the quantitative extension to make more sense (#6087) * Split out a rolling submenu for the rolling functions * Make a performance and a stats submenu. * Test the statistics functions * lint * lint * dupe test * pylint * ruff * Try tests quick * black magic signature funcs * fix my custom tests * Fix the existing imports/urls * push the api update * okay I figured out whats going on * this should be all of them * Correct docstringing examples --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * [BugFix] Fix ECB Yield Curve (#6108) * fix ecb yield curve * standard model update * Update unit-test workflow to check for changes to openbb_platform (#6109) * [Bug fix] - Fix package mypy (#6110) * fix: package mypy * types * black * [Feature] - Equity router descriptions & examples (#6103) * feat: equity/calendar * feat: compare router * fix descriptions * darkpool + discovery * fix paragraph issues * fix descriptions * fundamental part 1 * fundamental part2 * transcipts * ownership * fix * price * shorts * Update darkpool_router.py * minor fix * shorts examples * examples * ruff * black --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * [Feature] - Add `exception_handler` decorator to static (#6112) * add exception handler decorator * add exception handler decorator code * updated static * rebuild to fix docstring indentation --------- Co-authored-by: Diogo Sousa * update extensions list (#6114) * add missing field descriptions to yfinance equity price historical (#6116) Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * remove charting extension env var (#6118) * [BugFix] Fix Company News (#6111) * fix company news * update tests * multiple symbols for polygon * don't include pageSize in Benzinga querystring, fixed as 100 * remove extra space * black * unused imports * make benzinga test cassette smaller * missing params * clear empty strings --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * [BugFix] Allow Multiple Symbols in `equity.fundamental.metrics()` from `yfinance` (#6124) * allow multiple symbols in key_metrics from yfinance * field order thing * remove unnecessary function (#6125) * [Docs] Update OpenBB Copilot docs (#6106) * WIP: Tweak description. * WIP: Experimenting with react-player * WIP: Add copilot docs. * fixes videos width/height * WIP: Refine videos and copy. * WIP: Add last videos and sections. * Add bring-your-own-copilot section. * Tweak grammar. * Add copilot link. * Fix typos. --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * [Enhancement] Add Previous Close to DATA_DESCRIPTIONS (#6120) * add data description for previous close * ..just the one * update the model tripped by this change --------- Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> * added australia as a country also (#6131) * [Bug fix] - Fix regulator cik map standard model (#6129) * Fix regulator cik map standard model * fix description * Update cik_map.py * increase timeout to 30 (#6115) Co-authored-by: James Maslek * clean up some v3 deps (#6105) * clean up some v3 deps * forgot we need to do the requirements txt files * not sure it matters, but run ruff + black * am addicted to bug fixes --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * [Bug fix] - explicit multiple items docstring (#6127) * explicit multiple items docstring * rebuiild * rebuild again --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * [Feature] Pretty Pydantic `ValidationError` exceptions (#6130) * fix validator in fmp IndexHistorical model * make ValidationError pretty * modify arg error * linting fmp IndexHistorical * black * remove unused code * tmx etf info (#6132) Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> * [Feature] - Platform V4 Markdown Generator V2 (#6094) * add recent `openapi.json` * fix data types in models * removed `openapi.json` * set default date value as None in PolygonCurrencyPairs class * add function to generate reference.json file * reworked function to improve readability * reword function to add seo metadata * add functions for creating markdown sections * add code to extract data card markdown title * add additional functions for generating index and data models file * extract first sentence of the description for cards * code cleanup and documentation * linting * linting polygon models * add openbb import statement in create_reference_markdown_examples function * add POST method functions * cleanup; reworked generate_reference_index_files function * moved development section to 7th position in the sidebar * fix POST function params default value add standard flag to QueryParams and Data fields cleanup * add type expansion from package_builder.MethodDefinition * sort data models cards alphabetically make printing less verbose * make MAX_CARDS global display less content in cards in Commannds section * cleanup * Remove '_' from the cards under Commands section * " to ' in econometrics/causality * replace ' with " in ReferenceCard for reference dir index files * remove extra . from the quantile function description * shoutout to @deeleeramone for finding POST method description bug! * set correct value for standard field * handle BaseModel types in provider data fields * unit tests for the platform markdown generator v2 * yeet 'Default' and 'Optional' columns in the 'Data' section * last minute bug fix * add info for multiple symbols * make multiple items info same as platform static * organize sections properly * sort reference sub-directories alphabetically * extra space in 'OBBject extra' description * add type expansion for fields with multiple items POST method cleanup --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * [Docs] Adds Example Notebook for the Implied Earnings Move (#6128) * adds example notebook for the implied earnings move * remove commented out line --------- Co-authored-by: James Maslek * [Feature] - Sync with new openapi.json (#6137) * feat: create data tabs * fix: uncomment * fix: remove unecessary comment * sort side bar * comment * uncomment * use .dev functions.json + clean traverse * fix futures example * fix example * point to .co * Fix the v3 markdown generation workflow (#6138) * fix workflow * debug time * see if the docs generate at least * ahhhh i found it * getting there * put the test first * some keys cleanup * small change to error message * update functions.json (#6140) * fix intraday check in charting ta_class (#6119) Co-authored-by: Henrique Joaquim * [BugFix] Display EconDB as source for macro (#6143) * [BugFix] Disable Intrinio `InstitutionalOwnership` model (#6142) * disable fetcher in init and fetcher tests * disable provider test params from equity python and api tests * updated static * add more examples into findSymbols (#6139) Co-authored-by: James Maslek * [BugFix] Fix SEC ETF Holdings Parsing Exception (#6121) * fix etf holdings * linting * black --------- Co-authored-by: James Maslek * Docs/update xl docs (#6145) * remove print * update obb.get docs * example * md lint * fix get reference (#6147) * [BugFix] Filter OECD data using `start_date` and `end_date` parameters (#6144) * move constant dicts to constants.py filter by start_date and end_date * black * black again again * Merge 'main' into 'develop' (#6151) * Release/3.2.4 (#5696) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * 3.2.3->3.2.4 * Changelogs * new changelog --------- Co-authored-by: Henrique Joaquim Co-authored-by: Andrew Co-authored-by: Adi Sai Co-authored-by: Sandip Saha Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Luqman Co-authored-by: Adwait <111136306+AdwaitSalankar@users.noreply.github.com> Co-authored-by: Abhishek Amar <66067391+abhishek-amar@users.noreply.github.com> Co-authored-by: DidierRLopes Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Ramazan Co-authored-by: joshuabuildsthings Co-authored-by: wojda <114031148+polooner@users.noreply.github.com> Co-authored-by: Bim Phomthong <118195204+bimbolimbo@users.noreply.github.com> * Release/4.0.1 (#5840) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * Release/3.2.4 (#5704) * 3.2.3->3.2.4 * Changelogs * new changelog * OpenBB Platform v4 (#5225) * change location * check something * add cache * fixed auth w/@IgorWounds and @montezdesousa * fixes for econometrics * include Darren auth suggestions * some routers included if dev + chg hub backend var * coverage router should not be here * update docker readme * forgot to check auth here * Change extension imports * update docstrings and readme * headers function wasnt being called, just referenced * relative import * econometrics add headers everywhere * Fix QA * Fix TA * Fix test * Fix python interface QA and TA * Lint * Cleanup * Change path * make the changes and some etf models * tests for command_runner * ruff * solving naming issues on pytest * Update some docstrings, fix typos and lint * solving econometrics instantiating wrong openbb * chaging the way pytest runs * messing around with the imports * ruff * Change template to add platform considerations (#5533) * change template to add platform considerations * @the-praxs suggestions * solving __pycache__ issue * removing typo * ci yml * making linters happy (i guess) * Improve Omega Ratio and docstrings * chaging pro validation hash * ruff * Fix OLS Summary and lint * Add OECD Provider for economy extension (#5534) * Add record to docs * update a couple of cboe models * Fix econometrics bugs. Make tests pass. Lint. * black * ruff * pydantic v2: remove deprecated Extra * pydantic v2: self.dict -> self.model_dump * revert pydantic * revert the revert * try 1: pin urllib3 < 2 * Revert "try 1: pin urllib3 < 2" This reverts commit 3736c311cb6aa9e653dcb5db733798408b72a82e. * Revert dep * Fix * re-lock * Skip all tests when doing cspell in pre-commit * Resolve linter errors * Add OECD to install script * Add OECD * Resolve more linter errors * Exclude static files of v4 python from ruff * More linting * Another attempt to resolve even more linting errors * Change how Literal is used * ticker. symbol. consistent. @piiq * change ticker field in Stock Search to is_symbol * Update Cboe model for stocks_search -> is_symbol parameter. * Fix issue * Lint * Small QA to rename SDK to Platform (#5544) * SDK -> Platform in docs * renamed in core * renamed in openbb `init` * `sdk` variable renamed as `platform` --------- Co-authored-by: hjoaquim * `validator` -> `field_validator` in standard models * Standard convention for multi-ticker symbols (#5549) * standardize symbol input param in forex and crypto historical data * static * linting * Fix stock_search integration test params * Update dependencies and linting on the CI (#5550) * Remove ruff and black from platform dependencies * Update codespell configuration * Lint python code * Add toml and tomli to root dev dependencies * Update requirements.txt files * Fix buggy docstring in python package methods (#5548) * fix buggy docstring for methods * remove space * fix typing * avoid name collision with validator * Revert "avoid name collision with validator" This reverts commit 8a30a44555d97132f6bddcbc4a4facdd97ecc591. * typing * rebuild * python 3.8, ParamSpec not available * lint * ruff noqa * Merge with develop (#5551) * Charting extension integration tests (#5547) * initial proposal for integration tests on the charting extension * int tests for charting generation * python generator * ruff * boilerplate templates * python tests * tests for the api * using body instead so data don't get redefined * unit tests for coverage * ruff * docstrings * unnecessary access to keys() * Add trading economics economic calendar * dev install * Data Models disposition on the website (#5538) * pydantic v4 * flat structure * md files * Revert "md files" This reverts commit bd2170e2adf82fed3a35d34fad6a2e3ba3ae1d49. * improve command descriptions * nice title and description * human readble data model names on left panel * implementation details section * content markdown files * markdown versioned files * showcase page * updates --------- Co-authored-by: tehcoderer * everything except tests * fix `datetime.date` import in fetcher test * modified url to remove `api_key` placeholder * record test * api key is called c here * fixed fetcher test for api key * recorded tests * refactor * life is ruff * codespell * Make Intrinio options chains great again (#5540) * add multithreading * cleanup * linting * use dateutil.parser * removed `TICKER_EXCEPTIONS` * modified `date` and `type` fields in standard model * set alias for `date` and `type` to match standards * static * static * Hotfix/fix post tests (#5555) * Fix econometrics * Fix ta * Fix qa. Remove intrinio to not be rate limited * Lint * Fix typo * obbject tests (#5558) * obbject tests * ruff * fix dev_install * fix unittests * black on nox * black on nox * nox * fix fetcher test so it can compare dates * fix intrinio tests * ruff * change to model_dum() instead (#5561) * Passing tests (#5560) * Passing tests * fix options * Fix most tests and bugs * fix forex missing params * make symbol upper in polygon fx pairs * fix fixedincome integration tests (#5564) * Fixing charting api integration tests (#5562) * fixing charting api integration tests * black * fix stocks less five API fails * fix the 5 failing stocks integration tests * recapture fmp stock news unit test * fix fmp forex api test * couple more forex integration fixes * changing the request to always use the legacy session. @jmaslek this is was broken for 3.8 and 3.9; with this change apparently all versions work - lemme know if you see any issue with this change * ruff * fix ta * add missing param * fix testers for the api * fix globalnews to use images instead of image * remove unncessary pandas import * econcal int tests * update gitignore * fix get_querystring to support lists * add missing parameters --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Henrique Joaquim * Stock Historical standardization and UX improvements (#5457) * polygon add interval standard param * attempt at standardization * Alpha Vantage params standardization * rename `get_intervals` and fixed bug for extracting wrong value * missed changing it in `extract_data` * linting * polygon cleanup * modified `start_date` & `end_date` type to `datetime` from `dateType` * standardized intrinio stock historical params * fixed yfinance * linting * revert start and end date to dateType from datetime * fix alpha vantage * changed param * fix intrinio infinite loop * `validator` is `field_validator` * revert time params and fixed intervals * `outputsize` alias set in `Field` * set interval description using in-build dict * yfinance stock param standardization * static * intrinio cleanup * Polygon add api params as `PrivateAttr` * modified yfinance params to `PrivateAttr` * intrinio remove overriding date params * fixed description for AV adjusted param * fix alpha vantage intraday not working * re-record and pass unit tests * pass integration tests * Update test --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Fix econcal endpoint (#5567) * fix econcal for python interface * fix econcal tests * fix non supported json output * Fixes FMP index endpoint to get 1 day interval data (#5535) * fix FMP endpoint for getting index data for `1day` interval * fix `open` type to prevent validation error * modifed `validator` to `field_validator` * type of fields is `StrictFloat` * re-record and pass test * linting * `validator` -> `field_validator`, a3'd everything * Fix regression in tests. Lint * updating the integration test actions * Fix typo * Fix typo * Fix import * Publish versions `a3` to Pypi (#5568) * bump versions and script to publish * small improvements * uncomment exception * openbb * publishing guidelines * improve docs * add providers to economy api * make symbol required in stock_quote * Fix keys * Fix oecd * add comma * revert * Add quotes * Sleep * Improve tests * Improve * Feature/query transform (#5566) * inject query into transform_data * swap query and data * update missing fetchers * last test failing * sig test fetcher * black * av add `query` to `transform_data` call * transform_data: missing refactoring * fix uvicorn command in the doc * Automated examples (#5576) * Automated examples * Fix bug * Lint * static assets built on 3.8 * Revert "static assets built on 3.8" This reverts commit fb82ff7bd9af92ed676d8f8047c31e74daf7b8b2. * remove assets * static assets on 3.8 * static assets on 3.8 * Wrap in quotes * Improve wrap * minor fix * rebuild 3.8 * Fix bug * Fix edge case * Lint * rebuild --------- Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa * use SecretStr for sensitive fields (#5578) * use SecretStr for sensitive fields * fix * docstring * Add tests for provider (#5583) * Add tests for provider * Test standard models * Lint * Fix standard model issues. Co-authored-by: @the-praxs * linting * `symbol` -> `is_symbol` in `economy.index_search` * static --------- Co-authored-by: Pratyush Shukla * feature/v4-biztoc-provider: Adds Biztoc provider and GlobalNews (#5546) * add biztoc provider * duplicate field * black * request headers * recapture test * move stuff around * add integration tests * duplicate OECD entry in dev_install * duplicate entry for oecd in pyproject.toml * Add Biztoc to workflow * update readme: credentials * Add Preferences to README * improve tests * fix biztoc * obbject pylint * Bug fix: serializ SecretStr before dumping to json * export credentials as json (#5592) * Check for wrong, changed, or outdated params. (#5597) * Improving `economy.cpi` for the FRED data (#5602) * remove multiindex using coding magic * Update field descriptions --------- Co-authored-by: Theodore Aptekarev * Improve error message. * Improve * Test tests (#5607) * Test tests * Add test * 4.0.0a4 PyPI publishing (#5608) * changes to publish * fix mini conflict * typo * cleaned `descriptions.py` * fix description in `cpi.py` * Add ETF extension to v4 (#5609) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add ETF historical price from yfinance (#5610) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add etf historical price standard model and route * Add etf historical data from yfinance * Add unit tests * Fix linter error. Organize imports * Update test data * Revert common descriptions erased by CPI PR * remove `symbol` from data for `stocks.ca.peers` * Test docstrings (#5613) * Test docstrings * fix minor bugs w/@IgorWounds * static only w/@IgorWounds * fix `importance` param in `economy.econcal` * right static only w/@IgorWounds * Fix econcal and add tests to noxfile * fix econcal static * re-record --------- Co-authored-by: Pratyush Shukla * Clean up the newly created ETF extension (#5611) * Add ETF to dev_install bundle * Add integration tests for openbb-etf * Patch integration test generator scripts to produce lintable code * Add py.typed markers for extensions * user preferences descriptions (#5593) * user preferences descriptions * typo * Feature/v4-sec-provider: Add SEC provider to V4 (#5556) * coerce string type, add default=None * add sec provider and FTD function * update description * ruff * data model definitions in standard model already * duplicate oecd entries in dev_install and pyproject * actually commit * integration test * add stock search to SEC * add company filings for SEC provider * integration tests * remove duplicated line * ruff * **kwargs in Transform Data * some helper functions for later * black * add helper for mutual fund and etf lookup * add some SEC lookup helpers to a new regulators extension * black * ruff * fix test param * take institution filter out of sec stock_search * ruff * remove URL that codespell doesn't like * add cik-to-ticker map * add litigations rss feed * make openbb-regulators a dependency of openbb-sec * add SIC search * improve ftd and remove BeautifulSoup from SEC dependencies * fix parsing the zip files pre-2009 * ruff * update descriptions * recapture ftd test * tests params * typo * change limit param to 1 in test_sec_stock_ftd * Add didiers to_records method (#5588) * Add didiers to_records * unused import * Bring back polars + do what igor suggested * Make the output consistent with what it was. * Black ? * spelling. oops. almost like we have a pre commit or something * Feature/v4-price-performance: % returns for various horizons, comparable across multiple tickers. (#5618) * coerce string type, add default=None * add price_performance endpoint from FMP * black * extra period in docstring * ruff * forgot one file * Feature/ipo-calendar: V4 IPO Calendar (#5605) * coerce string type, add default=None * add intrinio ipo calendar * fix typo * sort __init__ * fix description * make requested changes * update test params * black * test updates * etf integration * Add disc router and WSJ provider * OBBject extensions (#5612) * changes to core * bug? * docstring * doc * Update credentials.py * fix model_dump * create extensions * fix docstring * doc * revert change query_exc * doc * fix container test * redirect obbject test patch * doc * rename method * move decorator to extension file * rename method extend_obbject * changes in creds model * avoid credential racing * doc * rename prop * doc * doc * remove comment * comment some code * free extension names * docstring * doc * docs * Hotfix/fix-v4-economic-calendar: Add FMP to Econ Calendar and fix some TE bugs (#5580) * coerce string type, add default=None * adds fmp to economic calendar and fixes some things with TE * ruff * etf integration test * missing provider for test * rename te cassette to economic_calendar * fix test * rename tests --------- Co-authored-by: James Maslek * Add stocks disc endpoints (#5630) * Add stocks disc endpoints * Explicit * Lint * Add tests * Bump timeout * Feature/disc router (#5616) * Add disc router and WSJ provider * Lint * Lint * Move endpoints under ETF router * Update etf_performance.py * Add ETF info and sector exposure from FMP (#5620) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Fix linter errors after the merge * Fix more linter errors * Fix failing and add missing tests * Fix integration tests * Fix calendar ipo tests * Add ETF holdings and holding report dates from FMP (#5629) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Add etf holdings and holdings date routes and standard models * Add fmp holdings and holding dates fetchers * Update holdings fetcher to properly handle date object inputs * Add unit tests * Add integration tests * Black after merge * Fix test input data format * Disc router for equities. (#5640) * Disc router for equities. * add tests * Bug fixes in financial statements (#5537) * `validator` to `field_validator` in standard models * Polygon add `ttm` to `period` param * Revert "Polygon add `ttm` to `period` param" * Polygon add `ttm` to param `period` * `EarningsCallTranscript` standard model removed `quarter` param * use `tag` instead of `name` for correct field name * fix url for intrinio income statement * modified intrinio cash flow `transform_data` function * set optional data fields and validate dates * fix insider trading not fetching recent data * linting * refactoring * refactoring * set param alias in fmp stock insider provider model * get all quarter data for intrinio * add `limit` param to `stocks.fa.ins` * refactoring and linting * removed additional comment * linting * re-recorded and fix tests * cash flow standard model field type to `StrictFloat` * Intrinio cash flow model fixed to get all quarters' data * linting * refactoring * financial statement standard model field type to `StrictFloat` * Intrinio financial statement model get all quarter data * set `period` type to `Optional[str]` * add `period` param to balance sheet provider models * add `period` param to cash flow provider models * use alias in model dump * remove `ttm` from `period` param * revamped intrinio financials * fixed incorrect description for `limit` param * modified tests for `balance`, `cash` and `income` * re-recorded tests * skipped intrinio financial statement fetcher tests * Add ETF county weighting command with FMP data (#5645) * Remove code that wrongfully infers the filing date as end of quarter * Add etf countries command with fmp data * Add countries command to etf router * Update sector and country weighting fmp models * Fix docstring typo * Add unit tests and update mock data * Add integration tests for etf.countries * Bring back missing integration tests * Fix economic calendar integration tests * fix missing data in intrinio financials * removed inutile params from Polygon financial statement models * Intrinio IPO overhaul * tests fixed and re-recorded * Add ETF holdings performance with FMP data (#5659) * Add etf holdings performance endpoint * Add tests * Fix failing polygon fetcher tests * Split long holdings lists into chunks and update test data * Change chunk length to 500 tickers * Add stock search from FMP (#5642) Co-authored-by: Theodore Aptekarev * Feature/v4 pypi (#5579) * improvements to the publish script * move scripts * initial script that builds the package * adjustments on the docs * test pypi workflow * add hour and minute to version * black * ruff * duplicate file * moving files instead * build throught the script instead * update nox file * integration tests workflow * change workflow * fix dev_install * fix in sed cmd * testing the platform only * commenting out the publishing * fix run commands * improvements to the publish script and doc * fix publish script * updating the script and the workflow * feature/v4-pypi nightly (#5589) * init * Update nightly.py * cleanup * init file * not referencing dev_utils * updating obb platform key * revert * Increase warmup time * project name on pyproject and adding the --pre flag on readme * moving to the build folder * fix noxfile * reflecting the moves on the import statements * fix pyproject path * ruff * fix paths * fix super typo * update workflows * moving the pypi terminal files into its folder --------- Co-authored-by: teh_coderer Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Theodore Aptekarev * economy.calendar nasdaq (#5628) * add quandl econcal * unittest * add integration tests * replace   * fix bug TE importance * small fix * remove stuff from quandl * add nasdaq provider * add nasdaq to install files * Update test_economy_api.py * test * quandl leftovers * remove quandl econcal test * lint * replace   * ruff * lint * update nasdaq gmt * validate countries * here * no need for this * fix calendar tests * static * static * remove error * static * readme + website * readme * remove changes TE * typo * fix unittest * fix tests * Update __init__.py * Update economic_calendar.py * revamped model and added helpers for date range --------- Co-authored-by: Pratyush Shukla * Feature/v4-dividend-calendar: Adds Nasdaq dividend calendar and moves the command out of fundamental_analysis (#5672) * add nasdaq dividend calendar and move out of fundamental_analysis * black * ruff * add random-user-agent to pyproject.toml * add nasdaq ipo calendar * add nasdaq flag for SPO to IPO calendar * add spo test param * black * dividend test * fix transform_query - nasdaq_calendar_ipo * bring back different headers for ipo calendar * remove references to test * Add disc endpoints (#5660) * Add Quandl top retail * Add tests * Add Seeking Alpha * Add Filings * Change Provider * Fix test * Add dev_install * static * static correct * y u forget me * updated deps * static --------- Co-authored-by: Pratyush Shukla * using dev install (#5673) * Expanding the `fixedincome` menu (#5655) * models and fetcher * making the fetcher visible * std model * adding the command * improvements to the models * typo * adding the command * imrpovements to dwpcr * standard model for ecb int rates * adding the fetcher for fred * standard model of ice bofa * add ice_bofa command * ruff * ice bofa fetcher * moody std model * moody * std model * add cp command * unused import * cp * spot * ruff * hqm * tmc * ffrmc * tbffr * ruff * typing fixes * buggy dates * fred fetcher tests * ruff * adding ecb as a provider * adding new provider related stuff * adding the new command eu_ycvr * models * test for ecb fetcher * Feature/v4 fixedincome int tests (#5661) * integration tests * happy ruff * mini adjustment * ruff * typo * verbose type * fix tests * docstrings everywhere and an happy pydocstyle * fix tests * Feature/user-cache-dir: Add User Preference for the Cache Directory (#5621) * add user preference for storing cached data * ruff * fix tests? * fix test key error..? * etf integration test fix * add cache dir to SEC * black * improve docs structure for V4 (#5586) * improve docs structure for V4 * moving over changes * Add Docs to the navbar * add some, re-order sidebar * fix sentence * add docs install to source instructions * insert a couple of links, fix a typo * big terminal docs usage revamps * improve toggle component for tutorials * get rid of TOCs for all terminal docs for consistency and simplicity * improve platform docs * improve bot docs content structure * remove index from bot docs * improve ON THIS PAGE to only display TOC if at least 1 element * make edit this page text and icon on same line * add author and date to docs * add basic syntax page to usage * sidebar order for usage section * move api start command to the top with the import python import * some install page additions * small improvement * refactor routines section * Update introduction-to-routines.md * Update pipeline-of-commands.md * Update introduction-to-routines.md * Update routines-for-power-users.md * Update community-routines.md * update keyboard hotkey macros * askobb page * Update askobb-feature.md * Update index.md * Update index.md * Update index.md * Update index.md * fix images * remove HeadTitle from all files where it exist * get rid of extra spacing in markdown * small update * small edit * need index at the start because of main path when homepage of docs * use openAI to create SEO for front matter on my behalf * remove table of content from sdk page * finish improving metadata SEO for SDK docs * update duplicate header * update HeadTitle to be more specific on product * remove index from bot telegram reference * delete duplicated title for platform reference * another update * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * start PR so screenshots can get attached via GitHub website * Update qa.md * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * Update crypto introduction.md * titles * another title * Update crypto dd.md * Update defi.md * Update disc.md * Update nft.md * Update onchain.md * Update ov.md * Update introduction.md updates URL * Update introduction.md add HeadTitle * Update ba.md * Update comparison.md * Update dark-pool-shorts.md * Update disc.md * fix docs (#5646) * Update fa.md * Update gov.md * Update ins.md * Update tradinghours.md * Delete website/content/terminal/menus/stocks/options/screener.md * Update Options introduction.md * Update screener head title * Update screener TOC * Update econometrics.md * Update economy head title * Update etf.md * codespell * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Contributing guidelines (#5615) * intro section * what's expected sections * improve sections * improve sections and move how to add a data point * moving qa under contributor * better intro * moving the sharing section * better expectations * small intro to the contributor guidelines * moving things under the contributor section * there is no pre commits on the platform yet * dependency management * best practices for extensions * typo * collapse options subfolder * codespell * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update fixedincome.md * url * Update forecast.md * Update settings.md (#5665) * Update forex.md * fix front matter (#5667) * Fix conflict markers that got into markdown during previous merges * Fix front matter list formatting * Fix typo * small thing * fix hyperlinks * Update .codespell.ignore * output_type options * Architectural considerations * Update sidebar to hide pro section by default * Minor copy changes * TET pattern * import statements * clarification on preferences * Minor copy changes * Lint markdown and python * fix: open index on collapsible root elements * remove old content * options title * Fix linting errors * Refactor sidebar label to url mapping condition --------- Co-authored-by: andrewkenreich Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: hjoaquim Co-authored-by: Sandip Saha Co-authored-by: James Maslek Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Theodore Aptekarev * Add multi-ticker support to etf_countries (#5670) * add multi-ticker support to etf_countries * remove commented-out lines * normalized percent points * percent -> percentage * Fix Nasdaq Econ Calendar Fetcher (#5668) * fix nasdaq econ cal request * more html tags * add random-user-agent to pyproject * another edge case - 24H -> 00:00 * Feature/v4-unusual-options: Adds unusual options endpoint. (#5677) * add unusual options fro Intrinio * test params * move sorting * Change type * update FMP fetcher to use the V4 endpoint (#5681) * Fix price performance not parsed correctly when there is only 1 ticker (#5678) * Add crypto search standard model and FMP data for it (#5679) * Apply renaming to news data (#5684) * inegration complete * reformatted for black * fix ruff issues * revised integration * changes to versions in pyproject.toml and updated lock files * Rename models * Update tests * Fix typos here and there * Update routers * Apply rename to ultima * Properly mock api key * Mock ultima api key --------- Co-authored-by: Adi Sai * Feature/v4-market-snapshots: Adds full market snapshots (#5473) * add stocks market snapshots from fmp * add fmp fetcher test * unused imports * add polygon to market_snapshots * update fmp market_snapshots * black * pydantic2 things * updates * change validate_obj to model_validate * polygon cleanup * tests * descriptions * black * data description * minor adjustments, using less local variables, improving readability and removing pandas * better structure * minor adjustments * lint * fix int tests --------- Co-authored-by: hjoaquim * Add NBBO Quotes, with historical, to `obb.stocks.quote()` (#5617) * coerce string type, add default=None * add polygon stock quote * limit cleanup * add greater/less than to params * limit param * black * tests * fix tests * test_etf * rename model and function to NBBO * add standard model for nbbo * improve standardization * not redifining builtin max * fix input params * integration test params * removing unused import Co-authored-by: Pratyush Shukla * revamped code * re-recorded nbbo test * added symbol validator * added alias in field * Stock news -> Company news --------- Co-authored-by: hjoaquim Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * hotfix/update-quandl-to-nasdaq: Merge Quandl + Nasdaq (#5682) * merge quandl nd nasdaq * dev_install.py * test param name * economy python integration test * Add more input types to data processing commands (#5453) * adding more supported types to data processing commands * ruff * removing unused import * docstrings * data processing types covertion * data description * test filters * ruff * fix package builder tests * ruff * removing print * Add stocks/dps module (#5638) * short volume * pyproject missed * add sec short interest with days to cover * Add FINRA OTC endopoint * some tests * rest of unit tests * Integratin test scripts * dev install * linters caught by pre commit * lines too long * Last test files * maybe it needs a lock file? * thanks pratty * Maybe ill actually listen to pratty next time * sec test date freeze * I cant hit buttons * re record tests * tests 3 * Stockgrid test * regen int test * more testing * lint * moved these fns * dis killing me * one more test * last one * Update integration tests * Fix tests picking up wrong dps route --------- Co-authored-by: Theodore Aptekarev * Rename Forex to Currency (#5687) * restore fields as optional (#5686) * Rename Crypto (#5689) * added `crypto.price.historical` * static * fix tests * fix incorrect label * Move model from sec to finra (#5692) * Update toml * fixed deps * add openbb-etf lock file * cleanup * cleanup (#5694) * Rename Fixed Income (#5695) * Rename Fixed Income * Add routers * Rename stocks to equity (#5688) * Rename stocks folder * Rename openbb_stocks package * Rename routers * Reroute equity menu * Update routes based on feedback * StockNews -> EquityNews * StockInfo -> EquityProfile * Rename Equity calendars * Equity peers rename * Rename discovery * Rename fundamental * Rename price command models * Rename shorts * Update charting router * Fix seeking alpha upcoming release date * Fix linting errors * Update tests * Fix tests * Skip econometrics api tests because it's python only * Update integration tests and test data * Historical analyst estimates * Skip cboe options chain test. Unable to record vcr cassette * re-record cboe cassettes * Document CBOE unit test creation caveats --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Feature/files-for-igor: Adding a few standard models for Igor (#5699) * add some standard models for Igor * codespell * update descriptions * Add devtools metapackage (#5703) * Add openbb-devtools metapackage * adding devtools to the dev_install script --------- Co-authored-by: hjoaquim * Rename econometrics commands to be more verbose (#5702) * Expose command to model map (#5706) * Rename ta qa (#5708) * Rename ta folder * Rename ta to technical * Rename qa folder * Rename qa to quantitative * Rename the actual routes in quantitative * Equity cleanup (#5707) * cleanup * static * renaming to equity cc @the-praxs * Proof reading --------- Co-authored-by: hjoaquim Co-authored-by: Theodore Aptekarev * Don't enforce imperative for first word of the docstring * Remove ultima from default extensions * Rename `economy` and create `index` extension (#5705) * renamed economy and re-recorded tests * static * market indices * european indices * fred indices * index constituents * tests * correct package name * oops * static * linting * Move COT commands to regulators * Rename economy.list to available_indices * Rename GDP models and clean up * Fix charting tests * Drop _indices from available_indices command * Fix obbject to_dict test --------- Co-authored-by: Theodore Aptekarev * Rename etf/disc (#5715) * Docs/v4-working-docs: PR to Work on V4 Docs (#5693) * Revert changes related to pydantic2 made into v3 code * Revert fred model changes in v3 * Revert pydantic2 databento model changes in v2 * Update some names and v3 lock file * Clean up openbb/package before the beta release * Platform publishing procedure (#5701) * update instructions * introducing the version script * publish message * fix platform path * reflecting version changes * getting version from installed packages instead * removing toml from dependencies * Changes to get `a7` out (#5697) * changes to get a7 out * etf menu on the pyproject.toml * poetry lock * bump `openbb-etf` to `a5` to match version * updated deps * removing ultima * removing references to a4 cc @the-praxs * Bump index menu version * poetry lock --------- Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * Update publishing instructions * Bump core dependencies in extensions and providers * Add changes to the publish script following the beta release * Update the versions in static extension map and openbb metapackage --------- Co-authored-by: James Maslek Co-authored-by: Pratyush Shukla Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply… * Release/4.2.1 (#6456) * tmx etf info (#6132) Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> * [Feature] - Platform V4 Markdown Generator V2 (#6094) * add recent `openapi.json` * fix data types in models * removed `openapi.json` * set default date value as None in PolygonCurrencyPairs class * add function to generate reference.json file * reworked function to improve readability * reword function to add seo metadata * add functions for creating markdown sections * add code to extract data card markdown title * add additional functions for generating index and data models file * extract first sentence of the description for cards * code cleanup and documentation * linting * linting polygon models * add openbb import statement in create_reference_markdown_examples function * add POST method functions * cleanup; reworked generate_reference_index_files function * moved development section to 7th position in the sidebar * fix POST function params default value add standard flag to QueryParams and Data fields cleanup * add type expansion from package_builder.MethodDefinition * sort data models cards alphabetically make printing less verbose * make MAX_CARDS global display less content in cards in Commannds section * cleanup * Remove '_' from the cards under Commands section * " to ' in econometrics/causality * replace ' with " in ReferenceCard for reference dir index files * remove extra . from the quantile function description * shoutout to @deeleeramone for finding POST method description bug! * set correct value for standard field * handle BaseModel types in provider data fields * unit tests for the platform markdown generator v2 * yeet 'Default' and 'Optional' columns in the 'Data' section * last minute bug fix * add info for multiple symbols * make multiple items info same as platform static * organize sections properly * sort reference sub-directories alphabetically * extra space in 'OBBject extra' description * add type expansion for fields with multiple items POST method cleanup --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * [Docs] Adds Example Notebook for the Implied Earnings Move (#6128) * adds example notebook for the implied earnings move * remove commented out line --------- Co-authored-by: James Maslek * [Feature] - Sync with new openapi.json (#6137) * feat: create data tabs * fix: uncomment * fix: remove unecessary comment * sort side bar * comment * uncomment * use .dev functions.json + clean traverse * fix futures example * fix example * point to .co * Fix the v3 markdown generation workflow (#6138) * fix workflow * debug time * see if the docs generate at least * ahhhh i found it * getting there * put the test first * some keys cleanup * small change to error message * update functions.json (#6140) * fix intraday check in charting ta_class (#6119) Co-authored-by: Henrique Joaquim * [BugFix] Display EconDB as source for macro (#6143) * [BugFix] Disable Intrinio `InstitutionalOwnership` model (#6142) * disable fetcher in init and fetcher tests * disable provider test params from equity python and api tests * updated static * add more examples into findSymbols (#6139) Co-authored-by: James Maslek * [BugFix] Fix SEC ETF Holdings Parsing Exception (#6121) * fix etf holdings * linting * black --------- Co-authored-by: James Maslek * Docs/update xl docs (#6145) * remove print * update obb.get docs * example * md lint * fix get reference (#6147) * [BugFix] Filter OECD data using `start_date` and `end_date` parameters (#6144) * move constant dicts to constants.py filter by start_date and end_date * black * black again again * Merge 'main' into 'develop' (#6151) * Release/3.2.4 (#5696) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * 3.2.3->3.2.4 * Changelogs * new changelog --------- Co-authored-by: Henrique Joaquim Co-authored-by: Andrew Co-authored-by: Adi Sai Co-authored-by: Sandip Saha Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Luqman Co-authored-by: Adwait <111136306+AdwaitSalankar@users.noreply.github.com> Co-authored-by: Abhishek Amar <66067391+abhishek-amar@users.noreply.github.com> Co-authored-by: DidierRLopes Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Ramazan Co-authored-by: joshuabuildsthings Co-authored-by: wojda <114031148+polooner@users.noreply.github.com> Co-authored-by: Bim Phomthong <118195204+bimbolimbo@users.noreply.github.com> * Release/4.0.1 (#5840) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * Release/3.2.4 (#5704) * 3.2.3->3.2.4 * Changelogs * new changelog * OpenBB Platform v4 (#5225) * change location * check something * add cache * fixed auth w/@IgorWounds and @montezdesousa * fixes for econometrics * include Darren auth suggestions * some routers included if dev + chg hub backend var * coverage router should not be here * update docker readme * forgot to check auth here * Change extension imports * update docstrings and readme * headers function wasnt being called, just referenced * relative import * econometrics add headers everywhere * Fix QA * Fix TA * Fix test * Fix python interface QA and TA * Lint * Cleanup * Change path * make the changes and some etf models * tests for command_runner * ruff * solving naming issues on pytest * Update some docstrings, fix typos and lint * solving econometrics instantiating wrong openbb * chaging the way pytest runs * messing around with the imports * ruff * Change template to add platform considerations (#5533) * change template to add platform considerations * @the-praxs suggestions * solving __pycache__ issue * removing typo * ci yml * making linters happy (i guess) * Improve Omega Ratio and docstrings * chaging pro validation hash * ruff * Fix OLS Summary and lint * Add OECD Provider for economy extension (#5534) * Add record to docs * update a couple of cboe models * Fix econometrics bugs. Make tests pass. Lint. * black * ruff * pydantic v2: remove deprecated Extra * pydantic v2: self.dict -> self.model_dump * revert pydantic * revert the revert * try 1: pin urllib3 < 2 * Revert "try 1: pin urllib3 < 2" This reverts commit 3736c311cb6aa9e653dcb5db733798408b72a82e. * Revert dep * Fix * re-lock * Skip all tests when doing cspell in pre-commit * Resolve linter errors * Add OECD to install script * Add OECD * Resolve more linter errors * Exclude static files of v4 python from ruff * More linting * Another attempt to resolve even more linting errors * Change how Literal is used * ticker. symbol. consistent. @piiq * change ticker field in Stock Search to is_symbol * Update Cboe model for stocks_search -> is_symbol parameter. * Fix issue * Lint * Small QA to rename SDK to Platform (#5544) * SDK -> Platform in docs * renamed in core * renamed in openbb `init` * `sdk` variable renamed as `platform` --------- Co-authored-by: hjoaquim * `validator` -> `field_validator` in standard models * Standard convention for multi-ticker symbols (#5549) * standardize symbol input param in forex and crypto historical data * static * linting * Fix stock_search integration test params * Update dependencies and linting on the CI (#5550) * Remove ruff and black from platform dependencies * Update codespell configuration * Lint python code * Add toml and tomli to root dev dependencies * Update requirements.txt files * Fix buggy docstring in python package methods (#5548) * fix buggy docstring for methods * remove space * fix typing * avoid name collision with validator * Revert "avoid name collision with validator" This reverts commit 8a30a44555d97132f6bddcbc4a4facdd97ecc591. * typing * rebuild * python 3.8, ParamSpec not available * lint * ruff noqa * Merge with develop (#5551) * Charting extension integration tests (#5547) * initial proposal for integration tests on the charting extension * int tests for charting generation * python generator * ruff * boilerplate templates * python tests * tests for the api * using body instead so data don't get redefined * unit tests for coverage * ruff * docstrings * unnecessary access to keys() * Add trading economics economic calendar * dev install * Data Models disposition on the website (#5538) * pydantic v4 * flat structure * md files * Revert "md files" This reverts commit bd2170e2adf82fed3a35d34fad6a2e3ba3ae1d49. * improve command descriptions * nice title and description * human readble data model names on left panel * implementation details section * content markdown files * markdown versioned files * showcase page * updates --------- Co-authored-by: tehcoderer * everything except tests * fix `datetime.date` import in fetcher test * modified url to remove `api_key` placeholder * record test * api key is called c here * fixed fetcher test for api key * recorded tests * refactor * life is ruff * codespell * Make Intrinio options chains great again (#5540) * add multithreading * cleanup * linting * use dateutil.parser * removed `TICKER_EXCEPTIONS` * modified `date` and `type` fields in standard model * set alias for `date` and `type` to match standards * static * static * Hotfix/fix post tests (#5555) * Fix econometrics * Fix ta * Fix qa. Remove intrinio to not be rate limited * Lint * Fix typo * obbject tests (#5558) * obbject tests * ruff * fix dev_install * fix unittests * black on nox * black on nox * nox * fix fetcher test so it can compare dates * fix intrinio tests * ruff * change to model_dum() instead (#5561) * Passing tests (#5560) * Passing tests * fix options * Fix most tests and bugs * fix forex missing params * make symbol upper in polygon fx pairs * fix fixedincome integration tests (#5564) * Fixing charting api integration tests (#5562) * fixing charting api integration tests * black * fix stocks less five API fails * fix the 5 failing stocks integration tests * recapture fmp stock news unit test * fix fmp forex api test * couple more forex integration fixes * changing the request to always use the legacy session. @jmaslek this is was broken for 3.8 and 3.9; with this change apparently all versions work - lemme know if you see any issue with this change * ruff * fix ta * add missing param * fix testers for the api * fix globalnews to use images instead of image * remove unncessary pandas import * econcal int tests * update gitignore * fix get_querystring to support lists * add missing parameters --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Henrique Joaquim * Stock Historical standardization and UX improvements (#5457) * polygon add interval standard param * attempt at standardization * Alpha Vantage params standardization * rename `get_intervals` and fixed bug for extracting wrong value * missed changing it in `extract_data` * linting * polygon cleanup * modified `start_date` & `end_date` type to `datetime` from `dateType` * standardized intrinio stock historical params * fixed yfinance * linting * revert start and end date to dateType from datetime * fix alpha vantage * changed param * fix intrinio infinite loop * `validator` is `field_validator` * revert time params and fixed intervals * `outputsize` alias set in `Field` * set interval description using in-build dict * yfinance stock param standardization * static * intrinio cleanup * Polygon add api params as `PrivateAttr` * modified yfinance params to `PrivateAttr` * intrinio remove overriding date params * fixed description for AV adjusted param * fix alpha vantage intraday not working * re-record and pass unit tests * pass integration tests * Update test --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Fix econcal endpoint (#5567) * fix econcal for python interface * fix econcal tests * fix non supported json output * Fixes FMP index endpoint to get 1 day interval data (#5535) * fix FMP endpoint for getting index data for `1day` interval * fix `open` type to prevent validation error * modifed `validator` to `field_validator` * type of fields is `StrictFloat` * re-record and pass test * linting * `validator` -> `field_validator`, a3'd everything * Fix regression in tests. Lint * updating the integration test actions * Fix typo * Fix typo * Fix import * Publish versions `a3` to Pypi (#5568) * bump versions and script to publish * small improvements * uncomment exception * openbb * publishing guidelines * improve docs * add providers to economy api * make symbol required in stock_quote * Fix keys * Fix oecd * add comma * revert * Add quotes * Sleep * Improve tests * Improve * Feature/query transform (#5566) * inject query into transform_data * swap query and data * update missing fetchers * last test failing * sig test fetcher * black * av add `query` to `transform_data` call * transform_data: missing refactoring * fix uvicorn command in the doc * Automated examples (#5576) * Automated examples * Fix bug * Lint * static assets built on 3.8 * Revert "static assets built on 3.8" This reverts commit fb82ff7bd9af92ed676d8f8047c31e74daf7b8b2. * remove assets * static assets on 3.8 * static assets on 3.8 * Wrap in quotes * Improve wrap * minor fix * rebuild 3.8 * Fix bug * Fix edge case * Lint * rebuild --------- Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa * use SecretStr for sensitive fields (#5578) * use SecretStr for sensitive fields * fix * docstring * Add tests for provider (#5583) * Add tests for provider * Test standard models * Lint * Fix standard model issues. Co-authored-by: @the-praxs * linting * `symbol` -> `is_symbol` in `economy.index_search` * static --------- Co-authored-by: Pratyush Shukla * feature/v4-biztoc-provider: Adds Biztoc provider and GlobalNews (#5546) * add biztoc provider * duplicate field * black * request headers * recapture test * move stuff around * add integration tests * duplicate OECD entry in dev_install * duplicate entry for oecd in pyproject.toml * Add Biztoc to workflow * update readme: credentials * Add Preferences to README * improve tests * fix biztoc * obbject pylint * Bug fix: serializ SecretStr before dumping to json * export credentials as json (#5592) * Check for wrong, changed, or outdated params. (#5597) * Improving `economy.cpi` for the FRED data (#5602) * remove multiindex using coding magic * Update field descriptions --------- Co-authored-by: Theodore Aptekarev * Improve error message. * Improve * Test tests (#5607) * Test tests * Add test * 4.0.0a4 PyPI publishing (#5608) * changes to publish * fix mini conflict * typo * cleaned `descriptions.py` * fix description in `cpi.py` * Add ETF extension to v4 (#5609) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add ETF historical price from yfinance (#5610) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add etf historical price standard model and route * Add etf historical data from yfinance * Add unit tests * Fix linter error. Organize imports * Update test data * Revert common descriptions erased by CPI PR * remove `symbol` from data for `stocks.ca.peers` * Test docstrings (#5613) * Test docstrings * fix minor bugs w/@IgorWounds * static only w/@IgorWounds * fix `importance` param in `economy.econcal` * right static only w/@IgorWounds * Fix econcal and add tests to noxfile * fix econcal static * re-record --------- Co-authored-by: Pratyush Shukla * Clean up the newly created ETF extension (#5611) * Add ETF to dev_install bundle * Add integration tests for openbb-etf * Patch integration test generator scripts to produce lintable code * Add py.typed markers for extensions * user preferences descriptions (#5593) * user preferences descriptions * typo * Feature/v4-sec-provider: Add SEC provider to V4 (#5556) * coerce string type, add default=None * add sec provider and FTD function * update description * ruff * data model definitions in standard model already * duplicate oecd entries in dev_install and pyproject * actually commit * integration test * add stock search to SEC * add company filings for SEC provider * integration tests * remove duplicated line * ruff * **kwargs in Transform Data * some helper functions for later * black * add helper for mutual fund and etf lookup * add some SEC lookup helpers to a new regulators extension * black * ruff * fix test param * take institution filter out of sec stock_search * ruff * remove URL that codespell doesn't like * add cik-to-ticker map * add litigations rss feed * make openbb-regulators a dependency of openbb-sec * add SIC search * improve ftd and remove BeautifulSoup from SEC dependencies * fix parsing the zip files pre-2009 * ruff * update descriptions * recapture ftd test * tests params * typo * change limit param to 1 in test_sec_stock_ftd * Add didiers to_records method (#5588) * Add didiers to_records * unused import * Bring back polars + do what igor suggested * Make the output consistent with what it was. * Black ? * spelling. oops. almost like we have a pre commit or something * Feature/v4-price-performance: % returns for various horizons, comparable across multiple tickers. (#5618) * coerce string type, add default=None * add price_performance endpoint from FMP * black * extra period in docstring * ruff * forgot one file * Feature/ipo-calendar: V4 IPO Calendar (#5605) * coerce string type, add default=None * add intrinio ipo calendar * fix typo * sort __init__ * fix description * make requested changes * update test params * black * test updates * etf integration * Add disc router and WSJ provider * OBBject extensions (#5612) * changes to core * bug? * docstring * doc * Update credentials.py * fix model_dump * create extensions * fix docstring * doc * revert change query_exc * doc * fix container test * redirect obbject test patch * doc * rename method * move decorator to extension file * rename method extend_obbject * changes in creds model * avoid credential racing * doc * rename prop * doc * doc * remove comment * comment some code * free extension names * docstring * doc * docs * Hotfix/fix-v4-economic-calendar: Add FMP to Econ Calendar and fix some TE bugs (#5580) * coerce string type, add default=None * adds fmp to economic calendar and fixes some things with TE * ruff * etf integration test * missing provider for test * rename te cassette to economic_calendar * fix test * rename tests --------- Co-authored-by: James Maslek * Add stocks disc endpoints (#5630) * Add stocks disc endpoints * Explicit * Lint * Add tests * Bump timeout * Feature/disc router (#5616) * Add disc router and WSJ provider * Lint * Lint * Move endpoints under ETF router * Update etf_performance.py * Add ETF info and sector exposure from FMP (#5620) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Fix linter errors after the merge * Fix more linter errors * Fix failing and add missing tests * Fix integration tests * Fix calendar ipo tests * Add ETF holdings and holding report dates from FMP (#5629) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Add etf holdings and holdings date routes and standard models * Add fmp holdings and holding dates fetchers * Update holdings fetcher to properly handle date object inputs * Add unit tests * Add integration tests * Black after merge * Fix test input data format * Disc router for equities. (#5640) * Disc router for equities. * add tests * Bug fixes in financial statements (#5537) * `validator` to `field_validator` in standard models * Polygon add `ttm` to `period` param * Revert "Polygon add `ttm` to `period` param" * Polygon add `ttm` to param `period` * `EarningsCallTranscript` standard model removed `quarter` param * use `tag` instead of `name` for correct field name * fix url for intrinio income statement * modified intrinio cash flow `transform_data` function * set optional data fields and validate dates * fix insider trading not fetching recent data * linting * refactoring * refactoring * set param alias in fmp stock insider provider model * get all quarter data for intrinio * add `limit` param to `stocks.fa.ins` * refactoring and linting * removed additional comment * linting * re-recorded and fix tests * cash flow standard model field type to `StrictFloat` * Intrinio cash flow model fixed to get all quarters' data * linting * refactoring * financial statement standard model field type to `StrictFloat` * Intrinio financial statement model get all quarter data * set `period` type to `Optional[str]` * add `period` param to balance sheet provider models * add `period` param to cash flow provider models * use alias in model dump * remove `ttm` from `period` param * revamped intrinio financials * fixed incorrect description for `limit` param * modified tests for `balance`, `cash` and `income` * re-recorded tests * skipped intrinio financial statement fetcher tests * Add ETF county weighting command with FMP data (#5645) * Remove code that wrongfully infers the filing date as end of quarter * Add etf countries command with fmp data * Add countries command to etf router * Update sector and country weighting fmp models * Fix docstring typo * Add unit tests and update mock data * Add integration tests for etf.countries * Bring back missing integration tests * Fix economic calendar integration tests * fix missing data in intrinio financials * removed inutile params from Polygon financial statement models * Intrinio IPO overhaul * tests fixed and re-recorded * Add ETF holdings performance with FMP data (#5659) * Add etf holdings performance endpoint * Add tests * Fix failing polygon fetcher tests * Split long holdings lists into chunks and update test data * Change chunk length to 500 tickers * Add stock search from FMP (#5642) Co-authored-by: Theodore Aptekarev * Feature/v4 pypi (#5579) * improvements to the publish script * move scripts * initial script that builds the package * adjustments on the docs * test pypi workflow * add hour and minute to version * black * ruff * duplicate file * moving files instead * build throught the script instead * update nox file * integration tests workflow * change workflow * fix dev_install * fix in sed cmd * testing the platform only * commenting out the publishing * fix run commands * improvements to the publish script and doc * fix publish script * updating the script and the workflow * feature/v4-pypi nightly (#5589) * init * Update nightly.py * cleanup * init file * not referencing dev_utils * updating obb platform key * revert * Increase warmup time * project name on pyproject and adding the --pre flag on readme * moving to the build folder * fix noxfile * reflecting the moves on the import statements * fix pyproject path * ruff * fix paths * fix super typo * update workflows * moving the pypi terminal files into its folder --------- Co-authored-by: teh_coderer Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Theodore Aptekarev * economy.calendar nasdaq (#5628) * add quandl econcal * unittest * add integration tests * replace   * fix bug TE importance * small fix * remove stuff from quandl * add nasdaq provider * add nasdaq to install files * Update test_economy_api.py * test * quandl leftovers * remove quandl econcal test * lint * replace   * ruff * lint * update nasdaq gmt * validate countries * here * no need for this * fix calendar tests * static * static * remove error * static * readme + website * readme * remove changes TE * typo * fix unittest * fix tests * Update __init__.py * Update economic_calendar.py * revamped model and added helpers for date range --------- Co-authored-by: Pratyush Shukla * Feature/v4-dividend-calendar: Adds Nasdaq dividend calendar and moves the command out of fundamental_analysis (#5672) * add nasdaq dividend calendar and move out of fundamental_analysis * black * ruff * add random-user-agent to pyproject.toml * add nasdaq ipo calendar * add nasdaq flag for SPO to IPO calendar * add spo test param * black * dividend test * fix transform_query - nasdaq_calendar_ipo * bring back different headers for ipo calendar * remove references to test * Add disc endpoints (#5660) * Add Quandl top retail * Add tests * Add Seeking Alpha * Add Filings * Change Provider * Fix test * Add dev_install * static * static correct * y u forget me * updated deps * static --------- Co-authored-by: Pratyush Shukla * using dev install (#5673) * Expanding the `fixedincome` menu (#5655) * models and fetcher * making the fetcher visible * std model * adding the command * improvements to the models * typo * adding the command * imrpovements to dwpcr * standard model for ecb int rates * adding the fetcher for fred * standard model of ice bofa * add ice_bofa command * ruff * ice bofa fetcher * moody std model * moody * std model * add cp command * unused import * cp * spot * ruff * hqm * tmc * ffrmc * tbffr * ruff * typing fixes * buggy dates * fred fetcher tests * ruff * adding ecb as a provider * adding new provider related stuff * adding the new command eu_ycvr * models * test for ecb fetcher * Feature/v4 fixedincome int tests (#5661) * integration tests * happy ruff * mini adjustment * ruff * typo * verbose type * fix tests * docstrings everywhere and an happy pydocstyle * fix tests * Feature/user-cache-dir: Add User Preference for the Cache Directory (#5621) * add user preference for storing cached data * ruff * fix tests? * fix test key error..? * etf integration test fix * add cache dir to SEC * black * improve docs structure for V4 (#5586) * improve docs structure for V4 * moving over changes * Add Docs to the navbar * add some, re-order sidebar * fix sentence * add docs install to source instructions * insert a couple of links, fix a typo * big terminal docs usage revamps * improve toggle component for tutorials * get rid of TOCs for all terminal docs for consistency and simplicity * improve platform docs * improve bot docs content structure * remove index from bot docs * improve ON THIS PAGE to only display TOC if at least 1 element * make edit this page text and icon on same line * add author and date to docs * add basic syntax page to usage * sidebar order for usage section * move api start command to the top with the import python import * some install page additions * small improvement * refactor routines section * Update introduction-to-routines.md * Update pipeline-of-commands.md * Update introduction-to-routines.md * Update routines-for-power-users.md * Update community-routines.md * update keyboard hotkey macros * askobb page * Update askobb-feature.md * Update index.md * Update index.md * Update index.md * Update index.md * fix images * remove HeadTitle from all files where it exist * get rid of extra spacing in markdown * small update * small edit * need index at the start because of main path when homepage of docs * use openAI to create SEO for front matter on my behalf * remove table of content from sdk page * finish improving metadata SEO for SDK docs * update duplicate header * update HeadTitle to be more specific on product * remove index from bot telegram reference * delete duplicated title for platform reference * another update * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * start PR so screenshots can get attached via GitHub website * Update qa.md * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * Update crypto introduction.md * titles * another title * Update crypto dd.md * Update defi.md * Update disc.md * Update nft.md * Update onchain.md * Update ov.md * Update introduction.md updates URL * Update introduction.md add HeadTitle * Update ba.md * Update comparison.md * Update dark-pool-shorts.md * Update disc.md * fix docs (#5646) * Update fa.md * Update gov.md * Update ins.md * Update tradinghours.md * Delete website/content/terminal/menus/stocks/options/screener.md * Update Options introduction.md * Update screener head title * Update screener TOC * Update econometrics.md * Update economy head title * Update etf.md * codespell * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Contributing guidelines (#5615) * intro section * what's expected sections * improve sections * improve sections and move how to add a data point * moving qa under contributor * better intro * moving the sharing section * better expectations * small intro to the contributor guidelines * moving things under the contributor section * there is no pre commits on the platform yet * dependency management * best practices for extensions * typo * collapse options subfolder * codespell * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update fixedincome.md * url * Update forecast.md * Update settings.md (#5665) * Update forex.md * fix front matter (#5667) * Fix conflict markers that got into markdown during previous merges * Fix front matter list formatting * Fix typo * small thing * fix hyperlinks * Update .codespell.ignore * output_type options * Architectural considerations * Update sidebar to hide pro section by default * Minor copy changes * TET pattern * import statements * clarification on preferences * Minor copy changes * Lint markdown and python * fix: open index on collapsible root elements * remove old content * options title * Fix linting errors * Refactor sidebar label to url mapping condition --------- Co-authored-by: andrewkenreich Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: hjoaquim Co-authored-by: Sandip Saha Co-authored-by: James Maslek Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Theodore Aptekarev * Add multi-ticker support to etf_countries (#5670) * add multi-ticker support to etf_countries * remove commented-out lines * normalized percent points * percent -> percentage * Fix Nasdaq Econ Calendar Fetcher (#5668) * fix nasdaq econ cal request * more html tags * add random-user-agent to pyproject * another edge case - 24H -> 00:00 * Feature/v4-unusual-options: Adds unusual options endpoint. (#5677) * add unusual options fro Intrinio * test params * move sorting * Change type * update FMP fetcher to use the V4 endpoint (#5681) * Fix price performance not parsed correctly when there is only 1 ticker (#5678) * Add crypto search standard model and FMP data for it (#5679) * Apply renaming to news data (#5684) * inegration complete * reformatted for black * fix ruff issues * revised integration * changes to versions in pyproject.toml and updated lock files * Rename models * Update tests * Fix typos here and there * Update routers * Apply rename to ultima * Properly mock api key * Mock ultima api key --------- Co-authored-by: Adi Sai * Feature/v4-market-snapshots: Adds full market snapshots (#5473) * add stocks market snapshots from fmp * add fmp fetcher test * unused imports * add polygon to market_snapshots * update fmp market_snapshots * black * pydantic2 things * updates * change validate_obj to model_validate * polygon cleanup * tests * descriptions * black * data description * minor adjustments, using less local variables, improving readability and removing pandas * better structure * minor adjustments * lint * fix int tests --------- Co-authored-by: hjoaquim * Add NBBO Quotes, with historical, to `obb.stocks.quote()` (#5617) * coerce string type, add default=None * add polygon stock quote * limit cleanup * add greater/less than to params * limit param * black * tests * fix tests * test_etf * rename model and function to NBBO * add standard model for nbbo * improve standardization * not redifining builtin max * fix input params * integration test params * removing unused import Co-authored-by: Pratyush Shukla * revamped code * re-recorded nbbo test * added symbol validator * added alias in field * Stock news -> Company news --------- Co-authored-by: hjoaquim Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * hotfix/update-quandl-to-nasdaq: Merge Quandl + Nasdaq (#5682) * merge quandl nd nasdaq * dev_install.py * test param name * economy python integration test * Add more input types to data processing commands (#5453) * adding more supported types to data processing commands * ruff * removing unused import * docstrings * data processing types covertion * data description * test filters * ruff * fix package builder tests * ruff * removing print * Add stocks/dps module (#5638) * short volume * pyproject missed * add sec short interest with days to cover * Add FINRA OTC endopoint * some tests * rest of unit tests * Integratin test scripts * dev install * linters caught by pre commit * lines too long * Last test files * maybe it needs a lock file? * thanks pratty * Maybe ill actually listen to pratty next time * sec test date freeze * I cant hit buttons * re record tests * tests 3 * Stockgrid test * regen int test * more testing * lint * moved these fns * dis killing me * one more test * last one * Update integration tests * Fix tests picking up wrong dps route --------- Co-authored-by: Theodore Aptekarev * Rename Forex to Currency (#5687) * restore fields as optional (#5686) * Rename Crypto (#5689) * added `crypto.price.historical` * static * fix tests * fix incorrect label * Move model from sec to finra (#5692) * Update toml * fixed deps * add openbb-etf lock file * cleanup * cleanup (#5694) * Rename Fixed Income (#5695) * Rename Fixed Income * Add routers * Rename stocks to equity (#5688) * Rename stocks folder * Rename openbb_stocks package * Rename routers * Reroute equity menu * Update routes based on feedback * StockNews -> EquityNews * StockInfo -> EquityProfile * Rename Equity calendars * Equity peers rename * Rename discovery * Rename fundamental * Rename price command models * Rename shorts * Update charting router * Fix seeking alpha upcoming release date * Fix linting errors * Update tests * Fix tests * Skip econometrics api tests because it's python only * Update integration tests and test data * Historical analyst estimates * Skip cboe options chain test. Unable to record vcr cassette * re-record cboe cassettes * Document CBOE unit test creation caveats --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Feature/files-for-igor: Adding a few standard models for Igor (#5699) * add some standard models for Igor * codespell * update descriptions * Add devtools metapackage (#5703) * Add openbb-devtools metapackage * adding devtools to the dev_install script --------- Co-authored-by: hjoaquim * Rename econometrics commands to be more verbose (#5702) * Expose command to model map (#5706) * Rename ta qa (#5708) * Rename ta folder * Rename ta to technical * Rename qa folder * Rename qa to quantitative * Rename the actual routes in quantitative * Equity cleanup (#5707) * cleanup * static * renaming to equity cc @the-praxs * Proof reading --------- Co-authored-by: hjoaquim Co-authored-by: Theodore Aptekarev * Don't enforce imperative for first word of the docstring * Remove ultima from default extensions * Rename `economy` and create `index` extension (#5705) * renamed economy and re-recorded tests * static * market indices * european indices * fred indices * index constituents * tests * correct package name * oops * static * linting * Move COT commands to regulators * Rename economy.list to available_indices * Rename GDP models and clean up * Fix charting tests * Drop _indices from available_indices command * Fix obbject to_dict test --------- Co-authored-by: Theodore Aptekarev * Rename etf/disc (#5715) * Docs/v4-working-docs: PR to Work on V4 Docs (#5693) * Revert changes related to pydantic2 made into v3 code * Revert fred model changes in v3 * Revert pydantic2 databento model changes in v2 * Update some names and v3 lock file * Clean up openbb/package before the beta release * Platform publishing procedure (#5701) * update instructions * introducing the version script * publish message * fix platform path * reflecting version changes * getting version from installed packages instead * removing toml from dependencies * Changes to get `a7` out (#5697) * changes to get a7 out * etf menu on the pyproject.toml * poetry lock * bump `openbb-etf` to `a5` to match version * updated deps * removing ultima * removing references to a4 cc @the-praxs * Bump index menu version * poetry lock --------- Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * Update publishing instructions * Bump core dependencies in extensions and providers * Add changes to the publish script following the beta release * Update the versions in static extension map and openbb metapackage --------- Co-authored-by: James Maslek Co-authored-by: Pratyush Shukla Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> Co-authored-by: tehcoderer Co-authored-by: DidierRLopes Co-authored-by: andrewkenreich Co-authored-by: Sandip Saha Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Adi Sai * Hotfix/pypi openbb terminal (#5719) * renaming the project * documentation changes * Finishing touches to the publishing procedure (#5728) * finishing touches to the publishing procedure * grammar improvements * Run tests on develop (#5725) * Run tests on develop * Add a check that files changes in platform * Seprate Intrinio financials data tags into a different command (#5723) * add `ebit` field in income statement standard model * only add required data tags * remove calculations data * use `name` key instead of `tag` key * set `period` as required in data * remove `period` and `cik` from provider models * add `equity/fundamental/search_financial_attributes` with tests * clean descriptions file * add `equity/fundamental/financial_attributes` with tests * set `value` as `Optional` * Fix threadpool test error (#5734) * Remove ultima from deps (#5736) * remove ultima from deps * skip ultima test * black * change skip location * try except statement to avoid error on the ci * new currency reference rates pr (#5724) * point files to linters (#5739) * remove news from equity (#5741) * Add tiingo provider (#5740) * first commit * things * Add news endpoints * CryptoHistorical * Add currency and trailing dividend yield * things working * deps * fix pre commit things * tests? * black on the tests * pratty told me to add it * integration tests * added helpers * crypto revamped * currency revamped * trailing dividend yield revamped * equity historical revamped * company news overhauled * global news overhauled * remove `tags` param from news models * crypto correct `exchanges` description * james smh * re-recorded fetcher tests * fixed integration tests * econometrics smh * james smh again --------- Co-authored-by: Pratyush Shukla * Add `derivatives` extension for `futures` and `options` (#5742) * removed options and futures * add derivatives extension * cleanup * bug #5649 (#5722) * bug #5649 * fixing --a upmom, downmom --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Rename the fmp search -> screener (#5744) * Rename the fmp search -> screener * misses some * i cant copy paste * docs/fix-urls: Updates the Terminal About URLs to match `/develop` (#5720) * update Terminal about URLs and some other broken links * ruff * intro * changing the heading levels * dependency management sections * structure * developer guides * structure * contributor guides * keywords and descriptions * broken urls * cool cards * Cool cards (#5727) * tidy up terminal/content * some more tidy up * fix styling for platform that was missing * more tidy up * improve color for dark and light mode * create new reference card for more basic cards * rename back to menus * implement all index.md for terminal, except reference * improve bot title * more refactoring * fix remaining index * header styling * more styling * heheheheheheeh * Revert "heheheheheheeh" This reverts commit 7d095fcfd258efb7e82b75b4663b5360785195f3. * Ccards (#5733) * links * more links * improved styling and chevron aligned to title * fix index.mdx urls for Terminal * update package.json * update index.mdx * fix generation * spelling * toolkit_extensions * update data extensions * couple of links * add tiingo to data extensions list --------- Co-authored-by: hjoaquim Co-authored-by: andrewkenreich Co-authored-by: DidierRLopes Co-authored-by: James Maslek * Stock leftover cleanup (#5745) * change to equity in `.md` files * `HistoricalStockSplits`->`HistoricalSplits` * `StockInsiderTrading`->`InsiderTrading` * sorry fmp * `EquityHistorical` cleanup * `EquityNBBO` cleanup * .md leftover * the last of stocks * Hotfix/urllib to dev group (#5732) * use the urllib3 dependency on the dev group instead * adapt the version script for the nightlies - if it's a nightly the package distribution name will have a different name * add dev dependencies to the dev installation bc of the ci * updating the import on validate_call according to: https://docs.pydantic.dev/latest/concepts/validation_decorator/ the way we were importing it breaks if pydanti… * [Docs] Guides for Metadata and AnnotatedResult (#6457) * [Docs] Redirect contributing URL (#6460) * redirect url * order * [Release] 4.2.2 (#6480) * Docs/update xl docs (#6145) * remove print * update obb.get docs * example * md lint * fix get reference (#6147) * [BugFix] Filter OECD data using `start_date` and `end_date` parameters (#6144) * move constant dicts to constants.py filter by start_date and end_date * black * black again again * Merge 'main' into 'develop' (#6151) * Release/3.2.4 (#5696) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * 3.2.3->3.2.4 * Changelogs * new changelog --------- Co-authored-by: Henrique Joaquim Co-authored-by: Andrew Co-authored-by: Adi Sai Co-authored-by: Sandip Saha Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Luqman Co-authored-by: Adwait <111136306+AdwaitSalankar@users.noreply.github.com> Co-authored-by: Abhishek Amar <66067391+abhishek-amar@users.noreply.github.com> Co-authored-by: DidierRLopes Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Ramazan Co-authored-by: joshuabuildsthings Co-authored-by: wojda <114031148+polooner@users.noreply.github.com> Co-authored-by: Bim Phomthong <118195204+bimbolimbo@users.noreply.github.com> * Release/4.0.1 (#5840) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * Release/3.2.4 (#5704) * 3.2.3->3.2.4 * Changelogs * new changelog * OpenBB Platform v4 (#5225) * change location * check something * add cache * fixed auth w/@IgorWounds and @montezdesousa * fixes for econometrics * include Darren auth suggestions * some routers included if dev + chg hub backend var * coverage router should not be here * update docker readme * forgot to check auth here * Change extension imports * update docstrings and readme * headers function wasnt being called, just referenced * relative import * econometrics add headers everywhere * Fix QA * Fix TA * Fix test * Fix python interface QA and TA * Lint * Cleanup * Change path * make the changes and some etf models * tests for command_runner * ruff * solving naming issues on pytest * Update some docstrings, fix typos and lint * solving econometrics instantiating wrong openbb * chaging the way pytest runs * messing around with the imports * ruff * Change template to add platform considerations (#5533) * change template to add platform considerations * @the-praxs suggestions * solving __pycache__ issue * removing typo * ci yml * making linters happy (i guess) * Improve Omega Ratio and docstrings * chaging pro validation hash * ruff * Fix OLS Summary and lint * Add OECD Provider for economy extension (#5534) * Add record to docs * update a couple of cboe models * Fix econometrics bugs. Make tests pass. Lint. * black * ruff * pydantic v2: remove deprecated Extra * pydantic v2: self.dict -> self.model_dump * revert pydantic * revert the revert * try 1: pin urllib3 < 2 * Revert "try 1: pin urllib3 < 2" This reverts commit 3736c311cb6aa9e653dcb5db733798408b72a82e. * Revert dep * Fix * re-lock * Skip all tests when doing cspell in pre-commit * Resolve linter errors * Add OECD to install script * Add OECD * Resolve more linter errors * Exclude static files of v4 python from ruff * More linting * Another attempt to resolve even more linting errors * Change how Literal is used * ticker. symbol. consistent. @piiq * change ticker field in Stock Search to is_symbol * Update Cboe model for stocks_search -> is_symbol parameter. * Fix issue * Lint * Small QA to rename SDK to Platform (#5544) * SDK -> Platform in docs * renamed in core * renamed in openbb `init` * `sdk` variable renamed as `platform` --------- Co-authored-by: hjoaquim * `validator` -> `field_validator` in standard models * Standard convention for multi-ticker symbols (#5549) * standardize symbol input param in forex and crypto historical data * static * linting * Fix stock_search integration test params * Update dependencies and linting on the CI (#5550) * Remove ruff and black from platform dependencies * Update codespell configuration * Lint python code * Add toml and tomli to root dev dependencies * Update requirements.txt files * Fix buggy docstring in python package methods (#5548) * fix buggy docstring for methods * remove space * fix typing * avoid name collision with validator * Revert "avoid name collision with validator" This reverts commit 8a30a44555d97132f6bddcbc4a4facdd97ecc591. * typing * rebuild * python 3.8, ParamSpec not available * lint * ruff noqa * Merge with develop (#5551) * Charting extension integration tests (#5547) * initial proposal for integration tests on the charting extension * int tests for charting generation * python generator * ruff * boilerplate templates * python tests * tests for the api * using body instead so data don't get redefined * unit tests for coverage * ruff * docstrings * unnecessary access to keys() * Add trading economics economic calendar * dev install * Data Models disposition on the website (#5538) * pydantic v4 * flat structure * md files * Revert "md files" This reverts commit bd2170e2adf82fed3a35d34fad6a2e3ba3ae1d49. * improve command descriptions * nice title and description * human readble data model names on left panel * implementation details section * content markdown files * markdown versioned files * showcase page * updates --------- Co-authored-by: tehcoderer * everything except tests * fix `datetime.date` import in fetcher test * modified url to remove `api_key` placeholder * record test * api key is called c here * fixed fetcher test for api key * recorded tests * refactor * life is ruff * codespell * Make Intrinio options chains great again (#5540) * add multithreading * cleanup * linting * use dateutil.parser * removed `TICKER_EXCEPTIONS` * modified `date` and `type` fields in standard model * set alias for `date` and `type` to match standards * static * static * Hotfix/fix post tests (#5555) * Fix econometrics * Fix ta * Fix qa. Remove intrinio to not be rate limited * Lint * Fix typo * obbject tests (#5558) * obbject tests * ruff * fix dev_install * fix unittests * black on nox * black on nox * nox * fix fetcher test so it can compare dates * fix intrinio tests * ruff * change to model_dum() instead (#5561) * Passing tests (#5560) * Passing tests * fix options * Fix most tests and bugs * fix forex missing params * make symbol upper in polygon fx pairs * fix fixedincome integration tests (#5564) * Fixing charting api integration tests (#5562) * fixing charting api integration tests * black * fix stocks less five API fails * fix the 5 failing stocks integration tests * recapture fmp stock news unit test * fix fmp forex api test * couple more forex integration fixes * changing the request to always use the legacy session. @jmaslek this is was broken for 3.8 and 3.9; with this change apparently all versions work - lemme know if you see any issue with this change * ruff * fix ta * add missing param * fix testers for the api * fix globalnews to use images instead of image * remove unncessary pandas import * econcal int tests * update gitignore * fix get_querystring to support lists * add missing parameters --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Henrique Joaquim * Stock Historical standardization and UX improvements (#5457) * polygon add interval standard param * attempt at standardization * Alpha Vantage params standardization * rename `get_intervals` and fixed bug for extracting wrong value * missed changing it in `extract_data` * linting * polygon cleanup * modified `start_date` & `end_date` type to `datetime` from `dateType` * standardized intrinio stock historical params * fixed yfinance * linting * revert start and end date to dateType from datetime * fix alpha vantage * changed param * fix intrinio infinite loop * `validator` is `field_validator` * revert time params and fixed intervals * `outputsize` alias set in `Field` * set interval description using in-build dict * yfinance stock param standardization * static * intrinio cleanup * Polygon add api params as `PrivateAttr` * modified yfinance params to `PrivateAttr` * intrinio remove overriding date params * fixed description for AV adjusted param * fix alpha vantage intraday not working * re-record and pass unit tests * pass integration tests * Update test --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Fix econcal endpoint (#5567) * fix econcal for python interface * fix econcal tests * fix non supported json output * Fixes FMP index endpoint to get 1 day interval data (#5535) * fix FMP endpoint for getting index data for `1day` interval * fix `open` type to prevent validation error * modifed `validator` to `field_validator` * type of fields is `StrictFloat` * re-record and pass test * linting * `validator` -> `field_validator`, a3'd everything * Fix regression in tests. Lint * updating the integration test actions * Fix typo * Fix typo * Fix import * Publish versions `a3` to Pypi (#5568) * bump versions and script to publish * small improvements * uncomment exception * openbb * publishing guidelines * improve docs * add providers to economy api * make symbol required in stock_quote * Fix keys * Fix oecd * add comma * revert * Add quotes * Sleep * Improve tests * Improve * Feature/query transform (#5566) * inject query into transform_data * swap query and data * update missing fetchers * last test failing * sig test fetcher * black * av add `query` to `transform_data` call * transform_data: missing refactoring * fix uvicorn command in the doc * Automated examples (#5576) * Automated examples * Fix bug * Lint * static assets built on 3.8 * Revert "static assets built on 3.8" This reverts commit fb82ff7bd9af92ed676d8f8047c31e74daf7b8b2. * remove assets * static assets on 3.8 * static assets on 3.8 * Wrap in quotes * Improve wrap * minor fix * rebuild 3.8 * Fix bug * Fix edge case * Lint * rebuild --------- Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa * use SecretStr for sensitive fields (#5578) * use SecretStr for sensitive fields * fix * docstring * Add tests for provider (#5583) * Add tests for provider * Test standard models * Lint * Fix standard model issues. Co-authored-by: @the-praxs * linting * `symbol` -> `is_symbol` in `economy.index_search` * static --------- Co-authored-by: Pratyush Shukla * feature/v4-biztoc-provider: Adds Biztoc provider and GlobalNews (#5546) * add biztoc provider * duplicate field * black * request headers * recapture test * move stuff around * add integration tests * duplicate OECD entry in dev_install * duplicate entry for oecd in pyproject.toml * Add Biztoc to workflow * update readme: credentials * Add Preferences to README * improve tests * fix biztoc * obbject pylint * Bug fix: serializ SecretStr before dumping to json * export credentials as json (#5592) * Check for wrong, changed, or outdated params. (#5597) * Improving `economy.cpi` for the FRED data (#5602) * remove multiindex using coding magic * Update field descriptions --------- Co-authored-by: Theodore Aptekarev * Improve error message. * Improve * Test tests (#5607) * Test tests * Add test * 4.0.0a4 PyPI publishing (#5608) * changes to publish * fix mini conflict * typo * cleaned `descriptions.py` * fix description in `cpi.py` * Add ETF extension to v4 (#5609) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add ETF historical price from yfinance (#5610) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add etf historical price standard model and route * Add etf historical data from yfinance * Add unit tests * Fix linter error. Organize imports * Update test data * Revert common descriptions erased by CPI PR * remove `symbol` from data for `stocks.ca.peers` * Test docstrings (#5613) * Test docstrings * fix minor bugs w/@IgorWounds * static only w/@IgorWounds * fix `importance` param in `economy.econcal` * right static only w/@IgorWounds * Fix econcal and add tests to noxfile * fix econcal static * re-record --------- Co-authored-by: Pratyush Shukla * Clean up the newly created ETF extension (#5611) * Add ETF to dev_install bundle * Add integration tests for openbb-etf * Patch integration test generator scripts to produce lintable code * Add py.typed markers for extensions * user preferences descriptions (#5593) * user preferences descriptions * typo * Feature/v4-sec-provider: Add SEC provider to V4 (#5556) * coerce string type, add default=None * add sec provider and FTD function * update description * ruff * data model definitions in standard model already * duplicate oecd entries in dev_install and pyproject * actually commit * integration test * add stock search to SEC * add company filings for SEC provider * integration tests * remove duplicated line * ruff * **kwargs in Transform Data * some helper functions for later * black * add helper for mutual fund and etf lookup * add some SEC lookup helpers to a new regulators extension * black * ruff * fix test param * take institution filter out of sec stock_search * ruff * remove URL that codespell doesn't like * add cik-to-ticker map * add litigations rss feed * make openbb-regulators a dependency of openbb-sec * add SIC search * improve ftd and remove BeautifulSoup from SEC dependencies * fix parsing the zip files pre-2009 * ruff * update descriptions * recapture ftd test * tests params * typo * change limit param to 1 in test_sec_stock_ftd * Add didiers to_records method (#5588) * Add didiers to_records * unused import * Bring back polars + do what igor suggested * Make the output consistent with what it was. * Black ? * spelling. oops. almost like we have a pre commit or something * Feature/v4-price-performance: % returns for various horizons, comparable across multiple tickers. (#5618) * coerce string type, add default=None * add price_performance endpoint from FMP * black * extra period in docstring * ruff * forgot one file * Feature/ipo-calendar: V4 IPO Calendar (#5605) * coerce string type, add default=None * add intrinio ipo calendar * fix typo * sort __init__ * fix description * make requested changes * update test params * black * test updates * etf integration * Add disc router and WSJ provider * OBBject extensions (#5612) * changes to core * bug? * docstring * doc * Update credentials.py * fix model_dump * create extensions * fix docstring * doc * revert change query_exc * doc * fix container test * redirect obbject test patch * doc * rename method * move decorator to extension file * rename method extend_obbject * changes in creds model * avoid credential racing * doc * rename prop * doc * doc * remove comment * comment some code * free extension names * docstring * doc * docs * Hotfix/fix-v4-economic-calendar: Add FMP to Econ Calendar and fix some TE bugs (#5580) * coerce string type, add default=None * adds fmp to economic calendar and fixes some things with TE * ruff * etf integration test * missing provider for test * rename te cassette to economic_calendar * fix test * rename tests --------- Co-authored-by: James Maslek * Add stocks disc endpoints (#5630) * Add stocks disc endpoints * Explicit * Lint * Add tests * Bump timeout * Feature/disc router (#5616) * Add disc router and WSJ provider * Lint * Lint * Move endpoints under ETF router * Update etf_performance.py * Add ETF info and sector exposure from FMP (#5620) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Fix linter errors after the merge * Fix more linter errors * Fix failing and add missing tests * Fix integration tests * Fix calendar ipo tests * Add ETF holdings and holding report dates from FMP (#5629) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Add etf holdings and holdings date routes and standard models * Add fmp holdings and holding dates fetchers * Update holdings fetcher to properly handle date object inputs * Add unit tests * Add integration tests * Black after merge * Fix test input data format * Disc router for equities. (#5640) * Disc router for equities. * add tests * Bug fixes in financial statements (#5537) * `validator` to `field_validator` in standard models * Polygon add `ttm` to `period` param * Revert "Polygon add `ttm` to `period` param" * Polygon add `ttm` to param `period` * `EarningsCallTranscript` standard model removed `quarter` param * use `tag` instead of `name` for correct field name * fix url for intrinio income statement * modified intrinio cash flow `transform_data` function * set optional data fields and validate dates * fix insider trading not fetching recent data * linting * refactoring * refactoring * set param alias in fmp stock insider provider model * get all quarter data for intrinio * add `limit` param to `stocks.fa.ins` * refactoring and linting * removed additional comment * linting * re-recorded and fix tests * cash flow standard model field type to `StrictFloat` * Intrinio cash flow model fixed to get all quarters' data * linting * refactoring * financial statement standard model field type to `StrictFloat` * Intrinio financial statement model get all quarter data * set `period` type to `Optional[str]` * add `period` param to balance sheet provider models * add `period` param to cash flow provider models * use alias in model dump * remove `ttm` from `period` param * revamped intrinio financials * fixed incorrect description for `limit` param * modified tests for `balance`, `cash` and `income` * re-recorded tests * skipped intrinio financial statement fetcher tests * Add ETF county weighting command with FMP data (#5645) * Remove code that wrongfully infers the filing date as end of quarter * Add etf countries command with fmp data * Add countries command to etf router * Update sector and country weighting fmp models * Fix docstring typo * Add unit tests and update mock data * Add integration tests for etf.countries * Bring back missing integration tests * Fix economic calendar integration tests * fix missing data in intrinio financials * removed inutile params from Polygon financial statement models * Intrinio IPO overhaul * tests fixed and re-recorded * Add ETF holdings performance with FMP data (#5659) * Add etf holdings performance endpoint * Add tests * Fix failing polygon fetcher tests * Split long holdings lists into chunks and update test data * Change chunk length to 500 tickers * Add stock search from FMP (#5642) Co-authored-by: Theodore Aptekarev * Feature/v4 pypi (#5579) * improvements to the publish script * move scripts * initial script that builds the package * adjustments on the docs * test pypi workflow * add hour and minute to version * black * ruff * duplicate file * moving files instead * build throught the script instead * update nox file * integration tests workflow * change workflow * fix dev_install * fix in sed cmd * testing the platform only * commenting out the publishing * fix run commands * improvements to the publish script and doc * fix publish script * updating the script and the workflow * feature/v4-pypi nightly (#5589) * init * Update nightly.py * cleanup * init file * not referencing dev_utils * updating obb platform key * revert * Increase warmup time * project name on pyproject and adding the --pre flag on readme * moving to the build folder * fix noxfile * reflecting the moves on the import statements * fix pyproject path * ruff * fix paths * fix super typo * update workflows * moving the pypi terminal files into its folder --------- Co-authored-by: teh_coderer Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Theodore Aptekarev * economy.calendar nasdaq (#5628) * add quandl econcal * unittest * add integration tests * replace   * fix bug TE importance * small fix * remove stuff from quandl * add nasdaq provider * add nasdaq to install files * Update test_economy_api.py * test * quandl leftovers * remove quandl econcal test * lint * replace   * ruff * lint * update nasdaq gmt * validate countries * here * no need for this * fix calendar tests * static * static * remove error * static * readme + website * readme * remove changes TE * typo * fix unittest * fix tests * Update __init__.py * Update economic_calendar.py * revamped model and added helpers for date range --------- Co-authored-by: Pratyush Shukla * Feature/v4-dividend-calendar: Adds Nasdaq dividend calendar and moves the command out of fundamental_analysis (#5672) * add nasdaq dividend calendar and move out of fundamental_analysis * black * ruff * add random-user-agent to pyproject.toml * add nasdaq ipo calendar * add nasdaq flag for SPO to IPO calendar * add spo test param * black * dividend test * fix transform_query - nasdaq_calendar_ipo * bring back different headers for ipo calendar * remove references to test * Add disc endpoints (#5660) * Add Quandl top retail * Add tests * Add Seeking Alpha * Add Filings * Change Provider * Fix test * Add dev_install * static * static correct * y u forget me * updated deps * static --------- Co-authored-by: Pratyush Shukla * using dev install (#5673) * Expanding the `fixedincome` menu (#5655) * models and fetcher * making the fetcher visible * std model * adding the command * improvements to the models * typo * adding the command * imrpovements to dwpcr * standard model for ecb int rates * adding the fetcher for fred * standard model of ice bofa * add ice_bofa command * ruff * ice bofa fetcher * moody std model * moody * std model * add cp command * unused import * cp * spot * ruff * hqm * tmc * ffrmc * tbffr * ruff * typing fixes * buggy dates * fred fetcher tests * ruff * adding ecb as a provider * adding new provider related stuff * adding the new command eu_ycvr * models * test for ecb fetcher * Feature/v4 fixedincome int tests (#5661) * integration tests * happy ruff * mini adjustment * ruff * typo * verbose type * fix tests * docstrings everywhere and an happy pydocstyle * fix tests * Feature/user-cache-dir: Add User Preference for the Cache Directory (#5621) * add user preference for storing cached data * ruff * fix tests? * fix test key error..? * etf integration test fix * add cache dir to SEC * black * improve docs structure for V4 (#5586) * improve docs structure for V4 * moving over changes * Add Docs to the navbar * add some, re-order sidebar * fix sentence * add docs install to source instructions * insert a couple of links, fix a typo * big terminal docs usage revamps * improve toggle component for tutorials * get rid of TOCs for all terminal docs for consistency and simplicity * improve platform docs * improve bot docs content structure * remove index from bot docs * improve ON THIS PAGE to only display TOC if at least 1 element * make edit this page text and icon on same line * add author and date to docs * add basic syntax page to usage * sidebar order for usage section * move api start command to the top with the import python import * some install page additions * small improvement * refactor routines section * Update introduction-to-routines.md * Update pipeline-of-commands.md * Update introduction-to-routines.md * Update routines-for-power-users.md * Update community-routines.md * update keyboard hotkey macros * askobb page * Update askobb-feature.md * Update index.md * Update index.md * Update index.md * Update index.md * fix images * remove HeadTitle from all files where it exist * get rid of extra spacing in markdown * small update * small edit * need index at the start because of main path when homepage of docs * use openAI to create SEO for front matter on my behalf * remove table of content from sdk page * finish improving metadata SEO for SDK docs * update duplicate header * update HeadTitle to be more specific on product * remove index from bot telegram reference * delete duplicated title for platform reference * another update * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * start PR so screenshots can get attached via GitHub website * Update qa.md * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * Update crypto introduction.md * titles * another title * Update crypto dd.md * Update defi.md * Update disc.md * Update nft.md * Update onchain.md * Update ov.md * Update introduction.md updates URL * Update introduction.md add HeadTitle * Update ba.md * Update comparison.md * Update dark-pool-shorts.md * Update disc.md * fix docs (#5646) * Update fa.md * Update gov.md * Update ins.md * Update tradinghours.md * Delete website/content/terminal/menus/stocks/options/screener.md * Update Options introduction.md * Update screener head title * Update screener TOC * Update econometrics.md * Update economy head title * Update etf.md * codespell * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Contributing guidelines (#5615) * intro section * what's expected sections * improve sections * improve sections and move how to add a data point * moving qa under contributor * better intro * moving the sharing section * better expectations * small intro to the contributor guidelines * moving things under the contributor section * there is no pre commits on the platform yet * dependency management * best practices for extensions * typo * collapse options subfolder * codespell * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update fixedincome.md * url * Update forecast.md * Update settings.md (#5665) * Update forex.md * fix front matter (#5667) * Fix conflict markers that got into markdown during previous merges * Fix front matter list formatting * Fix typo * small thing * fix hyperlinks * Update .codespell.ignore * output_type options * Architectural considerations * Update sidebar to hide pro section by default * Minor copy changes * TET pattern * import statements * clarification on preferences * Minor copy changes * Lint markdown and python * fix: open index on collapsible root elements * remove old content * options title * Fix linting errors * Refactor sidebar label to url mapping condition --------- Co-authored-by: andrewkenreich Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: hjoaquim Co-authored-by: Sandip Saha Co-authored-by: James Maslek Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Theodore Aptekarev * Add multi-ticker support to etf_countries (#5670) * add multi-ticker support to etf_countries * remove commented-out lines * normalized percent points * percent -> percentage * Fix Nasdaq Econ Calendar Fetcher (#5668) * fix nasdaq econ cal request * more html tags * add random-user-agent to pyproject * another edge case - 24H -> 00:00 * Feature/v4-unusual-options: Adds unusual options endpoint. (#5677) * add unusual options fro Intrinio * test params * move sorting * Change type * update FMP fetcher to use the V4 endpoint (#5681) * Fix price performance not parsed correctly when there is only 1 ticker (#5678) * Add crypto search standard model and FMP data for it (#5679) * Apply renaming to news data (#5684) * inegration complete * reformatted for black * fix ruff issues * revised integration * changes to versions in pyproject.toml and updated lock files * Rename models * Update tests * Fix typos here and there * Update routers * Apply rename to ultima * Properly mock api key * Mock ultima api key --------- Co-authored-by: Adi Sai * Feature/v4-market-snapshots: Adds full market snapshots (#5473) * add stocks market snapshots from fmp * add fmp fetcher test * unused imports * add polygon to market_snapshots * update fmp market_snapshots * black * pydantic2 things * updates * change validate_obj to model_validate * polygon cleanup * tests * descriptions * black * data description * minor adjustments, using less local variables, improving readability and removing pandas * better structure * minor adjustments * lint * fix int tests --------- Co-authored-by: hjoaquim * Add NBBO Quotes, with historical, to `obb.stocks.quote()` (#5617) * coerce string type, add default=None * add polygon stock quote * limit cleanup * add greater/less than to params * limit param * black * tests * fix tests * test_etf * rename model and function to NBBO * add standard model for nbbo * improve standardization * not redifining builtin max * fix input params * integration test params * removing unused import Co-authored-by: Pratyush Shukla * revamped code * re-recorded nbbo test * added symbol validator * added alias in field * Stock news -> Company news --------- Co-authored-by: hjoaquim Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * hotfix/update-quandl-to-nasdaq: Merge Quandl + Nasdaq (#5682) * merge quandl nd nasdaq * dev_install.py * test param name * economy python integration test * Add more input types to data processing commands (#5453) * adding more supported types to data processing commands * ruff * removing unused import * docstrings * data processing types covertion * data description * test filters * ruff * fix package builder tests * ruff * removing print * Add stocks/dps module (#5638) * short volume * pyproject missed * add sec short interest with days to cover * Add FINRA OTC endopoint * some tests * rest of unit tests * Integratin test scripts * dev install * linters caught by pre commit * lines too long * Last test files * maybe it needs a lock file? * thanks pratty * Maybe ill actually listen to pratty next time * sec test date freeze * I cant hit buttons * re record tests * tests 3 * Stockgrid test * regen int test * more testing * lint * moved these fns * dis killing me * one more test * last one * Update integration tests * Fix tests picking up wrong dps route --------- Co-authored-by: Theodore Aptekarev * Rename Forex to Currency (#5687) * restore fields as optional (#5686) * Rename Crypto (#5689) * added `crypto.price.historical` * static * fix tests * fix incorrect label * Move model from sec to finra (#5692) * Update toml * fixed deps * add openbb-etf lock file * cleanup * cleanup (#5694) * Rename Fixed Income (#5695) * Rename Fixed Income * Add routers * Rename stocks to equity (#5688) * Rename stocks folder * Rename openbb_stocks package * Rename routers * Reroute equity menu * Update routes based on feedback * StockNews -> EquityNews * StockInfo -> EquityProfile * Rename Equity calendars * Equity peers rename * Rename discovery * Rename fundamental * Rename price command models * Rename shorts * Update charting router * Fix seeking alpha upcoming release date * Fix linting errors * Update tests * Fix tests * Skip econometrics api tests because it's python only * Update integration tests and test data * Historical analyst estimates * Skip cboe options chain test. Unable to record vcr cassette * re-record cboe cassettes * Document CBOE unit test creation caveats --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Feature/files-for-igor: Adding a few standard models for Igor (#5699) * add some standard models for Igor * codespell * update descriptions * Add devtools metapackage (#5703) * Add openbb-devtools metapackage * adding devtools to the dev_install script --------- Co-authored-by: hjoaquim * Rename econometrics commands to be more verbose (#5702) * Expose command to model map (#5706) * Rename ta qa (#5708) * Rename ta folder * Rename ta to technical * Rename qa folder * Rename qa to quantitative * Rename the actual routes in quantitative * Equity cleanup (#5707) * cleanup * static * renaming to equity cc @the-praxs * Proof reading --------- Co-authored-by: hjoaquim Co-authored-by: Theodore Aptekarev * Don't enforce imperative for first word of the docstring * Remove ultima from default extensions * Rename `economy` and create `index` extension (#5705) * renamed economy and re-recorded tests * static * market indices * european indices * fred indices * index constituents * tests * correct package name * oops * static * linting * Move COT commands to regulators * Rename economy.list to available_indices * Rename GDP models and clean up * Fix charting tests * Drop _indices from available_indices command * Fix obbject to_dict test --------- Co-authored-by: Theodore Aptekarev * Rename etf/disc (#5715) * Docs/v4-working-docs: PR to Work on V4 Docs (#5693) * Revert changes related to pydantic2 made into v3 code * Revert fred model changes in v3 * Revert pydantic2 databento model changes in v2 * Update some names and v3 lock file * Clean up openbb/package before the beta release * Platform publishing procedure (#5701) * update instructions * introducing the version script * publish message * fix platform path * reflecting version changes * getting version from installed packages instead * removing toml from dependencies * Changes to get `a7` out (#5697) * changes to get a7 out * etf menu on the pyproject.toml * poetry lock * bump `openbb-etf` to `a5` to match version * updated deps * removing ultima * removing references to a4 cc @the-praxs * Bump index menu version * poetry lock --------- Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * Update publishing instructions * Bump core dependencies in extensions and providers * Add changes to the publish script following the beta release * Update the versions in static extension map and openbb metapackage --------- Co-authored-by: James Maslek Co-authored-by: Pratyush Shukla Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> Co-authored-by: tehcoderer Co-authored-by: DidierRLopes Co-authored-by: andrewkenreich Co-authored-by: Sandip Saha Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Adi Sai * Hotfix/pypi openbb terminal (#5719) * renaming the project * documentation changes * Finishing touches to the publishing procedure (#5728) * finishing touches to the publishing procedure * grammar improvements * Run tests on develop (#5725) * Run tests on develop * Add a check that files changes in platform * Seprate Intrinio financials data tags into a different command (#5723) * add `ebit` field in income statement standard model * only add required data tags * remove calculations data * use `name` key instead of `tag` key * set `period` as required in data * remove `period` and `cik` from provider models * add `equity/fundamental/search_financial_attributes` with tests * clean descriptions file * add `equity/fundamental/financial_attributes` with tests * set `value` as `Optional` * Fix threadpool test error (#5734) * Remove ultima from deps (#5736) * remove ultima from deps * skip ultima test * black * change skip location * try except statement to avoid error on the ci * new currency reference rates pr (#5724) * point files to linters (#5739) * remove news from equity (#5741) * Add tiingo provider (#5740) * first commit * things * Add news endpoints * CryptoHistorical * Add currency and trailing dividend yield * things working * deps * fix pre commit things * tests? * black on the tests * pratty told me to add it * integration tests * added helpers * crypto revamped * currency revamped * trailing dividend yield revamped * equity historical revamped * company news overhauled * global news overhauled * remove `tags` param from news models * crypto correct `exchanges` description * james smh * re-recorded fetcher tests * fixed integration tests * econometrics smh * james smh again --------- Co-authored-by: Pratyush Shukla * Add `derivatives` extension for `futures` and `options` (#5742) * removed options and futures * add derivatives extension * cleanup * bug #5649 (#5722) * bug #5649 * fixing --a upmom, downmom --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Rename the fmp search -> screener (#5744) * Rename the fmp search -> screener * misses some * i cant copy paste * docs/fix-urls: Updates the Terminal About URLs to match `/develop` (#5720) * update Terminal about URLs and some other broken links * ruff * intro * changing the heading levels * dependency management sections * structure * developer guides * structure * contributor guides * keywords and descriptions * broken urls * cool cards * Cool cards (#5727) * tidy up terminal/content * some more tidy up * fix styling for platform that was missing * more tidy up * improve color for dark and light mode * create new reference card for more basic cards * rename back to menus * implement all index.md for terminal, except reference * improve bot title * more refactoring * fix remaining index * header styling * more styling * heheheheheheeh * Revert "heheheheheheeh" This reverts commit 7d095fcfd258efb7e82b75b4663b5360785195f3. * Ccards (#5733) * links * more links * improved styling and chevron aligned to title * fix index.mdx urls for Terminal * update package.json * update index.mdx * fix generation * spelling * toolkit_extensions * update data extensions * couple of links * add tiingo to data extensions list --------- Co-authored-by: hjoaquim Co-authored-by: andrewkenreich Co-authored-by: DidierRLopes Co-authored-by: James Maslek * Stock leftover cleanup (#5745) * change to equity in `.md` files * `HistoricalStockSplits`->`HistoricalSplits` * `StockInsiderTrading`->`InsiderTrading` * sorry fmp * `EquityHistorical` cleanup * `EquityNBBO` cleanup * .md leftover * the last of stocks * Hotfix/urllib to dev group (#5732) * use the urllib3 dependency on the dev group instead * adapt the version script for the nightlies - if it's a nightly the package distribution name will have a different name * add dev dependencies to the dev installation bc of the ci * updating the import on validate_call according to: https://docs.pydantic.dev/latest/concepts/validation_decorator/ the way we were importing it breaks if pydantic=2.5 @montezdesousa * loosing urllib3 version specification on the provider and adding it to platform dev deps * rmeoving urllib from top level deps; and removing --with dev flag * changing to ^ instead * Revert "changing to ^ instead" This reverts commit 7300904e9f3adba372b106d381b70ae06e28795a. * unnecessary dep --------- Co-authored-by: Theodore Aptekarev Co-authored-by: James Maslek * feature/v4-bop - Add ECB Balance of Payments (Replaces #5716) (#5726) * add ecb balance of payments * missing __init__.py files * Nasdaq calendar earnings and fix FMP calendar earnings (#5718) Co-authored-by: James Maslek * feature/us-treasury-auctions: Adds Treasury Auctions endpoint and provider for US Government Data. (#5746) * add government_us provider and treasury auctions endpoint * black * add param for cusip * move logic for setting default start/end date * Update hub<>platform credentials map (#5749) * update hub<>platform credentials map * typo * Add API settings schema to system settings (#5743) Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> * Skip checking creds (#5737) * skip checking creds * fix bug * ok mypy * add comment * rename required_credentials * fix * fix top_retail bug * don't require creds in some nasdaq fetchers * black * this was not here before * fix tests * update fetcher test * update contributing guidelines * Fix Quote (#5752) * Fix Quote * fixed return type and model validation --------- Co-authored-by: Pratyush Shukla * Wrap up renaming global news to world news on a model level (#5750) * Wrap up renaming global news to world news on a model level * cleanup --------- Co-authored-by: Pratyush Shukla * Remove eod from docstrings (#5751) * Wrap up renaming global news to world news on a model level * Remove "end of day" from historical price model docstrings --------- Co-authored-by: Pratyush Shukla * Massive docstring cleanup (#5755) * sec router remove command * standard models cleanup * fmp cleanup * av cleanup * benzinga cleanup * biztoc cleanup * cboe cleanup * ecb cleanup * finra cleanup * fred cleanup * us cleanup * intrinio cleanup * nasdaq cleanup * oecd cleanup * polygon cleanup * sec cleanup * seeking alpha cleanup * stockgrid cleanup * tiingo cleanup * tradingeconomics cleanup * ultima cleanup * wsj cleanup * yfinance cleanup * sec router lint * fix date query param description * Updates system and api settings (#5753) * remove uncessary import on rest api * remove FrozenField and add api.version * allow setup from json * remove id tag * computed field is better * formatting --------- Co-authored-by: Theodore Aptekarev * Squeeze build time (#5756) * squeeze build time * bug fix * fix test * typo? * rebuild * keep tradingeconomics * docs/working-docs: Working V4 Docs PR (#5747) * post-install clarification, fix links * more links * change word * toolkit cleanup * rename 'contributing' to 'development' * update extensions * some urls * Update sdk-platform and v4-develop in urls (#5730) * Update sdk-platform and v4-develop in urls * Seprate Intrinio financials data tags into a different command (#5723) * add `ebit` field in income statement standard model * only add required data tags * remove calculations data * use `name` key instead of `tag` key * set `period` as required in data * remove `period` an… * [Docs] Fix Broken URLs (#6494) * fix broken urls * couple more * remove poetry install openbb_platform from docs generation. * Try it this way. * [Docs] Excel docs update (#6504) * update xl docs * update xl files * Release/4.2.3 (#6517) * [Release] 4.1.5 to `develop` (#6192) * Release/3.2.4 (#5696) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * 3.2.3->3.2.4 * Changelogs * new changelog --------- Co-authored-by: Henrique Joaquim Co-authored-by: Andrew Co-authored-by: Adi Sai Co-authored-by: Sandip Saha Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Luqman Co-authored-by: Adwait <111136306+AdwaitSalankar@users.noreply.github.com> Co-authored-by: Abhishek Amar <66067391+abhishek-amar@users.noreply.github.com> Co-authored-by: DidierRLopes Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Ramazan Co-authored-by: joshuabuildsthings Co-authored-by: wojda <114031148+polooner@users.noreply.github.com> Co-authored-by: Bim Phomthong <118195204+bimbolimbo@users.noreply.github.com> * Release/4.0.1 (#5840) * test * ultima description (#5541) * Updating showcase page (#5543) * updating showcase page * use sdk instead * add new bot command autopost docs (#5530) add new bot command autopost docs to docs.openbb.co Co-authored-by: James Maslek * Hotfix/ultima improvements (#5553) * tweaks for monetization * fix linting issue * fix: Modify 'load' behavior to append data to existing sheet (#5503) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Fixed 'worksheet not found' error during export to an existing sheet * Changes: * Now if the sheet exists in the xlsx file it will ask the user if he wants to replace/append/create new sheet --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * added platform API integration test to Nightly build (#5571) * Add columns to `stocks/search` (#5565) * Add columns to `stocks/search` isin, cusip, figi, composite_figi, shareclass_figi * Update test_search[False].txt * Update test_search[True].txt * Delete tests/openbb_terminal/stocks/cassettes/test_stocks_helper/test_search.yaml * Create test_search.yaml --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * updating ultima urls (#5587) * fix: A value is trying to be set on a copy of a slice from a DataFrame #5582 (#5591) * Update README.md (#5598) * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * fix docs (#5646) * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update settings.md (#5665) * fix front matter (#5667) * #5633 adding comma every 1000 (#5652) * #5633 adding comma every 1000 * pylint --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Hotfix/reports model render report sanitize inputs (#5669) * Adding more robust special character handling to create_output_path(). Addresses https://github.com/OpenBB-finance/OpenBBTerminal/issues/5299 * Running black linter on code to conform to OBB style guides. --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * hotfix/fix-gov-histcont: Fix #5650 - /stocks/gov/histcont (#5676) * fix histcont * some cleanup * remove sort line * 12-31 not 12-12 * columns_keep_types * remove space in regex (#5675) * Pin openai (#5685) * Clarified stocks/ta empty recom object message (#5468) * Clarified stocks/ta empty recom object message * black * lint --------- Co-authored-by: James Maslek * improved market cap value extraction (#5169) * improved market cap value extraction * pylint --------- Co-authored-by: James Maslek * Release/3.2.4 (#5704) * 3.2.3->3.2.4 * Changelogs * new changelog * OpenBB Platform v4 (#5225) * change location * check something * add cache * fixed auth w/@IgorWounds and @montezdesousa * fixes for econometrics * include Darren auth suggestions * some routers included if dev + chg hub backend var * coverage router should not be here * update docker readme * forgot to check auth here * Change extension imports * update docstrings and readme * headers function wasnt being called, just referenced * relative import * econometrics add headers everywhere * Fix QA * Fix TA * Fix test * Fix python interface QA and TA * Lint * Cleanup * Change path * make the changes and some etf models * tests for command_runner * ruff * solving naming issues on pytest * Update some docstrings, fix typos and lint * solving econometrics instantiating wrong openbb * chaging the way pytest runs * messing around with the imports * ruff * Change template to add platform considerations (#5533) * change template to add platform considerations * @the-praxs suggestions * solving __pycache__ issue * removing typo * ci yml * making linters happy (i guess) * Improve Omega Ratio and docstrings * chaging pro validation hash * ruff * Fix OLS Summary and lint * Add OECD Provider for economy extension (#5534) * Add record to docs * update a couple of cboe models * Fix econometrics bugs. Make tests pass. Lint. * black * ruff * pydantic v2: remove deprecated Extra * pydantic v2: self.dict -> self.model_dump * revert pydantic * revert the revert * try 1: pin urllib3 < 2 * Revert "try 1: pin urllib3 < 2" This reverts commit 3736c311cb6aa9e653dcb5db733798408b72a82e. * Revert dep * Fix * re-lock * Skip all tests when doing cspell in pre-commit * Resolve linter errors * Add OECD to install script * Add OECD * Resolve more linter errors * Exclude static files of v4 python from ruff * More linting * Another attempt to resolve even more linting errors * Change how Literal is used * ticker. symbol. consistent. @piiq * change ticker field in Stock Search to is_symbol * Update Cboe model for stocks_search -> is_symbol parameter. * Fix issue * Lint * Small QA to rename SDK to Platform (#5544) * SDK -> Platform in docs * renamed in core * renamed in openbb `init` * `sdk` variable renamed as `platform` --------- Co-authored-by: hjoaquim * `validator` -> `field_validator` in standard models * Standard convention for multi-ticker symbols (#5549) * standardize symbol input param in forex and crypto historical data * static * linting * Fix stock_search integration test params * Update dependencies and linting on the CI (#5550) * Remove ruff and black from platform dependencies * Update codespell configuration * Lint python code * Add toml and tomli to root dev dependencies * Update requirements.txt files * Fix buggy docstring in python package methods (#5548) * fix buggy docstring for methods * remove space * fix typing * avoid name collision with validator * Revert "avoid name collision with validator" This reverts commit 8a30a44555d97132f6bddcbc4a4facdd97ecc591. * typing * rebuild * python 3.8, ParamSpec not available * lint * ruff noqa * Merge with develop (#5551) * Charting extension integration tests (#5547) * initial proposal for integration tests on the charting extension * int tests for charting generation * python generator * ruff * boilerplate templates * python tests * tests for the api * using body instead so data don't get redefined * unit tests for coverage * ruff * docstrings * unnecessary access to keys() * Add trading economics economic calendar * dev install * Data Models disposition on the website (#5538) * pydantic v4 * flat structure * md files * Revert "md files" This reverts commit bd2170e2adf82fed3a35d34fad6a2e3ba3ae1d49. * improve command descriptions * nice title and description * human readble data model names on left panel * implementation details section * content markdown files * markdown versioned files * showcase page * updates --------- Co-authored-by: tehcoderer * everything except tests * fix `datetime.date` import in fetcher test * modified url to remove `api_key` placeholder * record test * api key is called c here * fixed fetcher test for api key * recorded tests * refactor * life is ruff * codespell * Make Intrinio options chains great again (#5540) * add multithreading * cleanup * linting * use dateutil.parser * removed `TICKER_EXCEPTIONS` * modified `date` and `type` fields in standard model * set alias for `date` and `type` to match standards * static * static * Hotfix/fix post tests (#5555) * Fix econometrics * Fix ta * Fix qa. Remove intrinio to not be rate limited * Lint * Fix typo * obbject tests (#5558) * obbject tests * ruff * fix dev_install * fix unittests * black on nox * black on nox * nox * fix fetcher test so it can compare dates * fix intrinio tests * ruff * change to model_dum() instead (#5561) * Passing tests (#5560) * Passing tests * fix options * Fix most tests and bugs * fix forex missing params * make symbol upper in polygon fx pairs * fix fixedincome integration tests (#5564) * Fixing charting api integration tests (#5562) * fixing charting api integration tests * black * fix stocks less five API fails * fix the 5 failing stocks integration tests * recapture fmp stock news unit test * fix fmp forex api test * couple more forex integration fixes * changing the request to always use the legacy session. @jmaslek this is was broken for 3.8 and 3.9; with this change apparently all versions work - lemme know if you see any issue with this change * ruff * fix ta * add missing param * fix testers for the api * fix globalnews to use images instead of image * remove unncessary pandas import * econcal int tests * update gitignore * fix get_querystring to support lists * add missing parameters --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Henrique Joaquim * Stock Historical standardization and UX improvements (#5457) * polygon add interval standard param * attempt at standardization * Alpha Vantage params standardization * rename `get_intervals` and fixed bug for extracting wrong value * missed changing it in `extract_data` * linting * polygon cleanup * modified `start_date` & `end_date` type to `datetime` from `dateType` * standardized intrinio stock historical params * fixed yfinance * linting * revert start and end date to dateType from datetime * fix alpha vantage * changed param * fix intrinio infinite loop * `validator` is `field_validator` * revert time params and fixed intervals * `outputsize` alias set in `Field` * set interval description using in-build dict * yfinance stock param standardization * static * intrinio cleanup * Polygon add api params as `PrivateAttr` * modified yfinance params to `PrivateAttr` * intrinio remove overriding date params * fixed description for AV adjusted param * fix alpha vantage intraday not working * re-record and pass unit tests * pass integration tests * Update test --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Fix econcal endpoint (#5567) * fix econcal for python interface * fix econcal tests * fix non supported json output * Fixes FMP index endpoint to get 1 day interval data (#5535) * fix FMP endpoint for getting index data for `1day` interval * fix `open` type to prevent validation error * modifed `validator` to `field_validator` * type of fields is `StrictFloat` * re-record and pass test * linting * `validator` -> `field_validator`, a3'd everything * Fix regression in tests. Lint * updating the integration test actions * Fix typo * Fix typo * Fix import * Publish versions `a3` to Pypi (#5568) * bump versions and script to publish * small improvements * uncomment exception * openbb * publishing guidelines * improve docs * add providers to economy api * make symbol required in stock_quote * Fix keys * Fix oecd * add comma * revert * Add quotes * Sleep * Improve tests * Improve * Feature/query transform (#5566) * inject query into transform_data * swap query and data * update missing fetchers * last test failing * sig test fetcher * black * av add `query` to `transform_data` call * transform_data: missing refactoring * fix uvicorn command in the doc * Automated examples (#5576) * Automated examples * Fix bug * Lint * static assets built on 3.8 * Revert "static assets built on 3.8" This reverts commit fb82ff7bd9af92ed676d8f8047c31e74daf7b8b2. * remove assets * static assets on 3.8 * static assets on 3.8 * Wrap in quotes * Improve wrap * minor fix * rebuild 3.8 * Fix bug * Fix edge case * Lint * rebuild --------- Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa * use SecretStr for sensitive fields (#5578) * use SecretStr for sensitive fields * fix * docstring * Add tests for provider (#5583) * Add tests for provider * Test standard models * Lint * Fix standard model issues. Co-authored-by: @the-praxs * linting * `symbol` -> `is_symbol` in `economy.index_search` * static --------- Co-authored-by: Pratyush Shukla * feature/v4-biztoc-provider: Adds Biztoc provider and GlobalNews (#5546) * add biztoc provider * duplicate field * black * request headers * recapture test * move stuff around * add integration tests * duplicate OECD entry in dev_install * duplicate entry for oecd in pyproject.toml * Add Biztoc to workflow * update readme: credentials * Add Preferences to README * improve tests * fix biztoc * obbject pylint * Bug fix: serializ SecretStr before dumping to json * export credentials as json (#5592) * Check for wrong, changed, or outdated params. (#5597) * Improving `economy.cpi` for the FRED data (#5602) * remove multiindex using coding magic * Update field descriptions --------- Co-authored-by: Theodore Aptekarev * Improve error message. * Improve * Test tests (#5607) * Test tests * Add test * 4.0.0a4 PyPI publishing (#5608) * changes to publish * fix mini conflict * typo * cleaned `descriptions.py` * fix description in `cpi.py` * Add ETF extension to v4 (#5609) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add ETF historical price from yfinance (#5610) * Add etf extension with search data model * Add FMP ETF search * Add fetcher tests * Add etf historical price standard model and route * Add etf historical data from yfinance * Add unit tests * Fix linter error. Organize imports * Update test data * Revert common descriptions erased by CPI PR * remove `symbol` from data for `stocks.ca.peers` * Test docstrings (#5613) * Test docstrings * fix minor bugs w/@IgorWounds * static only w/@IgorWounds * fix `importance` param in `economy.econcal` * right static only w/@IgorWounds * Fix econcal and add tests to noxfile * fix econcal static * re-record --------- Co-authored-by: Pratyush Shukla * Clean up the newly created ETF extension (#5611) * Add ETF to dev_install bundle * Add integration tests for openbb-etf * Patch integration test generator scripts to produce lintable code * Add py.typed markers for extensions * user preferences descriptions (#5593) * user preferences descriptions * typo * Feature/v4-sec-provider: Add SEC provider to V4 (#5556) * coerce string type, add default=None * add sec provider and FTD function * update description * ruff * data model definitions in standard model already * duplicate oecd entries in dev_install and pyproject * actually commit * integration test * add stock search to SEC * add company filings for SEC provider * integration tests * remove duplicated line * ruff * **kwargs in Transform Data * some helper functions for later * black * add helper for mutual fund and etf lookup * add some SEC lookup helpers to a new regulators extension * black * ruff * fix test param * take institution filter out of sec stock_search * ruff * remove URL that codespell doesn't like * add cik-to-ticker map * add litigations rss feed * make openbb-regulators a dependency of openbb-sec * add SIC search * improve ftd and remove BeautifulSoup from SEC dependencies * fix parsing the zip files pre-2009 * ruff * update descriptions * recapture ftd test * tests params * typo * change limit param to 1 in test_sec_stock_ftd * Add didiers to_records method (#5588) * Add didiers to_records * unused import * Bring back polars + do what igor suggested * Make the output consistent with what it was. * Black ? * spelling. oops. almost like we have a pre commit or something * Feature/v4-price-performance: % returns for various horizons, comparable across multiple tickers. (#5618) * coerce string type, add default=None * add price_performance endpoint from FMP * black * extra period in docstring * ruff * forgot one file * Feature/ipo-calendar: V4 IPO Calendar (#5605) * coerce string type, add default=None * add intrinio ipo calendar * fix typo * sort __init__ * fix description * make requested changes * update test params * black * test updates * etf integration * Add disc router and WSJ provider * OBBject extensions (#5612) * changes to core * bug? * docstring * doc * Update credentials.py * fix model_dump * create extensions * fix docstring * doc * revert change query_exc * doc * fix container test * redirect obbject test patch * doc * rename method * move decorator to extension file * rename method extend_obbject * changes in creds model * avoid credential racing * doc * rename prop * doc * doc * remove comment * comment some code * free extension names * docstring * doc * docs * Hotfix/fix-v4-economic-calendar: Add FMP to Econ Calendar and fix some TE bugs (#5580) * coerce string type, add default=None * adds fmp to economic calendar and fixes some things with TE * ruff * etf integration test * missing provider for test * rename te cassette to economic_calendar * fix test * rename tests --------- Co-authored-by: James Maslek * Add stocks disc endpoints (#5630) * Add stocks disc endpoints * Explicit * Lint * Add tests * Bump timeout * Feature/disc router (#5616) * Add disc router and WSJ provider * Lint * Lint * Move endpoints under ETF router * Update etf_performance.py * Add ETF info and sector exposure from FMP (#5620) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Fix linter errors after the merge * Fix more linter errors * Fix failing and add missing tests * Fix integration tests * Fix calendar ipo tests * Add ETF holdings and holding report dates from FMP (#5629) * Add ETF info from FMP * Add integration tests * Add unit tests * Add etf sectors endpoint * Add etf sectors fmp endpoint * Omit nested sector list from fmp info data * Update tests and test data * Update test data * Specify provider explicitly in integration tests * Update tests * Skip yfinance etf historical test * Add etf holdings and holdings date routes and standard models * Add fmp holdings and holding dates fetchers * Update holdings fetcher to properly handle date object inputs * Add unit tests * Add integration tests * Black after merge * Fix test input data format * Disc router for equities. (#5640) * Disc router for equities. * add tests * Bug fixes in financial statements (#5537) * `validator` to `field_validator` in standard models * Polygon add `ttm` to `period` param * Revert "Polygon add `ttm` to `period` param" * Polygon add `ttm` to param `period` * `EarningsCallTranscript` standard model removed `quarter` param * use `tag` instead of `name` for correct field name * fix url for intrinio income statement * modified intrinio cash flow `transform_data` function * set optional data fields and validate dates * fix insider trading not fetching recent data * linting * refactoring * refactoring * set param alias in fmp stock insider provider model * get all quarter data for intrinio * add `limit` param to `stocks.fa.ins` * refactoring and linting * removed additional comment * linting * re-recorded and fix tests * cash flow standard model field type to `StrictFloat` * Intrinio cash flow model fixed to get all quarters' data * linting * refactoring * financial statement standard model field type to `StrictFloat` * Intrinio financial statement model get all quarter data * set `period` type to `Optional[str]` * add `period` param to balance sheet provider models * add `period` param to cash flow provider models * use alias in model dump * remove `ttm` from `period` param * revamped intrinio financials * fixed incorrect description for `limit` param * modified tests for `balance`, `cash` and `income` * re-recorded tests * skipped intrinio financial statement fetcher tests * Add ETF county weighting command with FMP data (#5645) * Remove code that wrongfully infers the filing date as end of quarter * Add etf countries command with fmp data * Add countries command to etf router * Update sector and country weighting fmp models * Fix docstring typo * Add unit tests and update mock data * Add integration tests for etf.countries * Bring back missing integration tests * Fix economic calendar integration tests * fix missing data in intrinio financials * removed inutile params from Polygon financial statement models * Intrinio IPO overhaul * tests fixed and re-recorded * Add ETF holdings performance with FMP data (#5659) * Add etf holdings performance endpoint * Add tests * Fix failing polygon fetcher tests * Split long holdings lists into chunks and update test data * Change chunk length to 500 tickers * Add stock search from FMP (#5642) Co-authored-by: Theodore Aptekarev * Feature/v4 pypi (#5579) * improvements to the publish script * move scripts * initial script that builds the package * adjustments on the docs * test pypi workflow * add hour and minute to version * black * ruff * duplicate file * moving files instead * build throught the script instead * update nox file * integration tests workflow * change workflow * fix dev_install * fix in sed cmd * testing the platform only * commenting out the publishing * fix run commands * improvements to the publish script and doc * fix publish script * updating the script and the workflow * feature/v4-pypi nightly (#5589) * init * Update nightly.py * cleanup * init file * not referencing dev_utils * updating obb platform key * revert * Increase warmup time * project name on pyproject and adding the --pre flag on readme * moving to the build folder * fix noxfile * reflecting the moves on the import statements * fix pyproject path * ruff * fix paths * fix super typo * update workflows * moving the pypi terminal files into its folder --------- Co-authored-by: teh_coderer Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Theodore Aptekarev * economy.calendar nasdaq (#5628) * add quandl econcal * unittest * add integration tests * replace   * fix bug TE importance * small fix * remove stuff from quandl * add nasdaq provider * add nasdaq to install files * Update test_economy_api.py * test * quandl leftovers * remove quandl econcal test * lint * replace   * ruff * lint * update nasdaq gmt * validate countries * here * no need for this * fix calendar tests * static * static * remove error * static * readme + website * readme * remove changes TE * typo * fix unittest * fix tests * Update __init__.py * Update economic_calendar.py * revamped model and added helpers for date range --------- Co-authored-by: Pratyush Shukla * Feature/v4-dividend-calendar: Adds Nasdaq dividend calendar and moves the command out of fundamental_analysis (#5672) * add nasdaq dividend calendar and move out of fundamental_analysis * black * ruff * add random-user-agent to pyproject.toml * add nasdaq ipo calendar * add nasdaq flag for SPO to IPO calendar * add spo test param * black * dividend test * fix transform_query - nasdaq_calendar_ipo * bring back different headers for ipo calendar * remove references to test * Add disc endpoints (#5660) * Add Quandl top retail * Add tests * Add Seeking Alpha * Add Filings * Change Provider * Fix test * Add dev_install * static * static correct * y u forget me * updated deps * static --------- Co-authored-by: Pratyush Shukla * using dev install (#5673) * Expanding the `fixedincome` menu (#5655) * models and fetcher * making the fetcher visible * std model * adding the command * improvements to the models * typo * adding the command * imrpovements to dwpcr * standard model for ecb int rates * adding the fetcher for fred * standard model of ice bofa * add ice_bofa command * ruff * ice bofa fetcher * moody std model * moody * std model * add cp command * unused import * cp * spot * ruff * hqm * tmc * ffrmc * tbffr * ruff * typing fixes * buggy dates * fred fetcher tests * ruff * adding ecb as a provider * adding new provider related stuff * adding the new command eu_ycvr * models * test for ecb fetcher * Feature/v4 fixedincome int tests (#5661) * integration tests * happy ruff * mini adjustment * ruff * typo * verbose type * fix tests * docstrings everywhere and an happy pydocstyle * fix tests * Feature/user-cache-dir: Add User Preference for the Cache Directory (#5621) * add user preference for storing cached data * ruff * fix tests? * fix test key error..? * etf integration test fix * add cache dir to SEC * black * improve docs structure for V4 (#5586) * improve docs structure for V4 * moving over changes * Add Docs to the navbar * add some, re-order sidebar * fix sentence * add docs install to source instructions * insert a couple of links, fix a typo * big terminal docs usage revamps * improve toggle component for tutorials * get rid of TOCs for all terminal docs for consistency and simplicity * improve platform docs * improve bot docs content structure * remove index from bot docs * improve ON THIS PAGE to only display TOC if at least 1 element * make edit this page text and icon on same line * add author and date to docs * add basic syntax page to usage * sidebar order for usage section * move api start command to the top with the import python import * some install page additions * small improvement * refactor routines section * Update introduction-to-routines.md * Update pipeline-of-commands.md * Update introduction-to-routines.md * Update routines-for-power-users.md * Update community-routines.md * update keyboard hotkey macros * askobb page * Update askobb-feature.md * Update index.md * Update index.md * Update index.md * Update index.md * fix images * remove HeadTitle from all files where it exist * get rid of extra spacing in markdown * small update * small edit * need index at the start because of main path when homepage of docs * use openAI to create SEO for front matter on my behalf * remove table of content from sdk page * finish improving metadata SEO for SDK docs * update duplicate header * update HeadTitle to be more specific on product * remove index from bot telegram reference * delete duplicated title for platform reference * another update * Hotfix/econometrics export filename fix (#5508) * fix: Modify 'load' behavior to append data to existing sheet Details: - Added logic to detect existing sheet and append data if present. - There is no direct way to append on the sheet, so I am reading the sheet to get the last row number and then writing after that row number. Resolves: #5472 * Added --export option for exporting to a desired file in /econometrics menu * Added a -f/--file option to provide the filename for export. Made -t/--type and -f/--file mutually exclusive. If -f is not given, -t is required and the filename will be generated based on the time and module. * Revert `helper_funcs.py` to original state * Made some arguments not required. * Minor changes asked by @deeleeramone * No sheet name * black --------- Co-authored-by: James Maslek Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * FIX #5600 Updated the Twitter logo to X logo (#5601) * Change Ultima paragraph (#5624) * change ultima paragraph * remove old paragraph * Update CONTRIBUTING.md (#5623) * mobile line-brake fixed (#5604) In the mobile view (media max 400px ), the text line "Installation >>" appears broken into smaller segments. Co-authored-by: James Maslek * start PR so screenshots can get attached via GitHub website * Update qa.md * Docs/terminalpro and improvement (#5622) * add first iteration of content for Terminal Pro * Update index.md * Update dashboards.md * Update folders.md * Update grouping.md * Update report.md * Update templates.md * Update quick-start.md * Update index.md * Update index.md * Update home.md * Update news.md * Update index.md * Update index.md * Update index.md * Update data-provider.md * Update chat-with-widget.md * Update data-manipulation.md * Update forecasting.md * fix: images self closing tags * fix: only pro visitors can see pro * inter font * improve SEO content and restructuring * add new package for toggle on tutorials * move folder around * improve main page of each prod * small updates and improvements * fix logo above * small improvement in headtitle for portfolio funcs * fix typos from OpenAI's GPT-4 * fix _category_ json * remove generic SEO words * add script that generates SEO for documentation * add missing file * remove sdk warning message * fix links for andrew --------- Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: andrewkenreich * Add light blue banner, blue when clicking sidebar + fix link in docusaurus.config.js (#5627) * typo * pro docs tab coloring * sidebar selection blue * redirecting missing * Update crypto introduction.md * titles * another title * Update crypto dd.md * Update defi.md * Update disc.md * Update nft.md * Update onchain.md * Update ov.md * Update introduction.md updates URL * Update introduction.md add HeadTitle * Update ba.md * Update comparison.md * Update dark-pool-shorts.md * Update disc.md * fix docs (#5646) * Update fa.md * Update gov.md * Update ins.md * Update tradinghours.md * Delete website/content/terminal/menus/stocks/options/screener.md * Update Options introduction.md * Update screener head title * Update screener TOC * Update econometrics.md * Update economy head title * Update etf.md * codespell * Fix the redirect for intro to the correct url for docs (#5658) * fix the redirect for intro to the correct url for docs * fix code linting --------- Co-authored-by: James Maslek * Contributing guidelines (#5615) * intro section * what's expected sections * improve sections * improve sections and move how to add a data point * moving qa under contributor * better intro * moving the sharing section * better expectations * small intro to the contributor guidelines * moving things under the contributor section * there is no pre commits on the platform yet * dependency management * best practices for extensions * typo * collapse options subfolder * codespell * Improve Pro documentation further (#5641) * small improvement * Fix TutorialVideo for mobile view * main page terminal pro docs * jose whelp * placeholder index file that needs to be removed * fix: fixes sidebar, removes unused index.md * update link to api keys * update api keys link * fix hyperlinks in terminal helper * fix a few more links * fix some more links * linter * black linter * improve main docs page for each product * small refactor * header to take to main page of product * run OpenAI script to generate SEO for pro content --------- Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> * Update folders.md * Update integrate-your-own-backend.md * Update index.md * Update fixedincome.md * url * Update forecast.md * Update settings.md (#5665) * Update forex.md * fix front matter (#5667) * Fix conflict markers that got into markdown during previous merges * Fix front matter list formatting * Fix typo * small thing * fix hyperlinks * Update .codespell.ignore * output_type options * Architectural considerations * Update sidebar to hide pro section by default * Minor copy changes * TET pattern * import statements * clarification on preferences * Minor copy changes * Lint markdown and python * fix: open index on collapsible root elements * remove old content * options title * Fix linting errors * Refactor sidebar label to url mapping condition --------- Co-authored-by: andrewkenreich Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: hjoaquim Co-authored-by: Sandip Saha Co-authored-by: James Maslek Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Theodore Aptekarev * Add multi-ticker support to etf_countries (#5670) * add multi-ticker support to etf_countries * remove commented-out lines * normalized percent points * percent -> percentage * Fix Nasdaq Econ Calendar Fetcher (#5668) * fix nasdaq econ cal request * more html tags * add random-user-agent to pyproject * another edge case - 24H -> 00:00 * Feature/v4-unusual-options: Adds unusual options endpoint. (#5677) * add unusual options fro Intrinio * test params * move sorting * Change type * update FMP fetcher to use the V4 endpoint (#5681) * Fix price performance not parsed correctly when there is only 1 ticker (#5678) * Add crypto search standard model and FMP data for it (#5679) * Apply renaming to news data (#5684) * inegration complete * reformatted for black * fix ruff issues * revised integration * changes to versions in pyproject.toml and updated lock files * Rename models * Update tests * Fix typos here and there * Update routers * Apply rename to ultima * Properly mock api key * Mock ultima api key --------- Co-authored-by: Adi Sai * Feature/v4-market-snapshots: Adds full market snapshots (#5473) * add stocks market snapshots from fmp * add fmp fetcher test * unused imports * add polygon to market_snapshots * update fmp market_snapshots * black * pydantic2 things * updates * change validate_obj to model_validate * polygon cleanup * tests * descriptions * black * data description * minor adjustments, using less local variables, improving readability and removing pandas * better structure * minor adjustments * lint * fix int tests --------- Co-authored-by: hjoaquim * Add NBBO Quotes, with historical, to `obb.stocks.quote()` (#5617) * coerce string type, add default=None * add polygon stock quote * limit cleanup * add greater/less than to params * limit param * black * tests * fix tests * test_etf * rename model and function to NBBO * add standard model for nbbo * improve standardization * not redifining builtin max * fix input params * integration test params * removing unused import Co-authored-by: Pratyush Shukla * revamped code * re-recorded nbbo test * added symbol validator * added alias in field * Stock news -> Company news --------- Co-authored-by: hjoaquim Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * hotfix/update-quandl-to-nasdaq: Merge Quandl + Nasdaq (#5682) * merge quandl nd nasdaq * dev_install.py * test param name * economy python integration test * Add more input types to data processing commands (#5453) * adding more supported types to data processing commands * ruff * removing unused import * docstrings * data processing types covertion * data description * test filters * ruff * fix package builder tests * ruff * removing print * Add stocks/dps module (#5638) * short volume * pyproject missed * add sec short interest with days to cover * Add FINRA OTC endopoint * some tests * rest of unit tests * Integratin test scripts * dev install * linters caught by pre commit * lines too long * Last test files * maybe it needs a lock file? * thanks pratty * Maybe ill actually listen to pratty next time * sec test date freeze * I cant hit buttons * re record tests * tests 3 * Stockgrid test * regen int test * more testing * lint * moved these fns * dis killing me * one more test * last one * Update integration tests * Fix tests picking up wrong dps route --------- Co-authored-by: Theodore Aptekarev * Rename Forex to Currency (#5687) * restore fields as optional (#5686) * Rename Crypto (#5689) * added `crypto.price.historical` * static * fix tests * fix incorrect label * Move model from sec to finra (#5692) * Update toml * fixed deps * add openbb-etf lock file * cleanup * cleanup (#5694) * Rename Fixed Income (#5695) * Rename Fixed Income * Add routers * Rename stocks to equity (#5688) * Rename stocks folder * Rename openbb_stocks package * Rename routers * Reroute equity menu * Update routes based on feedback * StockNews -> EquityNews * StockInfo -> EquityProfile * Rename Equity calendars * Equity peers rename * Rename discovery * Rename fundamental * Rename price command models * Rename shorts * Update charting router * Fix seeking alpha upcoming release date * Fix linting errors * Update tests * Fix tests * Skip econometrics api tests because it's python only * Update integration tests and test data * Historical analyst estimates * Skip cboe options chain test. Unable to record vcr cassette * re-record cboe cassettes * Document CBOE unit test creation caveats --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Feature/files-for-igor: Adding a few standard models for Igor (#5699) * add some standard models for Igor * codespell * update descriptions * Add devtools metapackage (#5703) * Add openbb-devtools metapackage * adding devtools to the dev_install script --------- Co-authored-by: hjoaquim * Rename econometrics commands to be more verbose (#5702) * Expose command to model map (#5706) * Rename ta qa (#5708) * Rename ta folder * Rename ta to technical * Rename qa folder * Rename qa to quantitative * Rename the actual routes in quantitative * Equity cleanup (#5707) * cleanup * static * renaming to equity cc @the-praxs * Proof reading --------- Co-authored-by: hjoaquim Co-authored-by: Theodore Aptekarev * Don't enforce imperative for first word of the docstring * Remove ultima from default extensions * Rename `economy` and create `index` extension (#5705) * renamed economy and re-recorded tests * static * market indices * european indices * fred indices * index constituents * tests * correct package name * oops * static * linting * Move COT commands to regulators * Rename economy.list to available_indices * Rename GDP models and clean up * Fix charting tests * Drop _indices from available_indices command * Fix obbject to_dict test --------- Co-authored-by: Theodore Aptekarev * Rename etf/disc (#5715) * Docs/v4-working-docs: PR to Work on V4 Docs (#5693) * Revert changes related to pydantic2 made into v3 code * Revert fred model changes in v3 * Revert pydantic2 databento model changes in v2 * Update some names and v3 lock file * Clean up openbb/package before the beta release * Platform publishing procedure (#5701) * update instructions * introducing the version script * publish message * fix platform path * reflecting version changes * getting version from installed packages instead * removing toml from dependencies * Changes to get `a7` out (#5697) * changes to get a7 out * etf menu on the pyproject.toml * poetry lock * bump `openbb-etf` to `a5` to match version * updated deps * removing ultima * removing references to a4 cc @the-praxs * Bump index menu version * poetry lock --------- Co-authored-by: Pratyush Shukla Co-authored-by: Theodore Aptekarev * Update publishing instructions * Bump core dependencies in extensions and providers * Add changes to the publish script following the beta release * Update the versions in static extension map and openbb metapackage --------- Co-authored-by: James Maslek Co-authored-by: Pratyush Shukla Co-authored-by: hjoaquim Co-authored-by: Diogo Sousa Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> Co-authored-by: tehcoderer Co-authored-by: DidierRLopes Co-authored-by: andrewkenreich Co-authored-by: Sandip Saha Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: Mohamad Fadil Co-authored-by: Adi Sai * Hotfix/pypi openbb terminal (#5719) * renaming the project * documentation changes * Finishing touches to the publishing procedure (#5728) * finishing touches to the publishing procedure * grammar improvements * Run tests on develop (#5725) * Run tests on develop * Add a check that files changes in platform * Seprate Intrinio financials data tags into a different command (#5723) * add `ebit` field in income statement standard model * only add required data tags * remove calculations data * use `name` key instead of `tag` key * set `period` as required in data * remove `period` and `cik` from provider models * add `equity/fundamental/search_financial_attributes` with tests * clean descriptions file * add `equity/fundamental/financial_attributes` with tests * set `value` as `Optional` * Fix threadpool test error (#5734) * Remove ultima from deps (#5736) * remove ultima from deps * skip ultima test * black * change skip location * try except statement to avoid error on the ci * new currency reference rates pr (#5724) * point files to linters (#5739) * remove news from equity (#5741) * Add tiingo provider (#5740) * first commit * things * Add news endpoints * CryptoHistorical * Add currency and trailing dividend yield * things working * deps * fix pre commit things * tests? * black on the tests * pratty told me to add it * integration tests * added helpers * crypto revamped * currency revamped * trailing dividend yield revamped * equity historical revamped * company news overhauled * global news overhauled * remove `tags` param from news models * crypto correct `exchanges` description * james smh * re-recorded fetcher tests * fixed integration tests * econometrics smh * james smh again --------- Co-authored-by: Pratyush Shukla * Add `derivatives` extension for `futures` and `options` (#5742) * removed options and futures * add derivatives extension * cleanup * bug #5649 (#5722) * bug #5649 * fixing --a upmom, downmom --------- Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> * Rename the fmp search -> screener (#5744) * Rename the fmp search -> screener * misses some * i cant copy paste * docs/fix-urls: Updates the Terminal About URLs to match `/develop` (#5720) * update Terminal about URLs and some other broken links * ruff * intro * changing the heading levels * dependency management sections * structure * developer guides * structure * contributor guides * keywords and descriptions * broken urls * cool cards * Cool cards (#5727) * tidy up terminal/content * some more tidy up * fix styling for platform that was missing * more tidy up * improve color for dark and light mode * create new reference card for more basic cards * rename back to menus * implement all index.md for terminal, except reference * improve bot title * more refactoring * fix remaining index * header styling * more styling * heheheheheheeh * Revert "heheheheheheeh" This reverts commit 7d095fcfd258efb7e82b75b4663b5360785195f3. * Ccards (#5733) * links * more links * improved styling and chevron aligned to title * fix index.mdx urls for Terminal * update package.json * update index.mdx * fix generation * spelling * toolkit_extensions * update data extensions * couple of links * add tiingo to data extensions list --------- Co-authored-by: hjoaquim Co-authored-by: andrewkenreich Co-authored-by: DidierRLopes Co-authored-by: James Maslek * Stock leftover cleanup (#5745) * change to equity in `.md` files * `HistoricalStockSplits`->`HistoricalSplits` * `StockInsiderTrading`->`InsiderTrading` * sorry fmp * `EquityHistorical` cleanup * `EquityNBBO` cleanup * .md leftover * the last of stocks * Hotfix/urllib to dev group (#5732) * use the urllib3 dependency on the dev group instead * adapt the version script for the nightlies - if it's a nightly the package distribution name will have a different name * add dev dependencies to the dev installation bc of the ci * updating the import on validate_call according to: https://docs.pydantic.dev/latest/concepts/validation_decorator/ the way we were importing it breaks if pydantic=2.5 @montezdesousa * loosing urllib3 version specification on the provider and adding it to platform dev deps * rmeoving urllib from top level deps; and removing --with dev flag * changing to ^ instead * Revert "changing to ^ instead" This reverts commit 7300904e9f3adba372b106d381b70ae06e28795a. * unnecessary dep --------- Co-authored-by: Theodore Aptekarev Co-authored-by: James Maslek * feature/v4-bop - Add ECB Balance of Payments (Replaces #5716) (#5726) * add ecb balance of payments * missing __init__.py files * Nasdaq calendar earnings and fix FMP calendar earnings (#5718) Co-authored-by: James Maslek * feature/us-treasury-auctions: Adds Treasury Auctions endpoint and provider for US Government Data. (#5746) * add government_us provider and treasury auctions endpoint * black * add param for cusip * move logic for setting default start/end date * Update hub<>platform credentials map (#5749) * update hub<>platform credentials map * typo * Add API settings schema to system settings (#5743) Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> * Skip checking creds (#5737) * skip checking creds * fix bug * ok mypy * add comment * rename required_credentials * fix * fix top_retail bug * don't require creds in some nasdaq fetchers * black * this was not here before * fix tests * update fetcher test * update contributing guidelines * Fix Quote (#5752) * Fix Quote * fixed return type and model validation --------- Co-authored-by: Pratyush Shukla * Wrap up renaming global news to world news on a model level (#5750) * Wrap up renaming global news to world news on a model level * cleanup --------- Co-authored-by: Pratyush Shukla * Remove eod from docstrings (#5751) * Wrap up renaming global news to world news on a model level * Remove "end of day" from historical price model docstrings --------- Co-authored-by: Pratyush Shukla * Massive docstring cleanup (#5755) * sec router remove command * standard models cleanup * fmp cleanup * av cleanup * benzinga cleanup * biztoc cleanup * cboe cleanup * ecb cleanup * finra cleanup * fred cleanup * us cleanup * intrinio cleanup * nasdaq cleanup * oecd cleanup * polygon cleanup * sec cleanup * seeking alpha cleanup * stockgrid cleanup * tiingo cleanup * tradingeconomics cleanup * ultima cleanup * wsj cleanup * yfinance cleanup * sec router lint * fix date query param description * Updates system and api settings (#5753) * remove uncessary import on rest api * remove FrozenField and add api.version * allow setup from json * remove id tag * computed field is better * formatting --------- Co-authored-by: Theodore Aptekarev * Squeeze build time (#5756) * squeeze build time * bug fix * fix test * typo? * rebuild * keep tradingeconomics * docs/working-docs: Working V4 Docs PR (#5747) * post-install clarification, fix links * more links * change word * toolkit cleanup * rename 'contributing' to 'development' * update extensions * some urls * Update sdk-platform and v4-develop in urls (#5730) * Update sdk-platform and v4-develop in urls * Seprate Intrinio financials data tags into a different command (#5723) * add `ebit` field in income statement standard model * only add required data tags * remove calculations data * use `name` key instead of `tag` key * set `period` as required in data * remove `period` and `cik` from provider models * add `equity/fundamental/search_financial_attributes` with tests * clean descriptions file * add `equity/fundamental/financial_attributes` with tests * set `value` as `Optional` * Fix threadpool test error (#5734) * Remove ultima from deps (#5736) * remove ultima from deps * … * fix: openapi bug (#6525) * Update pyproject.toml * undo biztoc lock changes * Add conda constructor code and assets * Unpin setuptools in cli * Exclude construct.yaml from linting * Try fixing regex in gha yaml linting * Don't regex gitignore * Revert "Try fixing regex in gha yaml linting" This reverts commit 3fa1cd62066e93e70261f7f03dd030375753b501. * Update requirements to use pypi vs local packages * Update constructor specs * Add pro backend to the bundle * Update post install scripts and assets * Replace pinned dependencies management with the latest pypi versions * Windows Edits * [Feature] Conda Installer (#6604) * reopen PR * updating some windows things * text file edit * couple touch ups * update post_install.sh to install via poetry * readme * poetry.toml * try windows scripts * fixes * vbs poetry env use * codespell * expose uvicorn kwargs * try windows version of modified launcher * try something else * try something else * vbs api shortcut * wrong shortcut * launch windows shortcuts with cmd * windows conclusion script * add WorkingDirectory * windows python path is not in /bin * missed a shortcut WorkingDirectory * notebook windows arg syntax * cwd for notebooks * do a cd .. move * cli wrapper typo * openbb-cli * yaml * add conda * merge branch develop * fix reset_index erasing the name of the column (#6619) * handle edge case where user_settings is not formatted as expected * add welcome message and entry point for python interface build script * flag to not install conda on PATH * add condarc * condarc setting * update requirements.txt * use poetry groups for flexible post-install config * update folder structure * post install * try something for windows * no nsi_template * some updates * remove leading space. * update aiohttp for dependabot (#6621) * example extensions * install examples script * update readme * [BugFix] Fix Pandas FutureWarning In `derivatives.futures.curve` Chart (#6626) * fix Pandas FutureWarning in derivatives.futures.curve * black * codespell * [BugFix] `obb.news.world` Add Validators To Providers Where Symbol Is Mandatory (#6625) * add validators to enforce mandatory symbols in providers where required * linter * fmp 3.9 test cassette --------- Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * data.__fields__ is deprecated - use data.model_fields instead (#6629) * some updates * difflib check * merge prompt * windows updates * cmd cwd --------- Co-authored-by: andrewkenreich Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> * Remove redundant environment files * Fix markdown formatting * Attribute the installer metapackage to openbb * notebook launch dir * update widgets script for breaking changes and separate api entry point as an OpenBB extension. * codespell * add integration directory to openbb_platform_api * add Bls to 'to_caps' * linters * linters and typos * grammar police * grammar police * more linting * mypy * pylint * some fixes * pylint * duplicate text in welcome * add python basics notebook to examples * Improve wording and formatting in readme and installer text files * Rename OpenBB API to OpenBB Platform API to differentiate from our hosted API * user_settings bug * update multiSelect * label stuff * update readme * Rename platform api extension folder to exclude openbb. Update package name to use - vs _ * Expose a distinct endpoint per provider for each command * Refactor module files to reduce cognitive load * Minor code style improvement * Add package unit tests * Update the constructor file after platform api wrapper refactoring * Add support for get only routers * Flatten out the logic of the main function * Refactor package structure * Update schema parsing and widget generation * Return a lost function * Fix handling of parameters with optional boolean types * Update tests * Remove unused string constants * exclude envs and pkgs folders from condarc * Refactor Widgets Builder For columnsDefs (#6675) * refactor for columnsDefs * column_def field * linting * linting * linting... * fix custom provider name * don't add provider param to custom GET routers * fix some tests * fix key error in test * try fixing it another way * fix column defs edge case * Add implementation of widget filtering based on local json configuration (#6724) * Add implementation of widget filtering based on local json configuration * Update to comply with the widget_settings schema * Add --no-filter command line launch argument * Get openbb-platform-api from pypi versus local copy * Fix tests * Bring back the macos build action * Hack GHA to run the workflow right now * Fix typo and revert run on push * Try build on push again * Specify minimum python and constructor versions * Specify the constructor version * Don't just use tar bz * Add missing packages to constructor dependencies * Revert using only tar-bz * Add entitlements for code signing * Try signing the pkg using constructors native tools * Use codesigning identity name instead of ID * Get creds for James to debug * platform api readme * Add installer identity name * Fix typo in action file * codespell * Try signing _conda with application codesign id * Separate signing and deep signing into 2 steps * Comment out the Intel build action * Change --options to -o and add verbosity * Add notarization identity name to construct * Try using hash vs name for notarization * Clean up * Add Intel build * Run build scripts only on dispatch * Test if shorter widget name is working on pro * Update tests * some updates * patch openbb-platform-api * clean up empty_model * update url in root response message * silly one to build * make it start * make it not start :D * update 1 README detail * fix boolean parsing from command line and turn off uvicorn colors for Windows * linting * codespell * lazy formatting in logger * '%s' --------- Co-authored-by: montezdesousa <79287829+montezdesousa@users.noreply.github.com> Co-authored-by: Danglewood <85772166+deeleeramone@users.noreply.github.com> Co-authored-by: Igor Radovanovic <74266147+IgorWounds@users.noreply.github.com> Co-authored-by: James Maslek Co-authored-by: Luqman Co-authored-by: Pratyush Shukla Co-authored-by: Henrique Joaquim Co-authored-by: Michael Struwig Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com> Co-authored-by: capital0 <72140796+capital0@users.noreply.github.com> Co-authored-by: Ben Van Doren Co-authored-by: Andrew Co-authored-by: Adi Sai Co-authored-by: Sandip Saha Co-authored-by: Adwait <111136306+AdwaitSalankar@users.noreply.github.com> Co-authored-by: Abhishek Amar <66067391+abhishek-amar@users.noreply.github.com> Co-authored-by: DidierRLopes Co-authored-by: professssor <62937125+professssor@users.noreply.github.com> Co-authored-by: Farookh Zaheer Siddiqui <129654632+FarukhS52@users.noreply.github.com> Co-authored-by: MAX SHESTOV <57421753+maxxsh@users.noreply.github.com> Co-authored-by: jose-donato Co-authored-by: Mohamad Fadil Co-authored-by: Ramazan Co-authored-by: joshuabuildsthings Co-authored-by: wojda <114031148+polooner@users.noreply.github.com> Co-authored-by: Bim Phomthong <118195204+bimbolimbo@users.noreply.github.com> Co-authored-by: tehcoderer Co-authored-by: Ramazan Co-authored-by: omahs <73983677+omahs@users.noreply.github.com> Co-authored-by: minhhoang1023 <40023817+minhhoang1023@users.noreply.github.com> Co-authored-by: Ayrton Parkinson Co-authored-by: northern-64bit <75195383+northern-64bit@users.noreply.github.com> Co-authored-by: Luqman Co-authored-by: Eric Li <38477812+EricLi-Dev@users.noreply.github.com> Co-authored-by: Colin Delahunty <72827203+colin99d@users.noreply.github.com> Co-authored-by: Henrique Joaquim Co-authored-by: Disorder AA Co-authored-by: Diogo Sousa Co-authored-by: Jingyi Z --- .codespell.skip | 2 + .github/workflows/README.md | 2 +- .github/workflows/general-linting.yml | 3 + .github/workflows/macos-build.yml | 218 + .gitignore | 6 + .pre-commit-config.yaml | 1 + build/conda/README.md | 38 + build/conda/environments/constructor.yml | 10 + build/conda/installer/README.md | 247 + .../installer/assets/Installer_horizontal.bmp | Bin 0 -> 57514 bytes .../assets/Installer_horizontal2.png | Bin 0 -> 18794 bytes .../installer/assets/Installer_vertical2.bmp | Bin 0 -> 357254 bytes .../installer/assets/create_shortcut.vbs | 70 + .../installer/assets/custom_conclusion.nsi | 86 + .../conda/installer/assets/custom_welcome.nsi | 41 + build/conda/installer/assets/dmg_volume.icns | Bin 0 -> 674218 bytes .../conda/installer/assets/examples/README.md | 40 + .../assets/examples/empty_obbject/README.md | 9 + .../empty_obbject/empty_obbject/__init__.py | 30 + .../examples/empty_obbject/pyproject.toml | 19 + .../assets/examples/empty_provider/README.md | 9 + .../empty_provider/empty_provider/__init__.py | 21 + .../empty_provider/models/__init__.py | 1 + .../empty_provider/models/empty_model.py | 93 + .../empty_provider/utils/__init__.py | 1 + .../examples/empty_provider/pyproject.toml | 20 + .../assets/examples/empty_router/README.md | 9 + .../empty_router/empty_router/__init__.py | 1 + .../empty_router/empty_router/empty_router.py | 69 + .../empty_router/empty_router/empty_views.py | 29 + .../examples/empty_router/pyproject.toml | 19 + .../assets/examples/install_examples.py | 48 + .../assets/examples/python_basics.ipynb | 3848 ++++++++++ build/conda/installer/assets/header_win.png | Bin 0 -> 13096 bytes build/conda/installer/assets/installer.nsi | 264 + .../installer/assets/installer_conclusion.txt | 12 + .../installer/assets/installer_license.txt | 661 ++ .../installer/assets/installer_readme.txt | 19 + .../installer/assets/installer_welcome.txt | 8 + build/conda/installer/assets/openbb.icns | Bin 0 -> 16654 bytes build/conda/installer/assets/openbb_icon.ico | Bin 0 -> 19566 bytes build/conda/installer/assets/openbb_osx.png | Bin 0 -> 4509 bytes .../openbb_platform_installer/README.md | 48 + .../openbb_platform_installer/obb-env.yml | 5 + .../openbb_platform_installer/__init__.py | 3 + .../openbb_platform_installer/update.py | 30 + .../openbb_platform_installer/pyproject.toml | 53 + build/conda/installer/assets/openbb_win.png | Bin 0 -> 2579 bytes build/conda/installer/construct.yaml | 96 + build/conda/installer/post_install.bat | 61 + build/conda/installer/post_install.sh | 156 + build/pypi/openbb_platform/publish.py | 13 +- .../core/openbb_core/api/router/user.py | 2 +- openbb_platform/dev_install.py | 1 + .../extensions/platform_api/README.md | 96 + .../platform_api/integration/.gitkeep | 0 .../openbb_platform_api/__init__.py | 1 + .../platform_api/openbb_platform_api/main.py | 147 + .../openbb_platform_api/utils/__init__.py | 1 + .../openbb_platform_api/utils/api.py | 249 + .../openbb_platform_api/utils/openapi.py | 454 ++ .../openbb_platform_api/utils/widgets.py | 243 + .../extensions/platform_api/poetry.lock | 3024 ++++++++ .../extensions/platform_api/pyproject.toml | 27 + .../platform_api/tests/mock_openapi.json | 6357 +++++++++++++++++ .../platform_api/tests/mock_widgets.json | 3615 ++++++++++ .../extensions/platform_api/tests/test_api.py | 78 + .../platform_api/tests/test_openapi_utils.py | 397 + .../platform_api/tests/test_widgets_utils.py | 456 ++ openbb_platform/openbb/assets/reference.json | 2 +- 70 files changed, 21560 insertions(+), 9 deletions(-) create mode 100644 .github/workflows/macos-build.yml create mode 100644 build/conda/README.md create mode 100644 build/conda/environments/constructor.yml create mode 100644 build/conda/installer/README.md create mode 100644 build/conda/installer/assets/Installer_horizontal.bmp create mode 100644 build/conda/installer/assets/Installer_horizontal2.png create mode 100644 build/conda/installer/assets/Installer_vertical2.bmp create mode 100644 build/conda/installer/assets/create_shortcut.vbs create mode 100644 build/conda/installer/assets/custom_conclusion.nsi create mode 100644 build/conda/installer/assets/custom_welcome.nsi create mode 100644 build/conda/installer/assets/dmg_volume.icns create mode 100644 build/conda/installer/assets/examples/README.md create mode 100644 build/conda/installer/assets/examples/empty_obbject/README.md create mode 100644 build/conda/installer/assets/examples/empty_obbject/empty_obbject/__init__.py create mode 100644 build/conda/installer/assets/examples/empty_obbject/pyproject.toml create mode 100644 build/conda/installer/assets/examples/empty_provider/README.md create mode 100644 build/conda/installer/assets/examples/empty_provider/empty_provider/__init__.py create mode 100644 build/conda/installer/assets/examples/empty_provider/empty_provider/models/__init__.py create mode 100644 build/conda/installer/assets/examples/empty_provider/empty_provider/models/empty_model.py create mode 100644 build/conda/installer/assets/examples/empty_provider/empty_provider/utils/__init__.py create mode 100644 build/conda/installer/assets/examples/empty_provider/pyproject.toml create mode 100644 build/conda/installer/assets/examples/empty_router/README.md create mode 100644 build/conda/installer/assets/examples/empty_router/empty_router/__init__.py create mode 100644 build/conda/installer/assets/examples/empty_router/empty_router/empty_router.py create mode 100644 build/conda/installer/assets/examples/empty_router/empty_router/empty_views.py create mode 100644 build/conda/installer/assets/examples/empty_router/pyproject.toml create mode 100644 build/conda/installer/assets/examples/install_examples.py create mode 100644 build/conda/installer/assets/examples/python_basics.ipynb create mode 100644 build/conda/installer/assets/header_win.png create mode 100644 build/conda/installer/assets/installer.nsi create mode 100644 build/conda/installer/assets/installer_conclusion.txt create mode 100644 build/conda/installer/assets/installer_license.txt create mode 100644 build/conda/installer/assets/installer_readme.txt create mode 100644 build/conda/installer/assets/installer_welcome.txt create mode 100644 build/conda/installer/assets/openbb.icns create mode 100644 build/conda/installer/assets/openbb_icon.ico create mode 100644 build/conda/installer/assets/openbb_osx.png create mode 100644 build/conda/installer/assets/openbb_platform_installer/README.md create mode 100644 build/conda/installer/assets/openbb_platform_installer/obb-env.yml create mode 100644 build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/__init__.py create mode 100644 build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/update.py create mode 100644 build/conda/installer/assets/openbb_platform_installer/pyproject.toml create mode 100644 build/conda/installer/assets/openbb_win.png create mode 100644 build/conda/installer/construct.yaml create mode 100644 build/conda/installer/post_install.bat create mode 100755 build/conda/installer/post_install.sh create mode 100644 openbb_platform/extensions/platform_api/README.md create mode 100644 openbb_platform/extensions/platform_api/integration/.gitkeep create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/__init__.py create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/main.py create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/utils/__init__.py create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/utils/api.py create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/utils/openapi.py create mode 100644 openbb_platform/extensions/platform_api/openbb_platform_api/utils/widgets.py create mode 100644 openbb_platform/extensions/platform_api/poetry.lock create mode 100644 openbb_platform/extensions/platform_api/pyproject.toml create mode 100644 openbb_platform/extensions/platform_api/tests/mock_openapi.json create mode 100644 openbb_platform/extensions/platform_api/tests/mock_widgets.json create mode 100644 openbb_platform/extensions/platform_api/tests/test_api.py create mode 100644 openbb_platform/extensions/platform_api/tests/test_openapi_utils.py create mode 100644 openbb_platform/extensions/platform_api/tests/test_widgets_utils.py diff --git a/.codespell.skip b/.codespell.skip index f83dcca0908d..1c827e0dd8dc 100644 --- a/.codespell.skip +++ b/.codespell.skip @@ -1,5 +1,6 @@ ./tests .git +*.bat *.css *.csv *.html @@ -8,6 +9,7 @@ *.js *.json *.lock +*.nsi *.scss *.txt *.yaml diff --git a/.github/workflows/README.md b/.github/workflows/README.md index 50c9587d9dc3..a661e0370a07 100644 --- a/.github/workflows/README.md +++ b/.github/workflows/README.md @@ -71,7 +71,7 @@ It consists of two jobs: `code-linting` and `markdown-link-check`. The first job, `code-linting`, runs on an Ubuntu machine and performs several linting tasks on the code in the repository, including: - Checking out the code from the repository -- Setting up Python 3.9 +- Setting up Python 3.10 - Installing a number of Python packages necessary for the linting tasks - Running `bandit` to check for security vulnerabilities - Running `black` to check the code formatting diff --git a/.github/workflows/general-linting.yml b/.github/workflows/general-linting.yml index 54c05ba6c936..0931630a3e04 100644 --- a/.github/workflows/general-linting.yml +++ b/.github/workflows/general-linting.yml @@ -91,3 +91,6 @@ jobs: - name: json-yaml-validate id: json-yaml-validate uses: GrantBirki/json-yaml-validate@v2.0.0 + with: + yaml_exclude_regex: "construct.yaml" + use_gitignore: false diff --git a/.github/workflows/macos-build.yml b/.github/workflows/macos-build.yml new file mode 100644 index 000000000000..28ba5bd0565b --- /dev/null +++ b/.github/workflows/macos-build.yml @@ -0,0 +1,218 @@ +name: MacOS Build + +env: + OPENBB_LOG_COLLECT: 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: + M1-MacOs-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 + # 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-10-${{ hashFiles('build/conda/environments/constructor.yml') }} + # Set up miniconda using the environment yaml file within the repo + - name: Setup Miniconda + uses: conda-incubator/setup-miniconda@v3.0.4 + with: + miniconda-version: "latest" + auto-update-conda: true + channels: conda-forge,defaults + show-channel-urls: true + channel-priority: flexible + environment-file: build/conda/environments/constructor.yml + activate-environment: constructor + auto-activate-base: false + + - 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: + MACOS_INSTALLER_KEYCHAIN_PWD: ${{ secrets.MACOS_INSTALLER_KEYCHAIN_PWD }} + MACOS_INSTALLER_SIGNING_IDENTITY_NAME: ${{ secrets.MACOS_CODESIGN_INSTALLER_IDENTITY_NAME }} + MACOS_APPLICATION_SIGNING_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }} + run: | + security unlock-keychain -p $MACOS_INSTALLER_KEYCHAIN_PWD install.keychain + echo "signing_identity_name: $MACOS_INSTALLER_SIGNING_IDENTITY_NAME" >> build/conda/installer/construct.yaml + echo "notarization_identity_name: $MACOS_APPLICATION_SIGNING_IDENTITY" >> build/conda/installer/construct.yaml + cd build/conda && constructor installer/. && cd ../../ + mv build/conda/OpenBB-Platform-MacOSX-arm64.pkg OpenBB-Platform-MacOSX-arm64.pkg + shell: bash -l {0} + + - 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/conda/tmp + + - 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-Platform-MacOSX-arm64.pkg --apple-id "$NOTARIZE_APPLE_ID" --password "$NOTARIZE_APPLE_PWD" --team-id "$NOTARIZE_APPLE_TEAM_ID" --wait + + - name: Staple + run: | + xcrun stapler staple OpenBB-Platform-MacOSX-arm64.pkg + + - name: Save Build Artifact PKG + uses: actions/upload-artifact@v3 + with: + name: OpenBBM1.pkg + path: OpenBB-Platform-MacOSX-arm64.pkg + + - name: Clean up Build Artifacts + run: | + rm OpenBB-Platform-MacOSX-arm64.pkg + + # Job to build the MacOS Intel version of the Terminal=================================== + Intel-MacOs-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 + # 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-10-${{ hashFiles('build/conda/environments/constructor.yml') }} + # Set up miniconda using the environment yaml file within the repo + - name: Setup Miniconda + uses: conda-incubator/setup-miniconda@v3.0.4 + with: + miniconda-version: "latest" + auto-update-conda: true + channels: conda-forge,defaults + show-channel-urls: true + channel-priority: flexible + environment-file: build/conda/environments/constructor.yml + activate-environment: constructor + auto-activate-base: false + + - 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: + MACOS_INSTALLER_KEYCHAIN_PWD: ${{ secrets.MACOS_INSTALLER_KEYCHAIN_PWD }} + MACOS_INSTALLER_SIGNING_IDENTITY_NAME: ${{ secrets.MACOS_CODESIGN_INSTALLER_IDENTITY_NAME }} + MACOS_APPLICATION_SIGNING_IDENTITY: ${{ secrets.MACOS_CODESIGN_IDENTITY }} + run: | + security unlock-keychain -p $MACOS_INSTALLER_KEYCHAIN_PWD install.keychain + echo "signing_identity_name: $MACOS_INSTALLER_SIGNING_IDENTITY_NAME" >> build/conda/installer/construct.yaml + echo "notarization_identity_name: $MACOS_APPLICATION_SIGNING_IDENTITY" >> build/conda/installer/construct.yaml + cd build/conda && constructor installer/. && cd ../../ + mv build/conda/OpenBB-Platform-MacOSX-x86_64.pkg OpenBB-Platform-MacOSX-x86_64.pkg + shell: bash -l {0} + + - 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/conda/tmp + + - 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-Platform-MacOSX-x86_64.pkg --apple-id "$NOTARIZE_APPLE_ID" --password "$NOTARIZE_APPLE_PWD" --team-id "$NOTARIZE_APPLE_TEAM_ID" --wait + + - name: Staple + run: | + xcrun stapler staple OpenBB-Platform-MacOSX-x86_64.pkg + + - name: Save Build Artifact PKG + uses: actions/upload-artifact@v3 + with: + name: OpenBBIntel.pkg + path: OpenBB-Platform-MacOSX-x86_64.pkg + + - name: Clean up Build Artifacts + run: | + rm OpenBB-Platform-MacOSX-x86_64.pkg diff --git a/.gitignore b/.gitignore index d83e60b4d3f6..514c141e3ef7 100644 --- a/.gitignore +++ b/.gitignore @@ -55,3 +55,9 @@ openbb_platform/openbb/package/* # Dev Container env obb/* + +# OpenBB Distribution +!build/conda/installer/*.sh +*.pkg +*.exe +build/conda/tmp diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index b9e72f4cdf0f..9ad9e0fcb4d1 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -3,6 +3,7 @@ repos: rev: v4.4.0 hooks: - id: check-yaml + exclude: 'construct.yaml' - id: end-of-file-fixer exclude_types: [css, markdown, text, svg] - id: trailing-whitespace diff --git a/build/conda/README.md b/build/conda/README.md new file mode 100644 index 000000000000..a3e47cdf7249 --- /dev/null +++ b/build/conda/README.md @@ -0,0 +1,38 @@ +# OpenBB Platform Installer + +The code in this folder creates a packaged installer for the OpenBB Platform, using Conda Constructor. + +The installers can be created for Windows (.exe), MacOS (.pkg). + +The installer is distributed with a Conda environment that contains Python and package management tools. + +The dependencies required to run the application are installed from PyPI by the constructor's post_install script. They are installed by poetry and are defined in the `installer/assets/openbb_platform_installer/pyproject.toml` file. + +The version of Python is defined in the `construct.yaml` file. It is set for 3.12. + +## Build Instructions + +**In order to build the installer, conda should be already installed and initialized your current shell profile.** + +Navigate into the `build/conda` folder and then begin. + +1. Create the Conda environment. + - `conda env create --file environments/constructor.yml` +2. Activate the environment. + - `conda activate constructor` +3. Build the installer. + - `constructor installer/.` + +## For when we have a full NSIS + +To check nsis file - run + +```batch +miniconda3\envs\constructor\NSIS\makensis.exe /V2 assets\installer.nsi +``` + +gives better output for errors + +```batch +miniconda3\envs\constructor\NSIS\makensis.exe /V4 assets\installer.nsi +``` diff --git a/build/conda/environments/constructor.yml b/build/conda/environments/constructor.yml new file mode 100644 index 000000000000..21d8d69aec12 --- /dev/null +++ b/build/conda/environments/constructor.yml @@ -0,0 +1,10 @@ +name: constructor +channels: + - conda-forge + - defaults +dependencies: + - conda-build + - constructor>=3.9.3 + - six + - urllib3 + - requests diff --git a/build/conda/installer/README.md b/build/conda/installer/README.md new file mode 100644 index 000000000000..68f634755f66 --- /dev/null +++ b/build/conda/installer/README.md @@ -0,0 +1,247 @@ +# OpenBB Platform + +Thanks for installing the OpenBB Platform. To get the most out of your experience, we recommend reviewing the contents of this document. + +If you have never used Python before, don't worry, your first time is just a double-click away. The sections below outline everything you need to know for getting started. + +## What Did I Install? + +This is a kitted out development container for Pythonic, open source, financial research. It has everything you need to get started immediately. + +Included, is a complete installation of the OpenBB Platform and CLI, along with Conda and Jupyter Notebook, in an isolated Python 3.12 Conda environment. + +If you already have an installation of Conda or Anaconda, the version in this folder will not rely on, interfere, or share base environment paths with, existing versions. + +Tools for managing, updating, and building environments allow you to take full control of your installation, as well as quickly spin up new containers within this project folder. + +Follow the quick start steps below to get started using right away; or, open one of the shortcuts described below. + +If you want to build your own end points, connections, and features, try installing the [example extensions](#examples) + +## OpenBB Terminal Pro Quick Start + +- Login to the [OpenBB Hub](https://my.openbb.co) +- Optionally, add API keys for remote authorization on the page [here](https://my.openbb.dev/app/platform/credentials). + - If credentials have been added, from the sidebar, click on 'Personal Access Token'. + - Generate a token and copy the value to the clipboard. +- Optionally, from the sidebar, click on 'Widgets' to filter out any provider extensions or endpoints you wish to exclude. + - Without filtering, there will be well over 300 individual widgets. This will narrow the field and focus on only what you need. + - After configuring, download the file ("widget_settings.json") and save it to, `~/.openbb_platform`. The "Settings" shortcut takes you there. +- Double-click on the `openbb-api` shortcut. +- If you generated a personal access token, paste the values that were copied to the clipboard and hit the return key. + - Enter y/n to persist the downloaded credentials on the local machine for future sessions. + +- By default, the server will be running on: [http://127.0.0.1:6900](http://127.0.0.1:6900) + +- Login to OpenBB Terminal Pro [here](https://pro.openbb.co) +- From the sidebar, click on, "Data Connectors". +- Then click on the button, "Add Data". +- In the pop-up menu, select "Custom Backend". +- Enter a name for the connection - i.e, "OpenBB Platform" +- Enter the address the server is running on - i.e, "http://127.0.0.1:6900" +- **Ensure that "Validate Widgets" is set to "No".** +- Click on the "Test" button. +- Finally, click on the "Add" button. + +The OpenBB Platform API widgets can now be added to any dashboard. For a more detailed version of these instructions, see the documentation page [here](https://docs.openbb.co/pro/custom-backend) + +## Shortcuts + +At the root of the installation folder (where this document is) are shortcuts for launchers and to key file locations. + +- Bash (Windows: CMD): Opens a command line shell with the base Conda environment activated. Activate the OpenBB environment with: + - Mac/Linux: `source activate obb` + - Windows: `conda activate obb` +- Environments: Shortcut to the root "envs" folder, where the `obb` and any created environments are stored. + - "widgets.json" is located in the "assets" subdirectory. +- openbb-api: Opens a Terminal window and launches the OpenBB API, with optional prompts to login with your OpenBB Hub PAT. +- openbb-cli: Opens a Terminal window and launches the OpenBB CLI (formerly OpenBB Terminal). +- openbb-ipython: Opens a Terminal window and starts an IPython session with the OpenBB Platform package imported. +- openbb-notebook: Opens a Terminal window, starts the Jupyter development server, and opens a browser window with the Notebook application. +- OpenBBUserData: Shortcut to the OpenBBUserData folder. Files exported from CLI are saved here. +- Settings: Shortcut to the `~/.openbb_platform` location where `.env` files and `user_settings.json` are stored. + - If you cannot see the ".env" file, set Finder/Explorer to display hidden/system files. +- Update: Opens a Terminal window and updates the OpenBB Platform environment (obb) and packages. + +## Command Line Entry Points + +There are several command line entry points available when either: +- The OpenBB Platform environment (obb) is active. +- The "openbb_platform_installer" package has been installed in the active Python environment. + +### OpenBB Entry Points + +- openbb: Launches the OpenBB CLI. +- openbb-api: Launches the API and accepts select arguments. + - All args/kwargs available to `uvicorn run` are exposed. + - `--login`: True/False. Defeats the login prompt when False. + - `--no-build`: Skips building "widgets.json" +- openbb-build: Runs the build script that generates the static assets for the OpenBB Python interface. + - Run this after installing/uninstalling/updating OpenBB extensions + - Automatically run when `openbb-update` is run. +- openbb-update: Updates the environment packages defined in `pyproject.toml` and `poetry.lock` and rebuilds the OpenBB Python interface. + - Location of Poetry files: "/extensions/openbb_platform_installer" + - Passes all args/kwargs to `poetry install`. + +### Starting The OpenBB Platform API With Optional Arguments + +1. Open the `Bash` (`CMD` on Windows) shortcut. +2. Activate the `obb` environment + - Unix: `source activate obb` + - Windows: `conda activate obb` +3. Run `openbb-api` with `--parameter value` to add any `uvicorn.run` parameter. + +### OpenBB Platform API Over HTTPS + +To run the API over the HTTPS protocol, you must first create a self-signed certificate and the associated key. After steps 1 & 2 above, you can generate the files by entering this to the command line: + +```sh +openssl req -x509 -days 3650 -out localhost.crt -keyout localhost.key -newkey rsa:4096 -nodes -sha256 -subj '/CN=localhost' -extensions EXT -config <( \ + printf "[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth") +``` + +Two files will be created, in the current working directory, that are passed as keyword arguments to the `openbb-api` entry point. + +```sh +openbb-api --ssl_keyfile localhost.key --ssl_certfile localhost.crt +``` + +**Note**: Adjust the command to include the full path to the file if the current working directory is not where they are located. + + +The certificate - `localhost.crt` - will need to be added to system's trust store. The process for this will depend on the operating system and the user account privilege. + +A quick solution is to visit the server's URL, show the details of the warning, and choose to continue anyways. + +Contact the system administrator if you are using a work device and require additional permissions to complete the configuration. + +![This Connection Is Not Private](https://in.norton.com/content/dam/blogs/images/norton/am/this_connection_not_is_private.png) + +## Installed Folder Structure + +At the root of the installation (where this document is), there will be three folders: + +- conda (Windows: This is named after the last folder path if the default was not used) +- extensions +- notebooks + +### Conda + +This is the folder where Conda is installed and all environment data (site-packages, etc.) is stored. The "Environments" shortcuts takes you to the root of the "envs" folder. + +### Extensions + +This folder contains two subfolders: + +### Notebooks + +This folder contains tutorial notebooks with examples for getting started with Python and the OpenBB Platform. They can be opened by launching the `openbb-notebook` shortcut. + +#### examples + +Contains empty example extensions for the three types of OpenBB Platform extensions: + +- Router +- Provider +- OBBject + +To install all three examples in the OpenBB Platform environment, open the Bash/CMD shortcut and enter: + +```console +source activate obb # CMD: conda activate obb +cd extensions/examples +python install_examples.py +``` + +#### openbb_platform_installer + +This is a meta package for installing and managing OpenBB Platform installation within any Python environment. +Poetry is used to update and resolve any dependencies that are defined in the `pyproject.toml` file. + +The `poetry.lock` file is updated every time the `Update` shortcut is run. + +There are several configurations available, via combinations of `--with`, `--without`, and `--only` parameters, when running `poetry install`. + +Choices are: + +- main +- openbb-all +- cli +- notebook + +Each parameter will accept multiple items, but `--without` takes priority for solving for the environment. + +## Uninstallation + +Mac/Linux users can uninstall by deleting the folder, while Windows users can run the Uninstall shortcut. + +The leftover artifacts will include: + +- Global configuration files stored by Poetry, PIP, Conda, and Jupyter. +- Third-party Python package caches and `.env` files. +- Folders: + - ~/.openbb_platform + - ~/OpenBBUserData + +Windows users will also need to remove the parent folder where it was originally installed, after running Uninstall. + +Your OpenBB Hub account can be deleted, along with all associated data, from the Account page in [my.openbb.co](https://my.openbb.co) + +## Additional Information + +### Conda Install vs. PIP Install vs. Poetry Install + +The three ways to install packages may appear to accomplish the same objectives - installing Python packages - but each has a distinctly different purpose. + +An easy way to think about the difference is, both `pip` and `poetry` require an existing Python installation; `conda` installs Python so that you can run `pip install poetry`. + +In general, you use: + +- `conda` + - When a new environment has been created. Packages here can be included in the creation command, `conda create`. + - When the specific package is only distributed through Conda or the `conda-forge` channel. + - When changing the version of Python used within the environment. + - For interactions with the machine code layer of the system - e.g., compilers, and bridges to "outside of Python" land. +- `pip` + - When installing/uninstalling packages to the activated Python environment. + - Resort to `conda install` when packages fail to install, or wheels cannot be built, from PyPI. +- `poetry` + - Installing a local Python package. + - Syncing all package dependencies according to provided specs in `pyproject.toml` and `poetry.lock` files. + - Building and distributing Python packages. + +Conda is for container management and machine code level operations, Poetry resolves the project's dependencies and provides build/distribution tools within the current Python environment, while `pip` is for installing Python packages - typically from [PyPI](https://pypi.org). + +### Documentation Resources + +### OpenBB +- [OpenBB Pro](https://docs.openbb.co/pro) +- [OpenBB Pro Data Connectors](https://docs.openbb.co/pro/data-connector) +- [widgets.json](https://docs.openbb.co/pro/custom-backend/widgets.json) +- [OpenBB Platform](https://docs.openbb.co/platform) +- [OpenBB Platform Quckstart](https://docs.openbb.co/platform/getting_started/quickstart) +- [OpenBB CLI](https://docs.openbb.co/cli) +- [OpenBB User Settings](https://docs.openbb.co/platform/user_guides/settings_and_environment_variables) +- [API Keys and Authorization](https://docs.openbb.co/platform/getting_started/api_keys) +- [REST API Requests](https://docs.openbb.co/platform/getting_started/api_requests) +- [OpenBB Platform Architecture Overview](https://docs.openbb.co/platform/developer_guide/architecture_overview) +- [Create A New Router Extension](https://docs.openbb.co/platform/getting_started/create_new_router_extension) +- [OpenBB Charting](https://github.com/OpenBB-finance/OpenBB/tree/develop/openbb_platform/obbject_extensions/charting#readme) +- [PyWry](https://github.com/OpenBB-finance/pywry) + +### External + +- [python](https://docs.python.org/3/) +- [conda create](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#managing-environments) +- [pyproject.toml](https://python-poetry.org/docs/pyproject/) +- [requirements.txt](https://pip.pypa.io/en/stable/reference/requirements-file-format/) +- [pip](https://pip.pypa.io/en/stable/) +- [poetry config](https://python-poetry.org/docs/configuration) +- [pydantic](https://docs.pydantic.dev/latest/) +- [uvicorn](https://www.uvicorn.org/) +- [fastapi](https://fastapi.tiangolo.com/) +- [jupyter](https://docs.jupyter.org/en/latest/) +- [pandas](https://pandas.pydata.org/docs/) +- [numpy](https://numpy.org/doc/) +- [Plotly Graph Objects](https://plotly.com/python/graph-objects/) + diff --git a/build/conda/installer/assets/Installer_horizontal.bmp b/build/conda/installer/assets/Installer_horizontal.bmp new file mode 100644 index 0000000000000000000000000000000000000000..7de270256996faa5063a43679935999e70b33187 GIT binary patch literal 57514 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%0D{;uZ(YbU$*ia8VGNs_pef3H}XknRbg@o6$g zzfghMN);3G=j@2^nCFR@tw7cqDiYl}TanZ{-nMs6WMWCNCC3NoUS4Kcbp|4})wbhN z4xGlJuoL88w`lT|But@{qU zcKsOH9(R&(kdjbZ->Rz>mdOnof%IrE1Btr6}Ub< z$u9co?-_4*dlWBS=TE}}o~U`5mc*=tN=??QW0vfQ=|IUKxBxhixXW!^;)0v*OaqDX z@MKU;9TiZtfY+X)6uPBN+~V32z|O5=W7530!N+?b92?MQ8mq_m?@8j$@}vC$1p7B- zz7A`XaKQZpebg}S?qS2d9?O~1a*i9LaM5x3u{VtgW4jK$w;9*`&h7u$F) z#%m}1^R#}2U8u9T-qRzDprNtKK**0rowkQ)#{iew6UI@JixZ*q%t3^$RX`%B+@c0P zLpb$thl4N~7VgWnAf+GRJ#O`Om_~A-hf$-n^vr;rvLKAvx1O=hFocK_qFCXm z7H*f~Y${0ipKi?PP|AqII>}=kH-gHl4>5NrdJF z=jm(K)a4wJwlvP$?v-`hk8n>qhI1fHLx1&IV+2lB#CQlZ0E%OPn$tEbWEmW{hKNZD zG$3jgaG%4hQJ$=lF}r*-te(}2!xlU5nP3MX?@uL!km;-;f|ogudc(rhv?YzndUBU@ zkOL^oba5~%EBTfSN`Gj(sIv>NH6O~K#H`ujAyZw~UU4k;s(Fk9uU_^OJ!hwCa&%v( zdF*qtvKSMNO|A-0R(vgGT-RPp65n%lc9h{(28CxnKHPX4ulra>*-`gDDIxP~Qb6~x zb;jyO0JRE)BEe@KjxuyuLMDH{&09uMPby zTt!Hp)KSd5Vc(13jo~AHhwLz?UQDmxI!Lr!hCR>fM^Ee zxYe&GJ;X}Fbn==+3o9NSA24n6a6VjF0DYR!nmtJBN<#=AK;RkFlt5@-GX8+QtX}|N zLK>FgRzfdlJa!gxxzeQiF$=x}q&|So-neQWxnG{~@{j;qax5ETXD{k80<~!y7i)}W zo=H6sTR0|R#wG|OjlqWn3Ulp=XRQpVWz?IwmjgE9z8*JEsZ|YPT5nIe6^A-Y15DMs z1msVK)9b+Q$_zI)h9d);SKGq<=~&%1mc6+cme0lHa|s?BT0{J_k&cH_^A95u=prJJ zl}zilSoctGD8C|j;&@`a6d9S$P3Ar+%W<8r6HR$T+;gxj3X9$^26!O<=CP#rC39R4Tm@2o?5`ki5K4An2cMWaMDg5f=)60ze&zTOHP<4s> z)RN9nroHI!I`my*LfX*=G&3OUDh@3nr0%QDb4-UsK>@Eu!IAlsmW=r(DO=aFAy?)q z`#CHqymeI@u)Ck0fGCY=XC4P@U^gv9YVBnxOg8s6ZBH6UrWPf~7z7wpD|IA_DD$LN z2`2Q}^^`|1`>pogKH1&@p0pzYCklCHfke890ktPlHrvPyC7{yKZorMCM|HsA`Xkfq zNOc@eQg!RoW;X%}7mrM6%#E4Ksx8!%Gwl^5rB`GhwR!Rd+8RKe5lX7fHEa9Ei@e_H zp~~v>iIRfZ?wBWBh9UVN^?>y`!aa%`ZfuIauLwV_p<669y??bOe(a%Ix_;0G6CU3U zV1lJrvaS3oavL{vvy_GGwnS*~Ty}4SJkw4tFibs=Vuo*BUC|5g4n3(c7n4)~sOz`M zfh&X#$gmWSja&(;ArpFBmu)0jKZYb?WAq(t5dzz_G>v1%5kO~Y^9I1^@lgO^0w16G z%rq}HW%!gx3dG&rym_9qUbz<>;APJ4b*HX{uAHy}_JX#S#+h@^G259?u^X|~^k17h zttTZSxQM%*%DIf7ci2AT<>lQVno83+UEV2DfZVR+&m?Z=0G6J`W|&}MvP6W~h~BD5 zc<52haTt&sW1oAOTXyF25F&POS|+cB#U3bge6ccq7*n*T7*wj`lPoAPfoMVNlZMY~;o8~qxce!8p zM}ALy;y-><{D=SePvfn(KR5{z)Z68u4_)WeI(}vM&M7liLZh##DZBgI=K_BdZE89D z#=QOaY2AbNu0<5bbKifJ_w>}BW4y;IKjyd9=fe%iIvn66+$72N23UFXYOui}jb$(? z(zd?~C>DKTsT~ZT!-hj+UtHS+I?iBZT&DlC-G4uI6Cy_t!FBo>q16tk&8ZpF=Nkb- zfD}^EA*MbM2lwY#u!fOJNgL2QiwO_#@qY#G};aam}y4e%AfZOkBpevn7)@5h@U6D zc5HGAMrjzbT+;^;vFVgLkDfnmd27;LmVqG*3^SR-IM-JA6LvyBH4Dj4?B8=$cF==! za{v1Nm2dxqa;34a8R3ZMpmv1lp(9Zp_Aut^RdKa{m=~=;Qbfjf4QlbI4#zO1^4*x7 z2l#@Nib$%+seyrEwN{E+CkeC*rf-+uht zbq~YH*gceaDR@ePH$9OC9i}=m$Mwdmk}Stc`WabFc$a_`lK@;~Qcd(O^D$WLYa2s+ z5i?zb`8}e&6t!hA+?2lOJ6Em@P-jV7+4-x^ixRKUw5K($F!ZITOjgqJS1 zC|t?4Q3@1LdTY+a=MfI#vYoZk9`ixqEAxOi(3bSWAd@l&_;NECZ%ahjrog?F@7?QZ zV1_+R0*tXVLDa_5T3}$^2jNA8Cj+2pgedfO^t51iTgWth|ASxmyW+F?`R%{s55yn) z<9}{7_80;;t=R5RXJOlx z#E@wb0-my{S1CUYi$etHB3vbC~3Y}P`NQ;|XY>Ui~@ z3%r~1rASuK%&NJu5s*sQK<4xsa2sqkbtgAJVI~DNANPp>Lz(*lyQKZaN_G5GC4z>x ziZG8H)9?$7*WZWRKWI?F@S2OH!K@Wrs~S+kUGOPSyv8O+4db;WxE!vmf1%IEKlW|$ z7ykTTi@KEwQbNe(Q3z!4)4%*D#YaE-RqX5XKziRweEQR$iLd zr9V1;-LLuO>iHxYFit%tIR#L4c}L*6Axz#ElT&G)QXZ0oJmYW3o==So_7EDvwtG4Y z&6BLrUS!d)GWumPL3@6|BTYb8$SxW1ozU}PHX4*Q$QzO1G;KVq+O%pOE5dTLW0wU!7f`;KlKW>qCmtMBT{mHZG0%`2ho@BU2uwXgr%>)I7ELr!GqTX{Bp@Z}%=&jew=s%$3k zQ{gAPB8UOm*TX=`3}VKFp9iBS@rwxFpH{g)44~~KK+p(RbK6;OO+SnsJ0P}1PxvYS?HNXrQ;{xJJou?d5-0(K?WVVyu zWYRfFl~86eN92nnwr$SC70v@+XOM>F1?x!0QPSEC+-kZLcz4U@0l#C0;LO zY`f7e+j@RZLD%f|c74aZw}pV%e&XfDpXCF?&H;j~KNu}B1q8c1=M~r6%sKCho?^i| zRH0{GwU)(2#DI3KeDgd<%?hjPr+Jrc)~_ttQBT9@KDM0=+Kz4=D}Yq z5~0^Mjc6P?t(o831H8V~1%zv5!t?F-ykL%$6odpUSAM z-P0i|pCQ#8`^InlSNpZM_#myYTY{e695Wt0Hu-$RH~s6I@!vlA ze?1VN{EqL6d-4l2CSkvY{-p{DMkT}xHLlm{!OOIpI^odaaSp#V{ zt53UUir5udJ>GCYl06Qwf6{XnuRS95!p|~;#l>?Yl@&5qjZ^n20PYR4wK>Bd$0;*3 z&40>Yp4Y_cOsdB5-aW)bXUHnMfxP;VpeIU*X3Ssv>%In@#&+;|y=bs^7H@h78JT`Q z`qjT6{_yYnt#b!LMpgZ(@A%L0D}Vj(4j(6SIFU(Nz~}?ANs!a9=71Z^|GGP#2+CLy ze;)fij7VY`JUqodZbgSH@C4FXyIfuNJ}zGJ@Pz5I8OJnEHT ze4KbXt)w!KJ{IUXptzNvuRxx@do~Vd&^wS587gOZHnUf`%d7O?-0J9PzsEK``5wKk z!OQ>ZDUC;%+G`v$l);S!Q0@vIX1h~v8#Sg;(l=OZk2>9El6C;Q?!+TUm68w1C}nt5 z;uDEU$2A`F#^K*L0?^A&%Y4S}*?O6s9ZwrG!jMx$2Yp{-^n)4E(L|9-gLGKCM+4|6 zUUf2<*);h<_q*k|5y#*cz>WdjY1}E$%f@0rnJl+$W>(H{cQrk97aNQWe3U^0_gQmQ zIGbBn*{Cuv5T3vYV>!=mPQP_Z;&2a(Z73k{2tDmkVG9LjDrGvy)bkj5%Trz!TjqJ? zTSy(IXd@nkGS~d#OMUO7oGW?rIcxbHCUNx=n;=8NxR7ByMw9>+eP&(raX&JC^{@J+ z;hzfUCNX?bYJK>v5B~7bWx09m>+}BieQtc+*Zvlj=l191XCKJ&TmIcAs8zWYDrUif!S#}~rgxmHDzELzOn}%21|ME!Q zobNv7;Xh|(Q|sx8?AgK$J~bX34~b~fR}@S;-}e~TedMcue*9oRl}`*80jvvzAN^%N zH+~?Wx4!w~@n`?a-(i^?>0o}4n-|&BCqqm!AsKkwb<}5~j5IIVBTB>kv9Be)ho|c^ z?CBnJ1879RakE_|hjMN&Z3#JxuzR8tNq1Z9e%sU=Le>gyW2h!#OdoLRJK4_h=Z#6SqM+EhGKpnt29$6))NN0|BmV?4jN*QO>U6XE#7*bw8jqT&R?ulYTHI{wDr z{QINS2)#2RSnesk#YcbXSHvIsy}xnVlxvCDVMOwuzVpAtSNyWyMkB`KN+g>U({~X^ zeA_?%Gr>+CPn1XJ7X-jpp{ezZNe_aeJ==ZwaD9Bg8F~uJEKGN|B#k9d!em0gownTL1V!1L3H^hw$50;JADkBGxT@1o;&`XKu?8_hifgBd?s*Ek+u% zTr92JvVMaA%KBaY06t$=KK2N285mP`xxMB7h?-9c?SL0D@tk4Eo;R5^5yP?JzGL2x z(aY9oq!N;hQ8n|yA~0+LfHG21ueGt15ffm;BxB0Vpo?~c@hOxtFr0{cT;+AXIu^ba z9{U!YAWmCvibqdQU!}`X1?vUR<$+o@?>?O4l~H|6alB`eIL9-HlsXdtV@syI^}#QQ z5C7CJ+i-+XKBxi_)`x!F7wf`#^4-JV>zXhBDIb#lD6@T^(M`uHa1nyf2@0sA`%HUN zu|*dl@U6bn+gQJ%mxGi4HPzgvy}|snk~|f_+VY&Ro6=ROj$!x zxL-T-$#WT1se+hYxwlhYZUao^QR8$TdR%G?N4GHTMC0a3@aek0PrTb|?%Q1L9b{}| z#6~H4xo42sz*ODITM@ZuW;^L)hHeai^?u?gv8IF=Atoke^X0WfzF8Ci*feJ?@z&SHf0^~3rEa0V=v7R#i zL*%G`YOVcTpMpGXqJ5T!wQbadc<7w#sK3FRfPhbb2`B-CU-H@@Z+B{`DrW3ox@(3+ zN9w$L{jx9ZsD=~_FDZ95b&YTid!8`hf??`Hr^!I3IdIy>iBMV(s?EEU1QApRMBftd z^`BrmAyIACJ>4bWx0B=9_u+0NTRQOyU#(W+XaNRI!O99D=d#1C4d$T(Z4bImcFnjR?lLOLpNuw=q6pi?vV9C8LsYh(o z51dZ{FSX&3p0@+==eoFsY>T$B#A}vv%`u_-vQ75eCdEM-f)c9`R^DPRCC=)53#PpRu44dbE^ZMBW)r-;%nRO(0i}Zlql$HB7}%)H0atj~5-i0-+dXv2 zHvl!s(%b{pJYbeQY_P79ahH`7`iSv+?8sfiuE(XW_YtH7wMxI{lNL+A(*V83kh2ZP zO6nX~k2!x*+1(@obd|@E;c0^~Ii`^d{$@DAMaKrVW6ejZ_^GuW+b#r!{p9)(w=#W(0x|oGWIy6$ZRvux)#{hA&y1 z%6#hsKQuo4lYead(9eHgeCWq~Fuwg0pIXc2e)X^T1@Yb=@}Bs}SN)9mrhoN`b>mO_ zNk4WaU*3BB_v!EXzWBa(db_=^`OP1RfBErG#+Q8Y7sY@1Z{M?yee|n79PfMo=f;PA z^xN@?PkmRc(Dl*YkNo1F5?}eVzAXO9zxad!Z~l%l%K=1~JMfTzDJC&02`3QH&GK~y)dJ}1uf7MmJh)YN282$4<~}pOSe#BV^{mn?m^5iRJF7P@ zzOMP$xBiFthJX5R*47uDWql{!`lA0YKKR4lw;r{6`M&Ro^PTTq-#_?;kKs4^$%l0_F?OK#j_4n)GLov zHvX#EVgh&bH&%)CeiWK&z~Qe~_XWYHHq*O>!|eJe#c&o%c%jfkhZ3PDJ&eWr@hdPH zI&iy=C9*nILkzpDZFIP<>GeQ$i;1Bl=Kng12YNJ7^P&&*@_SW3T#4CisAu~beO z^tz*)KF(7##f_IljNI?XNP1gsMOz3C6PVa>kBK(Up|sXB*qi&5x+p$(7-@Y*)MjnU z5fr=TQ6#!rn1<*mBXbvq53llPfAB-IC8xqAt9@>mh6L1LnM4cEB4nh%Ecm9v8Xb1L z)Uo}X>hfb@<@ND=buF$rt=z4Rf&OJ|V^vFjblN>Nehh8-2YG}iIOcoHDY-31*JIne z+kM!*?3`oG-hKW0jjj0Cf3vGuqHRF_B!jZswq!GU$yW&{wV!?7#MVE~y1N3S%em<^ zV5%TRD;3yp<>c|c^c2WS*Y`E2QS&~|tj#zT@@9lR**@T87^pU}4+RaQ?hp~&5u7OIOv9^U61n8>M4OF z?BhmY^N>iI2x>{zPV?eOfIC_Edc@%Qpbh!MwKTc1a3f=zVAUp5sqiLamid*6U)Rl? zp=F$Nl-#?7HCVW2bs1`MYmf$M^&4IT*Fttf3H64|aNe?@SF`Y<_cWPri{*XAktatg&!)}Ym=RsX-6W2D6@ilSc`M(%j zochvQ11#kJEF-6}h7eW}hhfh>Z`E$b6Ujgq83Nw3faZbTG&(c3hv28fG*^ZaVQebH zhtUHl4B?D@up4%{qLhj0&e;Ak1l{~Nr>tT}z1u;d(u3cdJ9hx+4rV8bC^I1AYyE|g zkRdH5yU?A}v<1Lr$etNiaa$4e@8~kuI}ZRZ%!M9&6@c$_O_UMf)5e$BEjZbNt>5f_ zB=>jmkc_e;7)yFCZa!}z_>_D7KF!N*8#;N}(ueGF{$eqH#)ia9B|?tFHe)XDl{edv z!#3y;`i~nbgNSS0p6suhQ?Vs*O2<26ew`4}ED+v39$0py6`GJwYh)RcO+YDTV`dUU zHUL(*Of5Q2rP~p1^bZH}&dkg-608Cd>m3&CJuAh6B8KT0^pU$KU@v(-hAZ4qR924z zhGo-N0-dDJWWwoSUD$r|+T*0xdg76)lNIybhu-!R9`7X}AnwAp2A$>&gK#m0CA|ql zW|u!i8PYG99$v3ZC+pbKM}*JWfoO2gb>L)+YUJ%YG9A|)q!AvjhSk4Ba&A|?x+h}? zmAbo^w>cn&wYRnakWohFp%ep203;oBB%CKqXUgqc$_4ZI%$>n@!wlc{{KQ#y!Ww;~ zO)bFN%_ZAd(}c(=lyYXw5W@m&F&?syDM^KU%jD_zcl)83X0BrkZK<3x?aX@#(& z##6=w9(u9G-w|Q+PX5lle%VQvi?JfXQ-`gS2k_F`F=c@$pf_q3G+D8cZUntn+*&7@ zn~p4s*=tc-z2__J^fiW*KBQQEnRMZ}998CLbdQ$oiz+f$^jn z;&~e*0*t!d?w!AJlj*Je{oegN?s;{tj3CWE0mSas5E;(qUXVPQ`l7PNvzL~#HBny2 z&e)=^n0-fCs0}b-x!~Z?eizAppPkJ1GrWz2FoU zf(%!cl~a4`;IXiSTe_z(Baq=v%rM#mV0_9$1Q2WdcIqN|Ic%+QeJ*2NfH@*3VX)p3 zOV&tstfLYvp_5^qb8U{t>dWEnQqr+=+<+?X<`1Spr|V|i@}(KIhi}nI5^CxWi04hTD=sTj4-z0 z&-{H>M}i6s3kk#CP-NgGa{PHMGT|)*2ou|WT!!jx5WU3aeHC`jt+|8Dv@9W@8UtnI z4p-E_GHS;gGO@O20n`KI#@z}Z(TBs@kD7aqkgmj{h(tyd#*QU#>*NtyyfD}Jyyk$o z_3<)M#>g{pZO|fQloCWm=;@Gv@ufL{Eoj|zlaypB%%is{Q@Bl6upC4yrblxeyY6FF zf|+G8Izm~wffs!XBToJ;cAj_gNAMWSUmZO$Yl)xJKxA+Nu}7N6aIPe(C8 zx3PZ?`$l+r96L-go=l|lcV`E+RzET{?lW^r zSsxU!!rCKf^a$e{q;d0ZP~gag{AKVq!1w2r?CP+#9(3mYw8vywQD?^Hc{Z=O+S4HB z2DfQr$Z7kwzmDx(fc-KnAuE%j*ebBW5t{&+4uJ@q1wqSLM`oLsv~bU18F2^c=z886 zFMXfGIt@KDPI6RG{X=lC2D*pNlqAYdh1H_Mjnnk%aY|l3bvPloV9V;w2z4) zj8%lrxi7a^f9DfjyGb>6RrRZp1(OmR1z+`y2acIt%aJ_@;$%l^YrA>eFfcAa#r79{ zZZG2Aajs*lQ!5IMIPlPQ(cauB?I#`w0%-0)T07V8tzKMPo1;aUwCB?H8vfK!8rfVQ?hatKEsTG zpbSknC0COUfidr14(%8qRA)N7y25Yh%b?+F-~v5V@~*ZrDMy#hB^Nhj2cM}3;cSG$Vdz2GPJkc@^vGL3Dqgo~ zyaUym{qQiJkjFeA4XrSxawnR-zwH~kWzQZS^pwQ3$zL0m<#kXXoAa%th# z*kn20?YkKGN!1JEQh8$-qa(}!U~Ul7P6`{`g@d5}F;2tZ1@ss6g~X9jx7L>D^5MlI z$Nppw%E^`{X+{bTL^xiiaamFhKVwY&t5qOAF z@`F^;7*Q4DDQg}dP*O#1>_q+uZ)(S!KnxRIg2-RRM7jMpfeA%q)d zn$Qk<_ccCD_{vy`8w>&TuJ~ZYBH)JV3uBkjYlFqkS8VN_+XH}ctkeyzWwWY#@+D#m zN1>21JD6kJeI>)y5Ax+{xFZs&==Q3J_SNO zxrFZeAC}KKv7rLa6ZTnT;)a3gvTHN+2z4}!&CTXE<_8IZcLUs(5?f2FEeljrmDvbugX znzJX}Bt8clDM1_R_(=+F^N?=R$1^$=bp{XK%4C84Z6ut9gMwU zgaB~2v8%PTLB{6UN3!bcmK{whOLE?UxRI=b%zJ~jsC_-FaWOat%b);IIJx51~q zxY5UC#%$qMTJpgfiofkJ)8c4jk5@p6R|n3`h;XZoGwGcnGo`-m1|tmzR&MO0??W;v zZ_;mk^~v-JKC^mrS}M%F*0eKwT7_nXrDw*LUG=PX$sRAB2CPoTbSG;|)=kxY@oF6 zQu4J*&Essgf``n<`|cqxq*K&k1H4Rf2E=v!8ImqYevTDrs>xv=|Mp*6$9fiXw!xQY z$y=Xx#B9%PL9}W9YsnHX(Xiv8kP(rfiQ)G5j?(VTn}F~4K^*4|!uyY4Y z=WgSp4TZ8zmeC!9JxiczOt#g!BybR9Wo09L6ki5`BBW#}rH{vl%tFQ>MPnmS8m3K` zj0|oo9RiuzvR~cY86zh8olJde@dFA^9?t<2y=B1g<;id#j5!Q&L8GzoA6w;{R`Et# z^)Fr%X)4;`xZO!=(^dp0_TK=MzRw7ps1DkQI8)?Io3UpIchIR`*%!7QWFxFx^J<~r zihcmL(-NctT>yZ%c10EzLf2SM%}YYBW7=I<*}kQOdc}8S%X{d!|5i-S4ib#CfN*T^ zoP7{M$ur{$2nOSv^G$be>`P{4n`m)XW`M%MlqW4SegG`l<4~DwP)a)`GwZ8gY}(K%SLJxdn7Xq$(oLNX68*H} z`WGNZAx^VAOgYx^E~gBku8h>pNeEkEsDPk3%!`Ql&Nl490{3Z?NHH?m1F=OYmh^uxD-e zkd`lsafe248~%l+U-KwMLdeGW-5gAOqs9&?yEw?r0ASt~VDvS(vS4_s2Adk~mYx%H zBo7H#BQx%EQv`9)gW|`?hu3&0otwR{-^Qc;ckYG9biKwsiM8m<+EnPu+*BL3A#2kp zy+ZjS)=k%UkU(B_BLQ8{$#d$bNSw^HZsm^a^GCDX1BQwBECV7Xy-nCZYnlLAtDC~5 zQ+?*t$tUm2P6B4ucuSu+C!27FDLgWha2L8cmlW7aCiC>U0mbHF><%2se}M zX3t7dfC#b(G8j1zRhR;Oymu-@C)>&s0w;m`azKsyK~iq?oIk`h5rwTR)*pLgu!p5Q zlv`UM$8CEFg#4p(b|EB3w*(a~03ZyMRDxO8M5S|f!wd|(!d5<^5`~$tyE5=mCt*&& zEvGCYw62@>owK>Gdr7q8gnrN;l_g=6A_aD&wpBpapXYYj=yYyuz>cMrA)4Go1(3Nj z(paoJSLTBK;~;*O%BMFieNWRBI}c!T=?;O?_A`xN6|_N8S?ue0KueVaax_#^qjg{! zpWHgV42fk1A8aRo*pjyjygRyUGS3H!82}wKZ&>i|OJ2Cf`a-$AjM1lLh2Q|;Ey-l) z!sWR>FFSa5HHOh(Y|&Avgh0Pb^5?X`CQ>uv{RCj30*lrwPXo;k_=3Y3fs|32-NRm# zc~Q3!^rv8V`viYd5*7DNtIn_x+n%p{cA*LJDM4&Pcr7eW{GLJMHQC!gcf}d-?1*39 zENP5;TEYfk7{9Oa)hHyx)x>B05KgFD?mYxPf_|Oq2I=K5C|8~e_id4ZjqhYo1}w(^ zX22)NFt&sUSBGLw@j&a7AO~>e!32D^d5&|a0a+vC%gD&uL=W5d+^4Q`BSl3l4wW>@ z3yP~ujv$iI{Uq}U0VTqdA7ONbGS%AZS>O`*BK8mx^}=r46H{uaukP2`@r>DPy^@3iqbLhrCBOBruI9h384eMC{<5 z-al{A#`V=+XloAPjh{Os%E0aebPz>tbUB^q%Uol8H zf<AGMM9uFhM(Sgc9p_Xp8@V>-wI{g1j_E;dGl!XN;f%6gCe~R5t_w6 z_j{`Efj8`OPOUE;l38CSIRcNEQ24BVks;(JC$@NqWS#4#bbHJD6lybKY-yE*lOs0= zrawX7WxRyosdqVQD(09(9{OMQWJ!RZ0&|{dWj7~xp1E^o2HPUeGx``09i|HoDcnni zY>F4&{$_2oH0`OS$9-bI&*z45C0_t~ob~Ar0v*RZRJ~m<;1$UN;9MZ|=AX70b!S*K zI4q8zs%Y2KaIBl$0Ft+c;a);;tA`YT7#iyeO>wBVoN3TVXZ1}-W9jQF!mN~FuEThd zsIl&S92$|gdBWiF{)(5t$g2?)QlD79WZ3t5cEOaqm|Dzw1#z^cNE)lJ$ADlp5##8S zGSbuNS7Ekb90{gyStZ2Ch^d{S^=%zIVjFXX&$+53ZUhD3?*Gg&$y$=!K~2rmb5x|; zSJkU08yFkR-l5_58*o;bf4Z##tVP-N&oW(EvSwtkd-ho|gB2K>^Qx_zZY<7j1l<-} zpRXFJ$p7_6;3=0!mzF9AVXiz{tHP%Zy-;EZCONS75>M0)FB2#}_Z}wB(dCRze_|sPvZ?4?* z`Tj>xxr?t~ug|^B`)kAVlb>S$_3n|bsQx(gnTlEUKZ5CAyqkXgdU55VWb&sJzf>g~ zRP+YzS90Ftb7if5IqY2Ze8QL0p>mjJ$)oBlO-0jZ$CiA3{#v1JS#_m$K7aW_@RV1{ zzdopF!<5!AaWrL?m9t0nCtoy_D32U<_ znp5G!d;cV=i+7Q3){5Mx*I-*<0&I}1KFI3q;aMTSjrU7#3qEA_IMFskN@s-D{A(ni z%1nj)p=Lq%piFITQ`@);IOY-XDdhKg66C`{Wew88@C@N+WvoW_I>!C8`+A2kfi< zko3K%Ji&)NMg8I3&)z2nc3%Q>?+o%nSQQl9$wfF=c#Rqa@((qrq>Sqv=-aV?!X&U6~}sbPR8TqTUi;tq@4fU?X2>2UQRzAhYwv zxt2`&h;_DQ%3}@quutoBaXtZk2iU>3RCq&sEgg$hPf;I|*r(h6tfm_#FYp(+fqfa9 z{EHdeGCcik^?`e$_G>9S8}sY2LKAH70I^wp(2PHBivZr35BQ+nMWk6dQvQY9q|YeC zvSB))rUm{Zx&d>V;LB++U#+lKLw7(vG9JYb@3h6q6bFBeroJFe@%gFxV4(IR;yOe- zDXU}8gF1)$-ebMy@k;9R-2u*x9z>T+m-H4&KJR9Z{+UENM19Cp! z(5=->YsBEw8I5@ur((uQ%;^KIZv%5!GR|P$2(MLOk0*gdO?mzC!;S#sZW0@M!u;{x)+*`FCUt9WP&>AwAb z7~c)Pw~dZ3x~p!JlRR7tPfhJr;5`cNB6K(VJLcJwrA^cStQFELpU1spf^$K=k*>-V zVYXl|Z{umeUtEJ{1yJw!mvC1@c$?s58lq=RQly9I)e7R&jF%;k)rn+d@OhSzih}?7 z#o(-4!9`Z9GrVga>0&VS~mO<;=0+jNpX zVB93Wiv{~ae)_|mQCuVC)f2A3yNGV6LD)VA(q}1x9$?w*1FE+b+GAHbS;*5L-3s~y z@m?%9=}&Ki?MbHt_f3q}PV6KGp@mRi6>S*ICz&zDO^q$FS=W1U)zh@Sqx@ue#x_`d#kF zyE6=LHWb}OG+g^&3B^mw4K>oNZ332QcrWU`SyZ#yOK`pA`~JyC-$lLSDM>RPsDpgv zu|3Ca4ZEAhr00=Pe?Ri!^=_yn)2Vlh2x|XBs};gHmDGcOMt#D3rkfygPti@lbOgO_ zE2|IO1f8#o%)J{p2ZZAE%80wCqP1QO!??v7-n}!U_8{oZ_?q_S@;QaP6#TQ$596Pg z_R8dvbt`_2^|)A`4)80XwygtgH9<>x*e~kG;SAtyd$P^C+~%hkx5+8RZ_;6taJzsr z$X5}Ny>w82z)uGh*P0r6j{~(oN}rYwS&8byJCK^zXX(3SeaKx&Km$6!{1kA9rmrRU z!~xHKO2zs#Do520>;vy4^N5r6FJrnlsQZ)ICW_M><%kUC20ol>PsT&C>3izhW1AnR zzuJPjBFJyx2koxc7g7}WCWx&2@mfkls9u6T*Oo(iCvFQgz1+(%-W&Yko9I(-19RvD z5ousT7!JfF?Tn z?v}Eee`*Ejj-|;XGrcS37(8+xkZU^ZS6le4kYb@7z-Jt9Gsr7RtUY-4v;|r}_dMCq zjMvK`Q?}XXl-&0TwlELf8YhA|(?DIMx0k;IKT{*D2ZMPL-74?T8H5e~pYVRy8KvW9 zza5dq8q$wkYftpuOwoJ2j0oObl)plO=NX81EW7g$wZC?=CpMGn49Rdl#yQ#w&$59P%^o-K8+$l z|5|rD5^iFAPLef6#3%6V7JWZbH=QE4yu7a-4-KLH2DShn-i>p1?wVek^GH9~8+Mi7 za=!x}ft+sGg&v~4Gu=>A7r`^y9h_$@FJGj$xO>{xK4`bTkI?7cu%_Oi2MzmBUsJK{ zJ`jcAKB#Bg{d&KX5(kO5BcCiMX0@x~30U4#=OtkMxh>+41k(>i1?Rgk!(Mx{iD~}X(JzsyJL7H z+mtxOBRv#;wUpwjWPi89wr%PD#=gb9Mc*tRcpvbA7temc`LNnXz6Cw~G^FdnV&BaH z`$QpJ-LN-Atv1NB|FfS_rHavd9*!KGcWwAfG&|&tLwhm3qWF)NB7;WJ8KRuV#Z-E};+mJ-T}e|7ij?v!N08YakA1 zihD9mkfQb7Xcz3Kr+e!Eybs=}e5AH^U?GT@7JQxv(_3sz28Bz^-wq zpHpiuNww?uIZ8ygFn6H!gS@}4k|Oi9l#846gDS<|+^>WK*GK9>yY=0ee*x{`eO9}& z_W>O+hNReE5^q^Y*>hyg=Cp!gZ-n`TAYYY{_(LMVi}cW4hMit1{FAWi5a6Ti(*c{l zZ-Nf6VE)xIy@bA}uU+^1=HA;B+HQ;TFlOHpY!hP4w+;xu#(WfisGskustIgbdexs<{ZTfi zUI4+|I2ZekcD*(rw{@JQvi5XPC z`T#zUs{)=qCP_tLO8tW~kaj3fur253BmUbe)O#C`H2W?FVHdj4l&n49`+9+j_FpruOd1!j@neekdX{-f-l@gJ>ks0(xR8!2bhv`A0Vmo_d&_d{`y zVgJ|xhlU8$9^Dq(tz^9bqWfW4eGox6^R+z`G42Zc-7!digg*B(((&hy20T*EXl&ox*o1M$^%`)OnBv|K{xnUYz2#KW91VVd zRP})^yhVRb!h`%B-TM?;yE9V18;x_IE_l7cIB&3fTZ*u+SSF{ar@p!Y_P0RIt@TUR zdo>l>;&Zg1KUfOpYK2b${!w|7BAsn5`WX4%kYr)*`eACWA63T5C@GN3;TYbQ^%C?V z-4r_?p%3Fs1Gx0J%*+CRuV~vNQ!i%o2?wFCJDEbeN!L#PSBmeZQ9gb~bQ^iGoDiGg z-SC?Fh(4pCRua0aQl!^Y3+mnvm4&w1|1{NxyTH=u@z(lE^dVbCp9zMAypdc6-{fj@ zaa~E>N_Mfi)@n#!TsPf$FstbU=+5O&d3=2vrN?t{O&=`GyAKZXJ?t-6Q_j8E=WWry zM{`?*=;;j8E!f#pu$R`m8$xkcKH&_)$Kq5%cUF~mELqQn+II9dVLWIb5iWf<%kBwZ z?DQTkd7O{8QL^OTM_fy}S^+_KIFE~`ayXy{_R;r%zwwSPH}%PxQW4iIIhyp;Q#ADk zQ|MJ^c)EnXnnwG1m*}H5@bB`pMZkyU4ecxq^-Q<8o3c$rdz@|48CjhX12*7qNziqKCtc-sEQ(qB+- z&fU!c=|?|vWM8m1=F8GlMU+|P+uqoUn0f)L;t*Z@M%FihmFtL_w`w%o6>{ z>6q~D)oi$GW30|JL?8m1!$c3;$j<;!A-3o1Hc--K(vTKTOsVS?H z^-}y{JXT$Ms?vr>Q|mh-Zb*|bHrFld-mp}@q3#E3TiYA@2HtDTYE{w=8dnp1(t0md zqulj@;H?7$PtEUnEcDYKo9GwsUD@=#%*ixCDZ6*38`2!R=x+@{i*&TN!OwJFfTszf z^;u;@wjD{=PjPnSALeSEIlh`@8~KCQm$5OJdk3sbo9+oCJnX}`H65Zm0C|cwHl^tl z%ia{%cd(b5$F~%-MeY!7mSNW6&k^;@)zCdw_I+%LN3!cETll+U%CMVsJkO52c|SdU zJb(RQG`vH)5*0myKlz}lgo=sYo|;PG&$e_%H2p!B@W=vxHe~;OANU@>iw2*bP*~9W zeGs%&SCS5pou_EPBli*XDK@#I{wVtreYl>A^VKVKfEc$6avs1#ym|4 z3=Bel|L0Hs9sYT0B;E)wad#_3-1pOLQ#?3N66%M2z#q&z;nLB_N6mS*b(|#IQfc;U zr;0^%*_iP&PNMI^+`u;b-3N3)c+Un4dW!Y2t@spU`PmZ>qfxodj8z^#(_EwJM6(a< zi(EH^dtxv4i$VBL2P8-0>4`*|$pCf}_+^k5@jpd`+BmHiX|yBg?C-dPJ!sD=(+-oq zrm3f>kr3<)f74p?RP5(+p#f%x*SnSeEAuA!j%K#GWB;{ zqwf`>du?trlM3MHKoIaXr6It%>`nGZ$K&GNF!@CJ>mW_WYyD2Vys~g-C zuxv<;bLCWEyqB_pvB6)JLR*`y@0#w>e#REajMD@Kd$))UeivKHwMV3T=RmDWp{gQR?rvq}7ozdSnh0w@)Gh1qIsC7&={*nF=ZK&%JzYjWJ%~1%W z@9?hZiWR)3c?}Hp>sWj2fa1ET_q)Mdr!sY;U7N`Z?bQKWE2IyC_D*^=O4GeIESzE7 zO+X)XBu^jo2*tA@BF^Yv*7t{?>_U4+B|FZ^!~Tp`YA{cw_ki<61YJwUoN)^=SX%G> z_fY#;@!s`0*^2H%6STvry8FW&fZL&He#wQZTS3e=(FJuV-dY5x+24K88~k7_idHL$ z?nl-&x(?vc_aL8ch<^`^&8fi@=0u?#*t4Mx&rZFhd5|aRYaI7PVVnI25vLDob?Q@D z%|Vw4(zqa!68(DC{BoJo$QSIxb>H4J^4$R~?x8+EZM#$aMLL#-pwfVsGob?M89NE@ zc?#scIY|>rAM{ehov~LD`U1cI>|h)G#dvt%A8GLOo&a!HD)BVbH^{qu58YiX1=n;K z_nxVjpd0qemzgP{FYvn_x1Le_F67f0+ZcOO?5DnZrL{hW-J`+B4h41?Z|c(rnjZX& z0dFbCgg6R(1iG7`sXwnKsCR%Kq3F%Y&GKrU)kfGJ>PDDxqG6vaOk5Mk+U$XJgRf~{ z1eJ%GZV27AvwEWUbSpsjEN%E7FyHFhALPf(_zb*YZ}6)pw$8|&;2+E(U7u#;m77XN zGj6%hJHSgD(JUo`_KevR1$PnBkJC^e-s?4ht9epo^EPd4K06sItXjmoCtQqhThOQO zCMZoGic7NDKgdVQ-4<rei9NyQ5D9_Y@`-+;9F)pTJV zem$xd5pAe<(LZQCM}d4v zo4cAFcC!q{9l}3N!1yRq5B1t$U}ub`&p0@b^k>P_5_dyt^*7xHKh#V5qtR)F@%2g$ z?|@*Q&7X4w-QT|2wD2JURylnz$s%+U{msCPns4@|kvIEnD7yU#JL!D*X5LGt+vn7@ zt&69EbU7IV{+RvrL3KkO3GX?nmY)gi5qeo2?%#v$H;`|H2liPtq((UVBk{r$L9gZj z)n@$g2`;L#{t^BVRUBeA9Z(Gc(H;I*Vj8QnrtTh!jeJDk4+d(%>xhWcB3p=D8bwey zI8FYkGm7N@@Bg@n(7JgK3Utyt={Qm-K^e6kmN{rOuQ-$aGnF zvrN6@zMOt_0POQ=eoAPY?leR-!BFp23pyuN8yJ12?EJh2=!TzuGJ^qDynjQ!(QDWb z$mLI5XR}ug?Jo{WRA{-m4Env6eQR7yAe5rwPLKDErQG(LK`Nu4b?E_?Vx{%gGG*4ZCxhcRuVf#US%<6_xLHX~0c4%qH>YTi@Lf z;(7zW(2mLv-Py2R@06374J7{ltF+#)3g;o+m`__Al2UUHtBPtG@F(}^I@?C&2liqA z9(*A@KQ3#oR}*-t{<=Tl#jdO-2+lj>D{n!M(3hHT*Ov84xUYz7M;}v{s|nPj^*hv^ z&mmSx;-Kc1`@L7pHH?#Z9MWBB>izo}BpZQ7yAuWVuG%H*$DOcg(pl}!;B)*@UZrW+ ztpq7wM!YE?tlaAF3wK0K8kPHy9tEw!Q0d? zbMQP5f_t86f~Dql#orWn2bl5wHISTbA-(#eJHW+h2(x+f4-UXQ^-nqu-Fq>DzK?!3 z+fefs^vX@Wa*1`uqm5~kBjksA_syNSYucm(W}JTTkG}V6`}+JP+#A1oB=D9@Gd1Jm zZA7t&-c>#l-=bfK)fgLikI+lsjpzCKdlI83(jj!hEVChdG6w3Vb=swIwt`2jwV#g- zXckk7P~-HfYpbnXCNP)o#>yEE#3hRW!Bl5|YacEy6;$J*TBhhHu+QTc{F9Z;j&#o*UH<*2`@hh-(B;GHbef!!zDfjthVcjglqkKmhkU)PxKnl{%D zw7y^u>5LKa?R}8Sj3gntlkzztcdH2ViP3blzS?5F1A1FJV=>I*)tFxHSsrRbg1sZPAV8x<$VmrC4TvxSpgjucf^SycFHfQC530 z)rW+7p$+)p9NRwbq9oW|I!APkGLOsr%sHe3Hvqm z>MSjx7w-wk4fu_ASQe*%-@b+1j8i{EgnM=#rV;w=FVVlZ^W4vvbdXd6)EPAe@RnJ=G_aJ4y%i2j-LG*880yX5AJ7-`ld}mqro^FMP8qz!8?7X&dkFUK1~ocSFVH{ z`F1NLS=3wEBkp0`BNP*Zxf4h~0zR(B`|GK^5Aq4yYapUu?62QV?!4QpfO$0i^fclQ z(TeT>@A1@ix*@vX8w@!3r%|#&(|pK-G5mV81p;$z+o0a^Z8Jh2FR#&f-k)RX20vRZ z($e342DB~Z%kV_mOW$Q<%KLwU9jLATMfaY=`@Pkn8@9+_Jr%ikAI!_(&irhah6C-N z2h?{2FZFq;{LIYghIYuXf3yrUk3&2_*p|KpBfbE~8=h&1NI8J-AJvSnPYcni zcY>N5;SKObcXdYbZpCjkXGyu99n$-w>aCESu`%TkF-{E(!w`Vv0t0A^2nD;?9$Zxto><4O1^HuFksZ`wG z-qey0t~#>vhXvCFE$%4_PqhC2YpD%tVeZa|lks?5bsq$6%YDH2Xmc{uPam|h*EK!( zxA{pcFx@MFzsY@d41I%>iQE_Og17lSCAlAsdA4N~w%HS+S8f;==I)`5=yv);{d7jq z&eR`L$a`lAz4_hhyS|U@QDS8`%OGD#`5C5;O3b+N=N^Vu@aR3ZG-c#-OEc;Z@3t{x zY^npA<<$pNEYmIe>@?;9-?=tK%7b<`ShA-f)*Zc8^S9Wut-rDI=2HB{xR0!we*W{Z z3+*qL{%+P>`)0=cZud4pzL)OUKZtmfzS((E9C2r?`uqvl(t1-&9`&Dhz|q6tXZ#Mh zGd6w=#K!EJKGgGDnlH~A?;(2QI^JeLCNaD_;6J?ov$#_q@Y!?fol$U&ax7-w?~g(_ z$TN0Z4EUlR@Y^PNPpLWXB~spMPFsA+qxHwJg}xYf2h5jK<7brQG6xTnUMZ8qyJ2yy zRiT|fMc$5nt#%)1k92?j8f5GEQv7DWJxne*-3nVnq#N$MjiuiQ-O}-Oj&&E1LTr025NVzM+d)?=>vKRHudz^c@nr6KG zd+}cSez&KmV&5A|^gZ?WO#=Br804yNzy@2`-<|?zP0je!m&ALsdqu}!u;uXr8LrbV z+P}R93VD{a(~z#7$h7vm50tBjjma;0TI*wM!Z;qLwLS@TS4!^llt(09XzyCjRItai zOycS8aL{hYGWeNpywe0#Y~8oXu~>`c()wY)M0`;X+HAwji24R!M8kNCzKl)%cM5%K z9b>~aPVOw{<}$n+b|gN@j3zpm*9$=KZbd*I>L+nAOYu2DyM=yJd>e4>+}JO}W5=>u zp`1+2$+#Dig}ELv&-2*Y?b)EJzrI9!K) ziM4T#${Y3|?Eat+rUNEdB~k5CqHi^ipa)^24dBuJGW&v53f^yp(7igqTHmYn1(xq; z#^B#4`>!+6{j@?l0HH7NL${?rF97p6_-p^4eXj$6BPSy0=0rH zjn#a>&$QjWm3@$JiJ#Swu4y4(JJ%PpmTxGoMqVJ>;nX3vxE9@sVO-mk zhk8AG#6RpW||<#bD@p5@i`XE^=ZR9^@=6#ZCXHknfm!=DwgJMgzK=cr=|(O-&0W>@EL*n zbF{ce=mUQ3?4?i-??N~cFhlejFHwIwAjNF^ccX>-Gx7y{UJTtajeHp-?TNBiU1*zY zo}DB)M7N#iO@K5v3{3ZH*r*FE0d|91CWk{c&FH9eF zlD`LSLw@~9+Oao1)+oKO>_8}`cNN<{8H8ss<}mI!wMokREYw z-dovY>Sv7lo9Hxzp4#xwrOhV&n}rYWrS*6BHW6`wpEp4ie39;k7`ZpL1AARq-m_ec z7vN(59{*xLjC)%*1UqplY66es*7sKJ;{B-m@$5Y4dI|lPr>ES{453MWmXUA8pCyr7 z#b*5Bo*nRim%}xe`}>}mF8qgdQ%v0rkr%*DG^Dq+uQNg99-PtrR`WeU`g_SqvEOY` z&Zj>?Ea#(u+L#ac)e5HGH#V009AeV}pl$r2yOCEifB7Y(YmX1H(*a5%@umCj19EfS zOVN7mtfWY1PwP8oW{-9?OXzo5x1hJg&yD={*U*E1{Z+;b_EC8y?vkT|LvE8k?xnd_ zi}071O)FI0iXYvtTX=)dYLaH3Zs=BsxNi-i%Xg9ftjKxw4)8%cNstuX!{$c%eP?9p z@q=oVJI15t7W900kf#+=^cei-IjELF8Lw<;UV?^Oupgf&;RZy^~Mh&1T!^`=WkW9-OJ{KPPTYSAA^`@}DK%E?ziC z>)Xtf+z0tsns}R0`R)&_i#&3kM2h&aigvK*Y#0W;nu(;S}?K34GF*J1o#@pWaSZR@hr zJs12Bqp>yYF*Ce8ma(yFhxB?41I2zcjrZJ?x8CE^v}457aJ}nrlf#jT_)= z$q%lnzM{hX^xuEbM5_ZtsQaK9-+5PFenzX=P-^ZbNFJQ&l23mW7KGggX1seMo#A6` z>J4~E59}JpzduBNEBe$bR3F8|&Zwe*omQBoiH;le(Y4V6TO)#W; zRh3$r`ZPzDsvDYa*!K;765a$ux^uK1q30;j`RINUk<0yzwuSo2{d%C1Z)oxOX#%VH zfV?O88Cx2B&L-dOWbTZO_SCi|`uA5i-Vo|>INV&i1GYX`L_hg^s|Y%<+rzY70rvjk z&B4`#ZnsX@5B|Zq84vZvyO&1XD-pt}H_J>-bd8VhYQ9>>+r3E8A-(neDZigNAbdIf zMIlHtJ_h^~^{1z>tfvm2wmlwlvpRW_2jhJc`1`Es1G5k8o8bX=cn8>tu8iCpe>V6{ zV5pPBbvmE`kBblNLw#F&-T~DI;d*mB2j|mAS!w#nI?1TKsUJ;G2Y|fx0K5NSNgJ57 z!oZ%Si+&TduNUw4F8mYxYa@T^w&yo`*ho{(5q>d$EBL@`Oa+f1~84?;GIo{%66qPf!o$lRS9* zvEm0Hz#(MS^5XAI^V zE3u#1E@Ym>{s?+(Oh{M$_323x|5UK+FQfVCCu5GLhxdInvy1)Nv$LH2d*#n_Q8{h2 z<@5nl_llA&YH6$39kr|v+Svf?Vmb2d9LB4%=(hTo(`U70eKr*1#{a1A!N1K+fp3su z9F}Er^0(sD)OFq4*u7-*PJ^#K%hjmjh=)-g(MP_sWY}F?rk+)y-Rv9xSQ_m~A2<=b zOog-ih9n_o-7%tAmB)AV;XR}LPdtnbK5CvAW%tzJBj1L-z{i~U9gu|46(^zFl|!9M zj7?lkrsZ&+zn*>TV%{b0k@&b5VV-z`dWm~R^j$OzpU_1}FSpaD+?-|uxc?5og*@IS4u>&O74tsDupfO7{;m7wdYS;< z?b#W}!slz)?uPO_1$F%fZS=j=et|!6Vq?1SG54=OY@g(Vpk>BgVuy}ujb2dB}kDCkX%>pgVyQs>4 zAIABxEtSR`_SbpUUf!Z#^_F;E3@ErGiAV4!sfIA`Mtc)_!Q1uTCc4!zi2k1N4uEvD zKHpODdrIYnf2(Y$|LkD+Q8&B@NbOG zlK4&NA-!RbtFeeLld~7?VK!xtzK_a>dX0($+6Uxg-o-Uxw8zF6b{C&>Ufo$%{)ZY--p+tgSI|l@;wpAOk3-fh+@;dZ2p4X zI5Q3Swm=2`9sWW-6)St*1aa*TQ9?4#gBA8xf;zbkI!YeTjHeqGJu>jkf=AJ1cx zbNDmkkJxYZUlu-4FW&9K|Z5} z-W|}S?}ydE-m<>?_h1g`6;g2J9?iStzI;oQzE4}?+@ip2e)cgNg}gY8|BN^8BAHndm1iXz%-j?fF$ zK_1<=tdnpSZ9#Y5OU55ZX@yPM^CzSt`ekP9;&)?19~Ap7>vvO$dkOlG zj$^Th>5*fqVJ}TL?*@DqbYISx^b;2~{_}i=c}cmI-8>@h;aXG2FIDHlGL;%P*b7qc zRL+KmeUcsIL;fcnpgsIt`N(^q&f|B0&t?6pi}#j$&@Q>pA6T^8DRDRK-T?JG`^KCm zXtc-SkXZ2VA z-U*C%-a^mc!Y72EPUT*r?>*Kv|Lw}N1|tZz&6Zg4jQ?Y#p8 zMuMOwR-i+uw z0rpg;?#iOxbpLnLzP$98UrXY*JN;q5kROxN3CG&*iM#`bW$Icj1&^iisJ1}UO}&#G zQ*kdKZwqA7CH*DhEYSgL+WD^gi2k~|VRH$+6H%NU-5a3HR@io&a0ZJw+wg(_c-iUjW`P+f?^XMn_3J z^>Q*>rHsu~!f#wt<#%ln%+&-^`4al_?+@7z#h;h%Fn=%|-htXGe>WZ!KZ4$jYp0>! ztWMh-L9M&Y!*%Ao18i&t{N_4Prw>B6E4!B;>Ve%RX9>E&7vpW=?RFacNPMm;CwD_2 z`o5@XWe?pdj^d{w9?4c-&KZsN&Fq!+Id&O^BDH3Ti=zB$%))Eje^JIl+`IG)7LLJ zAD?fn>0w!8zY?4*-b>M!T1W9kj>QMBF{qd3DkK4CZic#W(xFemyVzV|Z2vH0-AG@B-keY9qKd{(zr+ zMkie_vk&rJKd|hkDe&DBYc=X`>#~X*acy$i(r9V%zGF_kexg%9$28zWJw1VrJAgf= ze#T15)pR$Q{RTWL&!}jV<5qxZk$!+35eND5Inno0dDR>30A3>pS6^q&s^uOd-$~vC zCjHLgi2b3SHgh!u+se{`q6a%ZgLfkxnchz$HFPsV^m%^x7icSn_!(qaqbQE z%FT7WO*qw(wIlqW%IG~PllbbsaFE{{!Y~v zo-4@{)93TkNfBk&NHpf@gAMtovzJs6?~-+Fj8xblo9MWjuG|BzhOm53Jxx&5Tm7}P ziqZOXL&jX}Xb;m(^u1aN9{jVKy2dR4{7&Wl$UXRmdMnlmU^-wae(?7w*s(feY>IJn zjr8}=a$3qkd-5dPXuyrUi=U|HOQ>D+<6&Cy{naaI?_WHH`ciz`n7XZ;h8RtE9~AF; z0dyUZ>%6)N`ZPf~_d2ik?``bXq^Cpj!FaX&vjH|cUeSa|FE_57=Nx2)T|9~GQ>$DTLW^GE<^^D;Bb9i(b(0HfDTIiMvg`^C)}idn^9(EiLO7 z@d4b%23hB-vX+u;S|8DG14B<#H(>T--bpH_0^_Hzx6{*2Ae-eHH~h=VAnRfr>J59{ zy%g`Ee#VHqc8crs)44?4Qm*M>9@y`YhjhbUyz72Oyg!?F!QMo7ay|Vj-5{|WO0 z^-Z^mSomG;HI1fw$+wk3{?RDv8~if$<6&%Ifk1@+59*hFpuc-Yn&td zF*b2H=Dje7blaY8f?U+pYKePyL#uxsYYjX2!?@@!%td;5PrdL@6KryCDSv)8?;wBA z_;{EsnQoEJdG!SB3Cv6d28I}+kDqBlN98%G8goWpNk-pKzY1`mMw$b)c~2#)?tsO+ zI>UkU@wPEPO?~%}%~BO(|LZ|9PFuJG(j`T`dI){D`bXuxZ6P208|_d(?0-i4QKel? zf1f3ywau`9>I0L`k{JhlBI3S&P@jf?>!N#-`cZ;a9%Zll`l$c*HEe0UJ3wex6ZlPF z8Fg!=^ zdqRDH`cJgP5BQey2>OzK)PGbS&*Q)RV0{C%wBAs+=m%#zoJD%>=#93D04}0QjJ75I zTt)GYnX%T#)kxDXC;y?=U|u7~QNSu+)LXSfv-46-!1FPnT~q_?Gu8Ifq{MWJ$8QMU9wL6#%RokeYzpVP@JA{ zC5@7I08f>&7yAdgoA(3w-mh&3w?n&tzlz@6UjR@9@CbT$Ntv8boIVh+o*podpx3tg zrk56JKa+O3pZ>YK5AWa~@Qr*dP4H(dL0`_NoD8B5>>1_g$=B8V9ADiKwmo!4qYdLs zb8t2CR{Y|w2fyZ0=sy(c8lw!@6`mY@|Jk_ z!Ls@GGin0B9|bq&t_=GzHsF6xeKwnSQ9taX{>GngrUE#l&^Gdta`K77za(C;8}r=B z@K>^a0(`M=(%ZRfryP!@Tx!0eC4Pv$oMB&=Io!*;Gi+=Y_(*xwTqEDCO3L|)RSK@e z%5Fi2^pSN|i+%HMu79gh5=qj{g?fzXR_>G)Zre+%Z^um@^$4gSxB*pGsPc@&?d^xbNX zxR-^8^s{}-`RpWa9j+zoG=Uxc^QrP^J$?pkiN+l0h~S*0rYfF)Ta_LE z^6by#qTldh-cv7@QTh0#$UPFjmSSuW{X|{>eY>e*^c`78;$z;E2wSEqc0H9lu0Kyl z=)-k3D9>N6nIfZqRzK54dfo?d_bvDC04saIU(}oE7@N3ti#xE7%^&=yg8JLlXpE@` zeBV}TdVYFSh;$N&cA|>u#=RVQk4s@xD>UX}oG+E2dqT1f>`)(xU$Tzk8}k|kJMrwX zlwJ5E;(K6kTG^>9H}b;#lBv4k*=VEYP@foyH|c5)NH6N6=|(n5lUIGUoxzS=^sfigKww_glH zy89qYGa7%`?^f85{}Z|2exC#Q5Y5hkUCHpCVkADr+}FxktoT2<=RtySTtN@1a}g)j~Uf zn{i}4u-B@l$i0XL@J2qarkbEgPdA|W0^d^JV<~%0(*zQ6?q_-|k#yjyf zR=p%tH0gDewWaCHoWses#C;@wU^lif-m#gM1}EotC2y z=>gxP(KgN?ANCt|z?b5G712rn9L5W9HHt9*U`mAU@SbTGSt|1$t;f_$$A@S%-Lfu~ zcfA;o)?4l+?%cUQ>4q{99ap}A-%TL!N9BY0&if|x(S2iXdtF&6vjP1=`x5A@`7Ds^c^+--J1UU(t3(f`AzE&Z-Rae?4&DimchJjOmV#}*{vT) z=RvnfI>TLJ#x3_{gba8Ley%Xf>R95(_-o0+4f~s*^YgS!8+`SF_Ea%|cPj+&8n;92 z9rew4{|#sum@V(y%J6;|Lw!j+cQroT_Bqy?o{FX1r&(cs_6uNfU4S>{k@ezzz;Dv| zbA(*WoS#Wf{GHq)+KFKw>RsPdzDWo0XFaZQNO!{2zJ(={VtnworD;vSp49jVR(9)ti95V=c4hR@)Vb(3=BLZ^c}S<|xSr%^%ykgfxJP)OrNKXMf=%3a*sE`( z)NCl6rP}F$Bs77eO-?r!`mRSD7?tUj4Q;KmG~r7dQB0_a-23ico@a_f`mXPhb&Uy; zPGV!TQ}1p6E&e<2w8G~@ticcLY(DCKQIGAh%A0747a?y!*Jw@0-76taD`J``+R4bmFXRKhmnbgAmGc@ndi>g8>bb^2 z-{(H3PP22p(?mzs(e(XdXA|_O|9{K-Y}mnnkhk2+*a+v)O@4X)F0@Uz0RMJL4D7`? z?5_?m?+5l(!P*o0lT95`c2%G|<4_OpR_;zc2RhcrWn9axBd@TEwm6 z5pj=St?V!^knMa7xTn6DjH|(-EX)`3Q&a-u2K))q1$gKNaNC&1T&prz8hu{<{dWGF z`Tg4!(t~Q}#q|!jyTNpa>v}^3@TJ}GZpPVPu(O(@Y;}Ws!g)*o-WJYtB<=%nyCX|E zO~6f#TIUn{Y6$V3FKMmaY8RTo9v@eesmI8ADh9u8zQKQhJa#^@ZfTHpqHb*Jk5*OD zOP3x^w*dcseg1J3>7x7j+ts`~Q6IqdRKmE%(49nkqV>j^!|GsuK2=@@2CI&lG3gDy z{ks^i5Y)<_7VHH$71&oC^j(#wo0sBbG&+RvDElP4!znc%Sr7P2+)?ly_5u8$^17!K z>0+F)f^VbQ7u_&!WskV42}TV|6?Y^0nk9F#cBgbxm)3 zvyQS*|L?rb{E6~~JosPq6eD4}l|Xu6-xAS{+?(YR`pJ`EU=AUu3-iD};G1qFzM8;j zNA6qb3v)@iLp$L;(;|HscQU*e{-WE+2XhsvOS|Q2P;i<+%Fa~OmyS=;%C5s|sk{@= zP9@`}@21{r-lUuN=zbx;IT^be4y(S2Eb#4T8gnu35Y)xBJD?Q*a})dyxo|ygk;G=E zx?~4mt39ob8Qz=ybUf-v2{i%ojKKDlJ(*cru`ywn*U+nk~v@D5lhl5Q*_Z0`~ zZRE%AYiUf*1M1QA3Ii_2!ThQw*hp{Qe_WnW_H@98e~JrvVUC@Tf5-nEc-L1;sdR#- zD+crA#vF(4Ix2suDAI8+x}F4TDw24EY@tsc-tB6Dx^%pCKU3(w73OymKZ1U$tD83L z!Cz?Ob2zmccIQn!riBRUS2I4cu40p}#Qyz+=m&Q6-9m41$IK{x`boSeiuX`oV?-Zs z({0g}^$zgMpv;V+4$f0aTck5mToof9sed8g?4$L^0Oyb{mXinV>+{d|aY|)~M%hjG!e7WE@uwyC1HRQf2LI!7 z`gT_Aq@NDdx5OWW-i#OiP50ZCZV=J%F2F&%rU8E{?Qnws*m<)b9oKlZpf}?<8KnFW zt>&%oJLaaF4V?t=LcYQ0_U8J0ag=-Uk@b8zA^nE^d@aU{^qxX@NWa;+GoBB;2WkWz zp}+5geYNoKS3*hrX8A++F8zFL>wBoz>foRE!A!wcn`3EyyK;!FX*-{CHM|3G?oi)W z$DYUM+o=d`U(>hGNkilsr}f&zfO9N>hw&rnqJChXWN!uQ`{g9>&-bedVcy735{Ym2%{5K1{ClzQhIqNy z!Uu43jk2d`#v}B1urDe1ow#^BRRaA z{hUr=6w;lS$`}4=f^J|0YAlkyfgJzb%Xz&WX8nlFSjDP zDy!d``C5-47Wg9U!Xy~Z>|#&A8A$bIQJ+TEfb%%k!szU6*Q4%4m#aQ6z< zo|v0UUERQVF#qd~>2S?o5Kc7sB*=Z!y(xPY%hJGjzYk=GBIx=hT0&6kOe;bEem?7B zCuk4gE%Zz7?PN}LMqkvZGd`|H-k5{@@E(0P(P;e$eG=3h%x!O)_p7I3e2=I(;1d>i z^WLN{_T2;_UEAQ@Awh?0jX^%s&XN1;A;h?fCf#F@UtBllVVpy$D<<7Jq@QnRqF`5k zIw^ko>E$eOCpMhP_u_)OUjtRKvFTNDZTtCcw1=NG1~Z0xI;CV=s20vCTq z@fYmYdMd?ub3K5Qi0-b-y%>4%ZXK7b7xhc)eOJS(xaNjZI0tQEPHtsSlBLSM+Q`GZ zVmqwH(l7>O1FoEDqQqT{pNONN-!UFb6UG_Q?&sST=_lz5Xm^GD`Xr?e>|vauNoORi z?-ulE`aX_+&`Ryf6oFe2c=28}OUD zA*7$oy9C{uu5rY@PpV=(T3=k3b1zMIajAK1Op^}s$oi4@q5E?p^|zzHYXvynHfLIl zX91Q=>RUA841w#(qCVcki)(r zO+Z3$c^T?mG5BR>j=UG?L7UNNhj-CkyhqUWJF-cV`~l8mQO(47o8cO`j=( zUJ_sWZiyevO}(VNz#q&-`o!f)XloDS0{;Z{it;(Y?i1{?>K1wfem%V^#@i&ZVYkrx zt|qdsQ7V6Jx_8W%l$&v3eu&ZiBkZ@+MIps^632p+kAcC)6y^o{ATR3i@33t1{>Sa| z_m#KF*|;w1y{C9L(W*1GUS|}@Boj^dRD!vuW&F)GxdXJ*6J3eoNBReRx2b%`|~Mj7Uem?a-Z+rnk5o?dbrMUftmD zp(OepTue@=$US8u24+T4>|Dr)`e8qSkGJWm`{4bCw^_V*UY6#1db{#{EToHZD>$T+ zl*jjy-T}tEZX)|iQa)!YjXXlHqA|ZUD=tQy=Qj z`W1r0w~}XJZr(ewZ^6R^e|@J~eXyFqUp(2>+=P5%KFO^rW*qRX@1^N2^ow*?{M!Pk zFRODfGcEUGd?S6RKOycHjSlP$N#P$^7wq)GxkP`|{7%_dy^M{Zez}G8lJ%R+%rybj z?P`W@C%1ii4(9Fvc)v!|3v(&ENM8Zk!MsMqy?Ni3UN73_`^dk)oE3k}!PQi1iq>aL zrRtZzzg!mPd(QrCsgbwh=dyDE_pPS^AH`2{$GE#e9iZdx>30F{fNSZvc@ODYE!dNc ze8<>i6zr8O(rE=j?Vc#1N8d%ae^_A513Q%i>ES)>qv>8{>U+o5{o6@rTB7OJQFbXi z#hFIpOWB+HX5S`f7k5j%VZWWeDZ==zos2~sS5x9H>2JUXa}pVwz>cyL!d$Wr?6x

A+ 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 XfBORFQ!r!BUx*q0>Xa|wn{WOfXiM9o literal 0 HcmV?d00001 diff --git a/build/conda/installer/assets/create_shortcut.vbs b/build/conda/installer/assets/create_shortcut.vbs new file mode 100644 index 000000000000..395da62415c0 --- /dev/null +++ b/build/conda/installer/assets/create_shortcut.vbs @@ -0,0 +1,70 @@ +Set objShell = CreateObject("WScript.Shell") +sdesktopPath = objShell.SpecialFolders("Desktop") + +Set fso = CreateObject("Scripting.FileSystemObject") +prefixPath = objShell.ExpandEnvironmentStrings("%PREFIX%") +userProfilePath = objShell.ExpandEnvironmentStrings("%USERPROFILE%") +currentPath = fso.GetAbsolutePathName(prefixPath) +parentFolder = fso.GetParentFolderName(currentPath) +shortcutFolder = parentFolder + +Set objFSO = CreateObject("Scripting.FileSystemObject") +If Not objFSO.FolderExists(shortcutFolder) Then + objFSO.CreateFolder(shortcutFolder) +End If + +If prefixPath = "%PREFIX%" Or userProfilePath = "%USERPROFILE%" Then + WScript.Echo "Environment variables %PREFIX% or %USERPROFILE% are not set correctly." + WScript.Quit 1 +End If + +Sub CreateShortcut(name, targetPath, iconPath) + Set objShell = CreateObject("WScript.Shell") + Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\" & name & ".lnk") + objShortcut.TargetPath = objShell.ExpandEnvironmentStrings(targetPath) + objShortcut.IconLocation = objShell.ExpandEnvironmentStrings(iconPath) + objShortcut.Description = name + objShortcut.Save +End Sub + +CreateShortcut "openbb-cli", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "openbb-api", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "openbb-notebook", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "openbb-ipython", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "Update", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "CMD", "C:\Windows\System32\cmd.exe", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "Environments", prefixPath & "\envs", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "Settings", userProfilePath & "\.openbb_platform", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "OpenBBUserData", userProfilePath & "\OpenBBUserData", prefixPath & "\assets\openbb_icon.ico" +CreateShortcut "Uninstall", prefixPath & "\Uninstall-OpenBB.exe", prefixPath & "\assets\openbb_icon.ico" + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\openbb-notebook.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate " & prefixPath & "\envs\obb && cd " & shortcutFolder & " && jupyter-notebook && exit" +objShortcut.WorkingDirectory = shortcutFolder +objShortcut.Save + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\openbb-ipython.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate " & prefixPath & "\envs\obb && ipython -c ""from openbb import obb;obb"" -i" +objShortcut.WorkingDirectory = prefixPath +objShortcut.Save + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\openbb-api.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate " & prefixPath & "\envs\obb && call openbb-api --login && exit" +objShortcut.WorkingDirectory = prefixPath +objShortcut.Save + + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\Update.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate " & prefixPath & "\envs\obb && call openbb-update && exit" +objShortcut.WorkingDirectory = prefixPath +objShortcut.Save + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\CMD.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate base && echo Conda base environment is active. Use this shell to create new environments. && echo To activate the OpenBB environment, run 'conda activate obb'." +objShortcut.WorkingDirectory = shortcutFolder +objShortcut.Save + +Set objShortcut = objShell.CreateShortcut(shortcutFolder & "\openbb-cli.lnk") +objShortcut.Arguments = "/k PATH " & prefixPath & ";" & prefixPath & "\Scripts;" & prefixPath & "\Library\bin;%PATH% && activate " & prefixPath & "\envs\obb && call openbb && exit" +objShortcut.WorkingDirectory = prefixPath +objShortcut.Save \ No newline at end of file diff --git a/build/conda/installer/assets/custom_conclusion.nsi b/build/conda/installer/assets/custom_conclusion.nsi new file mode 100644 index 000000000000..ec0839a44d1f --- /dev/null +++ b/build/conda/installer/assets/custom_conclusion.nsi @@ -0,0 +1,86 @@ + + +Page Custom muiExtraPages_Create + +!include "FileFunc.nsh" + +var IntroText +var InstallationLink +var ExampleImg +var ExampleImgCtl +var PARENTDIR + +Function muiExtraPages_Create + Push $0 + + !insertmacro MUI_HEADER_TEXT_PAGE \ + "${PRODUCT_NAME}" \ + "Installation Successfully Complete" + + ${GetParent} "$INSTDIR" $PARENTDIR + + nsDialogs::Create /NOUNLOAD 1018 + ${NSD_CreateLabel} 10u 10u 280u 40u "Click the link below to open the installation folder:" + Pop $IntroText + + ${NSD_CreateLink} 10u 55u 200u 10u $PARENTDIR + Pop $InstallationLink + ${NSD_OnClick} $InstallationLink LaunchLinkOne + + nsDialogs::CreateControl STATIC ${WS_VISIBLE}|${WS_CHILD}|${WS_CLIPSIBLINGS}|${SS_BITMAP}|${SS_REALSIZECONTROL} 0 10u 90u 280u 40u "" + Pop $ExampleImgCtl + StrCpy $0 $PLUGINSDIR\openbb_win.png + System::Call 'user32::LoadImage(i 0, t r0, i ${IMAGE_BITMAP}, i 0, i 0, i ${LR_LOADFROMFILE}|${LR_LOADTRANSPARENT}|${LR_LOADMAP3DCOLORS}) i.s' + Pop $ExampleImg + SendMessage $ExampleImgCtl ${STM_SETIMAGE} ${IMAGE_BITMAP} $ExampleImg + + nsDialogs::Show + + System::Call 'gdi32:DeleteObject(i $ExampleImg)' + + Pop $0 +FunctionEnd + +!define MUI_FINISHPAGE_TEXT "Select a resource to open.$\r$\n$\r$\n" +!define MUI_FINISHPAGE_RUN +!define MUI_FINISHPAGE_RUN_TEXT "OpenBB Platform Documentation" +!define MUI_FINISHPAGE_RUN_FUNCTION "LaunchLinkTwo" +!define MUI_PAGE_CUSTOMFUNCTION_SHOW MyFinishShow +!define MUI_PAGE_CUSTOMFUNCTION_LEAVE MyFinishLeave + +var CheckboxLinkThree +var CheckboxLinkFour + +Function LaunchLinkOne + ExecShell "open" "$PARENTDIR" +FunctionEnd + +Function LaunchLinkTwo + ExecShell "open" "https://docs.openbb.co/platform" +FunctionEnd + +Function MyFinishShow + ${NSD_CreateCheckbox} 120u 110u 100% 10u "OpenBB CLI Documentation" + Pop $CheckboxLinkThree + ${NSD_Check} $CheckboxLinkThree + SetCtlColors $CheckboxLinkThree "" "ffffff" + + ${NSD_CreateCheckbox} 120u 130u 100% 10u "OpenBB Pro Documentation" + Pop $CheckboxLinkFour + ${NSD_Check} $CheckboxLinkFour + SetCtlColors $CheckboxLinkFour "" "ffffff" +FunctionEnd + +Function MyFinishLeave + ${NSD_GetState} $CheckboxLinkThree $0 + ${If} $0 <> 0 + ExecShell "open" "https://docs.openbb.co/cli" + ${EndIf} + + ${NSD_GetState} $CheckboxLinkFour $0 + ${If} $0 <> 0 + ExecShell "open" "https://docs.openbb.co/pro" + ${EndIf} +FunctionEnd + +!insertmacro MUI_PAGE_FINISH \ No newline at end of file diff --git a/build/conda/installer/assets/custom_welcome.nsi b/build/conda/installer/assets/custom_welcome.nsi new file mode 100644 index 000000000000..461082fac36e --- /dev/null +++ b/build/conda/installer/assets/custom_welcome.nsi @@ -0,0 +1,41 @@ +# Below is an example of creating multiple pages after the welcome page of the installer. +# +# This file contains code that is inserted where the @CUSTOM_WELCOME_FILE@ is located +# in the main.nsi.tmpl. The main mechanism for extra pages occurs with the +# "Page Custom muiExtraPagesAfterWelcome_Create" line, which +# references the function "muiExtraPagesAfterWelcome_Create" for page creation. + +!define MUI_PAGE_CUSTOMFUNCTION_PRE SkipPageIfUACInnerInstance +!insertmacro MUI_PAGE_WELCOME + +Page Custom muiExtraPagesAfterWelcome_Create + +var IntroAfterWelcomeText +var InstallationAfterWelcomeLink +var ExampleAfterWelcomeImg +var ExampleImgAfterWelcomeCtl + +Function muiExtraPagesAfterWelcome_Create + Push $0 + + !insertmacro MUI_HEADER_TEXT_PAGE \ + "${PRODUCT_NAME}" \ + "Welcome to OpenBB Platform Installer" + + nsDialogs::Create /NOUNLOAD 1018 + ${NSD_CreateLabel} 10u 10u 280u 120u "Welcome to the OpenBB Platform Installer.$\r$\n$\r$\nThis application will install the latest version of the OpenBB Platform on your computer as a self-contained, Python 3.12, Conda environment.$\r$\n$\r$\nIn order to install you need access to the Internet.$\r$\n$\r$\nInstallation requires between 1-2 GB of storage space, with a minimum of 4GB RAM.$\r$\n$\r$\nWhen a non-default installation path is chosen, it requires a depth of two - i.e, User/MyUserAccount/OpenBB/conda, where OpenBB is the target folder, and conda is the name of the folder where Conda and the installed environments live. The path, including username, should not contain any spaces." + Pop $IntroAfterWelcomeText + + nsDialogs::CreateControl STATIC ${WS_VISIBLE}|${WS_CHILD}|${WS_CLIPSIBLINGS}|${SS_BITMAP}|${SS_REALSIZECONTROL} 0 10u 90u 280u 40u "" + Pop $ExampleImgAfterWelcomeCtl + StrCpy $0 $PLUGINSDIR\openbb_win.png + System::Call 'user32::LoadImage(i 0, t r0, i ${IMAGE_BITMAP}, i 0, i 0, i ${LR_LOADFROMFILE}|${LR_LOADTRANSPARENT}|${LR_LOADMAP3DCOLORS}) i.s' + Pop $ExampleAfterWelcomeImg + SendMessage $ExampleImgAfterWelcomeCtl ${STM_SETIMAGE} ${IMAGE_BITMAP} $ExampleAfterWelcomeImg + + nsDialogs::Show + + System::Call 'gdi32:DeleteObject(i $ExampleAfterWelcomeImg)' + + Pop $0 +FunctionEnd \ No newline at end of file diff --git a/build/conda/installer/assets/dmg_volume.icns b/build/conda/installer/assets/dmg_volume.icns new file mode 100644 index 0000000000000000000000000000000000000000..255d73c02aa0016a52cb4686bba8199699467c59 GIT binary patch literal 674218 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%0AQAk6$E3}3 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ϛ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

^v#M- z@6g5ixf<*k-vM6QQVGJufFydt<(<7P5{yDn)cIpivqXe5?d{&gkHjMPE)S@Lrn%*& z|D0!Dm2^rle7#dZP$vR+tpL+wzKY?8Y_JZ7OXE{g99-{GywlPDuxmbDOqN!i;rAzI z5E;#b29uUEOfb~Y>z^9MFQ9)9d>-xTUWM7VfT>Qq&wfxnx7XMn4KyFM8 zGlS99Zi4eHR+9nk;}zL!$>3{?Ga#Ak)uq+1xW}$fJp7&Fqj$&r+A1n`xVMoDET4Lf z-0I25M33Dmwt~Fv4#v>VevD)YUsBaY8H51R8=>paeQ8o0@ZM|lG74j#DYoUOK>EtC zZ*Kz1HRnV4;K_Pj$v59r7x*}-@M#n(sYeYPId99QD}NKB+VyNbxtxmp1hpO{M(5oO zYIV}SOL5;Bpd4F*lm9&wL6ih*F+b*Adwj?lidQ^AET&!4pezY>{XE4_Il+?G~aiTkiR7O*e@{Syfh(Y0l z_+C1iS?dM0BeOYf5wN>?Z&I$Qf%`K~I!{dja+lSi;q3D$;N~y>o*~9mVDb8fYM7e? zztVZ$O$~S1NtC+?WHS}zanhx3w!uQKCYQ{19NUmIJ~8YF5odkAe%wh9@5{KoW7fHP zOecCG1Usob9If`WH&mq+kQ{bj)vA4_mpf>!bvwH% z#nt>Ykvm55C|1H$9Y@w0!di>QPg|| zEz!s*A-g1zdz(ZCA6Z@dRI^zzWI~KD)+d?WKhs#Q42n?YezLIdEUIUE`@J~ESgBu{ zb{Tl~!oDX>dgUv@MRuhZ2+snNK6Ns?dd!tF|7q@2{R~Ksc7F6U(I1}*KWAx$Zd~H% z9z105k_dE|V7UR;+1s>4-N__CqeY&5TViyn;j^+eLMdBX>`$37Pkg4M@URbz{^cf!W{=_ zmW*XNYPt04DNdf;kdk!^%3jX!pbjcek5WtsV>5jD)%y>~ZMhsl$QevebG39|v27CP z>^)iOh0lIOTjd8GnJma5@>Vox-%a!HvE_^ZvTd3O65D9Jh~j#;t=RSn_}Qzv)z>oM zZlq!phK~gZYeyppghmzHO6B><^%dk7b7cVXcRjQg11qn&9bu)Vl0N9VP2My<(c< zZMzSJWnu;V9r!L@w{1wzrjGLwNpIT$G6m2^7Xore5hc~9C_ghJ;oI$hWCQ<}Sy2It z;$`)&AKV^C3l6QB-sTSud;Ckn&PC4-Hl+zN%cO>VW zL4BT&?B}Dcu7&?d^CVIea|c<@L@7o`h|e3VXHw1v@==pr{VO=X(|B`eq#x|MRfEnA zWmOAWl^u^Wwka{dT(9clgzV)r%%E879|{1>f1mPEh0d>hfPr<6%2C`DX7$cqgYg*U;!*N4wsQ^WbEoBe= zq_&NnMLlgvg2Rt=A)CYR{g?w9I;Bo780Yq+TR)(&mm2gX12i=A7`H*9hD}`&~s+KfWo|_IdD*Pk)xo-j?Pdz z>`K%E8^RVI)ZzoQ`&pzpT(~`b!UB&OT#y{mIK6aDzGP*uzI zQ<4Pb>io3FqZr@6^Q$j70`LKP9?~SmVK-5Ig`Z>*c7Pt*I2Dto@=LYv;#XtO9Cf6$XW z&fPxTovjmg8yV!Z48;`<#BYkm0xRJ8@=#p?pdQCXmf!b9bB;x7=x<9ziOTqq}rK_0!aXVV2T_nv=29|li5Nng^mIosM@qPer@7iYi zsIQ%CTz)zKBpumcfM*aiWaEM{SX5sWdm1{-%Jl9*f8ibc3#$dGup!;$im^}UHTjEl z#?jnawcQq}4ec1Y^DQGYtK-KcQ?>RzKv?J@Qew%jHsYXy!iz25(P}Y+Z?3`|d^eZj zL>?!UAay0A3g}*BL1K?$0KTt~Q&Q!)i_@ZqjldK89FCGsjR@2l6&L&DL$~%-wRFZ* zxlTsB0yt0j`Emh((o!M6NdoGYCP3J6K1l2E=i*DP;^_@r|DKulT)X>jFB1iNA9tfO zwtbD`85-An!s?%AX#GTx)O%u*UK3MtHCpM6tP>{hkE?lM+6owJmLhBx-Q01u4g$QH zk!3|Eute4`1m;|vrs=!Ht3JmvhadaRUtyBzigMyIlji|i7^$YPJj}5P_ z8JZ=6qZAKSo~AVr`&KwwYM@*3w98dAW;Qks#Vx$zzSx+NGsL1hiiAtcMi4ZZ;XLhE z(!s^nDdjz*9v;+#A}DmoyXJHrK-rOD4XbfZ9O{FD1PJn#ZTp|788Z3hite;e?(2KF zt~r$h2(OjtnVQ2So%k0*3$U)X-LRLFa-<_>)KkD9djWL!%qbVREaSFJ`(;lL*$`GM zCi0NNr(UopI(b$`td-PQ@Gvpn2CKYawuJ0)^NULsO~_|bSux~LX}IIw)m7M<_IHo}pQkW!o(wnd|n`8K~hI5?3% z`2g(!E2;jI&=~7`9KZ8cAmO+bR+1DkM8r3=)#5oaweN72P;RUQMSrx-tm|0#x@7X` zkr)TX9)$%ao$PwY3|GT1F6yr%uaqicL?O6xpTER}z?7Ktudtra%Fbg5@8iF{(UyS(zTv~F zcxB%mpHm*=8uM&RU>`KeT71{^4RPylOETetCs_W$MS~1%VdsA%=Mo=z+kzTTWS`&+ z0iedwtQ`DJt#(iAKRbx_+f^^ce>uJ=II;=mq(mEjY~l&m(0Q$9NZLDSm<@*j;B6i#CM(%fif7k<;!qo&N3>g`!9+l!~$$3@eoq%tj8 zD>np9OmGysy~#Mb@M-tr;sm2qlttGS#a-6cQ$X9o?^b;t9eT)mIUzpaBI7W^xm&3C zbW99$5v?TkaZ`v@ZdaG8*C(#-tbO*3xO+~KsyYF?;?`upFL}KMZfBhx=7JQ1Z)SFa-h%72lY4>~T;g zkUu(LE)pG0A-g&@v`_ib;o=2_4ou93a zscrcz@dVo+s{NFY88GG%oT7UwVwp@7XiDq!zkAo&AviX=Vq((Nn@2d?HtJ1h_E;Dd zs7fhPfZx`-lZVrBz*oJTHx%%Ja9%7}U7Xqa5=0*)llehJQ~0I40C?|ih4s2k)?wTW z7uw~>O^!!9HhSb8Lx5`Y`g+de@gG4X+%ISnS5DVA+~ctWEK{|jrliyh+|gx>a4*`l z6a&WA&2B(W?wIW#MuTpLmB22=Zr|@voNW&spVan-vE%3Bpz%9g`6`4D40HsxZAfuJ z>X2hn;;y|W7cW^fhw-6iZ==}F8Ze&yzP;V`lwkNZU$!2_9;}!p7Oi%pr?SaDfoKgs z6*HJt{4k~nST6(I6<=?tB|@vDRQ~Bh;yhHyxlV6>5#`!HWdqy?4Vg9moPL_jw;Mno z{G~rE=g~`3ncKB*DAX(Uc`ZsTj7$?U*HvE)m2`5AsG#o{J0sB>_FHlqc6& z8;)&KH7asm=sf?n*ug#{@U1*8v)#Z~WD*!uz31y% zyQpFPEx(4_xI4u7WQL*w2G9z~#J_iRgJd>-BzRha7-!{<&+2o{59?_BUxD7tUQTNO zJ*Tg>)_4=*1u;ayLj z{FL@=K}tU4Ox>l^T!fu*LH9(&=+GIi0H@B8hcDMbC!^6pYA^*jJfSxZofTtLja0g; zGwRZjedzuS-GGblI6YG4p)4UgTQ_4c^pWW zP2Q`N;*w2;cry`yg(BShNo#f+7+oW_E2R}4FL=T*qYlX_ka8)j*>zLeM5xi>D|>6@ z@1;mFW7yia1!>5s>Q>2OhOODcZF9h}ym2mj#)3d&jaG;2i@=E^_?i)`NGZCm)b$*3 zxeAzr6Hvs>B{)8T2pT>MbhP@HEh19h!*O+R2v&@E+Ir3jNJzjB(1?+4L=_QYa){sa zIk){P%2-Hlh+b-uY7-gFF>n1Qa>J-ncfWs1{VrB~A^a?*Me)&1;cqOqG~ouPUsE>2 zK{VNh^eKPV(>k2#nv+H`ecJi##cUD8nb~|7&JvX z>`zmJ&oN1-j1U&oOO7HN+jq0rqxs)U2 zbmBf;25TfZm6BBqS@)x3d4h*Jf~9{<78DKv3GG1_C-+}p{q)qo44dz`ShoO!VDaal zAW0}h>&9^eawCc`8R2%p!ArczyI?XYn7)|X3jM997D1z~2Xilg9Jj(G=ksf6C|wSJ zmc2o&E`}1^&ZAr6M)il(k_Bh_oTp4?ZQkTTf45dls<)^845=*Z9wpGcgPNY3`L9xy z&K^>Un0Jfa-Mjm{$qzVJ2L>T=r<0Zef^KG#sG8a<2#w<(=z*i5zRn;zlx%0{XX@JjW{fg6 zxs%W0*yy&W$YI%`C=Mu08;ow9xm zbTUGRxC?pyINKkubH;1LJ3A&}LXL3gLf5JYU*onZNmBA7C|NbeV8%^0ez4D(cEzPQeWI8Va|U=~FQ$CK@=| z3_+1Gu=Q&*HSx(5j%(LPMYQ-!M?7Zy|CY{e*IeF*;q%wb&9ueT0-vB&6D4&pH$G5l zoQvga2=6q+(~;uO(THPtz{e3y(*)DX4NQ>ZKlh@Upx9hEIOdf@*YM2<`Q~spSqQ53Y2v4CIHl0>rDD|Hs`R?oc0Kh^?2q zZhO!Cc@~e+C_2j%XFvc+us>ERe4Nh!n2dD7=qHXVWgvWVzwQ?ksUePMs^k+pKcln!sU@&2&Ck$u z&oth%qMv?yDzzCWYZ`Wwz1r3Zazyv%V>H5*({9QvC7(_2Cf54yVFC)mo5QN44 za=B0n-ftn}{?W6S`5z$#6hwaST0>uOjx%TiLGmX8P@79-G9DZ3Y}hR-`CzQj&z}10 z?&WHl;BuqO;GJes?}$^wTYIq>Mp#TfxNy^6OL*HLGV|=< zH6fJl-S77$tn#7DTcau32suctv13n;wA9r^#Um-`-s!)OW2B9^PmM1lo`WyJMEpL{ zkw_T~B2y8g9?k!=Pdug#jt&6{OvY|+_{0gw)1?6;Ss=T?j36U`R0#r(!^ zIW5Yth;pAHQvxYeS^x)of18>CfVc4u8N6kPPhgUF?c0O@T$Izl`SQQ;JvrMOQl|Nq zBn2qIXau0qfBxQ!+gy{f!v)`w4QyF>85?|)$#p( zi+sy=CT7L|j^TzXqGdO~WFm^c;yPmkRi%4hXu}Ktrf5GQTiFW3cd%EBg2<3Hiu;ud zgjz5_Tz>la-v>2lzqmlWTsXxMFBXV|zwoPbBAkJN1P!~Q{LOiR%i$X0Pv5IE%Gnrr zMYV%FlF&@}vNJYpK-x29V-)R)HrU$Ax_?M9@dCGPhHLVDKTF3%jz8QU5)IH{Edq$ znbC)nPjz7#y~vGiO82d*AJB?aB9rRPwVKuSw`|_|0AVq(Fk5WBpQ8H;p@s%Y!+4;hPE%fX7`mbM;Xq ziZ)TGAr{$qPV<~d$DI1xZ@j#jJN=q_OdZ=n=m@_0%x%Z|a`f5m71{FN=D&FrXlEC; zREfwf^XN-7(f?@QPeeiP;@(WzMZ&Fh$KI{Acx365aaV%{ed4xA&)dtn9VR{~%gNLb zQW#Xyt8?(AVu*gqc+=R_PMDB6<#jHVcq5vs$swg=5+rr)ae0q$RmzU0L)hg???n7{ zd5=FVyakfB%~p@sRROJ6Zb`{BV>_3`Inxq&`k(M}(NypJXVp)u$I0!cn_ffCP^ygejxFqwMLg?$Tby6Ewja* zI^+J_H_p%6W7yEP-JWwOF+1rAio<-u5ZrFlf8hs>9D$K=r~myQuA%9$IF^sP^d&a$ zw!+MRN&FNnq$4WwY9XX>nW}?tecft6GZGjjD$%sH@B(mU{q4jt+wo7H{zaBvh}W|z zd2L8VqnBxt9^AFL%rRwV*R{UhGxGDfnS1#;;F#SoI&4x#jCHZdcp_HVS`Nne+Ds^6 zc~}u}Vm*IO4fsfA4(oOGR;^AwOZf*(+(z~uYl9po^0)I5u&t})zP%YH=U}q27#g%JZHMk)aW`v})2gHoH;G z9Oc0;kvcqRe3((RbjZ&Zg!f9o#KLb}Gj664VgoJbuRL#!pm9dd$-eDjLnrpYa6jw> zFmc^LTp8d5aqN4;=T z>fm9AqnX_lCJYa;ozB!!l$&8r+)b2_>`eE0GvRvK_Q+hukeJ9~e*9MT{m9duX-C)u z##3F=v3O$zJ`qkgMaG zTz{DhY#klyEKjt*KcFh%x4arR%xy~j7oKfbMEpduec{O76s_|140h<%NsK*p&v^O( z2+GIb{owHckyNve*MHotkUF>`Bh@1)9=)X% z%;{eIr@xj+*uwb%bK~u%QSL$ecjd}D$a0NR zwpOkoSCq>;yEtRy$G9bP>|MVhRg`39m+#9mFJY+JNvskYbtj%lkMSZRzr0=Caj1s( zcNrik`Yr0;8Mq>uSPBUUkAgnGNU0WcE(KFO4Srvq1ATFkm6UAVA5Xm0nXL<2h; z1iT1(C1>2k>T}pNwMNr0p^>McB!a80QQg7i2ctJ0N|}*ES}-P`nWM-t?c&>wYrudY zehjY@Qgoot1_-sA`r7mz(YWlkO~2C*FXC&u$iUU?A*iC3j?q^xH!y5*1x)_envKZ) zNw_Z)A?&B%A;Pj4i8t|E)Y?|R1MoI3ATsF}{5$w79s4cZ<`S2K zj>W1WzRMitmK}ls13vE3kz^UqZvVd=A^Uym0N|Hp3G2(YS96z+7-spxb#M_|bAD1T|7?UIa8%Ok`aMofEP zX0lFg^KF+@0cTgRXx;z7EBqU%ue#a@68Am$pDw2-GNxC1q(LMxI;P0hUn#<)bti2lzwnC=U(=H;4Znx{EvK(A^ zo!H%~xRAn*Kx5RQea=*v)YLqhg3NTHf(EZZfsntz2XkMz+tG$kgW?$#-hZOXoZ7V{ zNlX9#??ap6JjrP1CC_E_S)+ka4-r4+`D^S?Bk}83SBJ9DNM#XYg}!N`K2TrRdsDqV zID4f_kn>k@q`Fvg&cJ$-SjJMbw+$MQL!N4+oWcWG<{}k&Bwe|_{$PZ$aif$X>Cl>& zs9n44ro>oC2Lxqk>|gWW;{@D1P?&wUFlYInHvtDi$zCYg+YMP1xnHOP7Fyx0luXyZ zQ+l==dKfTOt`?{l?KFt1&0|V`PkpN&_R)~`5h>h!%lOW)*?=Yiacv{intYPOCwlEb z&hg;Y_wo>%mgToqT6!SYFDN=rce9uxRb&dmYG|CbzU_L`0?Egny?}ou28;Ysi7p%Cwg?n9zA=rcRE9eB6ii(XINlQBB$=c1tGZ|(lri!SL!$_hz8}wlI_(l3}}I@ z7{E$gj5{{IPzHxV{&NlL6L3V68xHjT_@xNo)>Qz*8;!s3P_<~h=Qx~|q-yUeKOp?~ zWt#ZjFWqnEKg_yvYt}vm7&J{e#3$4WirS*7WiF=j=p45AHA&y~a6pEmd?JNAN4lHP zKP|I-!4^-Q^7EI${w^%BHbX2&mxcg`@c)5sE`FC>q$ByJyBYK2!S;#DE9FfpM_nef z;mv{ds6s==xQ)$*>d`n8-eJ}7`NtwX^%s@rqpH>7u84b-F>u<~$hng*tOTKg7~+I& zn$d0%l(FcIQdQ%W>8pm_cg-V$1zw{P@*f#C3;|o5fJ?&`Pim=0i0-&^NF)1!NTA4n zGUXJ=5fH3_oKA;sUJt&wrE*o1U;oAbtotTl+suP8sUczbK|#rhh1x)%-TzTd)&5I0 zb=%IJt70-J&ehXSSwi$r1>K^gC8}~~Er)vIeDGf5?bDrK4%za}3rOhfmCN^^&+q*= zFz!${Ympz(1{a+VZYcsm`& z6_u=1-(Med#?;!=A$fs%uJ1SIXw7@B9z6@HGCc#=CUBwagE& zQ5JX@KVN$_33<86#l!fGW95cT0$6-pS@?y|&q-skZ&@mUSee-FdLTc%Kg4Qb}Rl^Q(FVj>leuF%*oZrN88=hoY1VO!NY!cih= zeYSB*X;fi#MgDb?zKoDHfj4zW^b1!tdwNUDzd>yOpVU}RKt6fw)8~uGFp%(9NXv=T zBq85K#^<@Dm=yE7Lt*FFWiLNNpV6`Oa)GY^1a30xpIPM~;VGv{QeA-YiM{j0KllLy zk0!zqhO_*kHcOyEG(5^poYN}({ikFlRaff}+;N(I z`y)cya?Exht)g79JAoOo3wG2VIU)@v6i%M10%B&kFvBBliT_lJi7^n<1_J(QPz+Y{ zarx!-pV9Kp(R9aVdItjU_)9AOK@SuRJia*@@KkYP%o|3!OVWhDc9{1h<#y%-EStQW z>k94$2MxJ?I$!Py^p27^?)v^T^D7+_lJL^W-`^AVq5ZEJxHIe$M$&fwuk62z1hFg< z_>EkJq7&7d=#7}dgy%%BqSWZ&UxS=b^P0Ea7Es1Zc4lRWIrWKob>Idau{vm6-}s8_ zYpYkqZo-(##ZXKcLlnTw$=vf{QuG}bHZA+>Oc@HFNV69mOEF$*JG6D~4QcjtmPaa3 zJH)b37hD5^uyM_FmqIN}89tm2CFtEQt#gZoXa5O{XYuQqiiSGrP~;&HPB=$j(QxoL z=^w-tQKisqrkkhMFDEJ86@9nceqFZK{Hduym^}M%kzB%ahY`me^TRK;BNuPM&~lwC z1c7CNtnhe4C`%?&ko~C{oiNz_2WKCjqCJc974vtJt}Ya8bbKoTdqxG&fMMSLJ2b9I ze!Pkb@Wbyf9K`NcoJEO4M|Rx46ixrNjCl*Kw%t+d`!?vQdh%_0`PCDhgf+qC7#cI> z3b(|c+|SL{Ykqh68ggH>wHuZ`U_MyiE&X3?orPbNZP%`cQUpXPX#o+C?oL5M>28Kb z>68vdO1irdq*J=PQ@Xpm1{h}cjqmq8ug~85H~#=$UiXS)o$I`q5EAkzkb4PW;Y`oD zNknpB>dh0Bujr2xCd^*Mmd_@@Pgi|m-|@u&hYuJU$dF;%&ocZUEKN(wTYi1K+)^rx z@beicr!_}Ptvr8i=PcGRd)B>-r4FLd^5LcXMjWRZ9#1T%tyMH(5>$bO2C@4jw#m2K zORs%as2P+^)@+%c{6!igOq#|XYE@(SweYbYVMt37O|5>ySh54;`^!|;2k|KO$T+tt zoUql{=3i|jbK(~dRC3nQ4wqWayZcq3WvtlKdoL&>;g)s4t`46_jl5;%dy`w?OmFt_ zR#1u4c01`EyU1U*N@PrtGYl^YMNgaAn4UDGi0Jq0I8upfO;$_m+f zbAPV=eV%X=t4xXwI+@DxRTaB!-$UYzicoKsU0hAj+qdxt{y?E3#I#r9vJSdP#cQ0Q zv)aoJc+dj5nbM{ym7?B^ev!C=1%3Av4}Xn$35S$CI6YUecuT7 z0`3B*zPf3v91BE%Xt^ z;6OW|>v(7zJi`&1$817-%_v+3(Lu)ma`UGPLf@nd`6a1mQv4mC07uc4W7LG@)wsomlydSWT; zCvLMed&a`g@Zg)xp(}M5mZng3_(o=m!~9im74#=~(**iBGzwYY&N_`R)O5r-_CHv$ z0npMeA2|{C=Tk1X3ZW<7?AiYLN~WHSE8A@n|vReu_{jA=^FdJU313QqT|fFqU&| zSmaFm*G-rqgqWH7z+)fud7E z_&N=kUAqO~2V_GXq1mszi|A>_G#Nc%l*a%>?MDX%7?6>^4R;zuz48G6r*gRWyq7Su znN8-lfg-lLdp`0B)8yt{@+7Xnb{ zzZC)-yk7_88e4dq_5yWIjw)iND|G&rEv;VkYa6=Hpg8aW``73 z8=i0+iba>TiYqRzK?E5c%lHxhx5mr73J$m>B*nwLP;8vH_H77sUbkD{ zowrVqJRALCMc2%FxH<7@?H;K#rlrTPAL!b&tK@dFdm2;4;LgiC8-F1WC@_JS&y81gi>9gB=!rt)8(%{U+IrYBE>j z7zO%i&se~4H3E#VLJFddP$2@*GAXzWiSkW_L{Mno=~d>j z{D@F2ZtPC${}CyAFjP!z`O4=1g$W}r8a-Sm`y?J)JM``w2Rv{_raK*ousWtC;Tlap9j=)Sycv0Q8fU+HYo0}9)Q?Ji- zI3GleeGOg&8+dP-3wM5V=(e>c42VcGxU>CXrtJ?}Ax31hvfkGUDBQxC`)MIW{_%RV zMf8-&cjZZgO87If3o=)XCQvIsNJ8WV`1-|B^4-uwQV=@2y9xEyDh#|R1vQqw5)*n8 zmsCKGFVOWUl}ge?OSKz?>#W*Yv5R`rt>p9vs}t4ke4%Wu?x`B*w+xKY#~mS!PN8p7 zjH_Qz3*##2Ow*TCXw?7|0rBU-WL@jma@hb6#{0H}LRQ-^>lQ6Y|M#?oi~!&G&BIv`1Z*#BT+G~eCxl6L#1$GTCOn=q zP)O3+IfYGh?+X>WH&qLFg~O|U1Q+i9kO~icYWHs`!`jaEV>n&u>)S~^xa+YR;>Xb> zD!$Mi`SvE)#Xncz=q`R@llV>xnPD0*bH&){=n1Fe(*4fntjIO$M<+$u6284=r(oW9xw-fHn5#ck>|* z)m!Ddh|vf<%|hNVj@^Gj1YpD>&VC|JrjX**O&aV*_(Y94Zpoi~B5f#*u1RSq`$jVl zIEI+Lxs2^@9j%FSEmK(Dl{%OUyuf7-H&J{{5ZAs2j=I{c%mh^#qw;_mW_Kzefw39r zni^AoSjsNBElg$#%2sf$CiB_xwMa|fO_wO%zfGYvB(=Htb@ZQlLvz(;cEyq*X&Rl zWiFlQ>}c`MP3g#7`t5GJdhCx@t9SixlqfRUiroURldG?z*Oz>2Fa@rnw3$!oOxsu< z)C+McB}0#YvNI)~g{_RnhsYWp5n8*X5H{~;C}-mh^} zp4uM7BrvnSHj#Hv2LwbQuOt%Tv@p5nTwlhfwwCD|X()+i{ zet35@y2!sPKPF^yD>6h|-&xryKFK0Zgcx=t5t72>ku6!uFeQs?K(WZxv?=R0fyGJF zw$YV*62sxn%?p%sWecKY_{iH$gPC-E_k^v$^9Z+=rGPEwYR0RyyP|pNYWL>&KfHN8 zZJ3+qTni3#l*g)$OHHol>%L2DIj`2D)5 zobW3?q(p)bwgw!scVvDMJe$*0;khUlbDK1?x#Jp$VW+9qe-+NX(boBS7@!I)pJ^~y z&A%nP`(4g)C)|5I7NIec|GT;L4#e=7Dh0WWI&gH-fu6NEHwX>k?B58GjhESgDPhRJWu zA&*_ngq8zN0Ah#iSg+~|V3m+Ishmszt*E;auA_id>WUf`Vs^!AYp(zF*845#HlDuP zSMe>-E*qTwd4DN!JT5xz?=r=@P7%8w7SRE7Nfvg7Jj3#mg3Vv(tSH!;j(QIw1?=Ho z+nk7MPeUX!x%n&`_$poatYE7AmD1hg_fQTfZc7-q)mF6kM&VDej_lHmQ8MR=(B(s& z-p~XDrGI`dvlx(4kYn(UUJoO_d^6`x)3~=TQK<#^H|~-5)STpmTs3Q{8V0g`&PC*- zThkJ(6evgd4PN|^02%Vc%l!0;%25-QC-Dn9j2+9o1c&qCR*Jp`3~(`OJ2xStDgZ2~ zA+!C0ckT&QVgTBmn1fq-P^c~Hw{p=S!;$OwKLumcNa^y*O>Q{!bUWSq3JmH!hHGc; zi7Fb&o(3sSjVb!+K%-i^zdDR5IaTOYqO0tG*?wPQSAIOpW>9MMezcgbHb)h2-NCR` zVt8R8F&z^5QrB=$z>ao&%XXYjUEfr#J^EaG8D>+GzB+ddBG(24i2waT71>TM_wfVl zkKA{B-D>Z%jti<8*J#f7f{_oLWC2w|i<*ETU9Y{8Cw}ouu1aQUxP%9b!MN2FZTBk% zK?@eYu7V&z=M8`_;QtR_Sd&5hhcD0zX->C=(j8ays0Xx#oPK?4!1eH9VECM3f-IbT z@uo?p?|&a&k{Uluq4M zA%XiT>u$wDgqQuo_uk!d=)1(CR=UUG0*C+62-u#qOLWuIP^x>hC*pjFK2(_ zO@R04)Dt7U188ZEbfH!IPp{D`zhBI#UssCZHbf^U>tA$AvKlz!*R_)v-GBYbkaG>6 zNiDsMDu-c;z^iWZpyug9f80&Fan;v_GgTM`xWu*xs*Y^&^&8a|_ZwABmX!2?gc@4b ziO!zv9-3d9-d1GqY?|x!Y#6?I&VDt^{e!0O)yP5Zo33#x2~!D{q9C6pfGF@>5bkua zAC6_8F9_KBuYcck-UTM0a?{O!p9jR(c%@Jeh}_DIPlrN#j$6F5@0Chb?v-zoFWya` zNH3>G-Z9WVN{tsObR{sBKv3p5peU78w-qE`#i>iLI8ua`-;mtB9xega{{@icEu<)`h6~ zM{64)A&Dmid`aVqdIB@7THM&(IAqY)R5!_q-$=yel1#9^E?30t^%YRqLUn{sGmA7z z%d*jh+hE=|}bV zSvG*hcyZq3Ks{q(1f%~Et9-@LvtmPCxTSKc9(w2I60;ZiukU^mJ*vcu)h>r$HlSxX zmwYXK@5+WGoPM#H&8up{3pg>PDg-{j9&h7`k=)Bg{NfmG2=I{RlBtylt#mDqU}u=c4O@JEMvfkPRH2VP-B_s zjucc=QDO3TvS5z=!VDHt4}Z5Gb@jt+sVO1NpZ8wg)G(~s*hGWvmWFct0W>h`>ped|xYUooZ4C~}-%W^zJP9}Ekom4T+egC zpr7g(sc5R$`29@OMY^>d>Y5IV<%8c!1gN9|bL06r!mFWO-uh3=7A^%bq>}>+52RtB z{Ar_IRFAr0jShF1xIo%$0JBfr57gyxd0^YaPU@H7jg6CW)8z$;H{fA2kq1-epRg_c zyNvk!Nbe02xMhkTWSdS?IC#VEbHQAtF?brsh;X8|HBz9-z%$pBKRd1 zr#El~p=mz4!=Pd+Lk<|O@uSpFN8w-BxVZ5_>JIZ3tf`}6uPGgmFNHkDZP`lfE>1q3 zcZ1M8+f30$9JiG@*_#FlHP%SAU;-@$!PA1F8ObzPgsU~7KWEZ(?a-XhzMXU6xf?AC z@ans3G8K_Gwb&M)GYyMZMSruQzm^nh>hpU_DL%wC@sf(b^3L$tu*QW02U(V(waJ~H z!ojpe@D(BWCpP?>U`^VonP(R@jPS0QJ%>fI$0PUwI;h@W`d-Y#@O<`D%dY=*F_I9L z5L$Vh3@7(uRqoLbb#7BGD`hl$MSBe&E)oI{*pc?za|Eomo-WP#|z_|NB-&%(FrMQVDiSbv&wI>;A>n8#~ zetlj|^`c5E|7!oXd!%*9iFH>E;hk47HxEmjxT*GH=QVH~v58IpEhYf|f@Iv9ju4Ui z!Bf%g#awwv?@VRd-Rxb;=7oG0Xu3RiB!}#srq6h+z}onF8Ba*naduv%40rb$var8{ zHpU<9fRKPhw{)h?OoEKB?XWswDQ>JiKVSYHP5su13B9=b)pq>(aC(F+t3xjzGiZmj z85UAncHv>zymNIm{O3BPIzx(Wfc@(x7%;d6Zs{8mTskz|e%y6c9j)dNej9)~0N#iT ztNj=#5XhNOV-!2d$N8EMqS8&AXqE$mC@&LBcF_k7>SpB756a%l(A<3qc{!%@*f6mp zOToLRu;YNo-D>!@+-Uxu9@Mw@uL>K6N(fqBGj0Q1+Q8@=qXfCp_6AA>7(TArF)0+Yw7Aq$FVUeoa6hfg^ z@JBVx#r`8}NmtdAp`I(=omxi&dGfE8!tW`3ZY@9nWfbj4A>G$r=e=P(h->=#r`u{v zg?QV3yLs9ST+MV$gCfI8Ke{fI)M=EnIcaMGCMjK2x6p)FaiS6i7h1QyrgkWBV||>= zDGOsk56vE-inR5Csd9A1vZnOYvM{TaXa7r&7+aQPt#f`*Ji*t2aq(W>gw2Hl})Lj)a`Z9O^s{X zt7NOb)zPQ4amQD+R9e^~0u%j@fAc(^jj9-GKgg41uvdFJu>HNMg~6E^LYGt18eO3i z|KPrqI&Is?JHWAF4hSx6lb5V0c1ZI)&m`L!vc?E~tmkz{blsJSg&_V0!pupGhtW6_sBhE>G z>gxLSh7E{^fkv=l0kqST_FEl!l|?a1t+7-uDFLcC}dp-d&2(j8;zSTVR_4 zV|oaSY)pAaV}!6{N9?OmLVi3$8n&`biGyK^y|K_l0$}bt=V?%E14tJ}W|JOPDITpr z=2{S0DjWW_M8TX21jQ9Ef4w}lBeOthE7=8L3m&26;1Utf`(>3%-tDlLfPjchBl2%BKS6ZEMwTeK4&vb>uL zO-DruYTCN#Fq<2>?1ThJ9MF6$DmBx*Li_$8Vj%yIh+$|DZwdGqDQDg5{(|wq1y~US zP1HOOnJyf2C^RLsUwUFoI#FFenEi~-Qn-!VEO7Tqjx@VwD+NOcSwiZY}n{f9i*bZ?QW<(WWDb0r<&Kgl123`1Mr-g*_Jmf#b2mx3Vd&2!&A zl3-ECpQb<&=jW&YXnZXiB-7JqmLZ9uqsR9xV>pA(0)0?G?8tbIGmI;Y_Ikg7p@bwF zv^ZxW%W8Q1MRq>9@_MTBQ8@5)$iPQDcGT7j4K8Vg`py?QhXJX)bCNQVjNaqAl8(Ka z^OB{E{BpHxk}pa2G4QQD-iS=GhW;TCPe;Rq9qg;XAStzfeG|arxguV`yL5vG`M*a- zTi(615CcaqQJ0$?tL5LNo5$@1Im{Xaqg)M63Rh@R-YbusVB?&u+ta8~+kdRHHeN%w zpBmgDxibi9=OaJ5$*Ke>#B-JoaR$pfw9-{-GpCRZMBp9aJOT@jA7(vL(Ar4Mf-L%U zG9jpO@+qbd-d8+HsiCED!A0HwNSv5jE}tG5p6mmI9LX@)guE()MuWb^=hH^Tj5h*0 z)ETXpOR;Y((4wbQ@6n>sHnW2Cs!t7o`NAWi`ufQQyE+YXD^JTYJ4Hfb=Lh~UbD5%n zt<4hILwu&sgu7I-M!Mt><3}M8Y8%ZlWnp9G88HmBeRADt|3y=uAHkjz_6C4T^wpMC zwS(POH2Keefr&*MAFaN<`k< zTrGX(4Lj(bqxuo|PHEBlZe~3pFvzxZ0gm?}=O_LM;*^{*8|~e6q9K-cKQfoli-@00 zsIj_aZSIF<&$$?!n1ViTxKe_mQ%Bw#b;_5I+I=gns3_h=7^v<%u^(O{`!s^0J2Fu{ z8%PhA%DKD1hxe8XYLiaGAW1!WCAV8$!WCvdl*wo^D7lErU-Da3^yyCE$|x7rFakRc z995ZI_7Nrv7%zsNbhAg)*q};H26bB7n4-$3blWjL;e%!_mTXk)bIo9riF~|CXb!}2 za~vM4ny-70p3T(na{D+tBy@dW(y~DrhP*#tW5b{R^(7l#!hcU<1zvrMxf*(rw2gz1a5ZZmk8*=77*z$iRi zYFlogH^7!M?DVBsR=hN8Cq{%gd z-&PeyD#6i2ygm$^HO8O#26{rPRJ2p9gT42S+lvw;y|0EPt7duq9p(-@M>fzzB;FmT8+ys_?jzjuq>$>vrn;zb+ zn>u;_d4b98WKWopB}mLZ@g$3Tn>DrgS+<8_8dgFbN8T@=-8B24Hclie z&nHouF1;ST!_2=Uo&6S1!#8<3W~|U&W8gpcx()W;3)cL!kwW`vuAT>%9H*G~;;Ner z3Bs;Mi&MM69n+-$`M40#0coY4%tm-uwodERF2HsX6v2}8wQCE zH2Y`?9$|ag%WE01gx*y8>n>Z8=DYA`C~uJ8GJuPW`SbpK6#sh^@hS*SNUcWdO*`9N z!jz%ZDdUlqW?4osUife09L=9lPNPpT(ZSm-&ykosp87GynQ@F&^#Y>ZdIq0X73gGRb?-n~!sK~Jsf zMHpy5=XYP{Z@!gBP|HP$VM-Zr$HBN3qGRC(m2BI29ll@K+_G6uhEGd^7Gg5lSVBz= zAIAqhny@;k+~DFU9)6vE5}Rt$ncopQU@ch>Ra^l-hB4gWFW0Y55t{r;Juq_%vEhB0 zn)lY7;<%nkcpcms_@Q5zsjZ&!B^g2j=RdaqIEj^Ux-uce*5DD69*(c&Ca%@IX9t4E zIkLm)C|~%dswW0?4cNGU&1s+=OGYOtX`{ z*f%udd94PG*kHbNs|>q0(;4PDz3pmsqME&PV9G+2Kg9x>5;ATvYLE_czhK9qTHYof5ulY` zkGT=Iy8TjVDk>q6v6fS78KKHz99G_E4~qilDiY8tT3_K0kJi6?4CwmM!No`m4-}%Nt$1Uf=$z*JR9P!5f>aAvPW1RO*KO)@xbJmm- ze65XDFAJXyR{f>h?gd$$5$|TJ+}6~_%~#8n9N zr55_g>@b(9DB*0wUe21g>!9a}>-^5fJ8baZ18lf)Pkg>Xv~jtaXXz#P+2huYwre~2 zm>dP+M$jUou4z?dMEnd7Y{upd?LmN-U08r=b+_Z+#+xTxt9+?Lu+48Kh$2_r}D%qM@%1=|Ook<83qAGsRc&6^6{p z&}r&~@4Fg5Q@pv|LyvEgh3EL-Ku^tS982f5Y3Kh5yff~gc=>Ti5)>BRdXV?O>5&Dm z_8XcllKv2DWQ1!jcQd+AlSv3*nfvsNb8k+Nj)q|6U z&LvcBBM0&WT?jNDrZZEC8lqB>w5RZjIX3?+o=48l?@6^n`!=l!_M`pD(w32M2;EbY zE{ssgsZPGGOs2kt1>oCWOKmP~LekgGTF3X4^LcQ=hWOI< z_SDy=H5;F*hXt>x7)&>3ac`cDQrp5BQnZKSOkV3Jv+K;0mV!@DCSy;je3q^F9RErT z`K?_lD?Jn8gMNeumYlo?=jZ1YXCdD*MzlgyUKXCrx@^g8y`>hw+*h);+Y{5I?PK$4 zwI}IYd#z3T;?>Wu?Yhq+eO}E7i{<$`CZ~F;%VbhT7~XwFqdZhFHIrPjRfmWNNX7#DKTkF5D6s=p9M;^7AAOl1B~ne>nmbmUN=SRl4rO=e)G z1HU;wS0n36X)>c3ks@jkXz{~38)6>4;0A}-5ZGqw8wdN+9tYB+mz6Py3~Dx(jgSv! zQ9O^y8F<0(s_t>6HDh6Fj8E(mq+rZ&rG*DB$9>aPp~ISp@?{n}z^{y@0(Xs-H7kj&+7 z4k~43W9|uK7aOYH7w%9BIYd)!rJV9WZdE1a`zt3ft!C8LvFMwQ}!XO7?cNJ4KN!c^^E(e~`OQBiWd4}P5lX`R#xBk-9< zZtE9hoX9T2b}&n|?LkNL8KT+`$TWKo$TkPxtUGwQ^d5sgk|8LB@EJsP>$)+`YY!e3 z{Kiz zol2utR3iO8HC(7$t!E%kQt0~^^hPTN<`CVtqSVJ_cI>j(?YJrfgeKbb%MniA$;Ow} zw+58yUxll^9A{7qEjMstJ)y9VGk@O&85E{mL_n1_$i&(6F)oO)QZA4Kz7Y~F&^O=h zu}nF@OK-+GB!#M(6yGkaVOmUd`q|}8(4i)M`G#(7-+m(k1H}yBSkw{~fZ?l=blLA6 zFMMjTvrsnv*w5^pN6Pvz*+dz;#8&#-8VdvF3*_8Us=9`ebc73jPca!TAr}6U{;M}> z_nhhv5n&|zE?wY@I#M8Yg%^rQsN_(t7M6fhzNz)gy|`#u24sU|tH)|_F4n=1)VZb_ z#z<*3@&;Io^2XYnzh_@QdTWzh@+^^(m!^Rv-{HXCxIR~+!OMWoW9|d^t@BX21wF|P zZ@H}t=1t8pVA^%^*XIBnK^7tuBSS4&7n&7ENZnImg}KKbYxX1OslKiz1Z5=TiD~Pn zTpZIAX@3|Gybm`(XJ^wI0XI=3IzCXjsEW$VSfTud2vux-NO|yaPDfiEoth}UdLvsN zj`wU=j?{f1xVm%1k)4K40Z~_a4(L9ekbJ-hpw`FK49A(3OP^4-9<@3NpWMH1PTM)f z@gd7TT^RFNGZR%q`HfmgQ9y+fj??&zn7IslMoxD4=`Y9jr->|)Ux+2a4U28woIE6> zs(Q>&>6!!54wtv;mB)aq;{4CI^Kkv`!&9v|Zyj8`!F_p){e|C6k`_zgD5N8gCmDqT ze}_Zqg4T&}GS>M`%OAXvBXEnk0sNK_dDk4-kwtd-etXe{0caLk@Nb(^U1Fs{tuyvt zbf#}MU)$XE*>oYEllX z7!7GVD<5^sRVzN6}ln+oRf zM4x`I?5{haBZD#}2})5M;u~ZR5mAsJ-Xa>|8mKaTdB8;qx@qUVA6@+-%&{$5`|ALV z%V1jcu3dR4>x_cN*bWV!)N&F*|2sWDdWSC^Rs+-W zjUC_(~|FbYDh z(xT1qW~jj=gAubJV%+6kR6g%sQ@poZaixQub#?i|Sj4<3FSjY@anx*SqA`qug-hJ` z8h&4M*of2`OYrZA38YNrVOCb1OEALBW?-0WaoDh#jQkUFn|nZp{w@WtKNng7Z;Skc$v)hzTf8K@0=l;%x4$XF3cMb% z!5LJg8PYffbs%VrYmB;%$w|yN-fj2!(Go>1Fx6YGFGL?eo+?=%tjzPhODFzOQl-A; zqVO0yte?UUi*vJ`ZkAW1Tan?!1UC<_r7s8kV(##aWE1#kPkk6BQ~oX=%g`W?d`!u<;)xkgT#KrK21 z7ATBD@8z_4={Mn*n7=v7r6E}E#OPv*4vE{`yQk>$N>b=KWuXfm{*fE@e>BlJgi3W7<4zLM{y*sb>r%Pe4L@-XT z+Lq8~i=5RSYUrkCwdtc?70F8vHdo6C3eKpNpWadI5bZH_DJRdZ7kT-I;Mp59Z0MQS zb_bdo6JOBF5teQ(@FgCAPt|)WG0kB+$HrgLMqEV(M#_^v&2*C)`L87$S5P@tc9q;2 z)Tq)l6$NOS!3cV)U55EV6<&b<&_A$grGhSl7-WU2b1t1c&^zNWJl;}^A!|V;`@j_> zpG%QM4dm#N#JAg<76DYjcFrC10IR*t^@%zk0)2|U#hI>4tk_=r+gi>^-Y+jZoIakG zm%K@&@w!bO{}EceeU!q^y`n0)8o&JA+x=WY7=-|Q0k}43e2Vc{*0!$K#BiR(OCSbK zpPn>dbqYo=djazXXQsQOBQH*204_+#QajFCe(*0Rl2*EOvy3df$;e%e1NZUgLOZ%E zIIs|lHljYM=e0XxusFW$Jdj*{MQOwM2Daq9U~1;M1)c_b^=edqp+UO3RpzM{JN8?e zp1U8*#$hC33AL+AB?i$=ru@U)fTp4h4GKBU3E{wJo$J);XuzL_;<=A-rv-(@N8Bcb za5%31~;>RXH>Q-*aH7B8?OA&d@l& zpRO|eBVJQ~I!qU`XI%33WFEYMK*w+6H*UEQ)1~~(Sb>`zqBW~wq|9}tX-}M_X2zCw zz<`vE$<5S2x_c)1#hVmTxdCo;q?O^!txh(q4jcG63M(?2i&`7 z8lP!{$aT!RBoc)HzMxhgGP>9UUoq<9_Zk6)D!AjHhL0;AK-2BZtErccc0Dw=R#2{= zLWs|oQ8N7BDQ97s;gsNKA9Uz?K22C30wpDOzK{1_E%KZhD0S+Mb=rv<3pMmCMs%52+HDu$s=7jg}6?7=OrB!^}KbY>Xy+VL0L z3!oW%9DF{QIcO-#r**MCB*=L(fnPa9>DbAxGsID~88p7ziV$&+ zd1^JjA_%CgUEoqPo6$R_hTHiP%cmYegy>$1a+n$abLG<8hkEK#pw~=ZYv8jyv=$*F z90cqPHekP_QOPdqMlLl~8Nwl-i`fuA9hpLj=i?kZQ^khhZ^_}?$3cU^clt`fuU|Z{ zhRg+pz6?1EXNGO-Und{S27ae7Rzsaa!)o&VtaR6iE!pR~n9EI)RlE1xU1ldy1ckhW z3(SQ7>M>MS;Ejm#z~2{(N~ucRYp*hp7&4nX@-`_w&WMe60RLAX`}VI>`E%`ItIYR# zFPV+QR&QizCxJ(QLGQL8pYgSJF53CHc1#ExP3pO@>6(1zID4B7O`sv-a;sUJwe@9N z=)oo1-XUZx8k5VS?{YmxH!*h8Z^B$#yphSD8e6G-;{8QMvUU5X)q=BL;kb_hJKn$f zL31O%<0&7_0qn41^ne|{Mr3C$Ls|nibE(sh!m)`x_VvS4Eyu1^T>`P|V({D(*IKyR zRAhQYH=zx)79JzZ(6OnT>xGdLib9oBz$IGdPBcC(xIofE2+`I9+4Qe7;A5Zp^}k*K ztyB+9_XJlDYxHC(C_;Pq{XEIWO`mJ}kTC7Kc-egdj^Gk2!6f>{{YA|d&CLUZz#>6p zBijP|P$^^3;JD5Dl`WXi*z}nfh<%bI*&BtvXpBG~a8U@&J9L8$aAKE1KekwY<<)C(giPT9xm2%s_3vC7g9f1l@ghj5 z4H^{@Ro_C_Z)l%Z6TaVK)pkWF*B5O(eRqluG-35I7MAAc(GC$mOlwkB11S@&f@Ddk zT6t+$*w)Aq#9J}uIb`S-P0hfG&y_zuc@4e^sAd^wx+HX(@KZqp3$vH7^p*|^m>JHx zj$B^~L+Oarv<|}AaLw3w2X}A(^q|MAo8O@uNAjiv)>#xg(x651k8e0IiDDsHi1yoU zxd_=tvyzK}p0g&=1^y~C)^fRL;HROwoQfZNHS2xO;zimID~$cDHfaGK(KTjdQ0dB4 zMe3Vw{>8f})w|NsE0E77IwT!dYS63pNiD4lJ=)vaP#C}wV}G}xI!Y)Ij~4Y|!9gb4 z!g7Y+gFMx9KmVZ-gaC~IJ38EEQdCG0vS`Y8v9RM#JOMjwpSJ!34dd{LBX& zf@%Pc_`YiqEc+UVx&d+2+vTQPN}kPzB$?VGpvq#&;z z8#j8Ch~X)VGxqsN-9Lc?ParTrnnx&T)_L~uGZOjoD`RhNDI#1&l0IoA`>Jlo^>LjxF10R{b*F zLOU@ab}d?rX{`OjVCt`s&o`7$@`n7haMf6=X%1CPL{lOKe*ET@c&n%A z0nmm$z87{yyz7(8o{R@AEiOwc2jv!EMh#7cqJ8(UV8cUnH?MZep1k^XZFMW znzHQJqH(4LC(o_|83pqc*vwp~J{0}_tOu-6b4XqH^V0MjQKqd_P%6wFoGo|uPf%>U zgGHG>eIODYWtHIWkqm971Kv5PHueX1FgFO3454*KvdjXnckbCa=ATdF`t4P;$8~2I zGxE*zr|;nV@PT;dG5s?XbFO4_agLXJqU_-v0>2p_yF-pj03_^Szlf6clA?~>#si!iScfo!;5=6svHdU^_aq2c?M(m3?jsuG$^u==XSo>NWDvLhEXmFSfYxK2f3{*^yl{Zw09ke_!v_YJA=y-etm zSmjglb?yQMzny(g#ikK4ff6XY`5ZheXL6lY!r~31)k%YsXhf3eRaH zS&U4!=ZQY8`YE$7y7bXEKTVp-A{FeWnP#7jlBB3_Zh=T1Ni?EkCvTE9-k)-Y->+XE zM`-?4R0D*v0#P_EEk<27Sca{x6pR?yW*UEO$E4*oC}X0D%1XXln)Ae0oMetA-D>nd z@S)wTMA|o&e*OqB3Yj(NSC>Q3uPYmWevRW3;`?NP16w+6KuUG@xV*S5-6vARG*Dr$0fg5i?As9GqsbPmN(ov3S@>&JO#lKeHsGwB9wx6m^e67 z81@^TsyoCBi2zxH)|f{b3ixTk1uY`$X;)RWN5@rd95QL@v$?|$Obyn)Rs-S?1nb*Z za*!+sO3uU2^TO5}QAFz|mt2IfX0M!T{>^6^%Uh2`Uf2)+_0QKaMuDLEm=Oz|9}8Q+ zR!I>C4NDnKxr(hyq!s0~gHqws$(ho84d2L4eI%LY(HtzsN82ME>+dn{Bq@>b?xL9=}#3g^d)4uyPZ z69i)+mcDLXyVZ~D{uehiJGH+IXPM)F_VMOsjvf!|mzI(L#shEQ@a})Xe_lOX5RJW` zIhE*4GEtSvjNr%^@OLas#M@a$SkVk{?PhSpXW3e5mu|FW*@I^|07Iwg@!51^M2Q%y1xUal}3i}E)trE_jfqUMoQ?!0y zO8o3(UjDibEU_v%ajsa~|0L1sU=MP1{`Pq?l zxOs%4kEjx6&kq9u!SMeI2t~x8$ds+@qy}=~bt4e#${Q=G{Lk@`=kl@=6((M6Q}*EV zbe2}rI7A|C*vDjcB8OPxFcsbd<5lwO4>Gmw1ql>oG7~g>$fxm0MK8&WPGklcOge2- zE@X;WdL*6D>$W6p#R_J^BHz&B*k~yemalEM++%`7Z$wbMtM#JOXTuIc z)qvqeD+)ZlxZ zwl4KKkhw!$Za|n656p`zRD1ACrs2RxdWk{#hMRbx;b|k0*X-^bX`yk1x@TV=us}R7 z)pgo%3`G;6pZXW6)%XDd9!^@@BdQ@q-5puLP39R# z5?>#{`RYZXa*|rK#ht%$Uh2WNj{WAH6v<O(lYuoNr&O#S^XVtovUCmt zak?Mqgod4R!fkMKVwsRU6PA~Sr68y4lFJ~eY&I+6Y_74gX}t#?cNl(RjyEfvg|*=f z>P&sh{rXL))DZ37Dz&)s+Gu;XK#VDM)E{|60O=xNY5IKj`44&-z>WVz5-X-wOTqq4 zfdm?uYtAUJi19Fl=29;_pCvd+^2o&UZ*2o%KtEx})y_9UM*w_$c$)ebk;A4xxu9%8 zR;ZiQ$>Ejo2s22tBN%HG*x#^>K~nhx9txm`oiByt1{LOdbD?4@ngfuJxXT2)FPnF> zQ@%SxzsU(g-M+}d0@rs={eCPcObrqxa5>9m#_<0>?TU+mRO5Nk)j$q3!^j4OykiJk znjS_t`jKJJo|xNs{g1RE>~S*9g&k@7#*U3AlF!JaG2?}gaSnY8Jn^!QY{*-|B}EcV6c2co`_;3#k~48vn7H=p2HlL40GdYG${txYlUveY0byF zVAML(!QW;KJw3g4K~6e5Zm=^<_MSXU!W4%aN@bxSQ*Up;fBO8|gvIrTJb(Hu=VjTn z(!*6?4BxoHNi1CNJ6P}L1_2wDklRlh9N8KFhpn>=h^lSd^-v<+AT5n_Hw=gp0)ljR zr_v}bAxL+J2+}D?ceiwR3P=hJ48vaF`+gh0y?;Nyp5|Q>Z#`vgt3yOsWPe_euPaoThISAV@gQ z3K+o?<3cyrDaC+XKyVBOJG6q|QkPT7|NKU7bb|Vu@ z4?hf;nW;q^J;brCsKxAXVefVYMvm5&xkeP55eH^-PK{~LG(WkoCxdU`wN&(Xm4CN! zGboAUy-7$}tPzO8L1ysBmflLkgL9L30Uzp{jQdJgQ0B+%tcGSMzBYWH1}uBXP?kwa zYSEcE@JdbO=!l_(Ymax~^cb)gfGrzT;A>2fxWswee*kRlZ{&G9lb@D|z<;~&u!tJ? zmOUyk@o_~i$euSYhEh1tYau(p<&53dB-uaGi;u^3@MzA4c~- zJfR=jg#z|ehqjB7Xh$}l*2KzN{ml2lQL|DXybK=GgjR6^IAQ1?oM4P}21rh9`t;NL zn_AtFbIx8Nl@S?#fkA^*gTXgfsqEe1%#`@VVzsA`@F()d%<6C)Hk_p9zn^@K^)6DNrTHrVs^aT&y<;=os}pNZygkiC$3(rY7wP0;Cgw0&d|k$$V9%RE zucp&P)rjCT7wrPq)uZXVH{j@;avt{eps{R_3wRPOIkl1OaQj0T#2<(WhL+SZ=+4%j zC&uj4UKV6akYJ@MkgK-R1AG!v`jSeFcZ@g2(oUhp zk#J{P1*f`L9~Mw0s$#eEzRsiR*_I#J1QQ7j8Somcw)7MVP#JKr)|#S+>-x%k3Aq@o zA>#yuOV^#zxYlhTSB@D6MI?n0#8kp}1*(%Nz^k1gwr8YDOn^1z`qYTS3@%CMA zEK9TQ?h2?Bow0ICSdRf6_OsOZ=m&qGkbs3haX@CeG7Zoqn z9f~OVl6|zvbihKk0R$n$r^nZBl9&&E7z~+!i{#7=y5Zdo(tlZQ89~YEiQ|Z3hEuuD zX=J*8o*oQ~VMu1mN*|RHx~3>mRwrv77WgN)$%MjV)*dwH2rt|vDA;_|^EAP{>Ev)4 zq17Kl_|!2p9IzWiuzo{1(S@(gpy>6R?HM_F^R33RBn+M}N;?!E+^Mw)+}~eS$XTZP)j)bG#Zwzfd32Z!PcSFnK^^sMD4O82NP{xE-gE+LgSg?-eBBKpC3odIEa0JsY zO#*^!=)76<43Y{T#jD7$VtdcgeP##hlQ(Xmw|BMwJ|Gq3JTJ2-He%SX`zzEo6>Jhu zv%aNs&GBYFt4B`5q%1OohN}bGp$;dRK0Kb9r#uv zMV+1nZ{L&|w7_QD5!Q1;==QEx%WCibCWI(-FA!Bq`xSq`%z@hhYN6KAKvuXtM5S}% zf^YLA%!&F$D}}Iom#@n^Y>>W@#PZH1LOcEo8NIda2spGTrcag8A}izAm!c!l3t}!I=-vOD9ZO z>~O`;hMflO*@Onc&Hh8KsXj?b0z6`z;7LF946Ap+>0i?R%M`+9=mpFrzjTJkMtux_ zCKUb&Sgj=gbX_Odp^E^-XGn!mgK2tHOauuYtZoejr{D}^KPAu?jPcn~!jrCBqcL-5 zZsy~^z=Ftuj)x6yaec?15+qzmr_2c&*xi$OvG3m0hox-#mt_W^9gKD<9y;yrWK2@$ zvH867UoW;0B-?gh@MK3dNEYm7W7V0Y@jlmWOaQ}k2pX?qWeSJzdF@6~{8<`kS&&cr z3{Zv5h@b_&^8;tzL)pjz3pnr)zPp%`(Az6;k5+%1X<<>DIxXS zlV1pL+Ll(`y%JXx)36so2GX9#nZUpj81&wg1w;k&o2fY51a7+^8amQytT;MRJyfxV zgiBjforNWIVfJd&#za2+j94LyDOw7a@)G{?YElv(TH%5xQUG#$CwtiF01k}UefD{KU^lSaUoHg3}xHIBW6rc-d zg1&O**Qs{+CL)~VqcobO|6q%&)Y)Xdjrhz;J`moEQep9|x%Plo%aD8;Xp^M;FI6Cm zksRnbdzm(x;}ns%IIN)k#N|!*o*HLF872CB`U!Gz4+OVW|NNg344^Z}fs%ca-tiz$ z=66Fo!hNf>to5XZ%s8n^>eyZi+HEd$LW88=9EXUDNQs_RmT2{J=JqHqoy%%>l=Aqa zV=s&+Tq3b(i!rYEa;)U>qI{YzMlscFT{llDrHg$Yf+xM?5nb88L&cz;3kSrw;i!1_ zKLNOHsKtAd-Di0M1JvlX(rf(RTO`K)EwT-{Bo{h|H{rM=w3Z6!6u#_0Qje#5l5A0S zhvgTWJHd-LuHO@4UO7Y}(y-FE$(` z*61jVl^AGM(en5(i9u3-5L`9ic@515V6mEXfHk82!y0qd480Ja;+}5g5VezJJ4T$O ztwXjpd1vqxPAHBYDFr^QN9of4S*yiQ;5K>Yjr4QLX(h&QlV~WAS+9HPk^YH;d;G`e z#_S6zztVi)#uc8;)m&<7#0}zsZxnXNy7_VtI@0Rk%7lU%sVDb8MPvM6zlnet+#-}? zKmE{=cx^7U&wKY201@#0x#@2Ww`<_0xro|W#18j0`z&u?RD9MJ2+ioLZ)Y1-_WWQB zFz?j&rb`^;oLKo%V)QL2z9y-1VK5+>x@(`aSHceC*83^)GH}COHYQdEk|ac%1RA4d zA2t!yS-D!Jd{BE_Yy7?tnSVAD6`IAzOzM6smR*0$zc=UbaIml92e@&Olq2Y({9um( zAKIF&q#2Jq>SeNVN7yc88>$kEBeiOwV@?%v)FaCsFE6f0wNB~teTZ10N?UuSTHG`d z*T}EnvYS9XnV;AlI$8Y=D&AZTo!c1&i&ex$xbErcai7Kdqbh!5+!T|5oXOkOg#arsA@TRH0bpd?6kKPe|s!;VC0$9FkxAI?(cVDkE>+ zRNO<5PjzNyYObqLcOuIUAzV@rc@oXS)Tl@|o5j@5%0i^z;=TL_AR6&0OwE&1QCd9iet~6cF!rwA|q}S8q3v^uK?zl zlJET_O@OLF8t%1OrfFs8$&=Ej{RfxED^6#~Afn}ndFs6%CXfBQw|Z-IXc;1}d{Iun z4Y^H+N2qaj^<%vmj?@dX?vid(w)~=MrvYQM@y43pqf~i9=V3p`gT*R?TyW<6*x6(=#T;AP|P;?x=K3Y2q&-bvN%L%HF8Z0%vaag47 z+XQ}pfE9hF2Q;9$o`M+cz>B4;Y>j&urH6HNEW407`lA^x>k#y5&ox#F#Zr@}8bA<7 zHP4a}siY-8002S`);sIw6GzvP*E756OI~!;`AX?qXwwU$#AyDeS`%o{4^PFUj21{v z@+pJEw*8!4)ho5nN`_8BR?F#PY`^9k5wa4U{$UW`?@VgDCI3zLh**m>G30bWY?!xy zg6PlT_|^2Pm}uvE*I`KGWaOAYabX1M_wcyVhCKoQ0kB zDl`V$xhPa2dlS%)e;oBxzx9LksSsZnZdr&_(oe~f3ym2QqcvOyBllUu6tUH)6p-Ofg&ika;chwYrjvY7^`&P zz*c?%KRwf%;4^?=+b7v_!UCEH07L^FyKpRPB^{}rhduS?QqA1G*ueKdY*@X%ys1e2 z=hCUVLe1QY0n#tEKG!Dh?#zX-BMm+$)6a;WIouqSvI>NB<53xe1*<+PkgIz^RhsyV zmm?w9*x}uVosK^?1I~KdW7B?#djj$N2^#V)pYS#6=OnX7GzJi6j>p7!IRaA~X(2L^ z?bDPXHHNLNvjYG^bk2JtWdS@e>cz~<0z=^IrHoaVcOS*Pu{>w6-1bsSkeCMcipXQ% zbbro!v95&Wj}@4DY|ThV6h&T9W#__Zq(!I-3$$YyS7MGZu^M@nUhuG-xzd6*?s+;gg>qcoGmpRAO3PA>HoNu!BgtyRL_iQU5IT?L=hu38%^O8m?2w$D4i9fXZJZc8+C zM**pU$^zXt+IiNP=`hrwlwh2Fv_lZ|>F0XYbm8UTH)6)FfCXcE^$SJjlh+M{V5csk z`7l3u%P-|K-dAUR*ao<5IzOMYeoD9I`wM5&Bg-=Jj(N zbSH+8n%t8{%|6fiR&h^?o$2$?@P9Ro0i=cr&gL7!uAbC84)K{z@V^{F{vQre#`G%_ z+azi3QQ?z$fTxR{%*y+HgaNW)zULMi+`2}%$nsmH^oxw> zLF_^KjMNx=cIOJgFozF~9ER^Vu=W6>H}L+jk96>aVuXtvTqZ#R%QS#|lO-F;btQy!3#ilI&<}OfOY;Sfh z`@lwK#{7|yP6(}k$R6s{o9ZjOoWO}+gaA1cV!=6I3}HAQ6r`BG8X+^GG4R-Ywp|RR zeBEC0IthpVd{Dc49ugcQI8dc-?4tV-X%Uowy^p`WaoG-LS3EwrrEZqq3RFAVp!Cta z6zE9@_m?|a6N9~KbZ49dl#Hk`_zv=KhlV7*uv!gZCy8LmMWSJ(^3I+cWppRKdz^~8su#0!W;)wtVJJBX?@{nj}9UrNAZ}rw}L|i<=jQprQ9Jxww?3uZ?oKdZpunrFp-#y2-?yQgynv zbvW5R$A@R%#~!u@1Tnro&zqa3)7)l0qOd$21rXt@3TcrC)(aqf03AIf_{nD?1MXzk zebR8Rw;1O)12>|+Cvt)V)eA|!@Z6Boi-&t<^ShW)!!`UsQRV(hC4sAr=r82mZ{v-Z z5$#y&^!O)7LguqPP-h5~J7M^LtOw~yJZLA5Er{hi_C|gxKj~3V!tCT}kq^pKd!TEs z72CopY@b~1?)bg@(aY1(hEmb931J0jj1iA@Kc-$-6tZ6H#tCEUoJEF*B!<~ba=(&G zT3OTNv}PA=BvI{l!z@Y;Y%mEG-7i5PUEbxV~BVH4H5fW-eY2V;|-{3p+JQ!t;i-T6T@aer0%=%Zu}2{J0N!pc;aOt zPaRK&VjK7x%#D8#g86X59|mu>*A{F|>T;-l48c90pKJ_o7@@Z7~UR|=iLp7;hJKo9eK4YPgnecswpnNG`H$KkawDwyGS}nY} z-&f^RSIZL%ys}vOtO}22t2-@d=GU4(u@||b8W<6Ggim;+3PtEeYe4C^PEil)44;=; zRMJHb>|MduC?SQ*R7)pVkP~(m5q#U4hp5IB$sHLqo?)Ka5A-IF4lIe$2H9UM zf-d8l%;`_RpufB-(u;T>+P;F%wN>T#c+BH#1ElCJ{^vS241asjBIRy>lcyO8C;^Qb zLt>ucsYkb;S+bOIA98DqY|HY&36|W6i5Tr)SW)i(qooC*wG2U<32^~=@laB9Px}sC zF8!vN&-{MF#BzbB!;^6d+|HqxAd-(MlDz2dg49?%?gK&&&zqmMfL zMCFdV>=^ps_wFgRrZFaWc+r9h(-c5L5~f}7tLaf!vp9l z*?}zqrAR!`^`pC0N0&bjL7>2#vi0V@pqBRg434`}q~g{(9)vIBvVjz2kFE=Q|K^p& z8#k0yKX^@6Orl-#7elPM)_eo}DbaRHWde)mPZOI=D4~5;83} zjlQVc3}RE9R+DEf5;o9K{6!QLw-jg)PsA(@hkuUP)$odukqv_M24A;q$1TW4o_lTe z+5F;GIhhye&d_L+SOW+}AbJ|_9cvP+G>;2{o5~yyRt)pF|O4oiOn41A)=+b{~3VCFs~TEJ?+UHIWD;+p%o3aax|gU zsnTdkNb|AgYL_`xnd^QGOw|IvB)_6h>7YeSyvtz>y&L`B>f#4j5um&^QVmVBCDWA? z4Q>(|T{1&D@#8>g>Xn3KcfEk^i8FbYH50kw%bdD58M@MpE1bP5{fN3d*(!bI^2k5q zkc@i)>mS&V^by4cj%G2zCDpXHs0g@_y3b?n&c;q~sgxe^HAC0klGuSTHX}eQvSckI zafBGTEOjbP41h?+i8(W0!)UuxTEL8>IIL*X(-g^^ywjqu#eG*f$+dDO^KadQe!4~n zJL87l_T&HI6m-ty&;`(2-hYglK7!FQ5XZm{l1=mD<&*F})-4jT>tze_5$R_Gb=(X> zAMAyj7KY$Bq#KoTrDuXXk6kfBZK)>0>S9YEI3{rY6qJF+8lZZ%9trwM<-DiE+H~iH z{k*?~l1b$%{xXVazXN65wvfp3h_mBx|LU;Vygqv z7h*{HN6Ws&J3Ycmttq*!p}@|L#q7il=))~D|2`g=Mt8e5EtcesW1Vo{{Ls=9vn1A? z(}qi%aO0F{VY=~Hblffd49!;ZxZ2fcfUoHEa%cOIc-h#)52vp6ogWjk{<6a2<>oKJ z!Vw=A951mGms}Qu3HlK-!df`gKor^MA7X3}7==c(Pq4-jtFMN{XT2u)5Yo;@;{93sTIO1IkidCKW5Vo*H!{#G>-LjY`(sBPZ}Vgp38QEi2Ga5`&d{7v z2^Ho#|89Lpt*k<#mYIn+OsgcMvnOsjFFt{J5{!G62F_=k8|Z!*{Tw>Y`gG7=RS@-O z6Y3^-p=(EmGP8y5mi(qD=k{PEwWsHhkNDyB>o2$ixoeJZe60wBu#bC3up{qtt7Uqf zJ8peDGeVqq-%{L?h_i~SkJH&F8l_M-BNi8=-;!t0N;75ddXCTcp2dt@0-uVnUu8Jn z-#Jx}%G|Y+h5HEv_w!dYNkp1XT>JW{SJBgt2Y3z163nJ-YPZeUu9I#Znqj54$nMu= zJ~w-}c;e1v?;Ieb%=i4J8Mzwlx9al3WHi{fxzi0aN^41_&x1eE8BCojFVJvm zi04Q-FkNHj_RHWn%nbF>c|@-0H_Zf`$k)@SW`}fw7!_TKqFj#lHNE_bH2Vc7SPcX% z*ZeAbI4(={G0#{@{;+>x8Y=X;_D=&=yD|&@69X@89UqT;5=1R&PU4N^OOT@&ZX9M{ z<6+MACoF(9NUs@!}EOJD@Xl+0sHbGOP@(x+BABIUl6PTN4%+XJXQW$MVmVwTsn+sqa00?bP zK8N{$p7gx`@0SAZPb^{mCHNM4%0|+bcuD7*I+7_?;L`uJVX6=`^!)Y9MO_YTEWCPK zP95KU`D%xx|6v!Z4zI;qG%qzZ#pY5RDrhYnwBGdKM%;v1&CgwUt{m8$(o{DU{88)b z^=g1|vvkdrDk1Sq{eON!+)t!IGBJ<>m;=~^@DvMJ=?YGNp z9?drk@jXpxv2K1J0yIQ)`&+fqjgO|{UYDT)ipO)az?taL;bg3^j8?wV(RiD0Yo?^Sjzk z7xM$9?xJ1eCW8a8lkdW3R1inX;?3!^l)L7LaO528{;h0lwwI+WWDSMWLoWMQfdxk%H)9&3dZ*iSy$t!# zUzN>1KKoG*T?!!j+KXBY(B*xeU!A(A&{IKo*Lk3BZEI8OnH7eNdgxYh5SqZrWFx*m zHXHHPIy6`oEr=qGkmB1=9yI;s94?razy@xEE}jj?4Nxj_?v#qQXVbuj_Ykm@Wv%*J z53YC87MT zZwGeV8?f>YSbwsXZ9_mm?0{j;T%6-X5L}K`SV|?_*GA~M)+#Js9K}zYD-mhe|B9-N z4ZrzF;k5T;t05frv%CcZ^FE`&7K*y{=Uc3c{ja4QUMw%~h>`K3l>aLc0B+4H!3rAe z$%*%go>V+@6%IdKl9kBv*}%-em<_v$H!4;Eq4i@|yqua7wBup$+Pv2Q>P1`*qO2v( zW9!?vX(-`|Jhjsil%De&$5L01d{%NxqchdOI@0=GYXp|ZdSOSo1a~Zc=cWvN7p0E% z^7eG_b=i|ePZ+eW1wlMRS+%>%ZOpFT^OFCL`yX{vwrY%RqwFyp0Pln}u%xbx9n=|2 z|ITx@P&A!p%9?Ce3vo(fGm^ZUhwOC!IK-qYzsYvBqU>_mh?o0X(u6g0f!_7#5>N8| z`A*w;A)r@0xvq?EvHPsuL%773;P8{Hd9!BkEwIwn?`1;#+)2UtfvCLxzbm}G%WWi)3xfDxN&^S#RC&W8*Rgfdnv~^@Sl9j*i4`=qJ!f+kTi_sGP*0`= zQHt1zl-G=B7E=y#V~phd{fnU$>GRyOHligc3 zx8-<1{DD=E{MfFi2e#mz2<^h0ISAZ1D8ljK%a0Vo-HRjy;BN zk$hT*`^oUJN^s+aqnf@td<1`T50Av>!4&HPc7>`o#lX0|C zX`q?Js5?WsD^S2jL^u=iq^5ntPK zO{(@|DP1%Xv<`2smz?pa4WQAG&Jt>H4iucyDG#^z4@)x)s&CtHx{wJ|mtD%4ZV|i> zQ+$Xov}owh?oYt2E?$`s~-IpHCBG`Ju* zIUl;AH&`|szFe8IlV|hZMBnbv1t#}T48!2S`n57L4h+x$AX==P_Zg=+=r z7%Z&mfpC6@6W{%GsO!dCgA3qDaky;z zK+uZj?@FsQzeBY|a-~1l$gm+5H_>z>ClR*0SyF#u0)6}!eK4EUH-!rHJ ze~xhb5-uy4n?P@SJObOwqB>qTnk#_Xi6|(?{};IsPhM*rtf*q2Z|Nk56lAa_44QcP)-v3vi81$$ zYL$R;YhjleI+QsjMd#R>@4iH0g8B6i(O$FL(A%k-c9c|eji?6q-hge9tj+B_%a-qp zDRkE+%>xOe(1OdE2aEW+bNf%EV3S6#(?ibBYdRdd>Ikvv}H{J9A}MoMxefa zXkIlg!yyhkLmfzb5ULi3Q7fp@HT!-eMH3IRY3n;7z6#kC6sh#g18^;H9o+N13`d~f zz`YG$jyzW@JKzL;93eq)@Nx>#W@l;ANSPp_k?5g0tbWva)Lh8z4UgSYk1T`nl2;ZKEo%nyd;{FoXQv zZdW!bo4e&7|C{DO&WmhUd);gMvE|~Kp3ne5E_9<$*ukbKlP6*5d+KD8#2p#_0_$`eY+sPMm4kpy_=#W!+~;0n|jd@Qv+| z4;<+$*cWt)|H*T(>E4lxrx)n-x1EJa8;ZpoV`s8th`m6Egl||Rr_MN+95E-Ebh1&< z%jdP~DWpJIzqk%3E}a?tl|k2xeh83*gUG_H#MmoZY*dYn}5lP*}XBFm12q*0nFX+ z)EE!RcbCSBv?sE!1*f8LhMi0Xa48w6Ql8sb&{EM&wi7;b3^2A2RUq5-`*OUABGH0v z4V&w;_KrmryX|KrSxZY#d|%U9i6;N)4gVog>Q1!2RHgz6#AfC zgUG<|+a;zi3A$U=o6L__FFCHu9r^mx}6ajbA!;PFDbp zmHh+xkfu_UM8!<8`PdQoD8eEY_ru(@ahLmcvYz!lhSFym)$Yq6fon|Pr8w2loq*m2 zfmO4Q#o{lctFZc?Z&gDFGzk9_?4Tf9r+ZJe?m%iuW^o)XoZw_oha!^7ReV$OV^HBz ze%U3&V2O2B52~!=8a8=x1f1GTUOp^NXr;o&TDlB)!5dkp_vl_)=nH6M| zMU8BnyA#7epyS@BaEhSS?2U_b{ovymPEdwmPeDP^2^+bEjx762tRmED2)Xm0S>L}F zTaxpcS?L#(&a;46-f&5-#Jodf&*k{V=qICp;TyH_sC#z7v2n*PQd2zZ!LMwON;=-T z3L5q>iB#ZD6d1GPc$6q`5R6wS3EtYDlPsU|`+RqStq8e|+wXPTlAocU%HMhct3a&bZtwXp=U=(^~@yf?T-|RAXl5zRJ;}4kK+AQl>vG*g6W`w6gFZhy%GXGN@ zfm)q;v$LSI(NfnhCG_?H?}=#bnx9U^><6H^(lpc~YIWMl=+Nv#U&><4eEH6nhf=5O z=B%oyM(4lTj|ywE|U^?1lsQH&N`HsY{pkVD>Z7xR$JiqFyBc}$F~ zvV=nn=}}kli5C?SBP4k}XVO{;=JaC*~gF%2z zJp{yxo+(Jr$Gx0-&8YzC$e!);b1(|Ihz*jOMWNU6P8CXgHHq@krADk!caO!7qlzq` zIbzvZc6h1sO9UO+HSu^&^&zBnetHY25m(vsO7+_hH?k(pH=ZDPRd%+m0eT<)&++<% z`3S!SK8v7gko#0;@$n_(RM0%zV0%QQQ-;u|Iw?ftZ()SflVu*o_#$y0pK6G8B)}?y z*8i-;L_5%x=!X4AuuwgAvZw#H2z@q~&P#s{#R*Ue)F2mHJ}CHj1ne%et?na5t#PlN zb_2adXr+XU5@d6EoHAa#S9X65jpS6EYlhO+K+hvJpL7btnM&t~&!%SUw@SJ7(KFB5krlpE0Eab#TLb;=s}$(V3BW}eVmczfBNet42mWe&L?VWPj$&s({o7-~XfDIAp_vF9|^EgPbWI z#uLX-1chdKks>4Sq^|NPpTSpQ3Mo0*l{_lXUhE{5D5H04cb0*Baha>r6HO6hJ_=aK z*PtwUb!spUz25}9ic|PpckK8UYE?U??%|gG{lsJLodmQGW}&=>vY`sXTZ)~6!6%}I z#Xy~LNehBuVmi8hM*Wc7fy|QW{lL_7ChmJ?l=Ls=m`1TZ;Gl`C8k;3J`c~fR)lnrU zMw6|0C!w-5U&V|sUO+qs1H{EOEYB@RSh@UlqKPJDQsn`@^d5%)5}zI=m$cB(EKDNZ z1kX&N7bWe>-^|C?vaBoVobrl4BcOhETZ%i=U+^E(znys$P%9w4r?D1vV-~c+rD@3` z@h%5^Zd~d88crHB9FMdK=Xu?D-Fl=0GDaJYyu8u$U4_1pSEb~w-DN)XDqk#gv5QLi zcYR$0iWHN_Ls}ehCDsW%c{?0;a02nL0~>Sn;(S+usOh}>1<0Pv>%et(mCt3l zLqk7RLhtQv1jf4qNuR+IlcYmF>rv6>a1v4dfs@G3{XSXL76jj{ahkPe?Xbwa$(FY? zK-wTXf54mFw}k1 z=oUMU3`yqsXWHy@MUUYQDk&A@^OGpmZ!^EwOqlN4ET6UC$2~rR<=3@Z23w!XB z4X0vUnkXJbo))zr9QsabXPb;b{F2*_XhG^KvD4G6j99K~Y5Tx77y9=)vUfAq4wD7m8TZ|I{y zcFn*M!VflzT9?>rf`;#E4!Hv7y8Wt`1Lh8pXX>U2g35`#mAHChE?r9(@IYY#1y}09 zgJYD6-vBTHxWe@H{MnE8=H08>a1BAyz=>1EBv!HDT+h|8NUV*J=-LLRnHI*{7v}qO z5qxc&q)gt!85xucKciKgh85_`&4qU*JD_&4L-Gfh9f_xs8FM>efn-lUXDcjsy(^$7s_Xmk3gp0Y@ih-f!ZXGXYgcUhp zsvX{;uv#o(T9x-RjUNkw{Ai^Tjve!^&ywEsmp4zvnn~Hr4#F~L8kV_*4I~FKmWB{^ zR2OSGo`|{o=CBDmFw|Kmz(23~+p^crWcjtmDO>i9E8oVGff;;^3=_af`(JU{CiwTr z;telf&NsV@YCtB)vIjlI z{O-8S=*WInRr>wz_Ek?YL!@X9{&_P+=@MDLWor!aUoa~V^WsakW|}O2>>JRL-p2Fd z#IKU}n_Qd4G;U_N?Pun6o)5RURPuMh5B1kOO+pD91U|b%jnCa+Mv@O$grF<%l!C`# zm+e6HR8?rW?E`xo7y|*2U%tegXNzn|ob$_{H#-7E9z}*ed z!SLl1=Kkk#Def~ie`mvyjEbt1H?N?G&EXE$gOMOlh%yEPY5P>tcwAF$mS*eUVoM#H z=;M<&bNVD2^!m)E?aJ-y1o8@w6{4M@xCbWQ z_f;wbyAtA#->ZeK@AXW(e)BW}YWoVgADZkxl>PqD`SK2ki`-h;emHoZH2b{<$bLX# z1h(^_ElYk$IhlIxk#%yHj*+qJ(_{>y-bOlwX^J5s;%(OEW-v)wf@2entIYt%zhJ_% zQy~#hDo$UHSDPw7&J;LFpm99u1%LANs{cB3w=6?Sp1O{3^eFLTnEmg=6AjRs5Be_` z37I-o%&BO_-L$fryBEU_NJF)s@3YSTtR4Sx{n)o&#{ExsxqjRj;{ppNzLNImwhHdZ z1-YT_=DV5+@2+Pi{CRANH_WhK?o$#&KVHwQ<4AqjhGPZyl&Zd%uns4V$o1*^KV8BCEdN#I0^2yA6RV{2H+kAKkT^+uCc1zLDEHTt9 zQdo`p-Hn=fj_g*Q@b)0a40rC9ahgdky4VHo6v}OI8P;6jV%ZX$;SbC)kG&IW8NI@-5AwUDia}v~{R^<02!55X;T3QK@(m3P53dm%Pay4^f=v}t3nf$hw z^UQ-hvIg!OF}u3o2<2jCNOj(|vD!kAM|dscJrB^v05-vWd*&9w%wQ74O}vr=9u=_t zfrdla{SJNa*o^pFsdXQ)s-3CpVY{U}4Z)59{1XJFVG|o#6Z-zT;DKGIH^WN2#718s z1?FFm5*fc{-15W(>QX#z1C%%3oRGYiPYh`ezssS(1pq)F?cS+K86P#m_YsUZ4!6)Y z56!;R@{Rv!BW`X(flj*mOGt)CDX#vtxZL+7>;|#!k9lD>?Qp5{myni`t(K?O$S3O* zv&GE!B`nRz{0%Skr%RUMu))ZTC?(<}Czg+R5GiLlCf0WFXB{l5gRgoqwPt(4HFDnN zJrTK1D}oWG!IxZ~o8O`1Z;s<7S3mA)es-OOOKikrDuAYj|5LumDh_(^YYMRbSprQ;xTixYZdZe6P|qa4D`>X}zP(^HMCb>321?&u z+`|vPWytl^eykt4uTuB84b2J`FUHOKmq|pS(*Ku9n2U@QsDDuJY%-(!Aa0lFA9^QI ztV+q%Wuc}6ea(0k>m|3hkxgzIRWv&N)kXEWOa)j)({S(E-4oi#SNxGQYZp-IDHh<-a(U z2loUM3`xT3#`WK)XalDFYO!c~LEk>6i>>7d#v+^g=9kh(6lf&Dj@@8eTIRy0gN-N# z4^l;rz-c?Cpi>*Bif;Y)lK7Kr28BY=HRrg`ZkIqL9KE(J9)H*Xnlahpr@aNn3>AP+u_ns8OsN=m4DeY zXZlf4LvReNSX$f91N8Pc<$i8z)qv|ENQqnZ+W@`1JH^{aX7Y@g2?>8ZW9@HqPd?P!nG5autb=(Tc|GmI(Cchn{jMB6MQ zBgMJL>>>eC?A^>kHmi_VFak;Txwf`XfUa>zK5Ri&MD31=>5X(n1(>Vu8$Wz`DRI zaU|e>&uzcVul%_evMHAi##8}0&1(A(quMz|z z3O&QK7x-8Up+ie(x+Vi^-)^6}+lg}1exFu)XpXh#WT+EpdoNSKe z*bX92^ruhzd1UnZSzn6|KaDd3`E3fEM8w+WYJNHqk8F5K{pr8kI_@nE-D76H3YmJ2 z7aY%7R`bvb@IAuIbtS1uzD&Oz8SvCAgAXWMhC4dj9bdNqMZGesW<(i$|CJyK8MJ-d zb`^A>@r4xfqvfV#X>A<~6ldg&!Mkp*AXy>rxuYKIyxm5>A+}%I{8Eys;WI2-Wq>Jl z>1(+g3rB^C)>ay8;+UXOVt2#k2K8+{8{{o&-BH2{8_<~9#@qF)&edi+xcIcD?{e3N zGRT%@FqHT<$MbkCkSgdw8x#kDfC7?!i$|AIj;HALMp%`ezXkpH5Sy(?ONg0%wE@Q+ z`d}SW%6@7}ChsAwYa0SL5gN#mp#O#Wah2s`L^@!t#_J`5%%%imF7C?D3ZT~WOXX|; ze3V{2ePsMOS#yz+SB~@3vLk>!@My0kP*!bN5&b5DLHdge3r7U2%uU~aLSoRnyiT@+ z_LG@7ut39S<8#~Z8;NJHqc(pmdl&t&<)SBeB4x+~mj;*^L_I?%aCusrF-2YJKv8}WQMwRVOV z@VSX-w4jqQK0~&VO{%z_+N?ri69GxbaMK4n%mHzQ9K?cqLDiN9 zTh4D40SRo6B&Wu^e0^2|^fyljGkAJ*Xh>(hS&75oEg%UYk*^kT-*2}7dNi4w*9uX7 zW~T*ku(JEOSlKQ_3sLg@cfW^}J;mJq?_RlWvOqE}-oYam@+eA3yhg6c*ydu-RpFOX zG#%TGoU93-#Bk@Cw}S{Ejdu^jM;3)3N@Hk3a`4w_XsibIT3Vp-JkY2Lwu;|Qt8!Ey zCo{|C=%5U{#M3E>_)n@NS8tnc7Bu#B*zlV`TSKHfy0O(1^R4i4y2gxPK$`J7F%IQ+ z?P(9k|0N(yGmQE9U*Em@%Rt(z4d4X49~+W5b{h%PCXKHb0T07n7p$`UU3bz&WOo1= zhAQn-yrtg73T)S8}~EgMwm3}DdZ+Glns zNc<<0jXQeeUd+BF_jRnAAq6OHAK8^kZ#gM1=~LwL@htG05->^6CjM1sD5m?xx;Vaw z_>mZP)%*WL*;|H1xwc>2Lzjfo-6cqOBPbvs2uetdv~(jqAky7kN{BQl-Q6Hc3DPMb zB`^cS@ZN)a@5lYT&;K~y_bZ<`=D6?sI)g`^+@@8!A3#Lt;*)oO5=eTOpPf zNI66YFF|`pk(K-DC6@GN$egn~weZVJdVE_*OUefQO34dj2$jKB(NF2;P~A#nvLA8( z+C6WT$RTj$#-h|-j0j&4FQMmo6_091_iB;PSuwG3%qb^dWXZfDey51EY2bm#$=@U*$d`t7K3;LE@+ zULET@n?|VnJ46=650kPj+_8g(=_RAOv3Pe;)8uTzy2@IA9nR|dZpA%8i40aR->5|| zadoImf}9XP?5*OeA?0=Jx1e?L?By`7*~isI4A^5G6!xh{DHAPL04*Q2?wV@ddmFMs7=Yb+VL zpl+EpBI)?Ur26+XOnK%z30@(&TD`JSNv0BPph-1`%5e$MP0$2)>V~aJ;{ZUTKEvMq zSfPphoixFt)x=2^R=}O^Z4_EZP;~&a=H((vUR;)?^iSLow1EE8lX8#zHYZXr+IuX} z1yM)CW2(^1u0qWGhcqIoZb>SLZF_BjzdJr&-rrQHnB7+RNil|1s|si$1;frgUGy@q z?%4l-F=@1W@&h3(cd9>!FxRKcr=>HYom|H;bDQ=+U-MSBech1lP&~eLEv*1Wqe_aa z!H*{e?Zu5fe042oVE|6$&Krmw!sk9fEwdisXcQL5>b=5+a8aL);62H> zUT)Pv;15f@KaNdn*o3D;x9^igzHzz7jrY3fn(!$71&r|Z5do-G2AlLJj&rIbcDGC& z^7lAFDEfUlqfRZ=zx3{^mpRo={YIrBQtd1MQ$UZ6A%jJoUsPpvudN!At$@Dhzl=S_lfop7p`eouz_f63UDw#T197`_*Y1z?r^pW3*3XTZcxZ`e%<)3hvksr|*zm|NPy? zy2lN*{bg%$8ZdDY8(v|9ExInVwz}T}iNaFqspjs;+5wQ~4KV)nCon`z6$99WM_bs| zg>ydfjd3uHw946Ux)@1d z+(F&_v7DH7h;eCe|F=eL^50~PX`o275yhuS4SsBJfP|4^eu3-?lh=a-4*NF`U782xIR>2?);ro{5`c_P=(miIsM8OCMusT zY>PR}oLjTI8Y{B|t>oToZjfKwig;KfA2(=0CyW7i$NrQ@#GYX+w)p#NMw|x zWeO2*Y0I`)Ia_W;tWX+av2$By-u=- zu6>MP=m1~+(7hoh=C7ew7+%>mQPPHfoo3m zJuqZh0Y6dtVUdI7fXyI5o83D7JS%VWgRYoDL3{$W;g0ucu;%Gwa=pC{4zS{}Ql9|E z7hjv{#;t%uiY0G1WZkIvs{{3BzpaCwun&1yUz+~MEE@0%wAWWbkuD|5pWrpUGm})4 zC2JeOby{b3Jj5U0$SLAnfECe~%8q_@|2?HEd#PgK>+$wu#>G46#kNi~au#^Rs(rn+ zj@$-hGw*k!#B_XQdi)ZHXksl=6RMbQh@A8{M9wS5;_{y}yFs8e`G9tuy!@YCOjhZe z4r8%zkq=3WY~LFG4)v@qN$bY*T$E);lsE-pc|g}_C9;=jx^<->jove{k2*QR^0*0p z)LqBn-*uN#(>Ugy&zrv(88F~dj|S#AS_eP%shX%S%swhu+~p^=d~!0-8Wj!rH;R7y zH%w&LG{wzk5x^l!2AZ+@a}?bw0TF_vX5{p9g4Fzkr?>1r&K-LT8l@N7e5@t*3A`U< z#+-Rf7-)5GZMb06ZzHFpAryk~v;s#DYSChxH%xXpsp|{lswZ)JXo-|Gh;|Y=xx=3$ zn#A6iqiY#3emU*;%9RxnZr8nHUAeG5cm+bgvQXIDW7N~dzt+3Cot!56=4RfZp7-nB zkcRYG`AyhvGnD}0leo#^gytvQ)EP>%%l9H^FY~y~jRyc}gM%B-qj(q5Yv$0RsC1`v zqjDGfQuWA(dxyH>5VgPIY#ikE@L|k^>P1DOf1o`_Q{U`O_@sG33e;eb82?XA5YR~t z(_O}=2LwdJ$6@h~qe{N`45j1pBT9a;GFC-5U<^I#YoT`5?TD4Y+t*MtHCQO;^njvZ z7_>*XNtu;7%~)@(|5lg~;(5_Z(wj$w`>JQ8Tx+T|t7f}E`NvPgrkrbje>t;f5H2x+ zjUb*%(hu-K;gpJYPY7|xmtu`2AfkwxdYMIM@>}J4zff>BLE3w8eNx+Ma`KB!1}&f> z-;(W~2(0EmoNG^krk=-7=DuBZ$kdGJmW6ja=GPyg z1lVv-d4AP=tLmoo%Z9;?P?RH!i>GNZt7fi1tMd>CJjWQ*x^8{vgZELSI&I;dit3FI z#Oh<86#^jQ93FeEES1pj4ukfySA+tNx;bR%52jO34q)#7bAZMH?)pS4LK7oM2r^9n zm-bhJ>S)}qUn!ZMv)JaBx#M$In*IY=%V2h;#m58z+zdgh&B&v;N4ZT&K8GVXBv$DK zg{zK&*)8EgDGWU-J!0&rKVOG2{4aJVE_d8VRX>2;DS(X*mi4mC?y5mnf;4XpemW+N z6S+gTh{B+|up4)pMF&AXCgPC3AC#eAUx^;@n&zJ$Tz3z1HiZ~FF};6)R5%7|2S0|q zRv+-=2G8q+Hf_^O2zS=(sN?$dqY_J|Sd7iNaN;R>SgXC&8jSUvgL&ZJ&it6L(@X6C z0RvI(UGcpW#<<&JFW`T%6v{Y{y_RMOmjXFq{AufOD#Bf#0Zqfd5<9wP_U2?uF8E0Z+0^~+u+BlK-&PDN!}D^ z%XuN)@$aw4dE&3p*%Ge`Ohl8+cR`0=@GD3Y$|!2#PMi3f3So}<#@i*I-|&v2<$QWQ zS>3{$<0q0|qoaUJ2a(V&GxNo{EOAMB@9XgoLxaiV7L6U(mY>YJ<&xGC%(KEqr=}17b#M6uwGRmvebXmC1nZURlqA ze(~_pYgAX)d@=#NjHs>03y)SO%0*yuon*mIr*JMmso7^fpgdKAtN0?-obuh86%C{y z=(I||$aw1SdOUsoT@=*7Ji)=|MjZG73D5Y;Zv0gQFI2{iFwS37B`D{55~k-vke3sG4LU-*6GIK=2(0vJt3YXf!%uI z>eV&J5CJs;3ue=XA@?cs%OC6PEkNQxec!0OraSgLCtWIKqeUC-iQ%I2IB7AkI4Kj> z4kq+JVy}B1kzSV6(sMR!*RS;5E8P)vM&=Pg+;SOKX)d&ze4Py)Q{^ZBXsIsW^@v#Aj{WWPaCzL->f{n*RG1M*EcW1ci>WfQ#k758`TTgQltB2;536>d z_EWh7(2HpkM9I?iISqyd%gJ$B(pT;DPZL>FP9}GgD>r#cL?|!Pa$|;_`QRrXhoV_=6IRl18iGS1L*8C44{Q>1?SwI-yt# z;U!Jbx0o?z8tPS5Uo$2w(U>-m=Al(gbbK!3yUjJtX$&o=c+tZMAU;W##LF!E#?dmL z4_o1AgA}nb5 z8bEF*Ai1fuKi?4cQcyc;$LjgD8TRuzLDbVm+}?~(8-$9P{!p^>sFKqvWy;SH!!zCw zVkW7|oRG?uTnfu?io}r zpudzm^fk#xms^m*F2eV3%r;39s(yZb-@82Dskbi(`WTz2{fq9KMfQP6cWxE(sC^^* zQ8_(x0!!Dag|l)74YY`&8M(Mzl!uxAy~}2&sC~d0!vHmDuywbRJ&+<=65Kzt^AaNS} zFZn~NT{cZ|BVfYU%r)gZHHk_R;GTq_$C&BL&j}-=@1{hx}54xWVtr6{8FDwu?(w+{ipvQoP^ejEXWv7QdZv@$BpS zecPIL`dagq;w#Mu#tu9d4zj}(_eF`rJK-GFL-h1(kHG5vdTC8Kg9P#h2^f9JxJQt#1yuh6aO$^f-pcK;?GtI3& z>v+4vl?NK&gOa*HBW6ah$lITtCtU4u7efTz>n&Aa|qo`Px=Ah77rdlPPHi12aAR(1$CQ z&UsU=I-orowT2h{TD8@VZj|$R2F|lRE@nSm=9bnfW2|Vu`tH7w&M|dzp_@2%wfkyp z_$2kb#g6&Wwq>NzdADWhWAEocD5Yg>Wd6EV=U=U+S)`t)5^bZ(yjr#r+&NE1PsYD< z?S3%;(4U8Q7+44fExIC&%`j_DO_F$r1abL=i$CS<Q<0R;N4)_klh}TyP z;V{G||Ah9NK2~$6RZ?Ss{}R22t1eI+@4AUPYxx*gb3okcb-b9xy;bpN-^6;G->_b9 zW;z1eie$#O?>^gQN>7nf#v=WupJ<`OB-DT0vEd`N%$@>16E6wt{%gx+H2mmppSg)L zZdJ4~iXnP6r#$XC8w2%XED#dltc9*|;_On&5Cc$hNbv z|=YZA2?Ha90W2O7_3AcIf{x` zt0g9%+IovrIFL|{QDyO=5`vd+2C+#)rHIIQ-ep(`eI~`H_ELS_tRpsH6plfKYmzJu zOI35FlK7oW8De#_bAFwoKNPkiHiRn3eaCb($RsiO#kAr-*_4i;$H!Fp$&^gDxF;|Q|znAo)&23u>V6^R@L{!fMZz()f zIQ%QBGN~wMtLm{g{18!Xgk)^&{il4y=l?DrksAG?I`dPH46}76)%V-mp_=HYVb`m@ zkwvr~e^|*%IvVdDHnrg_r=1cW$@fRe=hVCC3^nqxv5$re_a^VwnRyT0j`+9Q0kdT< zg{j|#!nty@rXS@Iu^9h5uA)Cf>s)qL7Iw*&EKWDf!%9lOB{A7gh&%ZxH4qV(Xj`G2 z4?*m4iTCJ+v;(k3hSA@P+1Ony1N%UYBuMG``NDLupG$gEVku4&W%^{;0)ygQXskE( z*h>8_x{zRaBF}Y~zR#*KQt80oZ_Hmp!az?u&E(fKE1;p#<_|vAXVVPY?srjzsN^RVZG2)C^F1YT6!~dtx=n#Au;Cvk#T4 zE+DRLh-1}&C%4~I__T`0C~vsphoJZhH=bd^nK|%VmM#UOG&DA@2!a|utTnN8Z_2-C{${-FFk_mjzM38e8wO6+8_~n&asJAFAio|E*^$aMDQ_GtLJ1o=N&Oy7 zC9y$8{R@c#?PbcJ#N()HF$W6*qmf=rZ1&oZu01^xqw#AB**y98?ehA6M^_4=y~Mf) z1O#5b77Y*#kOF$^&dh+{i}rk{Pq0&LnBZM7 zpM9sRjr)x{*zOTqb61?K!v>zScA|!G25I-vk&C({B#?OnfI*di`#3PV z=%AV}GN{KSs)BV9H?oH}!q1E!L3*j& zYq!|mi{(rH7`7Wo=R)r5&%ZRgG5>U!0QaocKxeK$ePC?3{fdYx_5u^><=Br=n#t5Y zrI6?1lUd=CET}%fxhPFTDAK>RqK|xPBL55k9O&M{ir2(A-oum`tl9HaV>k*tbce{4v1xcn}Q-`Jy z?S;EhUn<5)Ed}WAb=56O)A4k@J+Ji2-Kpel3BfiXcIbGkyOs9!nw#F(Iz!Gr<;{!Rp6xWD6x4q?@%ndxq zfjmoQA}7v^1HEsq5fG{m|;h7~T3IO@c z9R91FP@(R2A3v~dGHm^q{!@+WiwROC)*aQ_OB|iEnRj$e`IWPDXk}@jU~psTII?23 zh2hN)G+bSF~9fK#5ae_cIau$ z(^BDqRS5?>X;2v9`K;kf?CS0bwV{pf$c%bR9((eNZq*~>`{o#>Wp3b4ve-Hwkc$_m*B%?v4wv{c;Tq> z>j+n_0{ew~po*10Pv0?J;95rjvZRy2o)83AH&JX>OS)>07)F`ra2=g5B)R$IM~<5K z&aVXrZdPVg{xp4-6}I9j-C)k5GRYLqwkSC7(gSK?!`AsJ)^q2P3G3$AbCG`U<&TY; zc_uS;C38%0-<09+hTU-1Z%SbAgTkdcrExvz(u6nS)iaHyUA!?1QC(BExVf zG@DKuba?Lj<4!5_1SX%$jqLF(v4?`L`4Ffw3GQsOW0*~0<2O5C1+SWFAHDLW^vL#m z5G&Kiqc+E2>#=;WUg#Rrm;7wDiC`cWKBW41z68)a?$vl3Tvf$u6nfO3TJ0gJEdO@4 z=m6UUzOD85Izbw0$-ek`TlAYu;~LrLr<+;H*URXRByyA|vx2r$Vf9t(^pARD1xv^6 zvUv-`;muaP&yd?2B8_ojKEV4fN#aItG zaqPZXl$*}{APx^+tR!4T0WG0+Fs%(;5by^5HLJVArTnz%YWH1Ej#eO|Fc1Tf)e~i< zL?&9^!$=ChFeFA>&sqjWRCT_4*ZY2SSxKbGG#fSIIW$>age7m?EA+Lyvv|lUwEI=W zyHia0zg->8G$pS4$Ht;Y)coI`r{U(#@VaAs7lu@*BW6x0LFFO;>IH2BY#mq6RczrO zeqG(yJ;1Fhv#di#T26PrZ$5?#-|ba#hzd*z9?oda@X1{gDh+lJEiVU}Cyw37X8B7w z4DV=&KQKp4FdV^MB?CLgHc0v7UiasxZYf^5&rnl`NF_h~@@ zg}=pkfFYuJP5XGwdmdjJKnkFAg!}8=oAR$^Ix`lMSy&Ur_UcMiXLh`3I(=ef2&7zC zsIbU7(XbED_=izkQ++P6`y=wcQ4@dwA8ELLJ?^O{d`OI zzhtB7mL5jaRa(H5v|zID2lRVOp1*O_Is5Trf4&~idJ(1S5&y^^LKu5l$F3;w4+;w( zzs`lgAeY_q3HIbYWgmfj2TM6j#nS)tcu@$4x=(ZX6STY=2}J*PrPLn%>x6e8m6!3@ zfCMt`CD!xuM~5+8!Vi*pBVRR(1Q^$`M}8)Fjbnb{8rQE?sdz`tKh-u&DQ=a(qS=|a6He`9~Pni3)E>)e4aKX_yCJ+91#4H5h^t1 z>J4xw_+_7v&?Q!hq|yp%=6LiuGCm6yI&oI$zSEl_<6f0R^HCJDD5WY zHVOQxR1zWu(5L}716-()GIqFzHk#e1y)VuYWjnI(Gj*lcd{zHu+a@FAR~=4-TK0hN z3l7Q*4L6RRl};YqHZvMmP(|fNY!%$(h@6d@cULu351|g^UGDMzFwDxd=N|uIZZ}WE z@X=^=zTuL4GUQtWoARoQaSN~keOANxhr2(k3Khl$8u5$w9kuW#mjk?U?pfu0BVO3F zWG1Q1#!bu#_(EGsb5-RV;?ej1(LTVl`}iqxF1PGSo}SQO#&JP*JFw?624X=%*su=G_Dt;~qHD9~?B*WWpzIm2Rgp9cK19N)g*Q3#uD_78-z^{1Z?KW!{ zE9)F4V>O&7v5FGlusLs4zZ(MPnKSw{%GQ^ts9qdu~x|I>8~ z+OlTB+#k+Krw_O-M^+%{1MAGs4RLFR1ztSs8RUdU-_kani0!SC z#F+BW6v|IT_0(N5PeppCiJ2#Nv6AZy9=7AfIj?8(2}JhXi5*rBACo2*YKEI>02Qk1 zH=&m}z0OyVGn&Q$_{EPpMEqfV1g- zRtu%RSREz_$H9NI0Cd5Ar;#5UT*p*fnCUvre!D0&;xlXL4TH}Y4#CWxKgL0E9=7)z zzf*PFbP3^#MxtS~Jg50tqtK`2sw$Eh?e~sy?xDwJ%qOZZ5%dph+WWz@;}Y*-A@ggu zwUJqv_C=Cvvyv$)!82)IN~q#XMAAKvP0>U@wrK@ex4?lIaGjf?M$+NnUvc4x^LE|w zx4FLCXnVg)c$fX|#^s_+uq$l#EclQ$MSihj8&|F~rANex33(5`A#V-SG7=FP z(L&NjbqX>RI+e3($W*QsAJ6Qb+IAgzfewJ8S)(cfDY*5`qJ{2yZQoaX1ExPIPXtmeg}Spg0qr*FVURNYJDjF*8&^xYDr93G zH5$)~8hGNexoOsOI@e|LCJRebb zB1k|6WTy@^v4SKXZ*0sF(R(5^@i;o(XfXu-ND@FH_wF1LpnX#am%p3t)9{w$r@bF0 zV15zvCuMLdyOrT9yTlHt&5%vxwJ#S&xXoVBk6)50;NaR2VuEX;CQ9qUZHV=SclaT)!hV@Hvc zSJY6u5$pH1ugXYvd@FfjA0H%JP?r!v=s+J=Z~goAI^1;k!+#NN-WEU)z1u+%B!%Mz zw6bz-jkONfb+apRY!=P-#M5z59lQ|GC-X=dzh4ehZ#aaJYl)}GU8)&|Q7B^&tCByJ zy6mg5aE@*o3o|=yLQFVnrLR@*X=xofS1|j*^BBtAD7Oj4EuyP&cv+qNPH(P!fNGeG zm%U%sf3vMy%yqCuYnE}QZFf9P8V2ey>oR2ye*DNQrEKK<9A?KgB*XVr0Tj7en1eF@ zHa(o>2I}E9&6enx4KO|I>}>Z#vBq0$1w|jB#=}tds|D};x>IGT`mKewf#|0ziYJ(lErF(_3dg->uQ{=&f z!<9D<3iIOFdIybqClYG^PJdLx*>4W)5|E&w_GYJxJK1a@17}W~`0#`TG@Aq&Sg1rI zNh7&mnieRE&w+)4u-i?`$+uZv8_-C%-ASPy%F2zOTM#Fuc~g+sg-h~exZOOCbcrs8 ze&|LsSv(9s@MhT~1j=%dn_j^C@KisQLtxlKsQBdOXgaa-+=bN_F$Mrl%_?D4?XXFvsbjGdrn=4>6^OLp|1-?Bk5Df21FG%Hit*`Rl`S6P} zWU*)MQ#nFlhDrMh*H*btL5eJ;ah+sC98rQd{z84lZzZ5 zTa7Ma)$Ae*1)Aa=chNxB=s(Eaq8oPb14h(Ql_YAZFwQms%jz6y2>dhiE$LEGD$zPp zG-}`74yDFq04r@%qsa4M7<`9s4-LPS4AINw->n)nyoIb>DLgr7thBZ3tN7?Xp_*nS z3q}K2P;-fcG@1-u-IV7=uZts?n)itgLYU3GE-$k^`*Z^3ts zwxm+-7*G+K=s??Mpt7}}DKZp0jEHV4-Zt$PrZ9fmG&fGz#somn_P7mWI`W>3#M#vC!IVs9_^b+`?SfuFWnx@UrS8U`1*Y zGv9_6+iq=YRacLIRVUu%tuF2e6g~hGVruPO2HpEqMOX}Akq__W59sZEY9OPC60{Dt z2!D?#@IFa>(ufiVv#QW@F7N7XcgnA7o9>A_;X#~O!3cv-DM4u{$xhTu7C6FNN>7jj z;26DGySyJpLaza`y|b2JnB zy#bzE06I1*~ZmX>dBjCY5GKa^YmOLa&=-4pE z+27PK`B`S+UfdsYgAa)f`iCFloc-l~pn(2{j{za*J_6sNWTx?i3|L;4(|gw--=Xnq zERUt=>5a|G_N%k`gGLq^v=03Hsd}`5A_2~hWi^pM6Vx9+5++&i<11w5oSlx=nIS6L z=wW2Tk|Blk|Hos3r>!%PK?{}i+DUTlH03R=a;Md#g(at6MR)+1Q_AbL-wctvpUifZ z&R2W!nhAerU1b|lfAGuB?OxH)-MPFHpeRNDG-{;Fr65WI*cGHa4RX=4{sf=)xI!UC zn%znmN|h^guri#Z&-L`Vh{p=l-SFb)3Iuf6iXcY5R+@sOv{^Mnm zeI)zTn%NJ~U#^cKr$3(k_nn%P>+r`Z*Ql~BPicHKP}9O}Fs7C>R2GcHoobi(3cphM zG&n)c?O7?)Zmom&0IxFLc`m8Fwj)Mg{fm>G8b-k91lCm^|DEJ^FU!_PBaJMr%e<1~ zOX=~4-9o$M0*&%`Q?O8Mpdl#=*KpIyfJN32NS#4vf^&VZugT z^J3&nO$EwjgJjpUPjSPX+|5l;Nng{r!}^Ox(0sfBpBLY=dnRNY)-t_v;w<`EZ#f4!A0k#*Nx5RH1L)EW1U6(v6V!Tx=O z^@pOGvz0H@+8~q^k>1*VV~IVkHdnpIZ$+!zx!;CmJ%xqMYLqm%d7%*|@h%*hizMZ* zc=l#a$$9l{Gsga7MR_#JUt>y%6{X7yzHh01(>k2{4COo}cLUD+82FW#^OdB5DF;v@ zD#5Kf(>bHtj8yHWJSQ$-d2^Xi)=hTv`9P`u`YihB6^3J88c$2^zKZ?#lq6V|3U1C! z)C3|$+ew?7QSuUiDTSmL2$LQZBtz0)L>Q8|1~Mo=e!JLwA+ zG$CH~Y#*%|bw7IBCVy*SZG|PiR?Ss(>x&Ljjo4CpwNq4k>#htPXuTfPBMB<|#X2eG zy9Tx)+6D|MXbS%rQt}&watVsNzCT&M{VG)O{_4Yf z?IP&RGd3!cB1z>kKU@E0szvo>dp5p!pTOC$?g=Pw#_CV5*_eKyZY8)M{)||6#Kw1^ zdMld>Vw1~j`I&#Qkie39=ML*Bhl>c;-rd;hxh}!bQ&wdEEVA2$=(igs-!_o2an*pF z$-GVHcibj!rE3VDc#hO$%7X4*gYsm=A#5@dy@uP?ku8dz(l2cd9vp2efbvUAs!SSBBJg#orZDs~juoq)>&y||!U;vo z{Dw7@&;loY$F~qhGxJpD9(iB^U-g7@L;Sbtq_pVz{Vw?>QF3TDWP9*5!EW#!k4ckM4#D7;=z%jP>f%R9Zz&4*(CQlC96IT zwXd0~_Pa3OX;U2JY|E-oG!Jw)RDB(jmH)kBy=GTrwvSQ#qp#XQ5013N%;?AYMisnw zJVTzXcl(Y`gG`#4WdUh{OX^QYAMgh6dV+|EV>c`7Q#UITb}q=;f7?;E*fvGWA|p~? zDVkWG=qZmR`P>9==Gm?Bn9LYr8Vl0oNlJm_*dd2*hYu4v2Y-^yVDu3=`y_T-{KV0>T0 z{zCED!Y*hhLfikz|g zl;Jk?!@0NUoxPR!=y9ZfAV0xxNS6&jA5CQ*WfbIIs=ciJy0yLyuv5D`ro#&_xiCbP4xb>2_^ZqKt^Ef?1ywuURmKxyO=JgS{xg-FB{+nC>E4Jo0i?zTC+zb zvEb0bGE=dO6pxxO3LhbXo7!4kXj{F0pj}(rdK~d`FMDk$T<_BWi290?W_}JcVo@x{ z6e5Xv~~(qznJ+BH{;*-Y zAdWM4|9yj`{-~o?=N1^YUZDHBV{&gxEZ`BK#r&Pe*%qJr;eM6xm_9_OIbX=|nuy+n zc4rL>!@6)-4l-b!>D;Z_F|m890ZJ@7MF{VCj;Kyv%sc=#IL#d+$VkFn;BLdjwir-eJFyWqND{ z@>>4is?43(R{M|tX@$`?Arp>W7@pl0@VCarO|M*%B0Cc#NIqd-8v~Fd$v11~@sf_} zb~sJcCGxRpOJhdDy2lJqfMd|DVf1O|lvLVGvS5&wxF8Jx4?mgu)ys1?O5zz~(@Ut}@AJ9X zqh)9Ia`|orQ^AZkp{r&|fK@U6pAoAiH80voiuMp3oN(N?3#ZiFc+;=@) zVBy%xabp?P~PC10IV+>{c472uR+L?)T^XQiNJu)^S1AF<`uex@=M&GLZ#2o`gP^8&?u1<~Q^5H-CKW8S2_9 zx1<5_f%JEX#;w4<3n1Go95YUQj5Rq_cS+9z3v0n3K!3z=( ztD>#O%*V|BcDZ5eA)B_7|EO5Qx_TP+mw?2&y{ zZl3piW!+9jx;tIMWT&c+J)vfl0zH5P18d@*TdPFZdbt%R<5S^CfEBug;lx5CF`hGJ zk*%?xrSS|YI((p?;hFP436C8IL1p!zx}fD(_>33{pYON8QAyLGZ?{t+LbqQ-<@#$h zC^p;nbP}Jv8^pBc)`o?)+DBW7KYbtg`NX}^#ntX(#@~$ni8s1F`JTDhRS!iQ+e+2G<>AwUOunkx-k4i?#XS}K_J>2ezdJ}yX z3bUooMU{i3W7Vf~@!t>RASjX=*Y!J_{kPp-PLy ztEKI&*3LvwtcEA6sFq0)P31nd@@NKP9Pu?H!rfMCj3gDdb63NZ0Y-54qjZxpsMOsy z`Leg>AM9fX%an8i;e)a@k=}}_-J_n?`iqX!yIbSA*NlA{j;k^;nG5QgpwAR9$;8qo zX_}%lFgzIB2`S`GN9?x$usYol zNE^@&%moKRE{Y*d7oiYnXfEL)!T8eE&sVzFXO7or1d&hFF=Uo-53gt2FG|}le2IPE zr0)oV(jaLP?-1hG`@COID7An{Pz|)y;=70}sm`ruFHGmjJ!~;{cW%!&>nWQ(FdnXi z6+gygsdFLM>D35`&~r83ce~9viHet#{#+%}zuL9mX`?fQbn|%a`5_LW)|>w6vxGvj z%AP5Vs*}?~**p0mZFh;<1$LX51yPu%M^wFwEnVvGjO?RCu5Wa0BOYW0M-O!PB8KW09_v=#l5?1+6R z{;mA_C{DMYF_5V7$m2WUrJ91eana=%U2T978^x+Gm^3gDsie^6_RHo{$n`no8vNGK zl-0QEfSCY2yV*plH%w^)_4_LuK%^bGpQMU$@bqG!&2SMu$(nr?0z6V+M@ z2Om`SJ=NnY3uBb6xM%9`JlMXM^}KI9&wvNhEpHZ2GArnciC6AZmsP2wq4xGs-JZU$ zz1Wf>DIusW5({)qub*(A`^&-xEaA5V|D!!C(OlA6D{yVJ-?+vTbjWqf!C_Sp^uZO1 zsl>zV{`l)0ky>?VD&WRhb(DRd5z_I}G=PkhOSNFWtKBY-d&{lhg^?jJP0oOpIAf-% z(Od1CWXxmMv-VsH#;S*(5xbxkzntM!3)Z0C;o=z0ox0kx1wBj9@VEdha z7Da{_2OvG*a4L!u^<4brzPsepD}*NzN)<|U5(x5_*;_yx{%E)7DEZ#W`XSlFD7%Mb zG)*c%H_qI7@>(IZX>-qa2XDLvqPdYU=`;R4MCuZe@a0Am8o!qBO`hpBNKG#PhQ1B( z2nvV%rRH?O8(1s8En&pgcMnatmKTpro)GUdR?{;rb!OqxaPdha^x{Lm0~1CDWR)1< zMGlfyRJx@wuUuEurOXENt29B>4AqUehvM+n9Sfco^0z1ZD1H*!GW1}44m9R09%(Ob z$ue&M@HmXEhN3i7BKBjeOmb9LFYyY_Puf>q1{A@}vjIeGnv4TaMCnDAW2Iepoc$l< z40AO4oWax6JlQ*5Svaxygue4Q15R$FNEEw2Ici1u)OTU;f{IWET~oBJ@?LXLR9x-L zJDZ}l6VF29ARf0%Xjxi^Wre8eke$C$XU;_3;$>}$LUuOya#@wLGguI; zssD?}LTV3|oi|x~V42SB9?s461Q}S$k^^`>JPYh^Pbw91-yag61wBLFV>FimohaXh zCaa{Q`7ZEt8BM_sC4fMrcSXv3+v^X% zRim~Oob$*?iepg>t`sVL0AI_oKk;RK=;!-$W5kB#>W!i2mC$-!wPSIqSL%enB(+PF z1>gsis~qd!+5(5l_>Z!$-mJi&dZcM|*VT8koflgM$3ZU;D}qJ8cmg~{1C)fyq^{Qo zrrk%J=ao~Dyq24G;5EwO2B26czaJ>p!3K(Ts{d201Dy`W)_+Ux|AKa*yMt^a7Hj|% z15bVZK+36Ank6eJY!~)vANzsJW#KNb*Yx`59?X zkntXr)stKD)TDI|+T{VXQsY-t@~wx8x$4~DxcNna-Bbwd_JCg{d(}y0^sm+x62R7z z8CPOPW&8P%m<&M^SaPQ0nIK+dfx|W*OdRFZwA^uSs2RV@I+sw&==lDsSJuDOKUB;p z<~#7@l58_OB7YK>PWA#Djx%$lamCh zgE`{60-hmgkt`QHS+(rM)nPA56*9g4Pb}L5l;8Fr@ihNkzVqu(mJ11c3X*b*);FmO z|A{6`2zuXDY=C^RD$a;u-A_BDH@oxppU~a$p||$X4h${n_yr9u+4Xzxi~WKi`Fvby zXWptYdi)7zarvI?$P-TzQb%-4k=Wq;_l+Yb)UK4u{|{Yn;T3h;wG9s-At}<*Al)F{ z-Ju}e-65SrNOz}%2#7RDceiwRch>*|^A29u{oL>St>;_w2e3HTxqs*0$3CJV$vV>j z6X|ah4{pVLvL7$Z@2+)?0V5iH4pP7d3hD9p18sJ?uQ~U@Q0C8A78Q+p0n9(lpD@Zi z8yGYP-T_OaqKfLt+SOS&e-K}XFp@k4r~@BY?`G|me zZtf=4tJ`vvDC%5a&Y)F%^={EUsQl?w=UQha$J*A}aeCTeD_^ngReq5=Qq5<2xK3%2Zn;J#?QxP}#?rs0kPF^9 zzLNAbwi(OXRe4RB%efc8;Hwq?eclw8gq?IArM{4l#$Q0aX^RwU^PEZXe)Ce|oSTw%S^%rxd_gpzbKo?ax=E z)n=f&tq6O7d7{#(nOLqH{+i;x1sio7NpDb4w&7v}&s3XSQZmh-56+147?(N{VZ5IL zpw4aA`uovSPZRlAOj#wQi;VE;Bk-lfB2!C1v zJ+VjnE7nU8VsTdT;mI>+df9!E^eDlv|BD1f;ynf&z|Y?fc%$=dsKb$AslDDLVw(CE z7D@FY2(P?ysAcej@AvNgY)~Hu6G!j30TWs- zH4}`eKGZ-RfW$p<$QK^M48C7xRrf*gZ-@5}i&&(k)}QqhzW(}mV+P98Yg%xt_6WRt zPXdrQ18vf0ZjTN4LXeaP$A7z2d=3dfzvF}3)hnaiadw2z9UNJWAUh0@@kqOX;IRanB zV7C<0L2GnuW}oL|WhEObm9RJ-bik+1o&=|hW5VH-+H%27%@ZxmJ4JeDffPMC`v0#b z%tpbhT;uZW894v*&CH%pnvSwArZ#7Lb9Sm#~c1+Utj3s|y450L$K}q?(U*Hs(+@ z759P-_LeSZTdR&~Fi5}WAG3mnBhrhTeoiOt=8$as{25x$`{ae*f^YxH6u!(}Ge z22RfWzCodo$xjo`Teavz|6(8$ULDIKje0MiR2pCPwtDw2qyoClOTz-t$>}8D^%Q_iw`?gE`C_KY#5xu?kfWsg6^>F=_j2}!yUYbLS|IsR|-XAoo_ zyS>RNrT3|P=VZ^`E5Z%TEj}?h6HP%iRWSZG7sdPFqw%6&;GQQHoQ8^aA0%*S&-0sm zv_7@<{+BMPpZ;T#jUwgsOc z=7$ycwI|Xj2N1GIhH~@4%<}#_at;7H_iOkn<^Pz?gn&Cmklad1rqIlLI}q0R&PD65 z#eS-8RLO5A)Pt!y+tn!Y>V5FqH(akMUlM}`5%k8MCOI1>XGK|zD1aBnLV$D4z1Y?q z=!Kfc$?^EhdS2i949!UDFR7($^-IpN`@tK=%P93B+N!hWrrSR&c2d61C`{=7_vi() z^lBE^ZE7u}Vteaj+-o+7x#1>O2uQY$Afd6`Wrw->)%u30qAP7OkqiHaH9GYy@r-qY0@WVZ+oKJkT_9_i~BI|&6{mH3N@S2bh#3sH7;rTebf)D zWzgie`Jwp_%aTmTrF=tOw|N^(2Xq{Ed3N2On(?CmrXdq~&xDF9CPA-JoG1FM+IkzZ zLTq~lI|j`jF~DI-clUk}Q;@RvM{Q;;euaQBTcDkQvw0gnMzP`FfT5dD#Ph#5h(rt< zQ+J|}$*)VSJMovHgb(gE zbjZoE5ccdB^r>_Iyl3PB?NQ!V?v0wnUaoSy&0o$~>tV0pt2cZxr_rG&#Rm0tCb{?Y zrr?W|Y5tQpbiT>=D)1NHsgC2u_a(*nh(U0c%>UT#{`nEV%Sa+6v5ld*Vj$)8DQev8 z*@&Qu!>12hY-1DS$VL&Bmqukl7G1{wkrZQVrROOV!1}tMAF9@hnLrXc`@5QZ+}k>C zSnwg^U-g;0dHSXS1+g>$rd6DxCss(E>y}Lp=y^71LvHpGAjff938RIY>2zxYfzAJD zwq|@{E-n_zhP0|L7cO4#D<+0R&7tpqc||pP8t+$MG+VX~)^HGvzzD+bX)YCTWjfSx zl|CorrR+Yq=KTDp>`Y!zSf42RGm~=$z`GLbl&KL)zf6>q0CXK?qrWya_AD+{nC0JU z>uCsEiDrF*2lYxLu-H;GP?!nmLZD`h8KCc(CNknXjmlCHEKc`^iO;g`vj<;Va#`1O ze+G{PQg1b4)hE1H%Hsa%lWQ0$Hr`u-`U@~-e-#9Pa)xwB0Ax1-OY!xnd`JH{Ha~XG zoHW_Xoa7TgSN!Mb0QC>Axsgtw0xnudN34J$=ARkw`_AWsW7!mfb-3bc@d))dj;Kgo zi&7%D7HBQ|?TxV;Yh$ZWROO(B)?44=!kpnFR>;`h=PKg2t)c&AQAuyr*EW7;=`b|f zNB5m7FPOC*cD>72jIVoxhVl99GZ{|9bfgfHqrbrW|6U}4ZC?#n5~;g~(W4U5)!hzp zjDS1vb~c6QsBucX;^IyzLVF)IXui^7_7|qZTE5sIif;RW>j)ZN`7DBAc%^Dq;ubMP zPO3)#{%#pYvogS1ALf5?=#8;c>QnqTMHx-_SUkrq%jsd`kYJ4rm!a(w7*AAyJyVXm zsQ(2WKKFzOG~P3>_@`(ApL+2O9H+|bFB+U}xqV?Kcugi=%xsKf6*>xy7zl}`fBv$1 z@Ba?TZ$@l8*1G>A*kk_@eqE8IB5OM}pRc``8r|Icp03sA}~OXrVb5s@_|j(z_3j z{rMs4icFbOTxkMpz|PB(kTgMZQlyT@N_UKys8-*vCgR)MVjR_s#?8OschF5CtvAW6pcebASKK1H`_lmF$mB5QyQ;%+9}4&lI%(<-o&1;_+3P zg?zI(bInZ)zYK+6>PKSmx2-!bWy!nDvK?u~^d7|4o##frb$tH#y8mZg(3)3}1&|L7!rEz7ofcv>TWi`<2$4+|3 zVhmr}bLiWq!i)Y#ZC&pLDk(n{h>CH5(PS|Hl?61uy##-D{wP35OFWBo70f~T4a4+Y z!Q1^IzOPdS7m6okO0a*YW&>awG`VP9%~!_(%o7cf-%t5 zbic$%w-Em)j2ZdUMzV>&JT;>pI@0IabM&2N<73wVe2@CEZ1}#J87SulBBG$@dj2H$ zk@(I`XxsL0D}JUt(i(`$f99L2*N;|au)c95pt-!hB2t~u4J9Fg#&www&P8cj?W`-5 zOjn(PDEjsFUfY_!*#0IMIge>S?+=sW0&gcN4YdsT!hif!tw{yW!JqvPl*B7y*_`1{ zcQR+kf7=30LE4=8Dg;!CspG0YoF@M#vhU?>v4&o{%2ggXD4Hpt8Q9N!|ys~CMT2)PWw0E{|N;k|0a z%{a#a?vW7cBmrZITlN&rxraw(?xhtD6R#{bP4d!CtZ`>|nSF)@frZ-s8qm)+jEHY8 zPn^&@x!}Wu4P~8|dRrv@_SS&ga(Uis2dJui;iJ{I(W-IxQ}M<8*S^*4xMpyC=eO)z zi#x%<8iihqyVdOp=!EXF-LpY$+H|}_iJt1OVD>OVeGw^6Wrfp0g2>82DeB z?G`wH%%APKqxZ!muV_uJtELpxthUvH9W&XSr%ehIsw|-f2bams1LY1l=&SFkd?up4 zdV~h2Z|45|H^{kqTo*9F6Jyxa%c9HM&4SW_eq~}Qe&WUV0xGG|djpSoUg$}(fatZS z)Wczx_H7P;ZP-Xl@$sRHEHu&@*!TDLTwv^pSufi@RSvp>%V)5-z{vg?`YZcKAr5F5 z&9+@mcd5kQD}$o-*_E6uM`ig&9Toq=OSk>2yyX1MgUo|=VgC@7#E$<%R6?_f$m-_J z(8h30#0`l^xsjMFF(zU)jcnT-t^?iU0DfIq&AkjHWe^F-nnvzj3Pf;`1iB)>i-)Qh zJfIVAEHJI94duoax`m;fe}~H%W=B#|QQBykdGsl1N_~+{dPC>85t}ZK@;ls&wPGQ2E~{<|7#tbpibn;fP0yQNs6gb$n%n^ z6rx8_#Kig9fvZ;c?D{i86GDT<*p)b73$FJj+L*j+;!k1l`!9dbY!_!dvTsbFUzUZz z@xWZXkTU!Cq0yfyXi^{w6luDY#2RnQ2q1(*>r@maMsRL|bBhif-DivcwzGY&W;j{1)=NNQkq}Y)p11C4lB;y9;wr${-NNWreDQm; zX;I;~`jFh z+bd@*8+J=i*qup6wCMKA?ZC#Q&Lpt0`s|&EY=rv9LvqeIZ0Qx6<6BuNr&P-MW=u4F za*8voMiwn!C6Y>ZCAN~)B&rou@Vw%B; z7!QDs)?M;n7jg63k1xwV4G1U}0(w)7u^Uc*-VX%#W84D#Nt7#ICQX++lP8)^e!vG+ zwmd89$N}EBC!YrHWmFS)xuW9C)*9O$zOR;)hBG>fWpb>!j+%GC5kXi@gg=^^5hC|O zo$Wc7=-QkparGgot=xJE?;FeNO3b|o|4i1zZOZ((z&c4*Fi#ll;m87=-g>c(DLg;Ge>(eYlHRJn5!kH) z0__2?Y+2=E3(7f>`iV87d1mK*f^!JFh0t~k*s$AF+ zC$@R}geI8MuD`5p5mzo>IgqJAYBxWV(qg(iCn`#5p!!Tb_6n23(ql@X(&3FZ#WNCI zr=6-YxmARDMyfsdYqJpSkeU-)bq6J|i(<3u%~BT@^rJDra72r=wF#6rYl%J^&Dy?e3$2PTfFxjJ3mCLpeXzA4dd7gi_W`U&Wtj^-l;uft*A@*f zUO(g!@H|j!)b5K1c_}|pR=wWXUvAkmQ>w+XSl@nsY6wdf+ zjV=(H!6n!Bao1jdTIh?;j^lK6`W`wd#%D%~dZ%5kBQu@IWHd1HL@uPT1Qes8c3HKB z`)W_J(teDS*@EU%!e3aakRH~B$6^K6(SSNcf@{pbdJS<%%Y%_hfbQ8F<9A+68n6R~ zVz>7e_sjzx_;8~0B;!x4z(07|0r!CQOZ|?MzLtoh#r7Tc?3sFxKBYOSxfrxXghgeja01b2 zZAbdcF_YzO%RcNdJQcA#N;6c*OT4S)s3w8T0!2(TA;#t%ssh?&C*hnSV7#)gT@q?< zo@q^?xhj{JJMw;5m9ig6@)`TQ-r{Av9G!qcLo-*}{c2iL_LiClBUa<9oo4mP zr6DQ?gYg*PJQ#Iii@Wu+J9wSXZA@=2y)McV1MArbQDkhndrBJed4Ip~c7uaU&`$wj zSMhX3E3>hYpF1aEdtckrr3{j!Uvk$tJLj-z0XWzMNn>D3U5lO@Hy-9KlbVh7C|2$i z6Pjxty`j#vD?KiV)DgK>exliZ3(qrqX@uIFJi@LF5A(*`)fLH(_RXxP-hq5%4`Q#9iQRc61YG7#$=#i`e-ZYza*SFaJ)A~;!62t^sC zvlORIf=9hd=C()+G5zm#p7O9>6*o6}&S)k2t)mh>Y2@WYIrK_%E_d-S#p$k7BE&wT zS3_ClZrH zP!+#bGfig7@Hj3~JQ#;DoKS%9iP7S3Ue zcIXp>RHAaGNI7@*l7v3Fz2_nyMFf!EcL}i9mQ8-T*GDWS zX$%nLT#skEj0@mNA%`-uE^~0K&g-7x7nN~pH0Qn2?AzWO z+v$(qve+yU^f%R>UWhEs9xg3BWHVJTO0}gNt#v2Fj;CV)vKpsG{;k*#TABL7AKJ-P3GXkyY0Es1tAwWUqC1d1CWukr~)D7AF^ORkC`*uM!9^k(;9mFkQ~2Ug2XZ2J2(50L zboeoFH3r}!it@2k#>zoZeN^e~QpHYxm;Fh_cC zxBMsrd^OZDQG2-`+ParKIwgHY-3Hfjmwnn;4QX8QwzE;V)mkVK9nOZzLEvq?%B(Nc zp9sak4ReQrIz`EO@FMa`hBW;A{q~gag7FV;hWv1ZpGyvOD<`EchQ;Tn2>XCto8KRh z046^mNi0>BxL(@Htqo3cts^)KnwuyNKrK4ua9`uE81IRe!Oml=Ux7tOn-cY z{@o?XtuMM4odS}zVQ8$T_Gwz3Gwr;!VCqwxGur+wL1dZWmm?R?^W#CbGGb-LnxIX9|_djoe z?4-*j@K47CcVjsdWKYB$5YyAQGSRru_+yZ-8+F7TkhKwc2}Gjv`=s=QVF2#O19&xL zdnox0%?Ugd#mSj^KQtYlpyJCfc#?oCS*{MPRmBVtaf$+PV{%V~?`PTvhh!G!!gms% zyrgjac`${CTi%2{8MS90V9p4K)UqN=SHh4hDn8l)()@01otFzr9V-z(-TY4Xc8O4< ztVArTYr+n0EMRc;s4}lyv(Osbts4<)_Jkhockhmx&y2~z#~Cte_yhGZfPj60o8Kr2 zBU7&3#Z>r}EDx^w)ge)>{dw!x+z~!-Z zhJ$3fe>@n-l)gPnm;Ecj>apPM$FG4Ezg}?(Y1$QJ%2w~R4c5*D0Tb{u%`lbDkgZi(ojOfPaYSMSQAQ@cTTeRaxZ9Fbhiivw zbh3v^q5ZAOH{4kw6>l8%Q59*$rpayg*N5B9Is;Spp@N<64@Sf7(^nMa{f;>cRUxcM zy`(~Hy+9Q13cA(-Q$tSw-!%Kb4J2TDIzj0E9T4Q&(W*2?Y(8gQ%fDyjv2n|l&TY{W z435^9enMR@tX!slrI;2@z2N=ZsQeccpxF^@#3n}{9YTY}7U`n3{zUvPx00zdMODu_n zAzHu)9_}v1xK8CK?x(aP-lxKq^}$iE+VW-rkjlWNgT^68cS_Zvq97urCj;cOuNYI#I!~GTWdetqgzQ3M=y*#?{2*)5y4{?R3 z$AXz~EaV0?r<={IE~}A5`aSMoxKT?s)JU6cduNU73J;LfmY5y$GBW{Z_^d7qukQZ& zg0YmF!1cnQBV!oBi0A-ed72t9ad_{Kie@JMx>JJ-ds3kG|6?^^e^@ z9tmx>SX00G=5OU0+kg%2w`xh0nwY(GpqoFjn1opHph|@XTZ714^KUttJpfzye&io){z@jme#EhA=OG) zH|64OTD%xuo;)l_py2N(D*tEwD%d8px{eGlQsSdO_X>Ys%0ZM17^BLG zmWA?m$nzuV!u;4K9-wF1{?GS5?E*x7w5!UCfUvHOS{E@PkK#C_eNiI=jzpJU^yW>+&(i`;D9_t_lJBjF~dNd-DUjOje$w3w4j74tXVNuF9_v%RqvPc5GopB%yWa(emN-Y;^D=ql<=$b!@k;+ zP6h?E7G@!~Go)ryD+O2x(`g&~L!7%WWFn7>DIu|N`*9s69;YoyQ8gz54o{gmj=_W| z5k-i6dKFi9`#M4tK@TCi3}g5233x8;@-Ci;G_FiYXgsyX{v5Onwmwp&|1-0H)s`I< zuqM(vijBCRbh^RxKRmlu^`8)H#QP2m{Ns9)RDyEanyNhzH|cH_C}+1QJT*$PD)JLw zz2y*xD)0}mdQhnXKcIMZ%ny)^L=ln{X}%(p66N%5qu=;0HjPEM*o5sm0ZSXy-w^Yg zJhV=>(WR%R=sHK+h>FX3kOM~J;so+(!@F0%%_m(MZgOd}gG}d-u7U2$TX5w)m_pnf zQ+Ac-Dgb;2bN>|dzHN!HWHjcWG=(&eBc%8Kpbw6Wx4<*LHpL1Sy=BD@PLI?j%<-Hz z3AG=c|7bTtcpEs-#X=AmfmUr$dfbaz?wYoxQp#2m*NI|qUfYKN#n&*EFHG0A<969H zPwD$eE@4u%&wZZ?XETwb>5>+n?n7&GNt}Bc);Bj)kCkOf`*lhB zL&^({ou%4iuon_$fETKN#d5N3=95loLS_1JcCUAn^96^-9G!-DfW_~ogvUV7_wl5j z#e@QU5-{J*Ua{vRN{|NifPU;YR99RF{wdO0k z>KLri2-APtRf;8GY`U80p1zGf>Ab%GjvKV=YEZH34!Cy7`ug_(xoT)+XI&m9{(>MC zZ9XoQgxydO#MQ-~E0rVFA}fH>W;ed}IZD-Qa(uNV#@$82A&Gm~DP}c7Jtn_afwJ$o z@v@N1>Y;M>c_K5pV9%Be3pV>G`H=(MF%|W$^&9n{o)mG02VtJ74*d+#Od2y-`bPhu z?EheGspz+|+sl9EuR-*NWD#i8zV$v2gpu+RL6YT4FDCkk0E+|=EI2JqB0j*npcMfj%ynSlbl5%$#V(%zDC^gJ{Uf#QL7pWfoisQyxrtM%C zSHVkAQkf_9<&kBUN2U^VL~bVSbDQ4P5PjW>BQv0eQt2Ss#W$d0h*Q=UThcEYBj(l%~3KpJfIpiui) zhTn3!TN^z&6{wvuP>JrLNE>kO;R68_=ztCaYuolVGyOdtsiX1pAeXY1VaPU+kASDz zoJ8wL_?yOlcX<*b!1buqkA7{F)HnHo)7?!&!(olN6_+V_iC()hxNz(TX%DlVYKl+I z2@7H0Bq~{@?yzYzY1DiCur4Vji3s|vfuIvJU2>VaeH>${(6LWJaSlG1E=HDOuj|qx z85`bibBcXIqYX7LzFBN6EYN=l4{Ajx>}GaUaf0R+`dswl0h5VdAuIHRaK&n+P7)*v zoxNPPy~l@RJL;=6Noh7vhWvW*H!eq<)Q{UzJG4QXs_%d3%*B*@eh&f;lYCo$q*dLJ znUnl+t$w>R);q|7zptfn1k0t2*BCwrZ?lgW;#nZh!8;GXuv18)UrPSCV)Hl>d zz$2vjtxoPi`LUU;d>5~W*N7%77F;qO4;#o=oBt4awgc_eb4^NWZlY%&Ho_t)`#U>Y9su&l=vg*x`iafpN zf-F&a>5M!HA~52t9~eMg_}dAO(PawpqR7Bp#-N0#fK4GPp_gE?C3nla_x;sfBsq>r zx(#oU{8&e#e7nCgnIBgU2J>9zM;BX1Uz2`lFrsr!O}r|5M8GWeSF$*-LY@Z0AF?tN zD9^4V4ijZ!0ceQ9T>>VJ9+uI-CI8PK1SaO&;R$}i%SWBOCcKL3UUa#l;+#d@rm6vM z%rn=9{HfO6bg~_BM;jKk%d!00l~-tDg}>g<_2f)!^Z>DdQw^qYx}R=;j(z~-0fuRB?-hWg)^ z*zcrI8@zH}DKezgpD&;H0o6+t7W9YX8okwo)s@C&OC=~OjphLGWgc5qKLQHs&$&S7HM_nBM6fMdEQq$kr$W?jOFsqC{|Fd_eE< zct#TOX#qW|P%Dt)i*t-z@ikugeEjFV*jcn^u6W#i43x)jhs_nkj7n?Ga}8H}J?|va z*wBRkMHM}oNatXou+kK6<#;Ew)|33Mqg_3K>77a{)1WRNVngis9t?4Y?!u-2ynAr`oXz)8M;jZ+A_8 zpYYR^FjUjY0^~*Z+x&wXg?jzKnRX{Z6s{QdqL3}z%I^Bc$^q9*kUOh-bzgE#gpnA) z?emIEC-1oa-APlI?czr>gJi*Ni)&l*xZ($HmQ_7+6GLIIDwPno3Qka3a$6LSC-H6J z#f=tUqINx|Ug!9cp1~ervBQ1EodyOYk`yRWPa<^G!uz&hZ+sHSr)SKTOWdnHZ$z|h z;R&+==k@^0rJi6S_=QBSFh_XI021kL=9@V*Z)y4+-f%W89)`Cc-ptVN)jC+8(V@DT zLi{vnZDhuNr??Th`xBe#nc}EehZ@{IJyJFu(fH(ru4Jbh6qb7(*Gx<_%eE~%xI=`0 zIk6pM#gEl}T8S~-h_EkYV%aDfr&BZ>WTD*5wj^ZUKd-rYkkLWT<@1}3bw|kcz4}1X z^K}2|F0~(pMNFcZ;j`qvX>m@B1%f&BMuWYJAEp_8|f5pJAnkwRZW+4Mw&#ewkNlGi(l{0Oyi`o5KxL(og3PMQ;Deh zk>fLp8SpRMj)T)0f0YYVu&5=&!Nw6dFBVZ&Uac?kW~FA8MFu4hNCz;J!XWwjwxr3I zz)|j>%x~Gb?mnP$ydahvk=0lU-0N=ndi{96_Qz7kvV{qIl_V=70=axAYH!@v6RG%- z-v+~}kMn%Jg~@bch+AKf;+Y&u+=?f{ZTM{ag2{O>5yGP*R7cnh1jYFdhP3(Ov+Ua0 z5_h}Ik^gC{Q_88IW51@PW&i1_*J8FiW&pFF?&IO*M>pNQ=i?(d}eYd1LQ`HyLP_C=mh{0O{%Ol6IQQ6N^7 zt?QK$-0l8ks{Nw|h&O67h3c9g&~-Z;=hn-#G6(;mNPg<79mVbxW+8#dI)hj&TR< za~=!B@%#h5y~9zA7pcG~D?t(|dE>hDB`W$D`nntriF6kp2W#03=1s6bVvMG#Iwp$Q zY!N8UVn#En9o)KTNx6c#!NIotj6oPoq>_>Kx*K7nZ8y1sY7G~dFk(y7LaS}VXQF9m z0LMNhjY8N0MbQeTA{nj<=5UQNj zt~YUU_1sdB-xL3aO|kOE;elJ53EM^;f*UE(^=a0=+cBf%Lno>~TYg0v9{?8=hbk?) z{RM<00w2}-`3EjIudU6{sEJ!55|Wh9PAk)>QQ89q*+i&xcTvmBAr?NRN1iYM{O+|* zOrY-eRxhhB+3ANPUS{YZ{jyx~Xe3MpwOk-TUN{55u%Z%e;pkX^rRrQ^C`m-H=*D^9 z8pE4`@r6Vfa_<+MjXvJ$kt&9kcD_N3SLpnt`y#iFJ48?nnmT8Q@r|Jh*K=^)en)?} zZA5?IALL)plv`V@sq}b22(xU)mbXc+KVcHP~kS-J4oz*aGZr>Eo0BL9R!1y71^bNQ6-j3i1sHqKXvP`7;^u;A zwdu^YYS7!jI=GA;;rgJ|huP)*tRSPqMej`Oy^7l^}E*vsd&p^NMxgPybp;`{pU8Il+sjT?m> zE^p3vj89nHI&Fs{wYkDNo5vq?ALX}tKAy=Kq$0Di09HuK?H9;530@r>t0xzR7uhx=-b1iSYfqq3PSZXrfULEAm7`ePAJ z9r%}*4w?5*=Oq3Gt7p!?AL%n*xN^2TRE7r1s@O1h<3Fg&$pKndXG0@w;JJ!5Q;2Ho zq#a9Zs?NS`a`n>CgE(oh>*#l^=(flgByBkLk$bQzvDWTOxw*z$Q3Ryj;z$VWtS%SQ zmJIiLAs0-T`WT|ArHIKcuVN%k0BnD3=@msm@@i0Q1#%FzXR2TzR;P0w#3$IA*iux#1rKO_n;jrEoL~}94 zb&*KCC0ClZv_vb987ThI(P-d1xw(2e)NypyFp#FdmwV+2Nfiebli|wO2H|NCAo>0 zIpF?U(^Hk?fqgL3B>lZSE+AS6V|jA+!@Je@2qbbsDr!J2y>D=DL^h&r^dB|~P_}h_EAIs{u!*uXsFBK zhY^0~$-SI_o$?E?$rCn3iw&h~8~3`ak5<2f%ur3y4VM40>B(-v{Kt3IA|l(T!P0E! z=H1*Je%~5$}X!JJ8D@thN3fl$7%U2lfYO)9Q24u6&jzAt7YT zpET4saLlj|3a0JydhB}t0VST{2h;t;wUCJ8)w;BRVrc^*PRHF}fG}iWDC0_tcT^y= zb86eys}+K3do<$f#q;)2Xe&#T1Fk&@deeY(;&%+d?o_}pCzR#c#EFc?a#M_((?cc& zFWwtvI#R}w*G%~5mOMdn)F-46t8~G4E8jilS-kor8a#m=Z2&*@0u=OWDxbn@p4!M?3f;@GNDvTMtMU*u;}5g->Wh z(O{oXfXDJHZ3k^?@U%Qkoa0+yo!3GjAQYWLGM* zVp#yDSaZ~OjDRb#`rG;l82Cub6Gp@G83 z{QIvHg!KNPjzE7|w0~QvO;4yW2IC~ni){Zee?JF7xa*U0BQnb)zov`+{`Ug)SS}S@ zI-(Esoa<;`Kj2!N|FTFz;)4uQ^S2tm$~HzXd;=4QL?P9i9La;{UHb7gP1EzaN!6qD z2wr(v-IKfJ2I&^xWFIsTPboFP2P@G>o~jfZP=gf6F#h$H1qOWHjR6#V)m>KBIH%_tNUn&G{5;Gz;zT=}c41*KqV2$1i|wJW6VVuP z^TxcAXifWF)keuM+Q*vmqVk0g4|PH2agF!r{v*A`f37M-i-y40-fIMoD@_i%=P^A( z6szI99F7{$=dqoEqyHR=Htt9Nva^2mr1MPlk*QU;)(t(D(nN~ z0dcN1|721--;x(a0%m%}@Nt-jM z1C9li5q#euH4Aw{tcoEudbqoZ?7msb(S1!81Y@WRxs(U|g<$9V*4YL4>{hc_SpPN< zt(M-I!vbRx#GIQCI!Msqop-ep9}DB=WioT3?S-nfBhz6obZJdvm58QMOF2!3n~py# zSH{AOwVCFOeDqPTwm0~2*f(ss(UU8p70MeU2s!r#cTOJH9?&TnxsF0rv6^^!+-r!I{C}%Fh@lQJs8#dNM?eT5z z^o@?uNS*cp~^RAk^F*Xm+Hr0j;vC%$7;FwT&&G$ zf=>AIf2#N_7HZJtk-ZutJJ&Vs2$NjwSw;zViJ)oiiW4+98=m&vWRRSE(*`z)EoIeU z8=z1kzta4oQNh3Y( z{RQ8cNUeobtd-wELAZiO&#H`Kb*0;rC>CbSf?AOpdc zT$*w3e9>0s3fPO}|1O(WD-yUV{lad3x)}p zu2oLNqv~3k29OK6px(pP`_$Za%+8;O_(sCXKWDFdRN1-#3(_{>XB4wr4-Dl&&FL zw)kFE7+$-X+=x5)+v%N_c0ivr;1EUx>IlpKT2%}?=Eu~_ISv0^%2lLsXHZ^y*|yNW zG9Zg8a#;i=!Jl{_Cq(oVl96E$NQyO;n&jGK?{AV5!ow5Kx{{grQyO3=ea};W9?q!} z&{=EJc8)O0R^h(*f=2R`5lZ}^b)N#lL;zNO=<@1&fxV<+Yi;<1JigT_L18aJ)NN?^ zYmIA@C$#Z$Y0Sw!*OF{367 zv!=IZ6bh##KJ`Vt@itL^vXhRU|WodYy^X>d7$v?oc}{YpkKz z^6Fl=1b+Z=w})%imaMuY?Xb!0g$!BiDc^ak~7nr z7xd57WJn6C-@|WRQN^(b`zAAR(=^q#%NHcekRV(%oHB(p}PB(%rG??vzbSBi-H2=G+^f=l#AXe>fNa0N1+K zz4n}+ImVc|p2M0+`hK`Jo?J{U5wDhbyJuF zT}UI7J+e|R#NSZ})+%$47#;ujBGvp~E|S~!osepycIveCVgaW-nu4IJdCMOv!?41) z?-q>H<63^*(gx9nJDFJ|Jc!6CCC}VqnZFC+=SKUNC?M zJvmdqA9O+&sEW8D;Vz`Y!MX-bp}Z#v*Q#im6(7FaR6bCHZsodX1I0x3-{LZYwK`lm(Y~$i&)mv@_R&Hw@d-XYC2D<`fG~1PK zpT%*QN(>c7rZ8Y+$^?o)K`1h78|AyKvLOp&Q}<~0fK&`3@30m`F15qtHo$0iD<{3Y zz9PV12CyjvJ#!vZ4h!+qd*{U~WTYh|l)>x?*Ji^RZ_)))Y8(R*HBOG)oxx&p!@hElUKmLzi>>rzA+Ye-U z5{wmRgmJQ3fVp`XnlNoHFT!t2&53Sb;6|C1t~1OWZ}EdJD{m^AZ>BQ>hpx_lXdp@b zBxTkuZ@uoA;7cbn77FS*Rrd%cX9Yv{iLeZAf~#E^IYylyu_qL;oZEw7dST6 zSo`^ddeWVgde(p86f|b(PMFG2n}#G^%z1-c(c9>r;Y`fpyKAlX$obD*aw-|y3@XSo zw3OHXm4<1$O#eq3R_XU~Buy}mV$l$yP4M*+u5F@ZtA6xpT5;9sY;0vLT{Lv{0Bqdd zLk1N)g8ZgtuDd8R4HDxhQ6&T)sy@#a+TxaqDcn~2Yu{F0@l_Pi#}~fx|9cE4MG`HZ ztql!|W8HljvKq8d!f0nIs#ivf z@`L7O^qHfwHP8%FYtm!`<`a zR=Hyafy}S@K~`2)=S*ul>f1!0wp#0!F!u? zddU%;Rmv0}b^O{V6C>(H7SJ=b+_ z7Z+dn4&S0u@l%nNBNOFoU`eJg^J6?BnpPG;>pj+lALHYOf3sFVe)1m3)0`P+g1*W~F+8w)ov^O$3E!_^wb2dP>pOChE1CCdq`RtnGEGstnhr^j!?#PuYdM+E~)CTr!}BWS^2(?G<_o8Cn;G^ZTI>m zR*Kbx353&!M!TO!L#A|(Hk(ZIBUxIqF%U&pvBM6JG09qH=9N$Jl}bN&ApSoI?cKOj2( zMs%tQFofoWG~Z|6O~{?ef(E+Y^#QfOyDDM#C1WHP%LX}(itz5%BNduONc)JP&eVPS z;4mwj5WL9JpSg5k$k1*6d1A6zxxHu5I)X~?dnqf-5p$L8%r4QEJ#3+~RbMZ4g0yIZY9hcS$rZNGtCMw=4NHpkz|bdJafFJG)Gx7(~0#-{C-Z& z#xHu^lba&-(U_Bpr_N=@P0sp1oeS(C$4Yk>f{)}L*x`3=weZ6i;;sn)lsa#6vR(hj zn+*`!LEw}3>$aCZUF|E1(ChUYux=|lfDEg>Kw;}w}6`S!%)j_|eS7pGR* z9bHiRqwTdf9J-xgm+aB3Fq#ltr{ZfA;hlBSgc3KF2DvzeRh}MUNR5Ok_Fx~V6^=iGEY=otiaU*=(|0^UU^Am)mX0!!rtg)h6e6KX9>567_Y^ zBlMQV?`hwjgr%=$o^h??;+%Zb^~W&ki?`DKEnSDjho*mv9K(ugJvu{A_I_7Ez|FM# zw$be;a$Chl)oOy($x>Xo7-WDDY>R$5BAH}ll%fBt(<1q!$gV6nwLjcOXP)d8(aMk` zC^Bp!oVoRQWFd_!eCOfBcv%>_CR_%EWxQ6Pkvi;vu%z{H4*%IacjP?zC{CaA!k)HW z^yVN((CC@LRh5Liron~un5R~c<8a~8?!$yb^B||?pQy1mN%Fk3qeho16_h>A<6`SS zBnzNet5rUqRYmK3D5QP`t$1WT!wpdm|GMMti}FRw`#!ev-0uzpIxmE#d%VdjI%oys zi@>5hhxKON;Hh^Pxiqo`Z{TrM0`x)<&w$~ezjwIn{&9JGA_4kJ2f$@#GUSKWtOim405mDp0Sv=S| z^XTCd>vkYo;033&%?w`xSvYt)_H3DIFT3xB)1~k4DNpYC@o;HHL1A##gY0N>sQ5(dMua28a&aO<{?1i~ux*Q%kyEG!FeWK-THM@OdolPTQ<`{nV zV?wrN=8`=3Z&(Udclq~h?fcZ~A$SRC52U;qXIVqO`L*F(qo>PQui{=EBZ<8VVRxD& z|L`pJ(SSPH;nYfsVofkAJF^TRxkA3jJE20umjr`T(TE>(52+D22Z{QL-t0?E`edQTu zY-e<5bO?Su@yh2bm<1;g$&Mr#&vnpj>XqbPzT)Igb1g1`)&T#=31^gyK32nPDHEcI zjj1b(W@X@&OAY27K^M4%NzIGZoW9@#5{Pv`6#PZ)?LLe*yBbiCgTA9_wy4b-M8rPm zbC|Ch!T8nfKNICIo6}Fc7}@3uSK#Au=^B$AX~KbyKv&5-^6T+zno^XU5a?Xneh`A_ zHfqu$hhmj9BE6K0KcT{Ghnj7yiYd!ILOaSttZ{f~T;yaMx7)4U78L@v*LSICZ|WSB z+ncH_r-s}6vk_-d`|>xppI^-<>{=`SiAQ{#vstaB_c!*+b#AFZ^!{_(@F;Vjx%(n} zaLCFuxW@lTjMaYGpHk%)*pQSRA+4`MI{(~~5hmrIK=(g|lnK39e2zF3V*g@_6vXglGzp1BT z2X$xY6#=R*T+>f#v~h^3^X`Z4Fw)e!mxhICAm(fk^F`LtoT7 z|J{LQnPNY#HbX^%(dgz5A4iBUA=#aUZ>;&15o!D8dZI3)Gjjaxchhib<8ZJmyT73v0tSeJ+ zo?>B)!tJ(ax1OWP%*_$G*l%-LC`tSd=6y zR(i&JWhCmL94z(YTO->2OrNz0yth154ppO^S+~xfu)0wB*qsHLwGe7vYfESZsA5*} zy!q~`tPnK<^~1Jo)DmGDlIcVDV^ zwzaLMa(Mr0)J(Uly;XSsKsT&8bZSFyc76y@pE8@ML^k+~%-QP@Fg0{Q%s3;aFDWb& zn9o#hFu={fk@<}&=bhVJpFuDI%}!@m1pI0Wipd9l_($z-q(V z$^?Dy9IfAdzzPQNvsRCni6?@vrYJXp*0^vU667rYgC;OF3uCIt44c`7hh30qQ zk9V(rc?~KLXN!~D`SwL`e@@vVyr=5oK-T;-D+H&goKaFEws4XYi~qdpw6u)8smE5N z1f|FNF7jNZDQnGl+H^1HvAPXSA7Bi%n*!{|*Z+KJq>bezfaX3F(A>A4ve>|s9YO*K zZpiIcS2a8GH4Eq3;F1@9(2b$`hUYKf)fRb<*IXuDnN2bvgP24(p^@M1!o*G`n1=mB zEF4H_{l6CVz^gGl+X<L+RX7T%s>@u~?2~)%PL8N}nlG0gPCsfi z@*xM~fRYjs6~5QTNs9paV^Q^FXd0^o0xp}$lhsj^s@4^}Oy zR2>^ixGotgo^4$R>+9%f5|yvL=9-Vco?5>aRPT617VQmNndO53xiTZYImSq2j!&lK z@*~L5--e{QT2)~ReK5f8Vet0m9i7)x`)1@IDwytuW z%m1=AW}B9zeZA~0a%PplYW7xu_9)2|L**0cEq5&LWLO4UPDf4AOXSG>fWB340K-|5 zpEE-O*;<0)#wURfwqojZk+Mv13DxU8S)uJ!1NM9B5s2hpjvaC~S{?&zEy)WlYWCXi1z#o;Mhp+RZ|JVVrdn=JNWBRlDXev9 z;WX~{LBgAStxL1r?0qFc#dC9T-gI!TRG+vE0IjB0aU}2L=vkxfj|k~2aJV~~!c1`W z3Z{!eRyU3snOlU0xM){DXLx$!1cNh;o6gfeC#a~xG`J}D>I7}Z;iWt=C4QQ$S0WH;vj%}RzJP+m|NyIuE<^mnpl~|3=OD0gpJQ%z)q1BR+!Oya^25!ZBG~YbrGBl-@Z;!~(I7#)g2EQL(Qe z*G!>8xhB}7mZ7*9QARLlbd_V2lF($HrtOxSi0C^vAqCxlyj+1mr9;Q10F>+&s@DWb z({@5EVW3 zq5aVP4YM^Gso=Lid*Pqs_D9XuP)ZY?JoQzV5zDs#L6@mm_bQx#2k!Y5th=EK z^vil^RuA!Fy&tt_Frq(~LOq_oj;^xz95RvX#crPJM_VHuqh;2A-yxs9_Kg7W9cmIB z(Jun>DxilEA{vzj6(QShNdliD<09@CPSCrBW}Cd+GdO1T=6!NyWdft3*MNJG{$3*H z;#eAs&LicxAFkfm!0ZKqK5mY0(Qc-p9tA2A2=9B1=MHk}vVP}GaekS%$qD%lSX2~M zjrFDQ3QDnF&s$~+gHg5qbh%4#ynmXHgT0BiwmbA@i*0SKSNQ(emmEZB#_zaRYEd=< z_{ZVelUiBu;<@q8cvc4%0HZ?;5U7M@xjT10%0+fc(R^}+`i$*EZyGwfL9}}Q6o9V| z5_o9EI+ShTh{;Zu=L6S7Ev?aA{S2{!1kDF@YY>cn|2GSOg@HLq<>jBkox#>YpC1h2 zLwuX_!1ibhifWRcCcj$sJ*^R7zXOdy86abHK+=#SyO8u)?;(BozE0Kk%Lvw1Uq!+_ zbkNPW;i+9pIkVp#l9FS5nJ47KmX%F#*D?v|hsyF{47tBzFaeB=%eqWf=if(z)YZHQ z#BqYL9r|DKT^DV{>ykA~FuUE5=RH@4=6;T7B%*=_Oe*36c$(vGq+6P1428C@osDX< zS}yhCk>EMD{~vt9@&RLIX02vy=0%75CLggmteHyMn-nJ6e`95pMU8NariQX~z`{am z9n%QiuPPo{Q?cCqq}!l~0%)&P79+8Y`-`y+qHMnQv+#7SeAh|q*arVxsu276n^t1# zBD7?pgtPN={EV_&aM5vS$l>o+dz?2TM50?IJ8|wm`LO@lfUlzH-OU0(cbEi3K>TqcKO!W+O?z3kobnj?g|1+7O^ER>{yG9 z=?Eqnk>nq{hvMa?Xb0JxP5+qk6gMjJoJzuUS0OJ&>g3Kx1AdCD4M5DFtEu$NBg+U^ zej+TC)Cp2P9_S9_T(P+8i(F;5=+DsC+<<&6@jaX#`9*~sg%BSj@~xQXNPqw2VD5hNt}Lv%GLQH<=Mxl*p?IH`;NOKj3Q$(?o> z?Gg6ELtam_KEtE`!Aeq$?_e8+FI9vA^EU$BY26YqmUv~~mv#<2FhEcAh<0pz+R!!OuhQT z;&1gdnX_BofYZy{sP<{@pXorde@@l3B6yA&%peqNrtYcvWM1I*$s7hJj zYs^a_f-%QeXcY0f;+Y@#_Z6cU^tt}h>0Tk%PKEn6>~koSq$ya05kV}Qrx2?5vg&%o z7XvpS_uOru3S;AOc7zDwC-3646U!_dv(@H-X=N8=sd6X>DXZUDo15#^vQ7#IjNzV-7d3IyaP06 z|NKb*Q$V&LoasDtt4+bswW=`ptCZ%04@^{ zD|D3<62u9-@5d`dgyhaSG;2S<#<B?GQB=;@eO;5x-9Z09TV=8?CP^7nVTh)d7*=8|S9p*8vz5N_HSKL1y`h7BA(zwrl zm0&RwcPV+oQQVqQco8T2$g@+AQ`O~x?yojECpp{U9W{(^6mmKKcK9eQ&N1BO>GPI+ zmKP8tX`4=K^2l$BNcXrM*acuzBGL6Twx>2Z>c4HWKmhtNNQ67xfpxUnxZ3Il(Q8uv z!=aFD>eBLhi^X$@kp{;1f1~Mp!LQkf_ zWGc*HAmh<4-3)vu4pGk;NB-k7K>Nr7&?sSA8AeT{(@!5|ABmLUjqpXkBkqp+l9w2d zoaTeFg*;QYF9kOBA__r$E-wL-8Zdwt&`N1F<@;n`!q0rUf02OF%Ma2!tBmSHGA6aH zJzqv-#I`(Nr#c%uFhtPO?e^=SLz(I|CcDJzQ&}rN@l&LELQ;nW46dxcXk@;;m_5Pn z*VyGorKL2!0t3ICf@$vF269Bq+AFhOMq*X`@j2S#4(t9gdPWK|&`4D%U}EV8j_#{TP+FuiBF^|8;`H4L*E-N8mSxHq!)0yv4D!d}KnPE+vlk9e$S)K=Ke=>4|DWY1PIrnQzq_{^IWdM9 z44vh|rWN(E%4V}B$|qq(E)3j&tg0noZhJ0C)YaJRtZGaj$oMLOgutMbkDPP68oP_X zuX{XZL3b_lER7v*dK|-d!b)bB5?`5jDTKJRKt>u|s|4TlJ10S?E{>ila=49U8<*Uj z&4DH%$4vZyhZkco{bLVT#0DThUN`&3j*u<}GYlVGY_y&^zu^J{e$Bh#zV2k$b*n&c zZgplvn0~pL%dc5cNi&!{mje@2P45S|n~SW>2Hvr&Ri6{Emu-`B8lD;1m2Q)d1tVUL zqt6MzVSgDwd}f5Pqa2Y0ok)1dj-RH^Dv5ut8sWJooWWY+$;!U`j;wU*vip@dG(<^E zmy!-8{uTK1quVnIPb8KpZNC!pMO{@wyT+gYupOJTud`B)=XDpk2e1b0T;-4mP?xWg z|07fOK&00hCX7s>{NKq`V>>$ewvIY7SAT#8iUXa1Qjo?yejCqBf{c9skoJwWlcu}u z)%B;N9g02hk)|)ZC6QfUbAxk@f7)J>capbs3Jkrtx;Gqg07Rh#MikCiPo9VZ0|Jnh zHjCWIym}Y8eY&{Y^%#`E=E9&R%O`LvQ4=9*%%74uO ze7(Jw;j6k?NCEmEPUVy6uc6YbFSXxlKZ87&-M4fnZDErT6)4eR_?aPwXH~W(ShD?H zl*6mwrqgnB(+AVU8PEHB?W|_k1V3My*mQpS-|6y+l@m|W;|KE!f{w+_uQ%5ZN1l(R zZ6E!YwsB+hq}0p_yZypf&AbwBng-F>w2+g!3d9^r0qSD3$jKf20DP)e(BLEy1z8%n819`a?LKw0~8pp8eM@ zgf^9BpVa90w(wVU3K!-VI|vpl&xIe*(;RHRZ6bBNRpCPsA^RdPLeVYqzETn^Z>Il5 z)eO555LRV>1tY#V)qUPhxR5dpFR(wx@H4H8lkqAyq6JYkeCUisfGSgafEoo#w(ZQ01@Zi@iC)G=Q zXg>m&Lvx?)1IHEej~Sl4ICpk1iBf(krIw%916l7q%K!WVE&{Jr#@+C4lu$Ti$bCz9 zb?6^wSZwyFA{@Kw@x0$?o5q{ty5%qk-A|XOEbV&60Cfe~P zqH^kf8I!>Vzn4{h$ZAl`^zwn_L%)hhh(Bm1&+^p-4QSYm%@O>M63j^kQRR*F#u;$2b8nECN7R zr9QYEmkN1=>W{U=c0DByvnAV`vTjqGlNQ>iGpsBXWuen2*vXc%ZsxZ4X{F22a!=?= z_<=(hepv$oP#O7tn9KK0F%9OH0?Pb_`0kcRF85_4G^lqlxk?}kQjv3Cd9Z&}_}uSTaSRWB z&^FooCH9$T?U7pznwz!PNG6QnWM^l00iZ1R`0T0Us3Nw)pUx?}c#HPm<;LK66}=>? z@9Wt{-$^EZAhG+^Y8c&BkdT@{vAWsk;^$uq?p^Yll;Oz@`+lmeDkEOtg3J#q5hd1_ zixrtOCf2QZdOT~NbxAoZ2SNmjVcykR?*?s5nO#KjZ{o16pLagxIsuF9 z%Z_E^!OjZPL}7#^j)w7U(_xi4=Lsf;azyeM){ys(vZ@n%ijR4%CAdX+F`0Kf-u-fy z0YpXuI?G5+Zmi}C1)WM?9(tR-HJHIZ5xjZf)LYF`y3ZH#-FQ}!pY71=vzI0gKK^WD z`YdQHa??@ewj)dM97N8@ML3K@SxM3%B`SR|oEQCttvi~m1+2?w%xDeHcl!2no9M!$}hXRA;=5ItCo zE7T~tKOyb->C9)C8=;I|TIw2GC_L0tPg@De2&1KBdM_c%opcEXwNS>G<^vUR~}H zDTBI$%%iq8vVNNg&Xyay6?meX>*9v%bSWf?Jfl+AwAyC(IERt2y_Y^;>5$^7A@9Hy zo@Cn3WInP!I=IAqLf*EATO8lHf1myyHV$KVeocqY6^*4bALc+RJP3AszFf6MkGS+R zJWM-7k@O`Gy+2p=1wqYsWl2yH>en59T4XIKdCD~!1bNsICCT09M&gY@NCUC z3k^?SXq20kBmH$O!CF~s)lYLu0CYFv%vUw@At~B$+l;UH4g*hdQV%y1&w7d6$#-*d zq94|NBbVX_!xFqCDRtkO4^?J!`z5@c_3RbX)P?l_q0G~TZ|@PQ+&@6lIXm(yevlO= z#5=4AH0f$+=YK3L{_Gg=r-U#l{d*^wa4;V6^DaI=*NZu!sY>_)^T9}qHaBz%=<;e>%`BDyT(6T_GM2$6Kip^^BkMb@}{K8$JEw+x>Uk9_h$?$4j6NPRN<;`FqUO= z{wLL|JrYRK!x@?m5llsky|EE+#c_K1FdCXQKs!?4e*A%iB@O!_!Q%CmgcgV}N+_hdGduy<~| z2^2o9JKUot@J}XtL zY&-DXJEV@9DT!D25qG{%k$yTFC(@s*Wf&7TqxZOdlQFl5prdbGjofuy?gv_DGt2N< zF5M#edjmpvpl&S&o?E?WjVxw_F){)1fpGY+F+;%=Lj zCl)Fr$Gjxj#)CMiSG+MLiM_?Hwazi3mxanR*$$CP+O5maWQ}UdtlR#&GgS09KjPCn@%6Sl z^zDV|xOy`{xgT~LvT#TIO|P+9&yOmUB`ZT`?Yj=3-?MAhbeQ<>%D!;eNTx2W?YemV z&^&J>ZIt~nZW}dd3k+K5G9#>6lc)Qxeht(Af(@hVfit@O-r#{EcZ(uoA7V9cb+`Xl zeLRF|Z<`}&6?X;?dBTSm{Q zK-a9}&3pz|nX3sNqaHe5l?`btyrKK-qG8@;F*x-bg-%WzDp*&A(H}_iuLB$63$T0; zeKz<(J|~K%8IznXhs|G-))t^4v-0~_5*&xG(Cv`99)i`_aFvc zi3Oc$4YL7+QIBu@;A85TP)G}{hQ>gYh{K08FSHh&+$5w<#rx}bi`&LMvKj+kLm_d+ zjb1PIsBU48dICOz2%jNvN8KdLmvi^3xZIaq?b}V5BS`X91^njLj zJw&P5&S*h_fURTh?buLu52Ca>=+F`0DBUSGD~W4aJP?21Ef1ULza`re04~=}<8blQ zq7tW5`GCJbDKTu>vaPiZw@8jvw5uuJ`A00Jjo^7ro%~9o4$1G`(PkzE=RRVu2 z4DIT8JT#u`Nu6+UaBryaz<+dDQygpWo39z-x*3v=84G4-!i7ayWe_#7gy@9!T%~M; zKr?SHq8Neu)vqqB=dkoz*e~KP+<8^g3RYe%Oj|LZ0`_Qz{oODpZV;7gb}o4? z;_y`1VwoDhdR0JpOyd{)@%Ic)hcy~iIpepjY;rn~uEiF;xg4C8gwuM_1g2Z_$I1j% zq#Tn~%96uG)Ns>l+~*l8jL=n9jK^^?@IA~&=)b$f9#q-hb{16uk3B5IR^cZ)S{SR% zLsoo^(zoS#zefH5ED;)=BRk%zk9_L8&%{gzEjwA|&W=2;nyeor>EzNU9YH2r)}^-D z=EeaF6m$2va;(STN~Tt{p3dp<_zo!GnxX~+V1(Sq=2J{kj!?qdbSBj7H1!%9p$ z5?5#w^MEA|c4u)Gdd@+n;C}^Kj*)2yGSh^1bz57+f}02+<5ipCDrfhU^1TMFxV@pM z6G6WSsJl($#rYL^&!~eO^kEQetL#X_|?6u$S? zhS!PB*RU8CrkO7o-gx))rm@|HSX(CwS?@e4$Yxp$o9ubKlz7k z@PcsGRy-!@z9{zZpR*5f6-8rlWIQHg+4H7(I_qW@Zas#}#|vipz>tr%%?$r7CB74KKQFyJsZ?m1aun zTmaPi3NEp2Qrfr`LC0YC>r3En#WL^BYW=DGO!{J5{F;aIFvvLxD2=}|pE)$qn?0P+ zy{f1yhBCg&HT&)2o~gO6lhOL*E<}-kZ8*T~y3mea%Q4wxh=p9{WE0Kw`Per@B!iVe zf+q^lYhk;veu=gi^L@u<>lXjY&%%)W6)h*xsjh0}pXE(~cPqLPPkJr=PlN8au?;W^ zHqk%+V!{?qS$SlaALR4^4*4CL^-2}rqcl}DT?3ND$? z6^mYx9*AGpA0^T(0?+Hz=%D+-CFK#hcTW6hQ%hLgE&D=3VXwt)d9FVi<3ske;uej% zn&9)qwTwZ#(%lDQ4i5;sPsREh+QiIfa_g%a_5DhkZ$9i2>G%FG{g!fhif9Pq&`Jyx zC$Xm$*kkaBPp`I}hqWrl55#Ag>-pi=?zC5+x*oG2qw9F3X%?ib6=%5B-u*iBwJuw;UD5$@Q}5mbQ9K#(zHr3GO^8qc7J6(8AK z1!=_9{u*NsF!5?P3}0y{37mR;)laD~M<*kyFJ}`3zOZg$Rfeb~3!~A1 z5fJu%JCS06XKTCb-u4~MqC$mH*sRb;w!7;JwJsjntN*5u%OM$^-8yLvIs?KRb_A?+ z-~l5S+LCr5agVrbvyD$RWilC95FKZ4u>S4bFeYg{(OP;p@a4;+;@@4%lGA@!Y*b=G z1^jzag_9Y;V%(9>n9iC@s%cBQHB4pA=cVO*?k5SUEgA%yvz*)$f#4a&w98i z3o61A_*l+R(~fP{2%9~?G=MoPHmuL)7c5WFp`x+yEV7pq{ar5K^Q^({;{lgz z+7vdG`{nW-jK|FcNKkc478WUi{I$AEH+A;LpPRqEuaa7*J+}?+3vJGJdyDKma)^Ku zp2}T!${h{uvq1wX2S%cvWSdMP1OfNu*&}I#XZnLBe7<@6^~zk zkN6p;uQ8kb%B5H4amPN$pHteQ?oBRFWMLn9qT6kLtb2@~mB4}T_U9#Gg>lBcDwvxa4#sw_Yy4OCh2yU2Fu zw{KffBGVw^mMN}p91Zc=jLQQM{}z6n^n71^9BF+gtniEZ!on1P>(ykRsp4fge7Z}! zNF5=XL*IbGm=g;(R5m%iKIlm@y@<8}XmS4KUQ5svAN;ZV7*OUFcua>E(vNQqz5>AlStkCQO<)?0EcSKx`- zs%iG4C*s^{*CFrh^InnLMjLD|$t1Y+X_2l6bg+bVx2%hZ*h^@~@mA~sw`Gkl@QSZ@ zpqO=JPzwE26v1@xSG%1RaQXGHZmR4X-%nv1RnH3TtZHL{1(#Ai74(&O%=Ue{q^C8| zRqA=A`cvsL4V}5sj!&U7U&_BxqaNNPc_|eT8|FK=j1gRZNO0Iiza1?Uk_g30JzExB zM1>IDI%zju8A59T&FGyiFdkv5bYbWGG{&hbF1v-sD`4$@lqy-RMjHZ*P@Zqj=YB>9 zU1UV(hv>nTHTz`Aht%^1zImG@(p&f0N!@MMOOk1aIyi-QO$++kjMUH1Ns&Mv=Ds%HC~tj+G((=>%N0M*tR2>(6%9&8e&%!wo%4qJ5NHvp&3|b zbEOI_XP1|3Vx8qE=f3nAw#|c=_eL&lcMIJW9ekkZSabuD6f42G1QQ9b*_HXFBNE+A zVk6Y~EOs^%*HT+lKSZ%Cc2OGu$y?qI z-?0$XV}(5|OYVu4pZn&h4`&S^^P-6&KI)Mb38N_>UslQ$wBN)wbEVJOnh z{8-sBzLnPU@c_Y4W)Ul;^H_AfKJV1D0p*Q9gW*vGsWK)TGDA>sM5ozI zZ(CUeNJ3C}R(&8_6@L8dkLFmrrZm`L47TFCuh}oEzCPHCo07FT3kc!Yznr1-UZfCc3*u`Sj!4`8w-0evk{66mkCHM^d$dRc&Y~fzA(g z=gU#)*9^ayD&eW-7C9h>wgad|w;^+6VaK%L$C>3up z9uH@Wr}vcMJaF$$B~?~>H^!U?1GJoBuhK<}$f8OU#>J$vw);LZ=(Z(g|G1uokIM+D z|3DKBU47^zWQ9BLc(9EnYNy&%!3LX3U%_IAOgivW&+;?X%bCd)U#u=<`Gi5JAawcQ z)a*yl%qhM1aSAeSdOgX!#~0Gt-caX};(2g^Rmk5L%-TukyDrOH)1bp5=a?8%E$dUm zRLM_>dGJ^Y-n`=E1*2Gmy=_P=ODxvjRny<?pv*EFW)lYAtixq>c^{M` zG8^vNQIiinCN%2D-^XP3jIVGB7_?RpSUI?T204e?mt!{c^r0D)-x{7yr)|azj1Ui?U2Zns0i*6J4+JkVP=)#0Z{HaAS9#R>6J}M&sM5ac z{wNe|=dE8>Mz+BFSC-oe3>Yu-D?0XPDj7faY(qO@VsuvXM%)ppcTe6y|IV=EWwwO>HZ8w zri+@MST``0jF7})LzJwS)u`Xkw=94h)yX60H-abbkoAE0mInSoB|-+~>}Yb4$B%RRo+6l;B>YtcnwM?NuV5|gmH@Dh~@yap$p#;)}eY(XP9=g0T7 z!9TSAbjH(m247#WJX74=$@gWJmxm-^TN98n&x#GcZ(N@yeSB4}-G<+{cU6`Cupg4B zGsS$q)0mHe7(+Cz0QZ=0|A|+yM&q;PFD(Si${G7Txb{J1Fwtyai=S)0jx`VK9xmCWY%GHasbi2(%~>}MwJPP-g>94NeC zvSDSXI`SZ=Vyw1UXtygK$mbYpH@z)By;iuEdWX(;MRfZ|yG^zvojdX-kMp)fM(2(Z zbS?wk^t^4{7Y3`9rsCvb_(dc)%DpwippJt)q>nHpRkxNeAW*pf$-+w)B6`y_AG*;z znX-zn9Kp=c@a~n_N}x=$U34OG_CmQ5uGjZcw_EZje$MhL9W(0qK%%6_D=kZjc7)?#>~G-v|Bv-ute5*Si10v(7os zIs5Fr52p5=M?3o1`L8ujj;wrSTgE6SGTDs?&=CPB-RmL|49aMKH_4eY`{Qp^7RBe= z{cI{d5P`47oP(Ao`mb7XlnQD*RrccElIw$}zr9NaHkU78?AhouT}_IFki79)i=`7?7|`GDt$>P8UbPn%t$=z z#dFGAtyM~h0Ct>E{oBt{U2Z~npemh3Cf9?F^SQyx!X~zOovGTzx$6f0&Fdk`)j4hf z3!Aj(7q!C~(DY2@WA6I1BtYt^9Fq4W*mPW!GP*C0*`s27Y%?pw>CAAVHSyvRVd5~; zrA38#&+8y!v7_)q1QDq~V`(_1yY?fy#P?A$+h|`50TY>m(DYIYFjx1>Nr#MGICxdH z345sVHi|L*^(E z(D^+!_(H&VruaexVNnD8kDv_pKusY|=b z<*pf>JpMVGV7K52{gMjDQC~6>%2*ZHe;De!n7bZQ~A&@I6t%GfHPMyqxog&(`QhkYC(0$A`ymk4I ziXi}|I$6}y^u&EK)5{SNu?`l1Yg(`Cko1JHYTi@}wHRn^nHabI z{U6YY_1qPa4$@bmX!g4I&c~1*%ZakpxugLtb8kGcqWFtG)@K*w%IUKIq?b;N)t?%D z3j>tnkbX|j?I}{E{M7n7y5g5rK#TO|YtWE5(zCBl$@(X=!!^L>Y;%$+h+A=2VIN>Jv4#Zmc_u^Pj zNv3t^noPIiM0o~wCA#fB?YSZK`nP?9TG>_Ag&PvRDMtP~m9aym2^ZW}3sZ)>W#rz8 z>(O&28muirBhdY>`jq~QG!beg_%Mo(LGJ7-`1?n%uNyZP28sQJTXS}{H*QWv>S=;q zwN_3=bwcWMfqZ^cD=c1l#fvW|3#lgW-l+_I^DdHk(`=C}!zXP%;xXi z?uLjYJE@xz2DsZT1_ne|&Gl{a*{NS(AXuAr%t;S2;}(KCzm+GZBZGKX?m1s$vv{5J zH=tjWYU(_^nm$Bfk!3+Ex-+7!5FNBj4|2k{#`@iAq^$yeUiLMt{=x+V)pquCi(zZ< zdpqpoXEiC@cpS0 za~CyWrw?HNxi{^Gst?_^nPHeJ`A<70 z3s+)1(4;iT04@mn-PLs_p5bRK_%cq9+WC1&D&~?TD${+&(Vv4iQRK5~#~^I-undC^ zHgAS?Nj+;OM7Z*o)S}n2;UeMM37is>d+r9&@k9K5^rlv+UD*Csp9k|oC@!ii-scfqeYWmj?IYYvYgs^{*pEsa-0R>nj^aLtHc&Klu@FopJ_4CZ_6 zy7ghbL^}I*$j7x9AEk%zn}u|N|bQBOVYSoT!Vj{KN7b~F2YNs<)^Qw$c64X znieI0oPsF$i&FeFz8d5`-6)*eoxFnb7B;{|&llGVCywJLxqyhfnn)qLvkxm8T$#gr z4qh?dshl{AJ9X=J1r>xl>|&Nb_>3_}Hj)X`%`@&(@K(CFLP)Po?&(!2908v(mza(h zo|E_T{fpWRYFhcsMOuzhz9Z2zd>s&BsUh`J)5NOJG)-c7h_e2_5a4y2EH^chzrXn{ zHmZ_AL4V^;T)ItEq;C7$@5}kq>Q={YH(z0&29CAgDvSvM44v4SNUOq!PB~38+m6aE zOf%B;HH6fzVPB&f>BM@{%#DMmw%w%|?U z)YB+~Az$6VFdLUoBEJjvpjUnUmg0`g^T%R(r@z6_U6PIZFhtJC>g=zPRh>8(OYq~3 z>oKIX#VmnU7iRl|>~k9LvkMo))c%4!psYK9Juui%KI4pHus+pPV*onabt$seknhIaG0h7D;a=LCBllyA*hY^!?BvsE4d zSSo9sAkTTkPR_|7GmdKICrkA5iSMv>-kWZmH{bX6$Df&}OKS$hT`F^iCI}N8EBlokG`Q@3C@dQy2PoJn$4rLMXSy7vC2h%XT`v8d_wqId_wlA+f15cTpqYCJy5hpL>a^hldC(8dn>ecQG*$tA z2I~sVq%j%JsjRl2X}GUExLl#{`b7CXwxMS90TCU>Fs9~Z-`Gvx>`PgV@SN00FG zXgln{`9SX$)6;x2f9S3Ah{Wv5$dY0+4zIE7A?$YD#Tyb8dJhgRoA2*7k4;t~iNL5a zEB?fs;?*7dw&yfNH-%IY((Ko4_VEuD>NjwZ!;7m=k(AYB!o=2Izhn$ZM7~;E1-oq~ zT75|`IodoC*ZFigIetq43mRw$q*{&HWt@qYrm1UchD#q@CqH%Z#%l2hhS9D-VdyQj z$p_?aq(zpbfBUz1DC_MU$BK#Vrkt1ku$u3`ryEv_^Yv0jyTSwwMeP^bljY?U7(6zh z-5dWndJ)T@E7Bh|njXt3vl(?TRM7TB#7mzHbskhF`feSQAim&T%~~51seL`_i($SK zMUupkc)4ew$=*BmS)lto`N6Wbt~X&pXW7G3u>gB4=#-o`fF%E1h18*cB;&=AGI*@n z8xBaTr`Z_9y|_zFy+m$f)gR()7^`f5j+MR_U>O@0E`nO<#_1**TehQYDF^`+@RgkH zjLTBVD*x*h45S}7Ip0$;XO~}k-mbiReOr1-?R`Y4dEG*feq(ZwLb!-{^OCl>UF+#4 z_P)!@c>QW)uMYI$6CYusS;zHYL+s5w+4);hY~!CZZM*6m;ZqTUxr0CxH#oaGd{?Zo ziC8I|^?1Y9{M`+7)Lz_LYjxI68rpeZiM;6zvOg$4yRTa)y}#E)f}w-Fe(y{e;eXAD z%yEKonDgtrheS9Wm;9#7*pz%`U%9|XX+Ib&72VKn zNFVL2a*9*kO`E+jgrege9u^iDu458VvS~*CR^l|rx|GYV-qTEoc47egWMhyw`F%}t zJ`jDAP~Lgo%g=hPpC59z8AJ64xM-wOJLQH&;8NS&=DgwD^X!R_wf}{DR?uFUsf+Ch z?+i8_HnoE+8>OB5ldLw!4S2TD9k(l3D{}jQchH|X^;Keo)>Erbq;hUOdNmWr{78&_ zUr1@2DfU)Ea<*j3qSFO7hdtOc=!*C5GmF@B8E8_PKLDNp?w}` zF+}c(*MePd=iF%`y&o4A#QPn}{P%YaC+;Hea*9{Cu7cc>gI1=HcBp?Bg{AKD=DPd! zDoxrBN#d|q6`A^fAoT{I!NXc>iDuJ}kr>mh%Z7x{b%WZA*ZP|sSJ+Eg6u*F&YfY0T z3Ol1wVWj@xgr>)u{50h_h_oE1Z5H0a+j6?0CrK)-!#!fo!4n~mn)Y32B)D_*NMvBwiIw53 zR6zQ>-RDv5?XCU!g! zn>zf)p;0`eewSVp-g^P?2%d^jYFH1|3|Pg)EBrn}`x#a+Q`LODON>bBmz7S%O?b_? zNnK{ebD@1Q_^LKdy2C!@%e12y!b{R^v~gkT|9Sx|rH8xmO_1UDHoq@C|NLL7)5H|7KT!+Z@o;el(_N2mwT~au zyagUJ^~QKda?S^8u%#_v0`3qy_&s@}4KDV`sfKe9rGm}l!$)N|xas*bmR310h0 z4n?zQpWD4_-86(Vd_(iiUKn-&MY1Y{_A%2tK#r44o{G=q=%iedxAL;WR+wU!3A_V6`m7!f_|aNPK18h5?WDMnj=`|_W=Za^q3X{ z_a>DRx+)nDTQA+{u;MhHuptJMR&l%d|I%yG=9!L`e7hp6sRk_}%g&w)r9Xd0KqQ&) zW>EeuuZiHjv&u6<$KpkyqMnV@`^M<%-t_v9!meY$bk=94=?ru(IYYU4jVpg!7ZE4n zM~5@z|9+EAZqKX74IVdaep2aci^v(?+uDeBnKUkMRe6YdVXCSbt}<3a^@pO8-bdKl zha-KjJUC5$3Mxh8w>PXpJXzYT8^z;o`rJL?%)IR7Fe!8BrkZ^ukt&P$3rl#sHL;-v z$q8|K!AP9wqlxCJ>lc}a=X#l_)G6wwzkf$nlw|T>0|(M_kZwUOmcJT;+dRT;yNEO% zew5{qr;Ki=A5gr`Mx<|_fz0}(K^2nxr7JsueL8YBPQFH}k8Qkf-!ERZ9o{#07f{q@u zb2Df4T=zJiTH>XM&lOrRNvm$QmR!;8x*Eu6MXQvv=>@Y$TzI~}P0`Bl^V^7H6tXYZ zx~)+(C$GXd@1L40_O}Em$fM>-4RCogrS9fyUcWKD#`O6FYHo?Blc-QLLj5lvewm6Z55-1Up<56QD%N#SEPiAc%-$n=pLt4 zjEQ@XB@tUs0@6lIn51*x(UW`bzAu{V(*!kfYrExSuS1YXE_?$FQ0`YMy8_}L`hyp;d!UUIV?vstR&uQ(c9+=Vcs=TQ|1m2 zJu^6`uF74+-*chKBj0Sa-b)i4=#>6i8opos;S+(iaN~Df0rv)XzotXPxFHe?OZDgJ zwMA5nS~Vn+l~7*-+G{RTjDBGpRG)%6fp2oSb^1G`M9jASWRHPm|`_RKs{6H`_S5ZW2| z9q|(Og4pzq_`_#pe@o#dQ_3HbIA?caQKS+t)TMQKn-&2y$IH&H$;{1pn5AMR+&SY* zDvD8`aVBdxOz?%Z-w=8*-iyE%sk)_9jHyzh?a=YCq!Fgq*_((t#9<98i%Kghl@H%!1{dzj%O zHpltn-2X+P<;gh5-zYTRQH9;Hl_IKdQGI5aE|X`P3Z3vZHJN73r0$7e?tzJQ-}2vn zD;5x2Xtw;2yDYxBUx(0S-eV4BKoZK3Sree3p&OnrXFYMf_bUAt3oVbJkd0fO5{ z!`bReqA6VP-G`;9qmTwlsx5t<- zGo$)(69OTvTUW;3aLzR06RAmxpJ(%4H)m0uoz;M5nktn@04~HIaW-y}qA;;MCY9M@ zgcjX8a6ZF5v(MvPh`kb+bRtM8iraiSFioiJ^A0xHNl0z$MC3|UnmV>Dnj zfA0(%$L^%|?gxN9g~&bhm#>En#gEo4k7IqzK+){(pA<8Cj}d-PuDT;Y)Lk)FU9`Cm zZx&9xQ{!+=SLXpgSwBGX;i=_y>^DrNa+P>bipc`=vtheu$V*CSf3QGY!@dRe>}10xik)FHICo#M zu$W0Iwd$PQ${V>wy-puM^#GT-JDC2=1NPph_qsJsz%fS$*MIA~QcqdZynhbg|xY55XgeBujHn9W8i!pdDS zNj3rIKt(|-()|Mh|Z z!VMsB4H{3E5Xa#AV>chHa{w;T zjsYLV5d8)SmzQ~IV_sS+c;^Ze$fwE3212l+g>NEkH@plnS3&}JV7=+WG({U4I|tS3 zHRCBa{y5knY44ibBj%V6xCp-ssos*8(gdsM;eSyg5 z`5lr)wGXQx&SG5h&L5}Ji9Ble7@&K(?_qrb1t`Phn&|B=?=kuX=pL&jQ|LOW+!r~pWmn7%x=FUa+S-(D$XrODs#g^h7`Rmx8AKP%Pt@GN9>gHgj79Z0hj`n){-=4@&M#4l2imh_^_x~|47Gf9jG z-S2#;O>DfZKEI*9tQtz6=FpSBH;sMowP~RJj5MZm^vP`c#|a(l`JNHrRC0Cn-St#6 z;yD%QHX^j%_$0Q|t5c>Z2l;$!%l)Z)TVjc^=i5g%8K005&k^VMCOoG=F@#?Xs;OmG zxDG<`JAQXTMDW6*R|(pZ)iF*gkh zZFkl^2}86khDgf+3Xz2ZECXzew!z}{1@Z^)=YTRuEwI)bORUZ`y;9U-D_w#)_J;ks zZfBo@Is1f5|Kteb+Wjq9gow@-ixs(5(7P`m784UyRvgpA+s)lc=u;CVI;Mv)u)SQ9 zeHOk0Zr3I8r=9k}r&FQ%x-Ns<3HETGGPw^H3Vi#g;+yOzd*j)kH5ce0LjX)5rYR#D z*A!U$*S8ow^et#1ixM6L+G~o?OHJ6hrs%0fwn5k7vYuTEG_ZI+@Q1V2Dx~5I@rQj& zT+CTJbK|#xAOXtPX3bBTOyC4DZddkvUoFCw;mlHlS%KY6D}sT}Y%^do6ZqPzQa@MQ zQ7&n`D(Oy+rVg4@Jwz3&C8g@8S*;=Cz2)1)*&%^nxVDz0Y%9ApY3ZOX^*TlGq{&%N z{bD!uoS_W7)I-URtKa;13#&yfDOnLW=Yp|~H`;$_FRd51HSe8wuX@$C$6h>~90eO$~ zT6ZZ>i;T?Mbs0pDgfzuE8JB9IDE-OhAjicq7N~`L?%tNOMza|3F^0>WSfqP(p@6!~ zE7HO1xv4i3e^-zfS$wwm8-g{#sUo=L|Q-kZL{D-mXY#;;O48rXGW!9P-G@Y)W-3dFHK|=u*EWU*{kJo38 z_3b3sPV(G=?~7ieF*-)#jnFc)_X?yul0VHuzO!()ui2RL{HKgp+5Oy!=72wyBQ~Do zE(9*p1agqW^KEUn=CdzenTq5BV3sp}1SSaEOV$v2Dp_3dP}dwGp;g*nMBj0qnAhE` zgg`_L@jyFRps9_G7he_YX9wKei_}?l<&zA&(P91HUQe^#pU`sPB7^bDRyBTXe)m5| z$zk`zpP3~5Iz%2rpsaNTMavG)YKz%>?K#UvadfkW3JX;($}yFv3UU%oyiSllsC*jy z4nP(O-ZXQJyeb6fjUu1d?T1o4gkFb2i;a&S*lNZ*tL}{m-kH(ilTL5TuYKYW|~~v|ggvrelL@apB*) z0^T~Z(!Q*_)GJw72SZO(x7$W)^M+YM^&w=B=E3vX^w5@Q48qV@qmnS`&Ld^e5t&qa zdoi+*4u@!;y;*~D+Mim{PY;>s7k_Ko(!_E7sP5)$Ou5<+>FOkwr-G+c$#=T3QvRQX z+so=uoFeM0&X(-iUQwcbg=t*KuGfRE^|LOzPIqh*F6E8Meo7=|plQw;&+G0#8S_PJ z5_>$;T`&17JQZ-Pf>ZkWlXURTX;`s|xOan!G&}i>dU(zN7+Gz*s{2)8_1(3>>W*hq z3RiXDSBIfn^qXUKqoGkiy?Lk7Ww*FtSJ4*E^=4D<+-xUfXBEWQXUjZHbpr*Kg3i{c`Y@TJP1nP{{x*~F%4$>S(7t;c$Umxn? z6do^IcrO=f^>A7A2C07(b1*PZc+9#YBXb{2MYiA=Int(NXjVCyq=ZH^iX)2R2qQWa zCjoZw-C)?Qs^as?j3&8PYaD-*aVo!q?gSrvkD@1vbhNS_V#8IQJ2Pk8NJ+9Ctl&s1 z-aZ+qqEzi?3@6T>TN-1RojZnX2ZwP+JmKpwHa5h~Alz+Q`8Mz$$4?-tK(NChfeJ72 zAEal~TrqFi*04FT56U{}Y8h(S|IHO@ER4PxI$I7Ns%&tT}#K<`c1;09uiuamkRK7jqWsT#>CQW5OOC&GxkR!^7 zR1Jv2=}+T3QC{o7OumwL?|0|8$`o5V7xlQPYeMl6xtPe;1oAR;Z{}k>3g2qq!=Ocl zKs$cKFI6>{EL9;2S`q}22$W1$I>3)cyC8{p+@R^YKg+*K;+8k%Po}rh`svP$10 z&F#&rjiD!fB{)K)>{H+mGe34w8Xf8Y52p;x?Tf1jk!zXe+|>&W9_G4@$7fs{dTsz$ z8@eu16H$(QE9yk`3$Qgf@X~G$gGB1mUeilm=r}1Rb%Y@pJs=8sM7nqBa}sQLe_mO` z{cO%ZeE*2FgB+zVhe55-iDyvL#&k-jda2Ei#)3r9*vXsrF_AIgSyV`Ly3^xdXYDV! zR2P4N&XQh`@xEVUHQR1*DvB8X@S#sDM(jOXWT<}4C?m|4<~3Wn5z|y;!7{MLc=zk$V`xSZ1*T{(>4A zw2d4P+q;W$v~_t9X@v#g$sz^U1%0QN?9qGu2(Uu(`hKc*^K4_r|NDpA6B%t6_kL{= zc?~b>V^k)ETht(S`lJ}bvB6*6h5^RRpbz9a^uEvOu0kikZIE0w2f>R)BJgJ2Xg6?4 zGveh(ZR4~6#zptJqj$(E98Vsvu1)D9wskR%^Lq@x0y1krKsE!z5<{BTMZK7OIWSk8 z{qP?M7z8(oFL`ZuTVKb6ikwcrgnIR7wv08oWB4FJzfRi_Gh$1Vf zF~J{2N*X4VnfJ{R5ZHQva_9GZ`LS441+J=uws;n|mEv0)(mW!ts8mlLmgrhU+4be* zz2#jR^EVJDDKV**lTKbJDBt074?YiFxVoua5d@WdJNI>QgX7g!{awp8JYQfJzRtyg z5+~bup||uCLr#s10?Uk7PsB%jBX{vJY24ArS_9J8b8hA10*&CS1o6XYZ}%RfH+ZWR z_+^(6KDih0ObK+vf}cRV2mNFV6;4dca9*($H+O3m5y`vXkU*TeDq(N%#ihc3t6mqy zc>CHg7+76O^8oBRviaw{gFCEEc~i}F>Aaf*XEg6qxb9oMQ-~6{&K;U;5BvYzXAmiB zTo{Yr^rQtLm~WKp#6AsVY{x5Vx@7k7pqh&0&!uPScEvC@>etkWme;FD=I~B(h(r39 zSXEh`GB)~D9ep&k>c1ilNojl2?f?}ZfVk2v-YhVG zNI`3~4HNbF!u!B*#DP9gxidzfX>oQkz|P9BjBERq7NXTP14qO8#Dne7tCo911>^MI|`_OEuBPn!E2W@+8w46?b7~abn2otlo z7o~ys!$qc}O4ftKrGVti8^l@6)^1!Tz6_3c5y}~g+L7$wlV0$H*D$l=se>|JYRru5@uankm9q8~=c-bndhxKY@YE zm+%j%gKx}ds3YZ*eJRj2k{AFc*Du~9E)i6qfu1@;!Kp+&!-ulo-c09Z<(j6@;FdBm zf4Vsg@UFej0&t2Hhlav4p|qb&qp1TScK}T;^LC6}oC^PzV6hG!l%8<1PL6HksDw$W^K?6V z&=#P}J$mOzjf(PX8(|MB3a|P;O)4oQwj^P~AkNXdP30aT^rcS+{oT;K1=jfjLR}F{4CM~FF)MoUfhTW-i zs``WEB0jezB{x3zruO^j@F-rPNRUW`+Zo_~k*B=+19XraZENSW&55_4e5*NRoPhvr znr|<)mLoVE_EC)#-^E|Ql7Dr4;1f^lQo|!&a+Wf){jAXW$*B>}o(K%pxT-c%RKm2k z=J3USw2bmIU7KI|4L|#JwF0fzneRA6Bvc3zm%@*CoV@`O@G-Dxu5CsK1+KoSkuW5j z31$8de_R>wa=Z8o40X}L0A(X&2Y?|FE@TCMlIZQ2wQ*YX$jJ#tBCj*L{HEw2!FmFo zp5Kk|j8t%jUp`J;=ZMGio_2zr29=D(G6e1K+3mG`ds1dzy`pO%ux@=6S?Em0jUrLC37;EqjWT7((*1CTa^_hePC7Vlsckb@QM z95=b-a83co2tNq$ zIU^q8Gc=0&mro3XtkBk*1;Igf)Bb1%*eCR@Bs)0FT|;2AX;RwNoZ&buC>uJH!q3)h z$~y~;HuHA8n@Ac1PJ@st?+RUtxgeSdi(NP8`g? z{JeL-+YBGvJX~lT>++;(hQ%zl_R>vAnMpnxraSMN2$)yGM$+ki?Q0n`JNyj?7eYQ3 zY$p1F3dzUeD>suyoJ{pHh2;0!&jLBLXs2s{`;G<9v`g^H7BHvlgE^%gmD+?IpyB%d z1I}Fg*Z#Rjv*L1%fT^M4-vu=L;7(X$MtMqZi`vq6Kp>V!%zBTGcL4j1tmT#9UXjwe z!5-5{##N`fJpuEl{vscMn7%hILoy$ZvvnvIxBHlU;%X0vAyKmq*@CsqnZ9_wP%Rs~-4fk=p_z0VrQ+fO%RN4@5H`zZ{s|DvAP zwLY(^$=)+EXfiWHGV98A79}|z97u?c-nJx5xIp~A%Yk?n7rYr2w=C~z(#LPVTT(iR zTYOT9yU4x7T>KJC3X!FI5pH~+(LE;+0Jr_&_Xokl_xphw_u>s2^iCUH^iD)<;7p3? z;iVcPBdkex2l!0@pkg(28}E#^5J=02Gk*`|KezJD0s~w5x4NLwS2qn_^>6M8b#mXO z&o302e3RK!{pz|&c=w@JQ!_bJF8t|>%s14(?o=0Uv}uhY5gjX3WBQ&7X3=o2LI0K% zs&Feg?DGgUW{{JAJ}nl(FMQMdWIXbt?zpD2>E`Fd#@~4Ua^Z|mGaSQ`0gonFN@(Nu zA*iLy&!s67+e7g$>(Yz6K~^C(Y~y&9dmpJKzcSP88$gCzJt5R`nKe-U1d!qSXpFtl zI-79;jUx$A;Y#A0H`!)I$U%u*<!lVU&K5Z7FOD z9-yOlfdM=R|448$@$^2{IMygbkL+$$(NP7gm9|?VMcrq=DbPp3TU6!*RE|cLk$E`J zqMA+kzynHQ>k(zQ#>WsC-1V@rmgyOVE(yZQGVrAVK?A}_q~eEVr5&boOjk4mJgE` zy;ec$9pe;w5k`F^_=Q!akE7zP%E_3}TCg4E5>1TAOoA!cnt*}xt+iv6%#?llOlce^ z$=T1ZRu6e?a^8xk9g*l5V;>L+FU+qAD$vNyndRZ^zuls=q#$cuU;WFW+i^$by?pC z=T@+Pc%^u~ey`b-O-Y!%;|F-c1xYZ0yVDQ=|)Z* z&v^`|tPCe^hRX30F994n5{^4*qh>TTKKqIChUr#cW~V>tv*8`F=rd~BD$5z8^%=?g zfV>aT3-b48jsMZvp50F7K9Tq*Z*}tEV7_xiW+)oK1q7~w$2;6e7$FO=fUj>4&?5ix z*|OB7@c2uaa2P=S*s3(|<9j|Pdlgtw=R3-Mw#lYeQljaRZ6EfT8)@`}lO2$Pk-i?H z9HD^5n|_MUt$9Zdp0)igT^>jc+6^2BZ$%7Ofkwh$O&T<5ZeHHyKUT^iN#|y$J6)t0 zPG!jco&~n?Qt;hsRv?H_5;13qF-GFh$8z(#m~Z}qI{wb%*7>zohbBqZ1pK$8=XZ5rOO`QFb*KVMaiB*kSAOX)~Q=R{|TfZLKtzXw}CMO#X zl{T%vB@1gM>SI)=$ewPrN^Ug=bGAZm3Tt#Dgaj8P`gyy533mjx@0?0RUY9+um^OVz z#cAmC26+d4IThp?>eMY7uota=@wKw3WZcjVLphGanQX=)yV;ru3#5xr1v50$?eNO0 znB&Zt<7R!Eh>oeZ{8GeK&!EwhhM;MH!y9?&>WNR8jx5Uu{=xmcf5_K5UnLF8?8v9O zDq!aDLiKTSHY(j-Jz35QGvwqc%l7!g>)5U|oz{XmL@IB{6s> z9b9PATH2=O|P}<*C0b66!*CShvaSCCD?f(IaUC! z$U{NP>+)+Rn1R?}`o_s%80O=2Bv4#D~tH32x*`Eygzevo3A8>YNO) z2Mn@i*X|#7yQEX0xh;k2OLmA2J6jvs^0bE@44LTR+K=du(>?^`M&QyZadL7uS5h@u z`jG5T&1d=Y=uOjli17E|>KJthTii2g@Ts_Y`WYiVy)I%o;0<9-oQpGY& z0N%$4KqnIZBGk$S$aV`G#Yp282$TI8)!M`FBxlM4tHG0OFh%MUk_z|VHMv-3-!GKk z^}0uBWCuq*lL?J_`bX+A_{n zJhV$LkjOBcQ67A)xDgcl^ZGJ+Swhj#W*e(6x&z1O0MDQZl>LY&Pr>s-v>Dwe5Y&7J zoN*(2^y#V$MNLMZ{r3FdYOV4pfa7Iy=i&{9n6(O}wY3_LwVue9OaHGhHfn3R+`$M# z>|4)R0oh(J6_(`4-4u*`A;{CI<0v<3C=2{Y3CnaU+Zy&iVX3RBK!!C+*sj_w)dS)c zA@G=eS7q<{kYO#aA$er8bC4ao?l_qVlUER+7)l;As`-CE7ou0APUhTiL^a5qo@C+| zZ{<$&7I5PLFnJTK*^@A9Vya=6TtQ%4o!ju>h?yP?&ow{hc5*kNBseR>Uf|4>o^av%6B9Tn`x>9P&^-mjAq4*pF&zIY;??fKMv(~yI3@%Wiy^I4w9(ofOpsCpZ1 zzPhW`beWBM3dB|f;wuFCOoo1#C)l&=FA-d54{MZHd^7b;{Cwl586eN_6lE@c#%{^egNWjy7fe(?kK_v1-@3kWZINA?dPtA;LO(~nZ|@Zh|j-JAGP zsT8MIT8PXTQ66VfR9m$`~3*iMPMC%TtVVQdI-P=yV z&B!se4h}VeRwiGd{h=rQ@2QSZnU^3)YRSaH&%9zqIc52`7RM(!f}RcRXIvNKpW$*j zpQV#zLwClAG0y#h%g>#nI~A+W+}3UJ&uB*9AP4)9Rynd6ZS&Mi%)KwVT4#o#;VO!& zXH>GS_J3|t!v;;n1egIwI0+{?vFCnUY0tg-=J|L(MQM_1GS;Bpqw^BjJtEe|ltuRe zBkSy;XH!Fm8Rm}gzc6#tqa2&cl+@jNOSXJp_y$_+9`yt9xGo@a{EK(C1^Z$o;RkE#-Eyru?*rzkWRw$=n?3Gjw zn>KWb?|P@OYIyAc*<#V~@Bfu`X$ELpR@*^MW1F`hx93EqSU*oByItDlf5ei4oetLI z#}y`}*ki|x-H~(n=#)OD22*4#4{|>uHMCy$&ux&5XOMYs^i#;{f8?L}u)&`%f}oQV|oT-II3kq*Wm*{+hZAvoChiE+zrLV5uCa^cis#0$o-F8UJ2u zI|9`6Gnp9nV*cP)G92ZBF)L(Ls{2co+=%`Lu%bA>;l2Ycz464%z(ad$w}$)2taa9a zjsl|&XEwZiNtnBOVcywI+!?r$o*V|0K_r~&Je&zH(rCilFM+@m%r&{-b zYo2$+eVbXu=}Plw)$AXN1wPaFhyx4Jn;GH;x3h?d?n|Ts zh05dVF(Vs2N_+Y>#{vT1eT7JG5;En$7hS$I^+z+fiE@HYEAAAY@Ap=^^_m1y`MxAI zySc^cBY!hxjHWSPmig^=!cOJcFMl$se%66Sx;rLdQ=I#=%$SwgLbggb9x&qMG4fKA zqOcC*1|w~$lX?H|C(=Oj#xb&L9H*_db5xGCQ+bedu0PMs`99odz?@BX(U0k6i!fgB zs2b{bLHYfSe40_|=zz9K=gqnv;&Mf>*dNU?wB*og&{=B0AhHZG6IA|0pe}zV^M{2 z>nCEizt3Fn<%QTLCvJudB5W|lY;mN6Hb!g6HF7%&7bqEkYjLMYE%mO4S08-1rh`ej_<_A8^6U*-;wd|j)G2ujJ^xdz0cH&ok-gn)U7MD>%h!B;RgRsoUup-` z+s|Ane`N2}OEg?VZnqadubJH|hQH5zWAy1Jr{NMN)rM|E&N1KFtwxvF{M^HMu(13e zBo+0ds1BQ4Edlg8#oGDQ7zHssT2FPOxyFC63CU5(Rurx&;di_`ITS@w!2^NL{MTtf z-(xr#H(U}Q3UpxpO)if385=L`azq+jhz{~ZEGCoYMG1Ny>Iux+dI)>f%%)4Wc_POZ zDPcGXd<_k<)1U5NJUyb(FnbhPMD$~0wB5w;IJLcx=qQ-+g1vgEmOuM8Iem}m5k6U_ z;jx4(#Uzd4F2tbB#-ACs)`ymjLpj%B|5>~lKs(DxT>e)!<+hCFwdjfSM)pMPq{csltz|iLt0$9x^94aq znlgySTul$j2<2JX|KaN`+@esUHQu2FX#}KOMd@xB1PLXjkr+Azq>&zwZV>5`Mrn|e z2I=lpV5lLb8DN;XgL|KI-S;`q{TJ5r#ah4hu6LFbYa&|(?T<})9B9@7mr!%&B?e*|jR}4UJxcf= z3Kd@2xIyB@281!23-G3H+# zR>7TtT2^WS38s{IZOtNjA+0P8R+8{(e5vp^!prz_M0^wE_wwWJkhNcY)?T11;j;W} zvM;Dv%ZNCYa5Ks*bsBE+#d!U;IBseDNiCBj9-3H@h2@@Y1j;Sr8#X|szq#Zpl}i-< zZ=+!!Z$cO+%@gBi4~1RXZ@{=3Kr6fHxb=0ngwV!2{_UM6olSyv%zqHn{67fFRn%*W z_`oHhg^+wr$DZNEM>@YZ{;RgZ%6ia7bWQTAa$8E8DgQlnrGg|^mEQ?jV4J^f)h@45 zviid$AI!f)lZy*u0UU1DOGOB8?H+#B&F`E9X|ozgp1o~(VQ^D?QI+D{O<=o*lhsBj z``X!M$uw6d(8#NDV#&wYow!JE4k2OO z5KoGnQvJK+XAp!2B`8-Z(`58;JotC1zyRkGA+3i*m?EvIi5pVu8^5V|OK=>>@D&+& zUoxD*w=YTRNcWfJ-v2pP>HLzAlVM6WHL3m1U9Dxn8i!?ppg|kU@7j9V3ou?P0{^=} zD@R8mfFY|%yvjCZnd7tKr?pFi{xMQ)mX>C}q2Hl(HIMiISg2v(UA|qYS0xApXcBQJ z*hhdm^2i^2ZhV0EkBJ(JG2NM{P1RXwJe6|ZC^w8xR6sn({Pb)Tg_uxN=)o0O0&wTD z1n(O*_VUiF`%hR=8|lg-&eo3MhoX+~bAv$$Q^ybxc?v`h^L~JgSEByP^nV!2%)H0? z!)C{aJLawqD`@I!OY<#ufAm&?Ybp*RL7Nv`wkXs@pZCuQCALI<34|w!XLHMkcGDVk zQs*~LUTk5k^v6yOCAA7lcVsnSo45IbD7t9y`vh?!>qCZ1kbDy%^6_eu4K4smxx0Z`Tq| zLvMl$9w}O_Sw5v)Wpc~K zc?tUWhU*tY#f5icI`;ZrgWaRR1)nI|@2{fN=n!EvoHt#!4q@MQNA^GdA#kN_!b8rk ziu5_9SJ5#&o+Ky(46C>%LJlE6L#dX6J8@OO|1GY<2nZ6qhmd2cNoxFs`aM^V*ZHiz zot*$XL<9CDnE&_1~pmS*v8S2;{!WPIx|RQJRAqlFSq9 zZ@;}*A}&Ts0HEampFAk={qf@fKdoZ&ERFM|-5i@^2p;-64SMOFj%rctO$Us{6wt3b zwLbxUDBKdh<oY!9taxqH|3FvF#FAEK1D6!P=A=hVVe{dMXB;!h ziuOem2;M~mh`(Q5V!vzUl|lgiV@43h-d3+2vM0gph(Gij!V0L515C?z^9XySR*SAr zc9IJSy9|V+s(&{(=)R$8_ote>$g3Ve>A2(RI1tP)QzS;}eR_nl*G-(F+eLqFCxgWf z=NR~$23~f58`7vf{Aw_)yxIOOgEqlo_0%L($!o6A%`q-pfb#TlfPPq$+Fu2m0DFfT zpe&o6y1;Q=qxs?H=cpw&13#Pmnv}fvD&6~1uUB<%SGJfJJ{FxC>$K)+9bM@vF4QMU zGs!?i0$yQ}%J%l~J922=vzz?R96NK!;Ji}6*Jr*^SO8f!)V;QseB$xu-nFc1Y0-;2 z4b>yv&#ICeC)g7h&lf^KNbP_eFhZ0FK#7%_CEucIGvs44h-K>Vx86yEtEuoIe!l&!fI-tJBe1zEr#arDg>Jg69u?osBX6`bIn@Qq*_3i-ol&L96Ch zev<8lMX%!JkqU!Z>R2{+5KcQ_md0)2i8M+y)fA{N$=+&`UeQ*)%E(@%H_QC`y!PmE zP#LV|W6ha6kIzMfaC_x+Psqf86)c+?dd$_f1;>;|yy=S-{QE^m)oB`NQojZ>3>LY)B`=lA zK$7HQ0=r{S^6D>Nt{d#@b>8oVl7J<6g>+KQ%G(IiaR>Nx2CBHTetE7_1d_9O4q-~m z6sob(y7n8376Avsb|T}F*58`$)E`2<5q+?xZ;`)OIbK~o8XnCtG`G3!scbCK;H3F! zmW}vg*tB~-zk5`Jl7eCb7*Hdg+r;G~j+XA)|t%i%7{#BF|p{wPipUHXS zd9Z6VT6^}E=W~ITY0;pS(b?^6Weiu%7$Jv;Og-ThXnA#%EWs(vQ5o?_S{RGCfawOU#7W(aTKSj#gOx;pfdOrF4Mvv` z)Z>_@ZJpG>!)18g{3=WpF+XjI^Z%!$dWTX{Y0X*f!kdk@Q*0lZh)SJSB1`%HLzIHq zk79G2wD*!**Be%jLk94#QHzx2r?x!QZz;UpgLh9}Vc!c~<64>gq$msZo{lKi=XgH{*Ykh+!~`Z}oo|FZs;Rwbv;pVl$i7 zxaY;oC(q`4ghjlpCgt9XevV#)<({em#+TasZx=!6;VF_U3Rr>-Lw8;%68m;XvNST+ zFo~G#qAOPo?%kI(8A~ZbE*qmoo6^!11jF~j!g}ZFaGuTETUK9E==A@-BE@L=KIq=V z`eeNTyt!ql?C@JJ-8ITIO}({V%hu28COsu*4&+|VDQcChqzPuiH z>w~;U^vN=n|Lmcp8-y75>#s(oSZzq&l6ykrjxdz>i&Rq|wthaO_Q}4)kMh)rnOlcq zt#Iy8Y%~jet&6SUeQdekbx%SwNe&@+KllK$tsR2;zrG|opdJAfxIXd+#P{0XCt7sQ z{7C0ug#g@T2t?`|m%-2sfWHxHYxB;wy@|g?CIKx7rzGYlYIhYcO*Mgo$IyqxKLlyj z6g7M(Lm?%@5t+sN0|S#wpf{4fMvyyOwC#fEi5EO5#jiGL)w4A7F;@;9_{{p9{_8%C zAF*ih4p@V3i;}u&|KkNvuGr$I4IxsE$O~3Jt zn+dmkdyey#IkEpC%k7m7Ur-JpJV!(7oFqUdInA-yVwS*f^-uBp40d^|09L!qXSjv( zBl|s(bKv5yG3{CR_87-IJ!H7r#YpCVV4gAI2-3F*dA;6PV$!rV`%55IsahNvh;gyB z6Ks(oyrL1#!LWy?`O2a%C|N z{VOlOqiv|+RY(+ICS3dX=1X#xo67y1X@w@m-7j6NTW4>0XP~zIHq8W7RDyU>6O*UZHJWke>6AJIItv_pat`S|nY_=%IP> z$#MED4!QR%gD`q|oc4j()A{($+LwM#Hr;RYKV**2mYaA{bF^HOe{)@)-ov2sTQGk*bF>yrf5H-6xB`rHf*@YUrdU4#pC1G!)XA}3L1xQ??qq*uazGJUW#8?r!kcs-(S*r6ve_^8k30XzuBWsLPlDxf zYGy{l2w>)FAn$!p0yk@|y0lVS0llFBO%oULHU-ez_X!vg$JPGyQ87wGMYC8n_h&Z6 zsj|zNg{NV-W$PHQ%8$g9M&bkrf72MHYXihz#grV(8jnmpudiQ==i!#PnPUo2#eRL+ zQxv`V+Y3fK^d0bo>aS_PBzD;Rw4Rhwyx6vt(v>jKR13cu<+<>OCxz)o|7+3zP8=qP zF6BD>-S-qVYFf64&;Qpeomeh?(YO#+PR~ZuRPwUTIhN}c0a-a6r$N2v0`L%*l}>(s znr0<+oZ%gXW3k;hOG zMt-V(mI_V>`ICiVa)xK!2FHTDEhXmr>tR_R%S~*lnBl@{bByjK#%&w7h+4RN z?26y}%cT{>MKNz3#u-`M&_Cz|rQGSF$y2BsrrC;RC_csrShXC|v5)pfVEJWjfJ{2fULwsS`pSH2Jb#Y+-0RcRrEtAJA-ih_%8SD{Atq??gcl zQ3b-=67B7eXt0qlYQ4o(W0>vhQlOMHeD3%JMo|#{5!aoH zO&k`_?mvJjOT=U4*ZIG1 zr|KU>M3iZydSP>yeMDZTZ$1|l`utL% zVP}B0>Jd6Qpnv-I9g-tChBlquYY70dwGbVzdxjhxW>hd)H%8NxXzKEx9K zD&`y@jS2~kK1~)zRMwaO!liEGW}7d8j@YW?O`Zx{mlM75A#XUu+GA;A7UUFKTWTgdm~AA5eH<+lqptdEG% z(R6btTV7~P9FSK%CFBJ}vR5CmZyb@UjXis2)U`PeEB%|V^BlE&m+vpK3t`uc5*p$nc z(jva`XpBm^myl}=GnKN7gW<&ZBG(Bx?=x`SM&krl($Ns1 zy!!FictJ}f1xse{f4I6wA6ubzawR$bt&+%ohxMz?tC>^E`)TVX{$k&3?8HI{p$t;{ z(|xW5$DW_w8|D0Rl~Uz_=8-`@-+0!zWqxjQC1+Bj)JuAk$Q`1Sil>h%UwVizZmSUj zd8AFgJgbS$zAafLWt1WRaFnP<<-5an?@qa-(TCcQSMf|fDnVhG#Pjw`%FE@?h;TmO z$niP@5{3$ovc)f(Dm%Rf%x($PYzb;AVfKcy+!5fAJg+`x?%QSkmXaIP(tof$LeEF1 zx4+ov>uI~5G8{%7U~hEbWP?9+bo$t9)rTu%Jm{G|wbNXniSiVgtF+ZS7^&-3BE?mo zrG7fjKah#$_%Vk#ToQXqca4t~MDX-qFD`9kl9(pfU_N^cwR^+o*l#YN*V2x(Z8LWX zKq>$KCjt2Vt49Ga-D_DXPY3;#=el@!JO!B7Vz0jjT2M||zog_^NOX`)_pbYfvrc)q z{XH6?!UlkDr{ai>WGMeE9wyV1?}GsXtZ@yWTlu;GYF(ThBjRpeUFJQ?^OYtpdH0Oe zDK~8XoY(lG@YRb(r_!9qLKS%-oB^u|?D!`plf>)PXB+c7ZS;T^uhXrCKWgXzWtV)I zz7C~qMd4lT##f0+)0JV?hwK5tL!=bCL(N(|uijGejm6M${WGukc0C1Oe1|C}>>SZs z3F@tDwXt`3O>5UrNDodZP%`$2ir2(n7mc;x#NJpDM!}`6>p_MDID7KkC{rB_qmf8< z%G`H|->~AjvsNdj>n-8<*HZg0piKcHK&*E9)nAE$S~WVnwAw)En!C>Ko4t0lZ`6+d zMa8@cQ@gt5B^C3PLp>JL?H{ysUlA(@%rvu;Bz=kl5usGXBF#S;e7UUDvX%OR`0|TR zGw_FBxuq!G&F{!KSEHSEY^%tu8=HN`GbyK+$d?najz zAWU`b{hS*3S~ELO@)RS0qS7p=XKQ+GEhvy~FtiTd7>b(FL!-@@+~esOJJCcuKJ8=z z`$A5d7$c3=0_Nf(-N(t2nISo>ni_j3sTX8UB6WK3k=m0b>2(bwnV;+IbCHi*{h}4< z@Fo$0CrylxI{?BoFQ{~=9i1Twdr;7!bTdHZms5}1&lKrRA!@k?$XcB6jQN?25P zM4fsl*a8iZjoJJKhdHB;^gaj2XPzv<`I(!K#^;o@ zJ4E^~gp*18boimV62OSg(`QUx#M#nm>q|;O$s7 zz?K>;_r<#C9)Ijg#a3?$fy&{KleSv+F!+-CCs`ws9Zjo7mTzdW=aYmEM=~0^ze99P z*sI9raqY3{(G3DCYteU|^R@G3wTZNE4K9@59|y18vUoJOoh6-PN;Z#iW&6}`yb@eK z=f2-%lx0gCD%Ubheddm1I&>(w`AAyVh)({&12h-F@X6ox2US1!9u#tSD2YexOP?G3Fl3w6SpHJUIWX1p#Sc%KG< zdC4^92kR^A_yvIRA&pwZTVG0?zDzHs0aWh#2(@~hLi!0+a79DQRCa%Y_cC!Ek!Pxm z%lp7bIr6+3KTm%u9i; zZqLJa^e!Ghd`Y1I;Zx7iU65gy&1Nw>T4NY3O1<6If7o&~5Y$eHGAwq{%hF5&jChGi zUG*G){e|8E9{P?3Xe)E6+t(jN1*ZfR9M5YcAsn(ot?77m7{=faqvB!s+G#aw02s`u zBXWR@*V;BQexAE$6~w~dC;gl0i^ybp@(#D?bR0Z_#G7F&SYbZWbt=dAh%?$+q(eM; zR^mt1sOXrlD3EApFLNo*6WZ@(ax5+};*@>dUA(S_L_>}J5gP1$GDHY3H2@58zYUdl z{O>_(8^o1p0f)C$i8b%m+AKk*mO&Fybewu_j@Jr6eSfqRqI+7-_T)Oj8*+XUtB)$PD1PKFstqLDAcbN&hUGAe1G&)o$2XU7CNHE{n?)Vs6c=r zamSCfD_>_t@MDs;-ZTsbxiH;e1;}7wBPT|hsH-!{T>l<*yG`5|m*fvoiD8?oVg$3Z zGZLq)VN*QypZFOpZnAxQyFAB)W-O(4U$jIw2?GqXvKmlV?cadG(%Dy~bp3SBt#+Z) zd=uO!^dTxnyJ z90Tq&5pvi_ebze@vKDImJTmM6KarbxcuRKHqmruC9tMj|bG0K~Ep3-8(&Y z%CJ7m-R7P>un|iG_@#XOk=jAI0^MFxNFYOtCW&3Pe|CV1PJv5cM1@ny=+XW*70|*| zLYL!)cl$A8a0hg9O`na4yn!Key-K`zZ@H<#^?oc#?Y->)32Xd%RRd zY5T;`2m-Y${dpkd3ZzclmDXrf0=8E@zFZyHQfPP+@KEBza84YT9V3=%Et1mgYAbM?^ z<4#ox*A6IgKI&X#iD+58iqbZ51W15(9B(HL<}x0=1GHRNP2SkKu=Z7mb47YEpD&Jz z;eq;5`zl8WvP&Xb-4{=yJij{uaMJW(SJES?qMn?H6N(c0Otro+;aE}C(!C_>iUjsb z1%%}udkSjhuGJL?#9fA@EI%F%yc;RnFp0^{~m zY}|?HvYrh6&{u2l+@-Ah1S(NOoH+)LcB4G#>1Au>7%gs!vtbuX$pM&zdz94@J=koD zn?&EdLRX0C`uI_fBV1pfI|*^RUBrki>~4+RgLh6f8{f>ag!EmBxBr-q!RvEsAxsaw zxk=$Z{QY~KhDHkNI%M4Lf2*X&*p3OUJI_wEVQ5$UbGuT0W^~hZ@TV>JBqG|-oIoo8 zMp=g~e@Lcy%ljnW?7Cxpo|E19<{AsG2O~)(hI8b3+_X~^U%LiZ_Kwmhp7h|g$D%3F zp2*$1lRWKwM=z4U`Nr%36Skh;0Kz}X_EeP~g(QG!G@Q7~u2H@T6=T_&BD?Ps*{fy~ zkCz&Lf1a=Y>w@X5mR1D(LMI*}`N^Vow37%;vpIkY089F0E)rj7k8drulCu-k1u<*> zE62@rp3{`0Hx5*TJ@xFrLM!<{QefP)l_AYR$ zE$KG*Kw>1TJ*=OhnYU0=Dw&0~XETxvC3>=ODNjRL&$kg{4Oo5yUY{sThv2I|q_5Xx z*r3#Ho;zs(ji5&FsLWgQbA`8LaxFnEL;cA93r;`-Tiy4+Kel?@lCgu({gCXVsd~$s zP~uyfO5%R-YkF_Rub*z`3Y&)zHIa&A@(e=QV#|dwjQx51I42r5=;7*NEeW!fzs7~& zvU9ggc0G=B1?8|0t{+p@q+DH8!cXE-8?BIOaFdTQ!7c(R8`#2MZs}XN>|q+&bmt#IgNK;S_B^L8TdB^Z8K5Zt99Kr zw4;x|=chx(6;;(F7D5bdw%%pB5Cgvx<2S>(5VNn76{^`@bD_0K;PlDHq(!MNUy(ML z-N;y!SwAhZSB3wuj9s0!`~n-k>1Xii5l-=JY2*c=%;q_b_E-{ZS*H*T&wsqXyCVDNcu3AOcfXs?3fv15~8mT!1LNkgUIzL&!rk=U(c)eD8zY7EY0sNHE{qL(m}mM zzG>IBR9m?m{>YmZBr(m|&AI^qLJrvPTI{zsMj24?(j@15*zN_r%xF7nT{~vMl}bP9 z@;OoKZhTTeDeF)=|h<}xW>i!Z@F>^hc?tl?t# z{ynrJ1G|DuIG_z;AJw_Z0Y=0ycMCb5-xh}?YSzvwljfe5J&D4rYu)|fHBRinbaB5V z?HoHXa%~$T1b)9cs|vgz8fDfcg~QX_4l6V%Ju2=D8^!iKPr37oKjWQj9epXXhsU6_!UM1`w|4vEGPT29 zMnML^ilbYR{&F6V7|5&$i~u(Zf5$T9`K;(qPkt$|a!vq1I8g}$&S;+`(ek$f^8;x3e2IDR6(JjQF4Q14{|SIy+xa*aw0M64@Pyl`O+xE6JCBKL(( z`{5RKpc}1sqvcq8{s@VsjMemVM?Om#R=&0N!lHY)sYRsD`XwZfoR1D&7Ma#Y$3h;N zSrr}zP_2(&;{tBu4)LC}lfDF4`s*|3jDm+e1p`26jI$@C>zzzH$%p6*o0__JIf8pg z;!6Ae+`>d5(jA}d_qr;zEJFne&6FzC#XKyOAgX+8xxWxQJo_clGZt^~x-iixb)~4# zN|856xOr>YC#o})oMy{08)wcIIgL5UyV{wK%OVf6kP=8YxY_6sCQ)0%zFd)@Q;k(6>;GM8AT{hkfR z&)msfeR?VAw0NG9we1^S$$aJAXKMp2=Ir5=NipkWB@67_XkJi2`GjbbTHV4e%i+ij z*BnAz{Rc{NpvZuDI-^>H$CAZ@^6S9k{*pG7jrEjW6N+7oukjf_0Cq!6 zVkM`+sC&2BDs8v$vPSFdv&&rlXMKd;FFga~Tb)UPH(Jr+Hy8T;`u*zBwE}=1I}w7C z`sZ(3-hLz;cOWlc4!cg5){c2d#6%A-$PAr8K&|3*#`gza#1jo9yq@OLfo}{jLbyNp zf1rQz*eOD7<%@(x8C=%7(UtA{E9UiLE=vfF55K=R{dVOkf#o*Q=j+SKm;7(b$h;UI zVPmBt9%V5GQ=7O&hCTB&ZXIl3JH-XG^>B1}u87@B=*eogxO=0fbU;f`Ql=u66K4#@ z-;ulBg7c})&=15JBegAC^MMIz@JzDUGct{@wGYLhfoH*H@z3~G%yFqhiZYq_W_e6n4+Oy>w#tye*) zcm!C%ThW}REern>BY!Mu_ki8wX-zo=MT4XR3cp`A$mw>=shOYUH1fU>>kANZpw3D! zEp{-JPiIFjMMbUUn3NC=|JEA7$jF44iOvX1E$vhG>2>jSie;x4pN)3d;{HtnEHNzs z^YVWpZK+d^hlnIYXvSSvhgc6EZzXsh=M;PDjTgLY70zhOz=fh=m?n&|M9Mv=lk^Xh}V0 zN33QXl}em8_~HdQZ2j66>8KD8YQr+=`(G|_2bjvGbpnXchK+Yi`ukvZKu#L&t8H$i zTSi%JVSZ&aqEvjmdrUIpy85kK2p&l91+jP92le6lB%{WvByj?JJwR@01tH5dpO=pB zm-Rq;Uda$S9fa3|Ffdfo3Q-FtBO)4PLlGtgT+>9+{Z|wP>!0L)l}9C=_Ay?0js`@n zcl(|-VD>)XN8^V^Il{i5P@cySawBirkvDZ@SMjQ<{**fKlRqWiVOAYtHKI9 z>*o!B2Ig@uc{KpXwbgxU7H+vMstnz7Lh!dg3rbRZ z6n`Ce%oN~*VKVEq`PZpxJH(aHs@y}2{Cs$jV<6oM2NBRYV!?(d8ZP6!d^Csp#slVJe#TODM@rK&~O4OI86l1PZz4i%rD6H_~YNZ1-OhR6JL3kwTU`b23>9TgG5h8eADg^&ivHjW_OTy6brQI6heNMQ_IfIa-E^GAe?JYe)VElU(-31b1UVNn>?z) z+UZAF+6_72(N=zVW?70jc;HVpT;3)eWS!SAYyg1c23(;97`~i$w6_7#PE^;Hlah$V z8rtj<(6j6BGMfU&U`%-HO_NBo&n?xA~Il+_m7v>l^V z-7~0yd5T^PWd{XmJzk|PzMr+X<+Yf>-*t)*Y!`lOrt{xxR;SZ(`_3c#aPTYj**ou| zbhVVuf=C3rN_mv!rP1c7z>VLaavr-GsdVgwEaow`)Mn%@}HYqWd^8%kGQ)$29yoyZfgodCyp z3|+T=B|k4=$N$4!d|03Ee$H&4*A%kYJ%kaefQUgS zKhyhEXP;b#ycL`Ac$jmLZg;sQ$MTwV4|9v7J$xW@F1Y24@rK8LDmg-bW|4|eLl)bTZ{UKRYs+Y)<~zLe0(q=N4?dLAfNu-6ojqE;YN3il|$~QP7tOsdB{(SAGpdw;C;ZcLh|;c)p@r=&V2Tb&Xpel?MVE zBYQC(l0liU+J@Q)vG6ywESL7ZC+)Xcw^+TmHgb?F@q8k_9o6UETQnIKM)y zJ58h3kQYy>38?zJR$)P-mqf?Eg{2t%=MO$)S z)erZ5oew8+ho;8W`CYHxZyRV#lllhV2g)cjAjYayl1|fKhe-DgS~iarIO%q+54Hyu zst_%W(FDo`LR`_Suo->$H_RK=WP^qip`zo3?`=wjC3%U<$kLq@N@Rca=j!?{$%Kqb z=H#*YH$QRcp~$2^=MzJA3Nj4>%^>Nw)+a$Pg&qt}80!4UL_`c+FFch2d?BXd>stN6 zhJSADjNgtPu+4p}vvu_lAT94BMN70aT@F|NlNxD3aZd*bjvSE}j?02km2v|_a!p|J zoU#F~QWe|2W!SG0TcE?%(5SB)6Q#!$7V@ki)-Zml9o`=V{f9S^QiyHGft_J@xM@|> zs+`1M4D5DBqsXM02} z)b#StJ4lTD2#OAadB)SS#)P(aXI;nB|G%h1cZSqZB@8>ysLY--Gp00k+>>|hdl3CFo z(r-`=_^5#R{9%xPjrz%Gbfs&b+Wfw`5e9FvrYg(=_u~dxq#-_nQIji7<=A{DmxwbC zs}c~d%Z>WqL|i;QCEe=};8=fHN+lFgc(#9AVZ#5((lFs&hK>JqmmA;VCOBvI)GwFotPLFI2?5?(i_v@WAUaQ@nWDG{s zo}$%oNWp_Nw0K{SLJAAUwKW(6?uajQ1KJ@uhZpw zPCiZ$@Q%^?GWld8wz>!z^^9-_Yajy+C6UTMKpSM;)HmDTos#dFl04VwwhK&aDNxM4 z8owfrl@jEKVvhGIUWz@x%$=l=viO%csj}QC>zN0*JAY_kPKqs|-CmQ@)=67uLabFh zK6jbY1s5Tge2Kip&tj*zpKq65N@f}})G znWV^*oX4yIRaa*3-`;rDhQ-8`8ATC@hE`8v>txVz^mZ{mAfxkOm`qW-387OpebB)Y znC|L=M`Lvp<^&@J!bOJflj{*}#*N}`ktn@|lN@Cz9Ov1o?!)*&eH{zgSHCJnlhMa9X-#zCH7o&?Gq5g}sX1np1_X5~!PybU3 zQ*gtAC?vHnKnqG56m>xo(e=c--^Lg~ab_H)9#>K5-I~KPC4Y@71vV#;?^fjFJP~ics_!>V1i#cJqOi(Vm?`vpyMG z-UjgIgdK#y=mr&;)TY3RMH6@-KBq7K)`{hlY&StWhfLa&PKlleT*-v-?qUrz9%%HdfD5 za0Ip#2^{jT6;z;n;V|qOCJa~QeLJGZ zEjdP0>X>IgZR4hdjjq^zkz=GMQ3k`<7;c)Mu#!qSx1idZRncpXyf@tph$E$|`^G2k z*9P_M9&>8yceM(pTS#Kue1nvA8&)(YRT@*KBAVf|}>- zdpI$U@`5{WxS;H{0iy6Uq+0~yJknvn-w27=ar@HIS1s1&Zqj743R1Y~TMVL%mL-ik zQIgfGK=7?<9Y20jp@M_*0p4(;8wGC(^KLk1z*W{nJFapCUs;0Cc%m9k{yIz`KP)(Q zr9RHN*6!0F0gqnFS97S*n|)q74*7HC>W>=y zo61j>@4Y{!r*6esU1JiC2WfOCY7>HpKXGM@UMGMZr>pdP)#mVy*0w)GRWmQp92Zh2 zMTKZjD)pO!CCqob0wjF}QzJkqfz!yv3%dC?Deo)f5gHw@MN~{15M)T5=pEgY;gu8e zEx7feUo3`l;r*d%26PeJ+P@V}s5rrbQm$ErT_$)&)Zk-|8Zx?Sh?!1##~C{4Yne-X zh$}k|7xD}8hfz_utm3&%Q8?nYZE(#pDI>bu4AA^rzM`HklBPB_YRGr^t(tWlTYgYV zdkO!;hv#YO`Xs6J)S`J$A5!W>?~6VbRn;H;u1BZ(SaU^ekFk^=tAzIGH*Dj12maTq zO-aYAI7eQe90oJQdK?f%3wD|1myhGL?oQYlQt;jFi9sJnn%d~brn)`s=H?n8?WidI zc<)2U7Rs4TW>${qwz#)v*wbI`_!Z<9>f+$Jj>!%H}E&{Z=Sqr=y_Sa03x#)wnk@L|tW_>7)(<4_7 zuqZ`@J$40UVooZS?6~N4aHOmz*6t}E7}m9aO7!8YCL;#Mu-}vZTIH6=2wqaf!mQU6 zqR%WQ1#?_FD7%lzMYMn1HF}Yfd-nivPPTNn6kMhzu^3#J7PVm6 zB4q6-O67!1vM zw$j)5izp*64S^xm{}*qPUXM#|u@pT+ZMHo3#0ro&Vj~*E?tBF*yGug7UID>7txVy| zF3SMV0~!FTw?SElRHb=C?ZD$8BLt!R&Z9?B%PsQ(ljxVHXEp@|Pg##1zlf`%s`?gI zwqU;5qHxlV9g=akrM$Vf0W_9WJF6X*Xy{Bcw)j1rE($)dCJ@cJIgGu~#+p;j^Q%@x zyQgGI;pf`LHrjmKf4{lPCiF9T271U#79-0u!*>JFRuRt~Ad64+dIVQ%Q8l{FPdZ!5 z?qdI{j4{62agzL2#xl9Z4IF{n0g@&wb0w-FtFJH%&WyKP-|gq112 zNj}?dUp%|%Poj>Cxb$ywn3MNJZAPs06Be*=5OU~W{N(ETN~+>stFwDTOYYpWheR2v z0bb8X7JR=eqF0Q>{&JQy*M#sBO7W^5-*G31=CN8$3vLQ#p{*?L#rt8%Cz7A5p~wR6 z3>Vd?BN?n&_YSutaqF8IiSwzxsx~codobHq2XV*0yXNz_M{UQxd+e>#`^7cZrG3!C zJKV(iuxzI;_M(!6?*wyB&Bc05$Z`hB2u0HJ6kdlr=EK=PdAFYAG$k5N3F-0%cS)_qlWGhfOfIF?@BN4G){dCH7|tT(!jNlF~5<0wN`#(p`#3cMXVugmgC|p>%h5hcrlc4>`av^PX_s*YjN7+w;f! z4bE+CYprt~`|;cNBdR7^c3s;loCOts(e}tURlo}SkP1W)dCWc8P3MTNw~x@dE%n}R zg{*vA)OQ(x0P*AkCDV;N>L8%%p_;0psWsqQ)6a6uSnMU{-$|eJ7b~O;669nZ(A3cN z2#TVF|Bv<*YU$uDyRZ2@{CyY@MV^T;a#EV4DoiqNk8H45o_XJCbBbfWTOJklH8k1c z;=NtyZ>}Bw9qW*xD0G1C?A-qQ#93nfLOtV$D{-X6`Bjn2m?nquMUkUhpGmph zG{ndeB~#@LKu`BM#`c@qDa7di7|@MV7~LpO!BgG9Xki%UB)c8T9d-xnx#+Ms>(Rm% z6YV4rxdu6jSZ1Lc!7dZz#mr&4%Zmic+oJ28h|ijb!7ZgX$`d}-F~g7{OEx9){QSb9 z)C$yZjRtbPBbcI&RK4vw>0j({itj}2>!VKfYqTdgDK?&hCco_r^yf#2AYPaxm2_b- zdfu-_)V!oj`{LSiC=E*Dc;Odk4PvXcoLG`#pZ!c(+8*7nCuz{VAyf_^8iC`+MlFja~aNKsps{w>WL9Rp*5+1KdO zWnm4P`!&3M+noD{;f2qz9Tr~dUFIYDA#NQ+)9+>4vMV`)zHrRe?lwut;MC1NSkF|(0kMt;4}lE`uDZyobx z{1eV>w#Ix@ow&3v>*W?T?dmOD0|J3%EXBdLh)P35d0+Wb=pTExd=aeYG`8?GqPslm11gMuxyiFG4b3LAKX2y$wwi$90L>U+^xOx-AHNyp4)sx^ zy~}A3e*JV%oEeoaeA@IJJXwQ9o!D7+_4ou_QKI6dttOKUP8t; z`_8-4BYiCHOy$CB;Q3_zANg=`^-JY7pMaQ0%23MyTB2^ddmp~aezwV|CfF)%Q;fJ| zCIVJx3`ZY&1w;gcA+c2n@t)BiayT__9!7}qb2IwVRRI2e&KWl%pCNg1^tKU8A}Ml! zEFjIsZ7@$_cYY?TfC&2Oa`fCEOd*Qyn;>|RW2i$K8XULRs7DO0k%cMiO*0YM6+>J$ zzU&MCsLK){rrzijwaubfY4?64j*P)sE|{8NQ%4vHsz2TKVZI=+{W0ZH#yYjoI56bM zGMVz9U36n9_>O+ka2X8kK2hj;?)tq&HBS~t7MvhF5UGi=6v%??QF*F$Ze6+pp0b#J z*hl4uo2N{m$!fTD7Nk)oikr(+bI7)S7?ZC@`dNa0WnD;Dp4oSqRCc}>OU!kZh&5Mq zWsWP|2p{@H7k~Xw=RU)?f3pC(N@QmC^6~}QT+O}p2#_znK2m-`xb(qLEI&M6E64F+%8)QpLJV#1f0T8`4+0GqkYWnOExe-;;tL$u7aGSr-wa4H(4E=1KA(liNo{W9n_lmOjM zVd8D0G~qEQ0OTjaIvl5yD{_#!$;MyxiY!(&TDaI7Ku_5-1z#|T-}fdj)GFCW4Uf=_ zn#;-M^@qhyXZ}=|e}Qce5pZ0Rh|7U91gqJ z8O3P3x?9E31Wg+<_PXBD-zghtRSq$u{J0}V)EzXWagMNJ1UAb9PX0e)A;L@|9Ii1 z=av5bIL}0P!w01yW$VZ-PTjc8i^$k61q+^zI{Pt(?n?fi;#qvK*>9d2Rd^}kCou>; z>dDQ*6<^DwA$nbgPvaKGpd}r){g3=45J$`S-S#KmeVEEbgm|M$I7|7d<_}zxY)x+4ms&i1>!BLo?a{e#d{5C?DL%K^tW2B;*rZg;d{Et zjLT^H$L({-7}+8W*?F7qNo^&jZJ^4|JDN4kzX9Q#McqD=O`%It!2jJkegh(ac0|~$ zkJMv7(VmwQm)A4a~t5`ZX&R#=^W0(Apg6!!81qHRgdT)yac zwbPkoZ?4T5hvS*}%D;{5X6e~u_izZbTx04^jSaw$;;2PsQC8LVj4wA-xYeB71 zCCWP|Wj?Xun%m6d{QKzexo~PaW48%?Jo1oMv-B&POjy7ja3~jS+LWLvYvt;oDa{%! z{3%`gZigvSyAt0aE-mw>hOvJG`%RN}=_hmGdoYx*4w{2Mkl;6?sikk1InJlGzUK4V zoZiF(W$(@)O3a#9GW&&M<|%?Yzlc}XR6p}&qoWydU0l&P>N3#%%B;Ofb;MaS$sp+L z;F|H|?v&tSoLtx`acu%bkVx(=wZmD}A7Mny)ghnR%&N895E>>a>I~aExbp8ErGh4A z7^3$xZTHv4FXoEK5Ba5OuSgp{@oT4=V+8Hbp-jO)8x<8`#4ot2QT8a-iQ*@58o4-_ zRH*!$fq8XbKle%Xj~kmo<4b4&gG6MPqe0R|pL=^wQU9W7EJS!M%90rslmQQ&w7<+! z7rQ6_d@&Ta({6dng8Tt>F=bKbB&ZZHWw_~)8r|a?rAv46_@{CH6X}RST;b?p{`df8 z{`=3u!iIELQs_6z0DDVHaGZlc6}uDKj~bo?Wlp4m(V)EKd*MUp`e72$7FFSHx|TKMe`?Af_Ks=Mi< z*%T}m{^xBzg;(zqp^p(S7Inp{#XpZK(%YAAWTe-wwM;5I7IB1bKmD0=%Rc#HV_;q= z*KdAh(w=^l2bChh0O4-^%JZEKHO2m(O7fn=Wekm6^I}7e2AOegGbD5+I}Qv3%uMBZ zC~dOO zf*~J0mqdFOg8LM#cq#gS?KBIa0+Z~dn9xq#G1A#eTmO2j7kaxd5Y^8$VLwfosoiA# zuoq6X-6Sa>(qBFTMJFI`yl2zQHcs5KmZ}up+55Vhu_d&Qh4Cxnl>VSJ`#&DLX&4)S z$;(>7dvQLO^}Xa;R7W%Pyzk zQl|l%9c>=Wad1yo)M1rp5DbB#A=-y8W+7b6s3rT}1P#9YA$XVi_x~-c6g0z9Z7rTJ zjER}zp6JWsQ~aU6OH+{YTC>5jsg+)qejMfJdS<=+KzNbB_6csodzKe5BuYri6HYqO z`%&Vg((Io>BcAETc!M?cpurzm@91*3nFmJoj=CtEHFzco(zw;)ynY#fo&7G%YX*?N}T11vlKBM)VenzQc9{MHg37Sa|hp zFdXY6kK)p#TuwRo309D%NM^L$YjujCx#7_dh|;Q@}^6ok5|3BH6lvK zsNVZoF7QASL(VNFbl3H5WZm`A7JvN>`7Y)*OL@ZiJfkm1dA9D9Tz2k00wyI%^|_XR zJQ6%LM2m(x=9N)6>N6KEDi5Z67n6U$*F6n65>OxLWOaEKzkkI;wY<@CIR*_n{-PAO zbH`83Pn}cPl*Xg6IKKik=hO_ho0Q+_`6pi(uioaoGpoNu@J09Hxuv z2dly-wZ(siSK8K1zQ)zq^sn~?Cx-;$gS$@q{Uj843ETfiixQUkoEY`U*e)lVj&0*c zi@J~Zr`bnrt1s3ZdWc7+F^SgqcE7%N;P;p^c=lK|!SN3@sId2MIxH0LaB?{e<^`qA z$j-6TmllyNlA%6tY0zcQ&zTgSY1+O{CyZdO_KFm7uY7_*i>YrB`&% zX3&n_i!TKyj-98QGZrq`6$Kfl=aTIlN|)ux?;w0on*2&ZXM(l6HoLpJXO{2V1r6j% zo#ZI}#cITb8A}8U6#ltQ00dBURgKuizwEfG%3I5B`4!!s3+blQKJioMn{gVaatQ|u z7i6G|=MU^m?Csjujhjj`rcGvYExW@DR-TnFRj5=*#AwLH5O{F!ZV25UeZs+$9%Pz8 zWzCJb{wzQbW-NYpgYwm^XGYE7s*Qb!MyWla!A8i^cG#cz4@4vv7n{)EUj`kI zMfV1%md>%8^ZR@M(;2qJDn&n7fV?<3+p;kDKKX+!D`n+*fnIk(o7W!TdSVE0s~{#) zWN*!JuRn5T#Up#~*hVHlNXh!M{L#vj#;DE(o)R9iHP#1PR&e~dhDIZnaeBO53kh^P zV=qE1CrMUQ7j;){xu zjt_O~wJh&{$BC9G84Vt-d~Wx{km_!iJo8E9wm+N!BBGjIY{X0PY3dzIxYyg&FJ>kv z1n*C=7F7n&qe=lHs-NPRud2t;)u`LP@LR(1sm=qiT!VX3(QZ6E=C9wL#~#_?hW?1- zsK|hCr`ldpqO5bcgL_V>iu|c=#y&E*b+oA?I^deYr0qR2>d40D%{gJ9DX|tDo@oImnDJg3zQC#$_ zKY?oR)MFhv1VtY2_+avd8EV1gZdAvf5aSX8*hX7hH>vz4~z|jZkx&nm)yk#=` zhjY%3gq2jY?iC*Qivjyx=l{@96yLX~n}ax#;5LL{qiOONB`={JxfQ$J|7cQ67;2fG zS`qvkWjTX4NbmN=Oqc9c;RxNEeZL zBo*3rK{5-=!e3DSc82p>^ecct^|ZE~{kpq-qejgZnQbi3g_O*X3{%@@3`Yi6F*W@G z-mt7Af5}n3Y|R0nQEpg9&wj-mq-LwX@f%&Fktu3C{@211bu7pX{H`;8c&V_l+D+}; zSMn!R!NaeIn0*-#q=<6`*c(J80n;5`M_iH-x^#}vi}ToAF@S_Jr7k-nLZ6x4g+zh1 zbB*G~N>slE0AqrL8gXr3m3N1eU^Bln%!LGVV_tXnA+tQr_Y2nDf_W!)xRYo30j5{# zM!Dm?e{s*q>I=n!=ee#Iz_j6eLtaRU@0QL)3v%17xMyZxmnU$FlyS0d5&Ar`ZGl`r z5-~FXP^iPlwVXuZv>^##VgD1~K0uSQ(-}IVx(Iw2)8qGzN$@S2u^6d+cPBs5Sxq%V z8lp|V+q44Q#4gJ+ zzo^N~Ub6)+lR!Lm(T&7$vmsiJiMY17F})MPc@D!VQGt#f5u9dRA)ye5jMSQ9;k7V6 z+}5|S6t?S}qvnO)$Q(#zTPTi+P~fu{Z|Hn`f0de}p0aG972o@+jHH;b-f_9UtZ2eJ zTzuIRA*#Pu=jDHcW9B^NX_^!Nx~hMcdXw4gfhDm3>b@JD#Og$r#6}2NI!RXdDaEnf zk&gwVH3VOMjuIgg4X`~T60N6yIb8c>){KVZK?lT@?8$PJZ%wl>v%@6ApQjBzQ-aLv zfou(w%-HNOSdl2Pbw{OM%`!z>jfDzP?c#wdDOvoH#zcR{EwL(>)>> zCq{?NpS#d4l&quaj-^1yPeCy94S=j;@mPHL%6-y9-q~mO=vIgFD14RbYIS{2TVSKk zy75A$2z2P2(U>pte)tqSFGV~p-lD9urX{5av!QJUT-t1*OX2Hk_#SF$+B6u1aaSj# zSu@qvp@ds@)s%qaKc2gtAQS4cHCrTas?p)1XnfyL3Ag*E>c_#?gY_XJ3h%w}@CQq6 z3q$qsOt1fb4OF6Y>Q$eMO)k6eB)JLKZ9YrbY_c$Weie63E~Ys>0;Vko@TW+HFbUgD zaiaOQ?>0Zv+h{$=GMmTs-*s(ZwySwO>`qr!c(UG_IpJz*^HFRie8e_q$ntaeM+RiH zT7ad&QXmt`L}{|Q9WqD#2i=SEwF$N;`u!gpDotEX9x-5}eN;A#+&p!m+q9pdlF+q_ z;?{Xk+jvG`MXM=Al7Hio1Z%hJ34`Z15FN=S{J?@ z8k8?Se{b8Dx;*;ORNVGN0o~={YkMUt!!}D4F(Gt0030BcfxeT07}0DIHIn-VLH9al z(Q_CGq=l~UPzuiSqE4JcQ+_YfV|bjXiFOWfO;I780zPQ}7k>hx3iQy<8~>%(s#RXi%6VcgE#}0`?&pOkRjw)E9yJ`?K7Uj~p2}&bogpDbgfA(D{kq`H-Z@ z@%UuO#!nUcBGnG~?+TQsV1mbs-_dd$nQ%^^9|ge~|B6ubzQ1enYpzB0SG2=s zqjyS~`A>eY6HmZaQN17kmm#5X9dDRPZ1ZXH^rv;EJ?*nER(CbC6c)(vXC$0+%iUsS zxknO;lCwVOo(3#S->6WVS@e~u@OL!0CX!znYRkrF8X)PWG+QTEuq+~ zZaGBYIjG;;hBuYAH+0kzt|)kn%V~l9R*)LkWnpYKn_u!h>k>Lr02DMQy>u(mW>32B6iH((PAN~U1| z8s+`_7L9Uj>9%+D5Ogf;=PnNwDvQDE!XWj~jq{QuC=bjQLU^;2?TA9O4vhXx<;+Zsb6~1)un@G!^tIUeJw1vg3udCJblci~d?d z)0#G=CGWX-7h3kH^};?INJj46-2d%q8L-*>YOXs!7^5CN@EilTmsYKofsWE49e(rp zN#V?d=a$=DzedQETy&%oQ12C@TKH9t+aWSjy}CRjs_NIgoeGkVbH2lugK^wm7<6>y zBaR;uLU;Mhko#lf=Kd)*uf%!e@h&&;^m)(PN&3v`Wu*ljq~Aw<{e{Aza_cg;J*l!W z3Zz;%DMk4|fGDW!l5GiCFw-86^ymoG41!nZ0LW9qnvp(UDq_Z% zK26taIuA=}1!WK7L)WIl!yRlNa$uag#ylQX{f0(^ArMZ+2549(8$@SA=ry!u7uMC8*i? z;7Ek``Y!0l55;|a>9uZ|_ ze1`z8Db0w#YrbT*a4>qj=Rw!|Q3Rdcss5jGzjWw@$sED7m*4XNmhf#9I@gteNp8Nq zau4a%YyU@Six`ptf2N2#g7?OxSs!~o{;Dx-&-e|ga?3}BrIO$!^8gW0(0+mrT%Gmk z8Z&sv6aVE7u~<{bRBa5OJM$7v7p01skYT{A z1nb7TShyLZI}hV5ayANYwa%a`3eQ3H3l4snKOmPp_H{N8=p!nHzx-KAm(iIF-NnbU zO!M~L;I9))zE!RXLlglzeIg#;cySto2#au|$ImN^mL{iNhAOY1#8(X7h24KYwCL0&tbM;>N7AW!n)J_M zc2lDv4VqU13vIB;|NJDvr>3=bY7pftK=Kyv@2t{YW@mr_N(z&_4v}}vms4`5xgw!m zYG|wQbPW27NGwCzwim1@SYtYXz!EtsLdHB;Q*3rgBP7zu4g!_m}umiLQbsjzNE=d^yZ6ccwX=#{d;1ur+ShC2ufYHs_2Tl6MVC>I71u zG*fY&-|Jv{^5c>e8IxJcf|7-$sN0iyF7jS&^RnH@Q_WIiVB^$GRI`>-_j%pj=HtHD^@=oFP z&x1G_XNx(6t|qs;ue1m$k=`amB^~c2)q|8~|JJA~(KUS#O!0N4zwqv6yH)QBZN1Vw zN`Du|KV18|?ts-=u?(tK!y+02wtKU{)hLz5Tagh!E*0Ps?ML5m7!m#k@DmEv}e(5`a#n zKXb7B6m-Gh4W!ZZaW=upKoK#l0_K~VyrLTx;I#UiOY1lmuGZ8%!Fvw-(oTnt*Gu^D8roJ-ln3#($ zIcygl$6D7iLM(PW$wbgNq=Qp#xC${{TRJGxf+?3oJ zA75*0DCo9&2F89dk~LCf;-wFr@&JlxYtXZ!<%T}aTNK#A&s@G=m)}(S8<2QNV%31P zSZmvmkicgbkcJU`W7(Ss$h@w3siD+bI!=ZTa8ti2Q0RR?NEActr{@F-2(rwHQYPOb z_+W;;ANVh9DwonpdJ@*^L|d65`z|ChOJuP4Sk{_`M{0w7O28V~^k#SEuf-{7&cqwW z0ENc#R29;lwwe^#80@RdT{CLwid*SA*s5|_GUKTg;O99Bu#dA8!T0J=cbAS1JMTLg4*6 zC$AlN!Q)ub6T5k(3bY#4?HhCLr$ntT0(q|i4liFLlQ<$E=%?wf;vil|eYp$1Fc!#m zn1}a1T4v*LwIRVHaAloL4BUeYgKwRC4G0oPhTw`_7D^y1%H)k(et=ILs@&%(c*88@ zG}M1S9^Wrkr@3W+5;Xs7@V}bX6rKqHBczK5`#()R*%=3ocfwA+_t#6M`;a@Me;iTR zOgc9J6{%S7wqnt>Ay)4lXOLre9qt(Q%wur_md}YeKt@#g8xO-x70x!#$C&Gh#A{#% zn*k*6Max6&PV+xH>=wWf5tkrN$>e)acuatdsJE2cLq-J8TfAI5H}H* zI{C$3+wtwygw$HN%sS&lhB%$?RV_^1^{!Xr2MR+8C(Tc5*E0?oo`HIs)Ks-T7v>--R>gC$*LOz_Dd7`1%p*KI2%VpaoIg9rA}wEXN-g(aLv zK+b}!d0;NK#;G+1k0-TjCuA9!-Sc}wi?8^+1@P*B{e^41MQgx&r>J`tr}}#XRteJT zdTlb~hh;#sjoKU;Ncd}e0N%HbRp~E)QP%6#~rl`ya&m`(m}c>^n1|*_ zP&nUxfrm<&Zxnbb-sK=lu;bMj8>L2|tVDI_k+)ce6Bih>BO_$CGi@O!c z>VgKyWc3iCLPhANMD=@ci{C30nF1dAHg-9m0g!6Nn+_7#)zRlP8`37731=>1l%`uX zfEEwl`Q!M~S>BqSfAE{@@+;2HKs0#|1RGJic1eMHA-uz;P;1N=uA8~bhvpJ=J1?H)I3KMWU(Pl47oi~z8T6-V1VHQB zpmdVA1F?#?7Gu&|UH!QVP8M{!sA+8U>M6(rgtubq3C+HC_Z?RIjoKSxq+;;|g_b!=^EX<4d{Rvi($+em-o)BB_2nfD?YR|LSqV4FYz-tN?Anp{~T zNNyRAVVS@}?p*$Iua>AWEYRzsNKmqy+=LeJ^qNnqM@UO$W&WixqC2cP{mEvf{6 z^tk4r1AZi)_U@7l1Pf4v;?ft|fqC=kDqS0nNpG529`oo!`ioCU{VIqGjEw}^)*9M`fxNVjH3LuexfWX3o2zuTxvXe9?KZL-4RIE9ZGE z)hqLKFCN|>lkMDepjD~u;W}JHwL;Y%28EL>IHuZ-m2b;}x>|HPf}OkVbt8N&9Yv(Q zNp{D5u@)!Pu`yCeyd5UxmDiT1UgVNjR{A0Gp3`ON?Xy%L`bnU*GshIzk3iE9z-!C3 z>uY2}Yf9RB*H1cwHIwQcJ~MR<8~5Z-mv2rLA9EGK5}6v!Xg=ZwgfwL*YwK61n$fjv z2u>BjW;gs7Jsd`S$_Vvc7GpR9qYSq>lFyFWQ9dQ&TcNCDrphn5NCoB`QvsLg|D)D{ zJ`EKQPJN1ft#PJxiWB#`44GbqGwh7@m4BF)buZ17dljR0e?I8y2dRqRTjeKO7bcJK z78Ps~79K2IePf-VKiVMd)z0t_GNKL=uk&AGxmKq6sV zoT)(z^Bqq%9=`YD`kyeVNhCw^GDXhb>O!X7$b~v`39*UD!e{4&@r7{mq=a2a=GZ?? zV%|wkJ53$<;}qdPZjWmKKtgQ)3li!gTg3JjKjc)HhOR};xb!Z3(m(%F?((|bH!b@2 zoYTU)>o@>l@KIL|DwVO@RN?+CLEdHURc^S=y!jCQStyl0viI)FNE7vbBX@|MxsyU* z)}zLfW#tu;G`=>N)a$z03*&xxVc@fq2EU%y|6o-QbuZ}GhI_E=36vsyhyoM}^3~B+ z)swr}&=Gi`8vi(Rm9e%lMOUMD$o|{bS4}!at#(uQ<~|bM1=$7~r;U9?pk(NEfD{E9 z=D&!Q$Ea^oCVwsZk~aS*FSyZv0ISr!Z&hYC`Nn20J4~7O>=!vajs}h`f?aV?TQmXv z(#${=ugI28TQ>2_1jt7sIl$?6R+Tb+!FIm%kzlT}r>Q5T+kTE3BrEprKj1MS(iBKQ zaSfh%P20haVB5}_+ESByX~2BF+ERS7@+TuHS51qUs-9`?iVoWg{&gBm@u@CdlAd() zupwc-oQH3mBAgw@yvw@!kz8dC9_gWZq|}X-w>Ceu00O-djqhsW>_<8YF;MbnLrp-q zt@tE@_nI+8dgE1i1P)@^2ZNhg>@qCjq8qSzv57 zcYRjXG=3MIx&h%6`- zLvLf>)#&HwJdlk0mlwI9xdxpGh6f^Q>QAfurrtfOpON_~jC3FXbx4gnV`i+cKm6GL*>i%0nD^k6aYs_Xy z4oN1rfzJMh8<&Rs(Q}k$#>dWBL8Cigm_r`~aKt)wGA3NcDpw1NBW0o5upSI8HSJ1h zJi^rsN#6{)-cmk(3sMT*4A~K`xPsqyS(Vj|P^#`u4-25jNeenwpjCBq${((lEY?c= z#(Im9v9gw4rZ;1mE5>Z@ zUH#>lCv2ekde^*DPHw`m{22{=wH#h&3YR5DOsH<}< zKWT!EaU@G0ScPeVt`(;%gi}=5j!NSsActzuei9u;$&5mC^vbpBsRr8KkiCDS@&D)T zTCMAIe)@b0{Ods2?bqhia@Z50aH;PVJ4z~_^jO+J?1Z(VS3}6VRL(p7tQ@C-qBZ<) zfsm>4WxvILH7!iEbEk&)Un6F($bC(f6oE`&%PHTaH^F*RAAfu;{W#tBh%0u-;`d$Dgns0(K|1R=6 zWdjfx?`TuDhP9Nml3VpXcz{#P7C!Xpss;M)TEiLHQ|s>y@TYx`BQ1Vr>puK(U^Y5+#aU9p_CoJ-Ha1( z3Wf4HlTb`k`qMa_juKG71}H>Jqz3T}In1(yU^J8cor=@Eg0~4I)ApF0sZDE-nlspH z#4=yL&K^*<8M>yHNnN~@+uxnewiF)-pOEOC;1=oHVya2sKK<1tdiuG&DEoMk)$U0B zETPO^^aA5950JF_S{-P-Te-HVW&D4(NO zL2`ppd*WvTi2zasLBca37!pg{OJlLh7$lrKy5i4oHW%rAK9-BMl&0obcjS7K_0dz% zDIREn+g=!bo3)E@<#S7Pk_Pp+yHrj)hre&7t?{XonAbPy=LwYEK|4SY)u3O3s93AJ;EfqD#U3PLPM{9t=qR{v()0)go_G4%CqH&5OxpNRwZAu8 ze08> zFmi8N*+z_wO0@v4w0Qp?VN1Ff$<4x(GnR^ok(x-awKHVsc3|?Jiw~~2)PGC}jD2Et z=&@!`+%-<>LdMJJRzyF3X}sBljbLx>I_(o}nfpeB<^eioOg-qY0zG^g3p#)s-Tnuw zPA2u&wVO6uJ+Ahu-0+**>O3M{P)7&`?;HARdcZi7R<Mwv}4NUiW_amVD}z?^5`x zI`s@pj(j>`q)KT_e6USpgGr?Kt8K$n3Y=B{%6?xg9A+(zrxjNK^Z8v2?Vp_Ec!mX8 zjsS-9)}-RQ5H{uSy$c!ttL+8&xSDgWp>Sel^32m-Yqaj5;ac0(GR1S#6UR70uGsD0 zqIKyf)@y~#g%o0)H{jL&xhmue!n@?_7^0E7j6sG8%?UgD-F7Qy9XZh^^1n}f`mdM; z%;W>Ot6MQ^ku2Lvhcc9|<~jgP#o@z4eJF1F0{Y?g`2r9_HLSOGx9!mrdXd!9TfI;H ze1fyY5&5Xe{d7A<4{h-P;(3DS-AAfyz3x?-Ac812w&blmx6q^g!sj3S#WYT0r&f}F zNAj5`#wKY*)8vgI(1DK?YTHT@@GpJ!zZ`*pwDp$ozwzh$f^CD~>!*cPr&~Ew&i_n0 z`9D&`91x2`D9=n)pna-A+DEE2F%40|zngnm1*A~<-Gke{Az}?G^^2H~z_1&Fhqu`b zcI<)`X~=14_2pXqtX`*^4^)ry_ChSv;VSC7gkMfGXvSwBLnrViLY`oEP~4Lu>JscC zx-kMaFSVkEy4P6NEQJO#5S&FrqQAgeeET#PnN8vm>j=SXG z{{k$KGUU{sn<&XzxVUNfgW6e)L>zA2kAJ|caG`KVA9nVS{&3?)(Wf z|2CTq*tl2^Ip%p17SL@R9LpV^x&F*Rbue6UepFl%|HjATIYqN+6UXl+xVrlE{%Y1R zCUFL#D^q}8L&m4-fWj-OiJ*l-Ic*qLj%-87Ak^mnU)VWP}NPDE+AtQ)xEineveNyZKei}*@-Rzfz)tq5QjC|Ypq?LPt_&Hl9NewyC{ge zd96uTgz<;RQIRY^bFIep{+NwVn410>5`nDCT~VC3ID4;zehtxi_?XX(_t4}^9R?1L z&FU$=)v7LG(nUEh#l()~W&PJR(xU<^@u5ZwH20(&vS7QNl9&5%n0Dihk5G)p(^6@- z-IP%OW$;kF^X^C-)IP8)Dj2z&rcq=fPuH{Q#&~^l@jKZ0U>&cKT>_%5b;&3fb)eo%uKF*O`|7axw*CV!TD+C ztQ&i)x?_9h#GJsdG22*iYsb}a!62N95b+{)(B>yvhOiBh4I;F1W;ZZ*@|m`offX>h zq4L_>za(rgqt6Nu2`?|Bj@dwVY8}}oQXNao$@>+C)8#WZC1Ew;6(wu2KI))~krsPO zW_LzuJ^W$W}yRj3x-$}v0EROS$$f_z} z9DcwYb1e}`bd{D))w?7(?~ZFJ zPw?AHWz{e3IU&P8@RvmQy>1Y$_D=+6eag1**0HtL1>+*NNXHYp1Ge!NuvPnp;AY=o zBint)+Ob65hhl}HzU9U(DS%rFL`ap?WAg8U-E6ZyfrZyy z%&kQY=6_kyv0Haz)JuKlOj~VYW1vrFITcho$Qu7hVgcS8U^td_h`$Z0B{~*B;e!Pi zxV+Of-i5I@n2Xi+suibx)t{H|6x<;57oPk%`ieFO9#E5=KH+@_4^t1ijTNYN_7obg zL5Hz`xd=qIBkEk{+m03cP4GNsP=9V#sVEM0jPZx)GU;~uOx#q6K>fnj?=D1Q$gFx* zz{`5g>696-`CXq;tYF>XQ1L_#>_^7Gd+FGFTe%+MnrwQ$)Z_2tII+Qt0u2gkC8ual zy`B}vo~1(>b{Q(=HrGD!G9e!p(7$Iq1gi78&so|LNaucO|50#<7g_Ec!j|3n9CKq9h+$`aSvLMmsRieX5|NVNPo^JaL&29TGhDfXRBmY2Or@A!|agQoG9?UBB~?{h}VLc{<+f ze-7q9*V#4IFpg1Pb7m@j@^;6!uq)7$uwJ!Cbf)QSZ(fOoRRx-8GCT&e+Q?UK%id>< zCiL`=w6w7x*2C-Z%eJ{j*y&6A~KT&q+ubIP>-ly!-Lj|0mm2=c0i34ILgB% z+EM;-?(m_}V4VM&C{fu0xW)j@lw+l5{L}Odn&A~U;07wq(gC+yJ>%pVs-;)E) zK>W!(V!}#`$Y$L+G!2T>bZ$jF9N~-+`f`t2{z{pex01F&fL3DN_9dMdwd*IzbqP#T zd~&M$P9x1{nX|z;2+p15Xxn@2UR-^R%Nq6wzUk7imKLb3*1-!4y^{CWWKhZl%_b9{ ztgfa+m~{SWJg14)$E`WdbvV1T^?sH*OY*%IoUt)o8W>#V8tQO!&wPO6}cC>v20Db;TJ3p6+QzZ^wfiMPU*MKboHMu+*b8 zyMidA-b+%l{yHx}l{6k1!J@R}ziMqNiKRtY`yRyz@u;h2LyN$q1q;a4N+b2^SLyLs z4DSo1z6<;GWO0xg5dNh9&b_fNDc<05#SbCAI&VUWLE&F6JPck)DcPr$2|+7vk813U zd!RK?pJ!TwTu==9NYv5xHLB!iIesFqR}0A zq~K@LXhTUMx#yZcy}n-2Q01li18Nx(C1xvYPZLZ{6+|93)X|=-bRIBGrB!c6&+f3y)?R`EKA2}^RQ(B}~(q4VlPVwmim+*qwKS;lX z0aEo?TNlqDUo`Rg2-EJpi;!Em@) zg&SoOA~j8u@I))wa7#lvclO9 zoJx2rX6%J0(HO@$d>zPyzQFT#>-i06hOo-JYj+!fUL>KagWEk|s$WHR>+F0BC`Jrp zw@%q)WNHBi6}jGnEFmMbwRx#0=+R53K${ggH^(#nWLKNUMnunp#r(iG{NF49rOWq` zzIPS6p1QV9Xr6s^qRAIbqSUkwZR(or>KwZ3omxSq{O^10=D%4z=#8TH=T8e#Q!^Xb zw0nK3-tFd>P}}~CK4h8m^!b~$r0wV9snLN?`X7`48e(25`@Iu-KSE|I`RP6lAODC< z)6nnI0Yjg;!>v7h*a#iHiQ}wyBw795^Ywe+YTj=^iiX0}#e;J&aZprcb4C9jTW8@{ z)wgy10|+Q>&@BQ=cQ+zPBi#*B(#@f}L%KmYl$6rl-5t^#TDsxzZv5T*JlFfY|HAt0 zz1E!HImVbtM1g}hA?I&lSUjG{Jp?I(BNlfNYRB}T#`8L?;-FtF-4mW2fBwR_eVDh& ze%;NLtn@EX?;(H0;b0?>q%vQ!q!ryc8{|Mf;Yh*p#;&_s9k=dFR5O>qF$sFf0XqXe z&xW~P(o9VI0jbV>9(dcq>h0hfU87+lNY%dL%dNHNvJgGSg)Ifk1)BvAS`&GYlf0W4>Kf3e{Ok?#IIdSW$WrXr-%N~1;>h&2 zQ$_^>7#^&IUx-$KsZ?ulpFZuhHM+yMsF%wOt)GtI7cFDwHcERR5J&W)H^z*}KB_9k zn3&5@v0J_3b=kQlQ1;yEm;n}y^ksN5hu}^sFJwL_1H@8@KnaWWKESO@H^;y((0;L@i?C<-cmlB<-Pv33ADQ`ZC+rLblmRolsEm3G*P+@}Z* za`u#(ZPL`LP9f{de4-W|>uaXbRhvp6=aNn(3(P`E<`2s$6wIO&=w#FqHWtBnQmnP_ z7GJIy592;u+(1X92o>Jbdj4%L8-|@#MwVtx%8ZiAHc;WRskFp?9+Y|;PkbCSQd|Qv zlE^=`yjgyOV2`kJJ+8H|E%Z6r{VOL>*#c6FbyX0&!H*qZdEPo*BDN(}zpBSHtmuv{ zT3;8#6x_-Ep+q3EEz#@NaYR`nY{zpY%IS#Ier|iWQ>@^VcT-O#jn<2=M(^zO2yf|R z-^CN7U}2ThbO(dKHMx&hx&EXVSVw!L^j!w0WF`oJ0DE&8kaclRQu!~Jf$NtDc|i1J84slEGy^b4_pQA@sse>g>h@uHCwsUe0gYVZRynH{|7ZH# znX9Q{)pHc@%gUxhY>=fSamDqlilqccG6w-+Y?yc-*?6E>#!E-{i9~y@+__=!(>HPK zhC-VIhBsAB$Ee*+fg-Pe4KWA4KNdSo8s^tZ913(~jsba?uPYF8}G#X3Jcg@I8HU{687#$+>yb{%YwQ{=5oNoqKev>Tc zBkPTU;~lv{0TGQVb4bE9GtS59im;xGf;5YW(+#dyjCZ~VcX=ebJBJq>nL0P!vJG&0 z^6;rq1WVK{VMKkn#y}_Op>Xq?T|lt)7U72K3uv1a@X$S%2|hzR+(VL10-Ap0UN-b4hq;O=Fw}6qhp>d+`WP_5*C@4tHNe{QNYmZMcem~cta$an27 z2=b&O1cfQTXku|8#f`1o)uvR%?o}B5u4s4Z<)@`Rbyj`9>Z&A?I{<*)o|Or+a$_FM z@C#g#lLAp#?%e?zPb(*fQqgDqAPk#Kq-q;;gX8&mgQWlhBWaRO1S>MV(x$n;1$t%& zLu#_)pkWw32*bOXv|Q#kf(57%G6csw^-}8uYuPW*LCg5=uI`ugpe-N}OS&w9m+w;B zwQ_j2N_F7Fu*INQ+ZFcP`ue9?69KskNac-E)B@ohNV?NI=1LbQzyiQ=RwP{*aYrb& z0Mk^$(2H-w75MLNO{gPJ^cB10@#YxCFo;lp0AZw3)vC2?;+`A*@mFzjV{)ng+3oy! z@>-CX`Z=oP&V9TYzhKF;p7=3KK(7^#h5OlGNgcGy=R7EtFJw%2+5(;1$I&1uCD?$3%fHto|Sm zB1bXMs(JM?OGLN=7HY{kZ5GyCJCJil+WGms-?aGoIkUY+;<>H))?EpH60m18ZWzKR z-}V&OxqWFR0hQ!n7cd}>%JzGT=0_B#lWIT>dgB~iDX~fy{FsmpwaHKi(x_nDWe($h zz|S+(bc`)!)6cl5u+Ktt>QFU&P)j`3GOw72%A!T<`|< zo}7nC$4tg*f6Am3ALyo0@uS#WqrrCw z0=WtA1FMF}q@VAza*&H$uHc_v|53nfpgmfLc#&SthqQ$LlCtfM}Vp&vVF9 zihR%jqZdck)Phq_%BPiLww@Lak8_HocycV zEf40QL0IC%lj?3|!oi-(8-5WtVpQH?9K}_hGSii%i~IzBHevbe=vWY7w6+4z@^zj-cVqiy<-RL#6rL$oB+Bs=_9(?0LvBh&qc;{Ev)<%{ z#AULfzDXGWW^vuy?|d8|1y3tKbRi#TOH<3wx;z!9#+?Y z^YTn@R@@xrX*mB0pdc<2E{QZ2`FX zKe1pj+7*3;lDbkMO-oMmni!n&GfB~O2(x}x>tIBpi4iljz>ghpu%KTeyvPURD`6VNZW@JI<*S zSo)jVyRD0r$>^~7;EPYxbq~({>|NOoa*a@pVhq=K8OeRITd8{zI91;B+~dOU_x^+B z{8pqmE-}}hJOljGG9$eB5v<>~)GyztI+a`F4Lm=$)xPk5zvTGzU>uhZZtE{<4;1mq zk9!pnNgyTI?ue2HV&F}JFnG3NxwgyNirf)N%0wLX(Co$>oj_-e2?OVnp;w`uL6SB!qmRCUwrOLfh0JzD z7~Dg4{k(E=5X3<+9pZ!)94hN;(eL=L|J>tXh&&Nv+vbjS(DT+DD zTR#h`hij$I821R;kMx^WoBtExZnzqK>-*v#$^|zGm=$H(CW$Ns>zlxROWj>Ng&sZc ziN+XjLk)+HXN(4xsav%*WVbL$0yA0r`#7O zcZ&C9#zaz8L1*DZE`N~-N2ELOvAX^BM|v^kyRJ-v5tFZO;p-dJn{Ty?$?flJjFod! zD2AA0{VT@|Z*}j;;HxvTP*W>^>t2MS4{HPJuB6b&FV~Y;)Gw;8q@0czUkSnV5p)8_ zH)6+IW}@I9EErT@V?{ls!QBNMicP6Fi7m);K}1YJN>ahB_}AA%x0lx*TL4_x0>-oQ zXcw&a*71+`**VKE(%EpwDqF=mepn z-Ko=U?6rtKk&~r$?Idp5+Ph@4=)UIKjb)Z{?1!~#u->A_ySW$mG`Q{F^q$ae&6)Mf zl(CSJI^!je{%WJy%d3*yL!LR_-rccV-t^>?k$JZ2_U4W8T8JNxjER5b`lJqb@EUZ!Nqh74m_dC8iy#%QzNgGEKhiS zFnegP{q4{)wE3flaStk(r~*4kLwuX@hG#Yr^BRz1LA32NE#l+I&^~<^_O=;ci+)O? zH&!(8adVjze%tM8!Mf!f-Me#hF8@pbxb=14J^psCFWo(lZhWj5IV<2i4c5?YmsLTf z0LcpNAk=to$ulrS1g<&8)02$A6 zuk}Mk{P$J?c6FA-91lXONcIrn>-WDa?l_w<1f$&VNObi_&u3={PzR;vu9hau{wlht z5HL->c|xtbZ|>d|3k(pl!}L&SA_E(5 z6VVnY9q!jMB!5$UgHH(;;%!TE!f2Zoii)k~w%EX+eX(79ex+Twbu*!jha5{lfUvt| zr_Ik}#AZ*qMi*8Wp63X<)s3$vvbPUR8WBj=ucLI}hrYcGx~;|Vi?7SpS*(MjM;91 z0oEpK$BRLh7Q|LvSDg_rODoLZ#+ndX^_h_?{6C!!d5Ey>vfq@Q8*v33F!aYf$M(i- zLe#UG42_Z56s?c`u~kb(HiKm1$C@7njVQ21;Ye`(`K8RZZsl zqvf!#<6Kf3>WXD%epNi9!gFgdKU3nWD_EhV#S&rrp>S@~Y!g1?GxDv8ZE#(AK@33p z5(@BT|2m{M2&8LGYsL9bif`yGn3F%iiK9cPZ(qpUGe0dv!~doDpmM*JGF;-io~8CY zl!hNKl|&@lORu<(+L7us={*ygHmO0&C<(%Ec8dJqUFs?PUu}Z#ZNJft*3#-0bjmkg zna&;z;H|c`NYMFVvBVv2+xyGTZWo( ztEXeOI_!asX{l+-9-%e)zvemX_$!!(MHIRH8^tg!KXBwByb+M~kTmR4&;c*hHGqk} zFci;X8~g)E?~CK&)l+8eU(%W)q}^++hTN>hxGD@7+EQ-8(NB_lzR~|F6D-)*h_U{R zR~esgOMAXL^`%)xC!7YrsdlbGB5H{fPzs~UAf}%1@pn#Qc)39HY~bmM>P?6FK_dU2 z>d()WX>tgeA|vHz5pvXwva#zvV@IJm7EQ|Ki4n2f6C$pg5$ZqY_C1Hj=p*= z!g#xlA6DhI0d)c>)dH^@`^b=)>!7h>1<5{b!kf25aVE6swpVX6C^-|FS8;+i^ArbJ zA{Be5d4^sZY(1InM~zd|w0P!P!@PfgTSFrISFfYTawLJ|f-0n(t$vD~L0znD`{DlL zwKax6#y-OX4!l_F33BKopxWm2$xqXhv{i}x^Y;eJx+hoqA%)m^?bS8 z&fwRww@5`Cmy%EKtiigXW-^2 zq8|fi1%Rel91?`{(TgLBLauJ}b~Nji@3>icReg!4Vg2H)+X39W-^V<+vB=xapeh^uEMvC;_N(EpKaSzQ;8b6$ zBa*=6WtU>LLPH@eCp_%klv#iABQ*n*8g7LZwCh))d%p#2=T7}ZxagiL`#@;)h^Ly~ z9BN1Nu2BJENsgtLr@UGx@ziX~mS_4(?AvpHTWjp|w--EIs;~37HuJ=u4cJ7wfdwU60qD7LHEn>X~X~Y34EO zA0>z(OIRp!IcaCmu@^MGjF6*15c{;b29)*~meoYi@D*K0cBh2Z$*QALfr*_8Xx?O$swtSx-lh8w5T#INxd??Qpt@(~O5S#W+uZTXCQiAwmCHyP+$4l|+^1`El znEOu~trbj$mf@QVnlNhpI!4Pr7Qj31nsoYC(*iMG=?HQ$w#4?!EI4L6j#J1OH96Rv zALM76GJK>|;pd+swL2Jng54Vr3uG>(fqc=33oTO z<#jWWc|`>3*aow;Oa14=CYLqpcfb5_zkK~<5Z7a92jcP(?O+MmmH<7)fa~!z6g5{g z-wI0L?l&Jdo1m&*Kww5*FGlshIvmrda6jw*Dy{lDikQ>(eOhRgE#U3}f)Lbamu3?9 zz1Q@E?_KYuba|3(>?i^W{ufqhQgA}wXBRR$sMg2)_4+5F5wRY@L>s}e@NpV)V2r|K z!#B*KB|}<6ltFuJxqgwSx1ezuTPW-6MOScngQ4u z$f8%`?onNF7w=_%u13Fi-zM;?(~VN|Q8T3tDpOlF3P{^m^G@GfRvuA(_9>Q%on3BqDi6?p?e%xA+ zRV`-;P!?E+S|j$nF5=Sw%q+GssLil0?_;HHVOo3K;(GdF8Ps~=(hrE+-_6O}UOj`j z@60aF+i01ZQy|qa5Ihno{)$ONIO(3g=Cj+BXpUKRYhu1|Ra)3EEx1z{ts40-DLOsX zNYxHutb*fFXNAX$Lw&JPWO#Gt3cOtgK)|hIK{73 z7*RzgW3*lf&7?ZqaF~C<@x3jNNFI! z)BpadtYqIAZ;uXRC^-h7pl%0y zetew2F!oJPlzWzslSTrT0CHV8EZza2kGeH1EtvUGl->)~Nllg+f?{-l+az#!wJ(AZ zie0tQZUXe@a3N|akT7_tt)5&Nj$2d%X_u+y8oR*FCd5cbDiPHys;N|Bddywx+Nb(f z)4pf*E+8GO`gT`MA@Q=72ZNdz6@zzuxn(4ghuHFO9Q6kZc%cfZ*eR=MWwToXNG94(i~Ri(M#zvm547q{mqz^CPJi) zN()0-5X!W!#9xdpp<(%2;!s_%VMDnjBUlh@a=!~2@VQ?RwETw6Cwq)(FVprN?&Yhe zEbznIi0a@0-5J(Ws4D0xD&sMZ&I=Xfki+JAv&``LjSbj=ml0|P_?uk;i}@GOkubGZ zxXa0Mrp<-?-M83Zg$G+hBxL+!Ml(6NQB)bR6=uemIL7*TFVI-d1l};F8soZg1$+dV z644J2(_0n*lTfRuhw^nMY9+m2uLN08w^JEIDonk#1w(P?*4{_)-`BCHo#T7W^LAq^ zu9LxAK4xaEA{87uWc(WT_=^!3t$aZeIKuJ9I>q&xDk`dKH72H3ZwyG_L4EF+KK#ACUbdKq#f+? zq#|O9Vg9rwHk9I55(!^JYG=b#dfBjWf4@@h(}DmD(3~FF8%TaqX_s_gqM zmrj>e!SDU2cDoWRPBVonWjD_+dB<6bQlEvr_6_&a;XV3!9O3&U2RD$NeONm;Fdjau zOo9dOwZz9X z*6AyTVzp36AxNf_y1Wf|8rk(W&MJ}`#YO`GO*O;M%O@aiJ%cAjQb z*V{QRGx2zC!4E}Ep4Q-TPT&?8_?7CuBStX4yM^S<%6|V>?a;$|#0*q?P>P3Zh+C)z zLyz+F;%Iv1))!K?4ZGFR=LG0wE6Q=zSh1p}*KdQm5Xc`s$<<_JDQdi~&Zsbg58y&f zTV-2h{x}#iy{mX@K-{f?w0V-5u;BGp`8STLQ!@S5lSiQy3zw}?ZHa38{!ridNJGCcG0cDU%S?}sF}&k zaZz=riKK!Xp6dk|PKG=*UyF8;qs?*=wH!~MU$xbly(f{f=$-voB1}>FUrcIuFDMFH zul({>EZ#gsF>zL@(>&aG)koVE6kfWI$%gGEa$=U>a$S;v3|I5Az_49<@WNu7-`jT zhZW3}afxfu{BHi)5Xa1VCW&|+{qpaAbq2JW&#xwpjMGzaTAtX<1`3>+&(5e>Sb99G z6}Y_O7oZ^aiqaN9>2>)6O8dca`qv3vnhJ4(ay)WNb1ieX(kRp1KfXzNflUca~^*}M#*L3^;5q(K^yB`pNICt0M{dWkbKR*7*wT$ z9iE}pc$LCoXVp=);FCaps))qGM+Bvy^25tAK$OHI78fbA5?N8a@C|2;v?I!`MyAbd zVq54BC?KUm3$m5c;c~9L+?XumN+tRurK;%(IXC5VX!u)7m4v2c>OG$%8G92^#J2Zc zCF~Ql3-f_)=+kqvrxQ%|MNa}~jVA5Xsq&dD-a9bI8Zd_v@=IiQgz$B~XV)Jah;SfO z4abKQATG2z78~u##=u&8qg5X*8DnA8O8`=&pthXJWY!hx{vQ@)j8JT7hZl@71be38 zW2obYCUr!K;1nmvdcV4L%(v~l?DfFk-u?Oq_kH&tppbYpj~F&;FWBpf+DiDdaU|qo zRueS+0h@=DfKVz`3KveB^=Dg*83Ki=)=kF;f5?6Sy-s=c4A+M9ew&_-cyd3ayiKa% zXW1-KnEU#Hl)da2-Aju(2-WbW6j!?45Vz%CnIpL>YD4(AZ$r~s&$1YdXWq>SJm{eV zCxny#SIO?8fpijOcx^<8YTl*&qf6qUnnXImJUgo(?=FmV#;9qUEz!8u%q_GuC6;=I z97~zsHc^Y|IA`y0!c?l(Jrh2;{JeGt9b-p^fd?IZTUvgPjcYiJ8>uf-E1 zzOPHeet;?cBL2@cMb`!}gmMM2! zr_XzCQ6LMvwxMX-(W6m`@ShLbRS>w0o!!fD46PCNVy3J%laAqyc26= zr|IT|&76uGX_eh_p^-d+X-hUcgasAWoaAuafA`_7`K8Drl z_8{)^GKg3{nHL2b?&=A|?@o3twPuZFNEYkAQH}6|nin>pg9p-j_XeK@jOKq&QE&#i z9|!U`5qR2tO-l%p=IF%CpSHzI)Siid+wddeF*nNyeP%tj(IHZSgIsfu&Gc>BOQvvD zEtYu*!y(6qLEu(5`0rc271+#{oToW$KB)!Zsu5DtoDZmI*cS0FK{x1>ayIvGYGy3K zCBYm3v0AD2g8uqo2pUsjPQ1^?>GZ-*Po=ezSISFwGz6rZ7A|wmCYQ_6vq47++{%Alm5F~d@O%?CzdCih(;<;ubyV#q3 zzl!N~v;``^I)!_JKLj3z{!8MiIn22Vmv|EDxbkEhj7eR(+iMwht8;Z1c$vbFbDO!I6Q>xWWv_)T zF{iutc$AwOkd752Ldu&MwcvNdmy${`)tSF1VK`Z>;iXC(^IHFI@DxDEGBxb}YXm_u z>@7$dmh)*-6WxWqRi;nA;MF(43}C}HlgK?_U$(4N98kOREUS9)No*a*69^%iQrMzHi*aID%aX+KXhhF$pJq#%_;KI?Ar4j9K_!y1xkx9|xgimV|Y<_BFpI6X=?D zc~yX?E_1Cw#>0(a_vu{>#TMf^R+tB2cP}U0QZtzPI+fEJaFJ-Qw3$==(>S`aczBYz z;A#ESN?}1Aes5|*_77*XcwdP3F&6BYy$khB6AMgRYeCO2)8P#w3%01fX060I`PsO|<58f*t zVHd7>3g!N|>)ady@NvVrsmra#i6w z?tUYLS8@qcd6{3G1x?zKtSp%MuaIe;USJ5ircUW^6O2DftiIU3isEOi#xg1d!rjY} z<+R;OWnxTOrBV}E8i2qomopaa3z;@~heE!MIz1p(3XwNVuw=TfyRl9bZ(@vqRWks9bud+_ zK*kPzt$&B|N?ZHM=#I#w6@uDQ-b>PMeLu!Mz;Nh(?M;EPgYU=q5UJmVLYibgVDjwK z*6jaKEQ7b<`-!iSBLn6%ydo$UXtjHik zQMJJhlP>BL=yur>SFS>vps%od`(e$L#HApX0URm}3t($3{8Q!(LndD7oTR zL`|8ss_30YhPy#(1y&8-(t_$gl3M%XgX15|hAkNjuOpU=J18(|9|Xu%z}`D+xY4e% zu5Oq}zD!{{>Es}9AbPP(sv0k6C($6_Jlr40U5>{H->=wQfmdYF4&lSVxDIGw3Vrs) zXj}9PX>7m&7@brn&J|04M9b~T&$XU1D`1_Mai+@Nz8X;~bHW0loneA4dh5+==joyU z+ZUeUc+-*P-4T@`*$m;x-Tr{02~V3$zlqvoGYNNn@r#hD~qc!+P~ z#G06j-2U5I;)9>7bog8MeGScH&eHtpl&3K#9DBe9LW)c)_ORmTpYO4}gN)dp(+Gro zD++Lu{aOiuX?Jt$F{B?vy0y&DSs!2hZa8!i@Q+Wv!COBin)_)w{HP~}`r`m6Abe`eoopC7k$i>13?OeHWRZ{A)vT2#6M?2Q7Qve$T)}geM^7z^bC2@M?Pe zh;%a-Zb`l++zNje&^gH|18uN^?pPo_OYm7TebCSjIj&z@%48fG2ji4c=fLI(534K3 zw!Wcf`Rhh<4AJ7^qY38~j@|k>DtGCs8Lu%6m~hp4{P!2%G{h1H|0A*Lnq}5IjskbJ z9rf32hGI8-j#Q50xqeL_=}+J6e7Nki{WtBCM#_lx!6ZHTm?PQPs%WqY=~><`hKngU zQ&dRw_Y|Qcobr0-d{4#i)D`5E3_&n^gX$jgCVM_CnP}V)KSBV*CRE(Fv(Q)NdkBqD zIAXCtx3SI>vmjDSXDdmf>s(4o>91IC-?&Wap}9Xhg?jI)ZGn>NCRBikpKgjZoLQ*c z6H~-UL|8H@0jz9;QKzw}jPDY-hK5Z+!2mKB9FW)TOPNFSvU;RiWkZW&zwcW41@){w zdcx3cs+gl3xHSQJRnEb;@2IGejfF$Nwr&1Ur|11*b%X4`zRZ^`r$d~}XEh+9ck?D| zt6;l5$b;{n{zhUcz|5=sMwnimZ{;zC0Is2_>46rsdTwIuY<}zdBT=>iC!Is^mTi#< z8eFm8Mul(6?kgO)gp9J!k4tqXl>i#`!2ZQCaau}vQ_o<|Z zTDNUaG~+Dzijh3&qW+X#&?ky}@=YSG?r?2l+}io#G!rNnuIWLbkXlkRzOAx^NAZhs z;S>(9!WGp7QNjX^k5YNQs_gWh-APmO7E|^-be17^ZHTGs&!#jP=)Nnh4uYhGqb&uS%BSR z0zg^%bccA|j&m=^k1aky>flCyFt7jBM#~Mf_PE5C5S&}H&1g-2h8=muTYt5Arl6}_ zZ0RAA5Kl7ugw#kGS+a}kp|AV%%Z-=1WQ0Fw5p^;;*YOr#w(KcUXqy@|*IHtQu`-AO zUO|fk6a;_kS8pT-ggipcW@=YIcAgO^eX(mCu9O?*qgZ+Be^7L|IPUxd?-r>Q20GJh zfp6_a=~O(|p6)>&mG%Vx`3*4n zQ6#c`Bg-#fYq2A0*gul13rcrFTnOZZ_@(XpmVMet_8#3hdiMntB7P306vBP2 z_ffj+HXE|51rCs$K|eK1(bi@<$HH*j_y_xuprPiY*ncWwy3m11hM)@!3)=0De_ zdd$?1l<$f8Oonj(n}$f*oW%V=;1>u#Xk8V(cV(3YzR}A&Bfy@PebgjNCgwQsk`BK5~9;> zv!$Exn7PD##aaddWbK+VW}8z=-q_FeqhFs`5~;#sF0Yas{tvm@$DLaQ*+k}N{->1v zNQxzzG*$)?54nnHO5;v6$4>fO6Gywa-m&c|m1pF6<{)K<BB{#{dW`=HEK5%UiLY26}1RHK$UGEI}H(jKo1(#f&@mUIe5zCPP>)$!M`BF%ue z$%7rgM-4JA-nKVX#K*-WhmXdC9Y4kkL%D_-b)lqu*GxTf=PZ$4ck85{*g`xSpV2WK z#HR)`XdgM&jA^By&@Eo~=^sx7kpRNVSPjT!q9SJPC{U$#o6h>UEP{Y1s$$|C-eZ%7l_#)31|Xy%(}m6xO%`7>oC%HqFWu;C@0=;s8YzD^657SAJl3 zaN5_~-7)gqWZLJZ>VsC{lI!+HKa%GTEnmmeY^125>!zJSR#8&(K3O{ z2)o-7e6aANbbUD~U))4X(r5oTqvsRHIoulc;}JOWB?Pq~T&x;4xAYx`)Gf2IS&6!e z?)kO`(x(%3s-;dgJcRx{sy=K$`Esz?jT-O>vzuzopSpel{nYv|Yo#LVkw7yN z(_U@Kw18I*gOo*)v~r5=%N4ckgvQRjXO`F=EKxTM1D&rVaj5n4m<(fWklr~wA;V-= zka@d~B3vIq+pUH02WWNqhKdrCb-wrlNUM%+)P<(MO%8or)p)gGD_w%kC`t4Uq(?x( zU?*ZDje#(hJtrt^Kg!MZbeM(wf)-Q@7k%8~a?JSf_`K~Dy`-0XMu01`0f}w8}qG}Hr;1q(@>){ z-w0!p?+X@MEDi%Cq=S1x;y=7R%ynx09zut-en)Vs*jE@yqY>Me=6~G`OWvq58M2_0 zH84{%7qN;X z#?NZcjHf)P5-s}uyn@#x@VR5er!sdC@Zp3rZ@%buV-elaS|{jZB=@oVFn6V(q_Pa3 z6oTyTrK-t~alAc>`UW2Eal9Yn@f+dEL`Rkk>27P8hmN@a@EXQcRZO)$*v(AKZXSaz z1*;BhO%=p<$L0mNJi4K`=9xKdK1Ypp;i5*M?TOzC{{$dAzfWSdtb& zg4{xa2F!{y4!g$K^r2c4+*RVbxyr=Qf;zHTxqBeR?2Hi}PVY;CX}G`un`m{pELd)G zcNZCQ_^Y@#TB$(Wwy(_5%Z1tXK{ccu%^IW9U`oxzdvhT9;}cP-QvMG}$QYASSh*?R z7|x$rXmy#0h{FWD=t;Tydkbc%q%YPJ`4)+%-cBnU?S3yv!e z^5^rSm%Gd^B{@j=4#V`i@>_Zs>AqJw^m5$?oH@Mw6(MHuF~5!bfl*I#qpi(T)qDg!lP^o+lT zb<_f+$B?^Sfs8aA=7BK*$2zM;;LCE#F!@W1y;6vO0%4b>y*1rb3H?ITCsN zF2jS;R9-5c!69{BlgXZ;4`&<7^ZZw)o3mDI45~$62bS2gB#v~&wxBdO@Q}XExzy7&Q_Rp|lAGzcfVGlqyCqM}73s4LE$`~e`zpyH|lbV3Ov1n!A&#~EP z=4!NBjuMU{s^AyJ3I`027D0XiJPWwr1BpggC=FFj2ozM8UC%DFxx2AwnzzAY+?Sm; zfD+4Xy0!NIqr?)2Hr9zp(dsVpc>ayB9#yn}bjBmqGDqV(j&iDiP=-j@E-Or-!ki$s zSfg~tx@c;grI1@u^9y{RHeo*QouWlPBX-mOK&(&dG^s_&sHv}wa4!r7HCl>Jv~-17 z7sEgLq^)BrC-fNWI@&_1!S6f)j1?Ytn64@l!X3e~WLyoT7|FjHcKUrU13FyZD$WAd zfN6T6dXt}FjY@C0O8(pEl_)DHe~X~H?ot+}v)lebHxuq?ceMueIkl49p4wvOR>WA` zUuQwR7#LVRCT3YIR;UgnXkX?2Bg6W?PC)_PQ4SyRegpxGtCKQX!|h#^7XBW4qChpGU$kw56C&xh4T&>T6A9jqcT=~6s_I$ck&xRk$;lZK3c*j z`3=keoduu+cl3^9PH`E&73m<#?E;s@N{fR4`4lJEfjl?;fRdK`--@hUyir0$7Hbbz zr^U|a%o_P>G1-{F7ANRRT^YSQ$aq8^w=zj8%G(6I`Qi1u-N~cM!+JbkoF0?#&5OWA zygh05GLQ|`f7PaEXdYL1WuRcpo3PM*M0Qqom5bv}T{d;EY)BoFy*0jEj=N}7z&GX8 zrSGH@B6i+ryV30H(Zw7;G2)`X-$c7!@gz$HJ{zhs9zJPYv(_>Nj|N)Jv+8)jy9E~W za|BK6p5%G~FiZcL*5IRku#);8`ykhFzyCGBVDK@I&$pZ5^fJEm){aCZ!|?yiboi1z zvu@hlAZ5JTS}!j&L0?D#(QW%9%2G-5T$?)&8uFM=c4l}Y!`QHLc#+UH;xd;=9L8&H z&p69*#@0tHc+s``k0ML|{fc65r*Y)U8>G|kIypG#S0^n6e6^6n3K01;?Od!lnf3!r z+p~R#|BT|Vv>m{I+UuQ3<`iFCzh4Zm{9OWE9Rm(`m@1QoM^>t$a3p3qPt97OPJp*w zND;#R+}jl|H2W6m#|)S3X3wX~1krM%q)d~bt1%?5w;h&csW*zYddqiG7_|ha-^DT1 zon9l(_?jtwuKbvJ?u=0^z`)tp0-g_F%7j~4wr+p}O#uSLMHiO)(?4I%jfW0D6QClK z@tEx*T=WQSNbx|1+EVBsXGL^Ejd8ml)2~ix-!e%b=RvA*c(FOh2;u9!(+sguULI4H;f3L9T3VIUrY2+$=13)c2Y4jjqwd33kbVK7%D-tslwxvPh@?N%RPK#@kj#5}oiJ+40wo+wq0A z=T(>CGDwfqf?`VcP)@o^eQptMSjM`zDK&w=sMTBt*UwX5?P6Qf>-Q!yLBq4Oo?lT6 z9MIs}h&IdXcNn@!^;%c%`;KCjkxT1Nl>0E7+`9EFM&8>}`N0K{EA&5k z45G=9!!VOEy^9!GeX&6&pUon{Y^!!pHF!EZKd#&)j^{-bcJ%VF9t2Do#MSU2qF)H0 zXr}KenQ`Zdw#NqO#U}c!7d`zMI?6eb^z+V2@+FZQ@Z7KWL=9gb2tHiP-P`{3mcLxr z6O7v$c_hdgX*a?a90xHei;n`Cr&))VHyuo9&AUxN=v6()F{z=!S~;BztJ8v1cOUvgcm+gX zZlsa4D{SyOn#6s5klX(#Fl0 z((8WYQ^{@%&9iq1g;--fw^6dOlfu zRUXIv>SMD1g(7opwX~{+@N};+Hd`M^D7-C5S{z+ORSGp7Z4werlt1WLbowoL3@`&) zwY|m^drZ7ycik3YP?-}qaRMPN?c6s8sS4Y_^uCyBfyI|es6Kf?B-aZ8cl|S?_~J!Y zR-p@5u6uKGb^CDMdkHmXu1v0)o3*iZDFFl+0M-->jTEqcMIqz;5y0g!aikJTv5$Bk)T zSfwgQDf~3kGMqzL;Fw-88fAbirIp=eDNx#MGO1MYyVHHJYnYOYM1+)Z)>`IF^SxqA z;xj(|H{nL9`j7a^;AY$u{(WpL7w7P%Zu{t5>CG^4Ke067wJ1msd{a;(l6$jG`mjw1 zl4d?@TRf07`E{ln{ij%nogrNXTXGDXwQe>syuDk+m2*QCvZOlzCL7H*vp!CZjBm$& z#LQ3`kqGT4(siR09cQ189T+RZX4td18oW*?{>KO?fOH|VY>1Fs*M=R&z;iUVy)It@ zNbxIo**RsATw|-Q-z$0$D+&BG z{Fzt8;9k{weu`wNc(=z+K;lD@>pW3w&fouGDr(n1A?Awt>6n`@gJpmHLy4eIe$zF& zv$U9ajfeUFBkkSanf@O*?l~nnRmvf!(t%P&atx~!IakX0OpY;f8ncZQ&%v;I%@3x0ZCwo1o_8T~|7cpL1#)Ydx$g!2Ooo_)~_x&1mB z$2!Z4wVw|?!6yOX{gTKLm7Zh$Ui;&qn9!uV2=BC{-`;#?p<>pNpgW$<1E{BmsP|uL z(i@5VGS0^DrHyKTjEX;#;)Pyb9E&oVgY+26@cTh?{+>T?KvRTajZnW1g=F;7|J%6G zQR9kwqJHso-MEQwLrw;XZ)eQo3h^Zch>O|S`%pMMIy>b8DAnqoQimhit zLV5WRcX@}CHdZ`U_l5Ul>qojB)I8TmGno8c&ClP$Zn}>yWrTJRkvd<!?`htSSDo&#c27L{{cKw0FiQa7#4*3eJXlIS>^bA~ zo`o0G2GZ~Y|GS$xE6$>8Ds!$Ua>^~ze; z>QzM`hsenn4EZ}MHikB1p}PxZgKFt@9#24p7tWqg9zIX7D>|p3^w?$XG|K#P+Hsf~ zHn;o#31*EbG|mf1xa}VXvw;6kFzY*uSNswM?SX9w{QSl#g~N~xp_-DYhZVtXonMuJ z|CxvIWf$lcDGR4ZmCzu||4+_3XC!=USl9r^JNch!zZtkjFlnqYf*xw7fd9x>hb6(5 z*8c^x9&N#&q00{it=m6`WH94}fu_l~!?#m^WHa3rrFQ1uwkjWdI8?NZFaFmOw47+r zoZqZItU0`udgh`X&`}K@SL$1D;oKR4DROqaY@jlGm;r0wNx1;YQZPOGBeLj zF=~UQ6TT?0SB+6ocLLMZ>;v2R{`2uq&mSJ7_jv#M`@}tkobGuvJU{SXAr1~>F*K_9ktyY(Jeq0%5P8Z~kR-7EaaYe}0 zWR|EVM3sg{y__-3QeqS29yP|odT=%~T^z$ULx~gD`(~EvDqmHq`8l~yikR4g!WI=} zt);^zuCo8NOW2^I(gO}fzzhE$5l}?6L-sdh$0Bb~c0k-RjrxQ`hl(y9H@e?n{QHBR z(03iIR~t)&_t*C|2g?ML>%I>y|4%jR*f0Ilmyu&hXWi~Fe<{TNZhSbxc|m;s?|Cb! z|LTM9D{Ka&@D~ScMq#v5`lLmqYbq+~gbYIwFmP6&F6lI9+Oso3Cozu-G~HxiWYh`h zGG346zS=McA2>7<>mobcT2@EQpuGY*te{==>IU2O3dqIwv+Up*_GUP0R9Z>B|1kGZ z+BYinhT=T^p#9r&96z^YwVHp}z-JAoxAQUR*4_D=29)_ba1mYEQCHpigyPA}0kKm< z`g1_edcz_WO4J9x+8P8Oy~HhDp|><*Cd#NUH?BQ|0`!}{=<7-e!FN?(mOqk9OQABf zo{Q?Sv25BLP_LD}z4(vb06fgFlnV2F!Ows7j}m$5%z5uw)R0+y0&{suXYYM*$!|z( zu9nT-!?0R#(Vbq}lA)iFWpZ^x&iQfafEo#S{=m%dF77Yf>P-z>B=X#4m1eDgK01U^ zKR6q;Tl*Bbt~2)rrI>o$Z!@#ZIZ^HGXtDn$!T(&XSpqs}I;;nwzQa`zIN*&4eV}hNkL=tWDqw2sY$wh&3~T(U1P;0I@Y8U^-l>=&wBjOH~I)43A|TYy>D~uUEjmEH{D}5U)Cf)A2KSK%UVq# zXbi2lMGr&Ogd`9WxJFn6U9MeCF$L@fFUQLnHb}-bb2Qk^GOH}A}40T&A z-pTY`<7>P6eUyqdt8G$7S5I>fm$&( zB66k1uX90hwdvKLZAOn z*SFwDHPj>E*Ojx0MeO&7ziQK6lL8jAFB({{RQ#7Ln9#{wYg6u4uz1_2sGM z9J}XAmukZ}M(-`&QF0)?w)XT%6^zok>~+;=ul?**ftmRnX14v2qHKr+Z$oc=-<*WC z_VjmoT!5v9P{`?Baab2$YW0em)u3E*8k4uEFGvQ;R1ZdBPQD1x7hi4cT?5rLLWdBZ ztzU@K;PbqUmn_QDsAKE?@Z-lc0NO~UMeb4@ht}S)tBUtWZSF|HsFy+0b7&(0os+Lk zh}@2*UZ7sB<2{4j$M*SFb#A5CpZcBnCCmDG+m3rxr0Qffes@yneWoU8^VM}cSJRP( z9g)J1^3VSLo;(K|Dt1YM^0;s&)tpYgBx5oy?^?feVOVr-iGw>_;-f{gIjWo2)l{m1 z&NIWstZ@4-rDa_uW{t@8-Lo607fUI*^Gr|jrR&JG68vs}U+Sv|DAeoeh{B9i!C690 z*ZEzFebMb8~U@{M-eMBbSDFIq5Grcx)XXL;R zCmw!P0%`U#5fJhD(1W!xh>f2i8X4+j-SUsyOZ9Cfq9DGj3EANo&a z^^CI+-9`>RQoHB!Yh|S^ZY)$X*^g;wuUitTl%~kQ5=vtd5;>Av`-H1q$veN>1BI?J zi$|ps`G^X*MWH2e+7TlqMc8f0vuoA8D7#(1T+S8X#~`b-KYrz=OTa%Y9X4E51~zXT z&QmZ%0f>9rGUk2#k0PPE1W%UY{{n6ii|f8YeSdbkxDK~QC%oW19f$vgTOQ&;V?~}z zHUF2yoa7zi`p01WE(gV|O_M)SD91u4D`ocZh}zNqmS3{X=`^VewyW| z=V|5>VsVQVSFW{7fi~6OPlTNiQrf&h{|Lg5Fi-r0QLEkV?&~+kZwo#LZ*vv2=hpy7 z8yoWB8o*~JLg$?&Pehgx{&IYMV>|SX^(eDGrO&jl@hYq!T!+=>-2Do=SP-%CR_Fy_ zl5w2P>3IEhIC5}C{FM8-D}cn!G!;67Ii9q>4o3W`jKJqUCm$5zJqOImntv& z{Zio7%`JCgbxbwP-ZmcMplmU;dC=y+o0#!d)4N{b#VI|=aG%24rBG*sBGoRQ@_WNC zBd5!`6Z8=0aFJCOFWL})6Jep2Ew^yhkN)14F*$KU``3LB%-PrZKUfJaOit6NfA}l) zn^GXxKL@dV78?;;APoTIvp7%~K{ER%FrVr`A%EfEypMStUuh@5KQ`zSnySU7yCMGP_>zV_? z4pmbpK9f>OfVDyThy~sFeNB{pba-KLSDe$hHc zlVUI}`g43Na&O}9K%zm)&3aRzyp4%JI$CB+OsnY3aHwcxKA~sh>D(J>^iN&`%IQLf z(DqAW7D&}zJz9@gL62DTO%3j6smXnE?Ruf6PB#d5A_T2dsyPTtPiCr%R!kUVPIOOd z&aLK!lbs0KU@72zEnUUhH$SZ1y^=q2axs?s$>9=1)$tomdz(fVlf`wd{$51nMrU@A zbAHc3lKU+gyL0n-2N_*S3)MB$NEC)LK`RIC9lK4k&K5G!Ggaz3FFKWmai&6y8P>zi z|90@l{T~D~ovsFh4_gC^Vp4-5Qy<&h$y?K?!qS7i?S=41L*#*Y18W(Xs`}ZsrK$Jg zb)kJg)1ipxgZqoZ3A&{0tE60bIqF0H{;Y`|<;0S{Nli+ASiKJrxUaAt;AGjy<%r|&Iihrhef8?2es`UFAI+B19}3VQ<>-!J<^IIoM#KSv z*vPsFa4@bpGyPZ~mHXWdCOftDq&M`g;+Wp7aO+!jAYBY#=U?ezX&bif9=i(F!3V_> zKP^=+9{_4Y_D{$odJb_AYVX0E-2+{FR?*fC^pAj5vXRHkQ5RT%%HwCG;;=o;Jrs83 zW8B03C2G^(t3|Jab#eO0jXbpJYBtzSlWtgm|2I(#Kg9Yo?gh_m67^H@ki-&uW*Y)@ z>dwaje^NaA(CGW%jzXNyv1m0l$&yz8Tb5?Eb?T~*;7hZw`*RXMXV5T4-=9W~`AUwv zf{DVo0Ns}s^Lk_Z3nwMhq@oq~HSDLV{>ApQHb=6o z;J33TvkQSrm8tm%SaL_1muZWzmvmF44*cOi=no6}$-rv`Zj1Y+Z^`>LRdq^fCNd&y zA!~CB%_Ug^5x>44Z%&X`)(}RM(uy5!(N|u+Tl~4o0+jc>T9c^sytNySLF|;weT;hI zByIgJR96`fF0Y}!?`OI;Y%A@&tZ!Vdp)6cah=JJwMJOAWJ;~qDX=QIfqS2GSLb5S^ zyf5V^UR#10>F@a*arg1I*IzjTdy-W3XamYx(Rb5mr@7Kag_Aj zd+Tb`)~^=6{a*Qfua{u6p#1ZPAuT#b^6#M6W&q~nP)y5Qu0+7~FZ-S~8w>x|x*~y< zOQQ&Xp2_2BkkNZbTK=(LjARwuv;V#uoOz1fF1oy>-E%hh&9ov zD6D*Vj;r%N#P32S=P&CAJ9kx_dA5@ySp}c1IS#luB$1l6xvz^N9j)EpSBm`_J79yZ zUBL(#m{dF|67(r)`SO-k3X~sZlbd3il~E7}-Mq zcrgAz*m>RQ`Kun*-dD7PwQj((3!a*Pd0F9!Dr7Eo;+tNx^X|=Bfd7oT`We_EIQ|p5 zOD-;xeSjOvv1XG&>{we3;*yziq1S(S{)5o9*2uto*$(Bo16`#J;M`v1VFx}W#=E*2 z_10(U$B1TTxPZClF{sdAsnw?AuM>^bNPXgY$T2%ZAavKXV*-(S(PLG*n3gc$?)-B5 zoJ7?Ajq)PQm%4EqlKUL-cj|Ky?J3(WDvZ$AtKDam^!~JcMr^Td5r6I`rZqR zVXS46R(8|1yFX)SdA}}TBG0|mH2?E`WZ>bDiM+$>dTqhh zj0gvva{sssCb&V9-h~?#d%#NW09I42cfT}>DWwfuK@`>PT) zr>?&n3S!Aph6AxF%bI`l-&y^*VB&OJ`B_J_OV>6X^=8gZ)|CypQJ4(8{#mdapDN z2M^(9KWjP1KlzN}h+87Iyj_a$QR~ye4{6*lf)n5Ct5$e@q|Gi1vb=Q&iDosTrzYI= zIQ%OvwHc3uZWIdjHSJttM9m>M3z)3`kTz^qC7V{smb_{l_O^*oJl4nZ(u_$xTp4Db zYY%s)90_wmaCWfyZ?R9_l3~CnVD-C^3igAtSMax=JSI%X_b>Hta3OrlTkCfDSIQ^F zAsDGIug)8K<|ExC#^7dbV7P zCMdr4L*aUj1o^EcROTR~b_`jdjZB?fRn7vYs9fr&NaP2uiwGZ6bz|HZW*cJRM?$?}^>%GUK?v_U0i z+jI8cDSQ>#k*@7Cif<40JKe{sWA6%V`_Vu=1$dhM@A$?aNGHrboYg#QnsR1EYlpxR zAN)9(d%I58LY`q*LEr+a0vd>u^Y`dwnI6(UN$grYJC73L2N8njz=4z$sj;VWGh>4m;xy zXAIFVD(^e|28Vg~v9&uAVWhGa<3oU0|6WaRBhxCy6B?9P)+0yp{7~3U$Aijf6K4)F zMr0p+TR^f4Xs;}dyu}!O$~px=oQYOKpMoDz+olsXdn8~@O991ixr*%-mE{iyBFvkeiGp66Chx12& zPc2i6(45sys0ugp3XYj|C|=lUx7T_&ozvo*ZY|q&E@73>sR0&ege#-Y^{O#55L7Xi zMl`!H<6=Kb9QnH~8u7AynOpC$6?UZ zgfWOKXPd_x z(q$l?nh-gBD+Q`~gsozJVT$#N*?SRwkSmEg@WKSi&-l3hN#UaUIeD=4Q)o7-!Y z3)b0OC|d|850+Li4~&oC;X5K6Ujt^Z;^5O7WI;>klK#m6Hqj5M|9cumCMv$cvceah zo7I&z!S}typqU1CyWB?%T{99cLL%g;o?+|5kLaT*hnnfC0>?rUluYA?RWy zJ@URk!sJFTL(0M8Mxzj;L4?jyVlzG?=S*QC(tlIE8hN$&Mx$LFhev~_y%Zsd10Mre|yBEpf7UBV;IQl?1<;j zg~h4ac8&YdHAB@!1*?*MaL(r-J>g|qo(AiKIRCi{XW7BUhvjVHkG@G^&155K5w-tf^GY{ z)^F|So3(GwM&}Ybhaw6RMMH@`Q#sE|mK=`md0kc59+}F&zjvk@o`MTwk55i4mB0z; z*@~Td(#f>hbT%eHn$ptOn+1dC4lUjs&W|Lrb-ALQlghE7#sb>S^7~_f)Pem0g8Z-| z8{^>hbnxcBh3+^n*3YgIaBo+R(TEtR-g9Y1(_r_O=y&8OfD;$B@Z^y^UpBb4@`@TH*B_pOk zpcP5tj_Q4q7`B%=aFZqd?1caNWtnm_O?hSd0VOM;Wi_rGMsEo4gK_AtpsBl@2hAq& zC+lca9SXZgpPkOPu6GnhpRL_{T*d*MO}H}EbMJp z)k3u{z)Jp;nmMhAc+7Cpv(xo*DH1c>Nm@_gn(dT)j_cF?b1>2fq!DCUl1+1fKXV*^ zz<@75^T^e7ej^c4Tf4)|$X@p7 z%^U`<-ga($D0cnlN7p%4+D?0;>S)Ih)@SYe*N=Vt4y(q_PrfTV^`48OV8x^C;XSA- z=w6w=dEOO=^5Jg$A(nj@bU+NPSi#NsWx<3$x(Sc3GuBv3m;1OTptBe0xR=(^PG)N$fj>ejI<$uu*6=)ZWR_ zt|!J%h${VbmX3!|oXx9=U&%NT!kkU2FeQpK_b|y;ep5UcTEq*No`e?ITPhJD15wcL5 z9X##^8Cylly-jF~<@Ay)^Zb-MI&22o1$kYuE{e_aOR{hab5P+|xIgpMG~4YKI#boq z<-(Ep`o5#GyTK!Vku0^V9B}&d+>Ri?;I7Wro=0W)b0x$pJuBy6PT4uYLAE7yU?FY> zc%F60EX)J3*!(iRvIoe{$yN4K+WUo;Ibko5Z``=BI*1gx%9vm23>f^S^A@w#Rl;qN zoSc612kTx_9i*yXg}@UA@{t!!@;ioQJG!`EGb64)wyYlQ`;J^0=+~Q1yQjL;{joGd zb<2it<(e>Lp{|d5%QCQXspF5mLlmW@5=V{WB@CA@Ddt$IS5kFl{VRTrx2IEYi5|FM zsE?Q4+|;lW@aublS*tCESZ+Od{vLkz+BIj3HM?s*qhIBjlpBr30U zPZ}pzE33f)8+?epFt_jDLX%L(%9J#ectQe>j0!>zq^|4ksSA(yN*pcb^bxG0GW$bQ>`}_7p-d|4qtfc z3t#N+mx%b%yJ#K)aT%;=qQuPA9MgW-ETLvDu4ChlXrb!+Ohqq*0Q?VPrJ6e@-ekj)+_ns zVjUv-$KegM7bliTj#v`ch!d8dQ~r}a=RtZ)+6iM$dxg*%d&;y7gINtRM|ZDAA`g;w z757PUZ`Wn7#ga0r(*^f(=QSMB#a5m9l}LU0tEcuxcb*`ji7ejnNe#^82H~!-OP2n6 z+rsKHuGiyV%s>$BDrPoHp}1wIq6x*KF2pl}Cybf@fj6Ot2jadEzNj)dM&#h&NQVVz z*jnRqHTb_;89kLv{^h{t>=2V_k}-vlKjpUHXdNb#JaJTh@&q2Qx+4J=3q{IIh z3P(9_gHfuoZCy^;qOql~sNNaEVCD;JzHopecI3cq?Gt1Vd!vAP?++Zi{o!RqHL zHSm-*Rm*bx6uHr+`QSpDbA8Tc;Pr zF5wD|V4Qtq!9vVe%+5#5Ob36fo7j~%ke?vh_D&v7WM2?si?2*hmg}v zWO`tEvMoWQZQ&+0@~^X`2iUN0v2_8OL(&4ik z88#H9OhmdEkT#PiHW4XX%?;rT+iUw_Y*fc?egy)ZD?brwY@us7ybSRz-=i+PT_c;; z_F?4E*+C(810xZNEElVa0krE3qJm_yL6ahUjq8Fewt)RTk=A;W)Ink(nh`eHE!+7e8|(mTy0kQJ)$!;ylEzJ7bt*N4w1T3Xt0{HZ7|eC zNJ7nM^R_!_Th89ubO59h@W>LCy89AalXtCN>UMB$ODtTAAGh1Jh6DH)wRCE|yPfT?U>A@%*Qa`*nPbunmr|n=$B^KH1v$cbE4R0zWSo#(ibm!_L{m2O`Xx= zmE)35A)M5{op5coZUe!!ROkfXD|OzJ1YA@J7o;|!xItE+HSYFp>q1aTFFSSFTEoM= zEeJ&&MY5K`fNhO71RKT@12CaQ&es{|xZm;`0YMB{CbOgb!1BSt&cgWdYQ4;q!tw=( z+Ka8OwPu$Wu?r}EK)~+&{)pj`6zT|PAM(noY+q$6ae(3bi2t0RvSY(+Rt{pUxDWF) zkqU70M5+i$tGI|Qh5V&^aTa89H}%zft5B<$3`?G)V(7Y zSu&M*Z;*BN;z=*8*%=)xUgNF*5=(g4pVjWy^_{J&&DPC7`jYj7eKJ~ilik*kw6iyr zbzpnQR~So+Q0wqaT?COBTnO64$@C&ba`MgmOQAc-;ZAGl9gQ%ut*RZ0o{XqSCWVgJ zA4pmY)oYF?k}o})o2@+ZXUk^X z+F7i_$yl%->p|Dsi)+y0wHLg-S~5*@(RI6eZB%^&sv43(W>$mO$znh=|JCc9X&bq?~`{-sC@D7*zD-w3Hkv2x-fqw1k$ zT_k*4$EuCV@duVj!dKm2~tt&(%l89V-85C!xlXc6uT{*M)%e=Q*WV z(&gdrXsyhx?bW)N-~SHy)Nyt^cT&4a1-cVPzo6Bp&Sg+nUn0^}*b1|v42`QOy~AuL zRqb6n$Go$A-iwU$7r;Lz-8bDC0`kgpo-~P4p+|L(&WGCxMRPFE{y@WG=Q2E z(TYx(ef2|gxjO!u-bwFw+1)K+%&!d#=sn8Zo}xe#k-6L0p}U65boOZ<91T%AMQ#5c z@%v~-DPfY+5p|?M0~O6OwOfffklDZb=jyo zhr);#WAi*m{zZ^C2tU6w!AbMuwTR)<6$ZMywBx+0{aFH`RN$)Yq<(`DRy!NHjqp7Z z+W^n9VCcdV^q4i3h~1Hrq9tw~E#^Mswd!hoMsEnakzKhQ-Ld$vt4VriSp5LP2U1#vT{XniDiUKkXreFFc~d8fMy&LOl~&J-(*th_Ps6b_uTtK3n_ zI5Pw;f8Nkm(f<*l`SK*NB6tr*j~OZT>eDKXxdTI1WgXKxKRm45))1!_XQiE8{**16 zaPsV3g)L2Tqj+ff$PwN{5WN7=LG00jL~#S=WpJyF`)b~NdWrsmh&m7&rSTl2POsS2Mv2X3@EhghBcF#1<~s3I+kL3*I1 z`Z#%rPnpwW1=+u)B^ko^HH#QA{AQyS0`?DaumoF9U*Y&O>M-zQMA@8^63Ax*pEziV zGAl1xYULh`D_wp(Vpq!0yjHUxm-UnNjzx4`|B!J>2(Ob^q+c|Z6rwDt@rvPsWAtXx zUm`R3{1XJTDeAvlkz{#i4vc_nj+Z)iVL>vjL4zeG6c8E>&g+#oNXC)0`&4^zjE`nL zSpkd#WDVbY7M}NKu=?1yW3cKXY_EdpSaq(R(V|gk7%YBI^xE0-dl8E=E9l{^X+))} z*TQwtAGa>xOtXXSD&9SP>}RUyKD9-2a>i!7C>KUyU$1)HXxU!P4~3c>w3VRV?EMR$ zllY9dlIJYH;vz(7k|$jWJ1Tp)fc(Fc2FZ)!v0LQP-Ui=qnWIVqbZ&uY2#$i^kp;9{ zbgmd)buF>6DdEeceS_^4?2W+MA&2G^!^D|#_+pQyd_|DZaG#;y1F}oUL-|-po!Q>B zZg2efh#ZRAd9yySx7h2fwDpQX1@)lyjz;B6H1!&h$bRs&fMng=qe~B$+FXOYo!4Bz z%r(Xi@n}MC`7~DVfJ1{DSH-MhZWxfEqXZZ@^hB+Si-CTwIsv6CkAr6xAEP*Cj@4ZISEQcn_!T)A~-cPn(u}fRi zG}x=Ptln|N0JKQWNnpIR&sPe;?}ZHT_SWwyGpMzji+qz;c1f zee_Yw;GQseNvQ{QD4g>24ZipLICTaz&v2*W%hp>|u_mOEoH{~r%1K6MP)a1Hph zu_MX0>S){GAUykj(gaUU_8V8-L8R?+=4Rtq&2g3f{87} zJuiU%QyuYKP5YBQMc3@uVof@_!<~S$k4D5ztEK_ILg7N!|Ex)WEm^na_Eo-e`VC+6 zo1@;z2IRpuY}rE_07byS*@>Tf6E`Bs!y)BdcH^iRa_{u_ojk){OE?QT_e0{1)3UPf7ZU;V^tZ1i=2hq6Xw5; zWY&E%6abQVLx)(RFUZB1^M zHbRRnY4^)Zc2;GH2j03+(h>e(s}7xxB7xAnIVP{CDWlLjKo=`QA`UPs&tO~;7i3sI zU~H;J2(7M(GN?9$Eotzbr8(OWP8Cykk(`+9xM7I}_Ab&X26C5Q8vD4s@S%WeW0GS{ zb9cuE9sFT4vf}*J#)^04LQXfoKP@{kaQ7DF078zf7knh%QAOu3f*=jU!|t{S@GDy@tq^NJT3=g0uu9%UQW4;#FSi@MY=q6U%{AnfqY0;2slP-c8oMpCK&%D^?%MG5{u~ zzLJ0}^zBZq-uhTj>og362aVlYA2a@`+w$5f*gH6#pMPv)Oju1#3n3?G61_5n=qv#T zGG4uc_@-cRz~-POL~HZPSnZvVg_>uTg)!9D7r`^S?f`azcLZiuin9C%kl|Vx_!nhu z4{9_=gE$JnfDHsshw;zrTh?o`WHjV|ξi^0*m29L3tJWXc2D@xWG1_OXr(W*z@g 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 literal 0 HcmV?d00001 diff --git a/build/conda/installer/assets/examples/README.md b/build/conda/installer/assets/examples/README.md new file mode 100644 index 000000000000..96ddb0c9cde1 --- /dev/null +++ b/build/conda/installer/assets/examples/README.md @@ -0,0 +1,40 @@ +# Example Extension Templates + +The extensions in this folder represent starting points for creating your own OpenBB extensions. The types of extensions that can be created are: + +- Router + - Create a new router path and define the functions for the app. +- Provider + - Add a new data provider source. +- OBBject + - Extend the response object returned by every command. + +## Installation + +### All Examples + +To install all example extensions, activate the environment, then run: + +```sh +python install_examples.py +``` + +### Individual Example + +To install an individual extension to the existing OpenBB environment, activate it, then navigate into the folder of the desired extension and enter: + +```sh +poetry install --only-root +``` + +Then, rebuild the OpenBB Python interface with: + +```sh +openbb-build +``` + +The new extension(s) will be available by importing the OpenBB package. + +```python +from openbb import obb +``` diff --git a/build/conda/installer/assets/examples/empty_obbject/README.md b/build/conda/installer/assets/examples/empty_obbject/README.md new file mode 100644 index 000000000000..d5f24806ed72 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_obbject/README.md @@ -0,0 +1,9 @@ +# Empty OBBject Extension + +This is an empty OpenBB Platform OBBJECT (Response Object) Extension. + +Install this extension locally with: + +```console +poetry install --only-root +``` \ No newline at end of file diff --git a/build/conda/installer/assets/examples/empty_obbject/empty_obbject/__init__.py b/build/conda/installer/assets/examples/empty_obbject/empty_obbject/__init__.py new file mode 100644 index 000000000000..4e8d88a52e06 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_obbject/empty_obbject/__init__.py @@ -0,0 +1,30 @@ +"""Empty OBBject extension.""" + +import warnings + +from openbb_core.app.model.extension import Extension +from openbb_core.app.model.obbject import OBBject + +warnings.filterwarnings( + "ignore", lineno=0 +) # This suppresses a warning you might see with IPython and OBBject Extensions on import and initialize. + +ext = Extension(name="empty") + +# OBBject Accessors are used to extend the functionality of the OBBject class. +# The name given to the Extension creates a new namespace in every output object of the Router. +# This is useful for formatting/processing the output of the function calls, where universal application is desired. + + +@ext.obbject_accessor +class Empty: + """An Empty OBBject extension.""" + + def __init__(self, obbject): + """Creates an instance of the Empty OBBject extension.""" + self._obbject: OBBject = obbject + + @staticmethod + def hello(): + """Print a greeting message.""" + print("Hello from the Empty OBBject extension!") # noqa: T201 diff --git a/build/conda/installer/assets/examples/empty_obbject/pyproject.toml b/build/conda/installer/assets/examples/empty_obbject/pyproject.toml new file mode 100644 index 000000000000..5b44d2856e5d --- /dev/null +++ b/build/conda/installer/assets/examples/empty_obbject/pyproject.toml @@ -0,0 +1,19 @@ +[tool.poetry] +name = "empty-obbject" +version = "0.0.1" +description = "An empty OBBject extension" +authors = ["OpenBB Team "] +readme = "README.md" +packages = [{ include = "empty_obbject" }] + +[tool.poetry.dependencies] +python = "^3.9,<3.13" +openbb-core = "^1" +openbb-platform-api = "^1" + +[build-system] +requires = ["poetry-core"] +build-backend = "poetry.core.masonry.api" + +[tool.poetry.plugins."openbb_obbject_extension"] +empty = "empty_obbject:ext" diff --git a/build/conda/installer/assets/examples/empty_provider/README.md b/build/conda/installer/assets/examples/empty_provider/README.md new file mode 100644 index 000000000000..1c6572627501 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/README.md @@ -0,0 +1,9 @@ +# Empty Provider Extension + +This is an empty OpenBB Platform Provider Extension. + +Install this extension locally with: + +```console +poetry install --only-root +``` \ No newline at end of file diff --git a/build/conda/installer/assets/examples/empty_provider/empty_provider/__init__.py b/build/conda/installer/assets/examples/empty_provider/empty_provider/__init__.py new file mode 100644 index 000000000000..b1010176fea1 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/empty_provider/__init__.py @@ -0,0 +1,21 @@ +"""Empty Provider Module.""" + +# Import the fetchers from each model. +from openbb_core.provider.abstract.provider import Provider + +from empty_provider.models.empty_model import EmptyFetcher + +empty_provider = Provider( + name="empty", + website="http://empty.io", + description="""The empty provider is a supplier of promises.""", + # credentials=["api_key"], # Credentials added here are mapped to `user_settings.json` in the `credentials` key. + fetcher_dict={ + "Empty": EmptyFetcher # The key is the name of the model defined in the @router decorator. + }, +) + +# Every provider follows this same pattern, so it is possible to import the fetchers from other providers +# and map them to the fetcher_dict above. +# from openbb_yfinance import yfinance_provider +# yfinance_fetchers = yfinance_provider.fetcher_dict.copy() diff --git a/build/conda/installer/assets/examples/empty_provider/empty_provider/models/__init__.py b/build/conda/installer/assets/examples/empty_provider/empty_provider/models/__init__.py new file mode 100644 index 000000000000..b62c0791abc6 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/empty_provider/models/__init__.py @@ -0,0 +1 @@ +"""Empty Provider Models.""" diff --git a/build/conda/installer/assets/examples/empty_provider/empty_provider/models/empty_model.py b/build/conda/installer/assets/examples/empty_provider/empty_provider/models/empty_model.py new file mode 100644 index 000000000000..d8b02760c5fe --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/empty_provider/models/empty_model.py @@ -0,0 +1,93 @@ +"""Empty Fetcher Model. This model is used in conjunction with the 'empty_router' extension.""" + +# pylint: disable=unused-import +# flake8: noqa: F401 + +from datetime import ( + date as dateType, + datetime, +) +from typing import Any, Dict, Optional + +from openbb_core.provider.abstract.data import Data +from openbb_core.provider.abstract.fetcher import Fetcher +from openbb_core.provider.abstract.query_params import QueryParams +from pydantic import Field + + +class EmptyQueryParams(QueryParams): + """Empty Query Params""" + + some_param: Optional[str] = Field( + default=None, + description="Some param", + ) + + +class EmptyData(Data): + """Empty Data""" + + date: Optional[dateType] = Field( + default=None, + description="Date of the data.", + ) + title: Optional[str] = Field( + default=None, + description="Title of the data.", + ) + + +class EmptyFetcher( + Fetcher[ + EmptyQueryParams, + EmptyData, # Change the Typing when returning a list of models - i.e, records. + ] +): + """Empty Fetcher.""" + + @staticmethod + def transform_query(params: Dict[str, Any]) -> EmptyQueryParams: + """Transform query params.""" + transformed_params = params.copy() + # if transformed_params.get("some_param"): + # do something + # + # This is where you can set default values for query parameters. + # Essentially, `@model_validate(mode='before')`. + return EmptyQueryParams(**transformed_params) + + @staticmethod + async def aextract_data( + query: EmptyQueryParams, + credentials: Optional[Dict[str, str]], + **kwargs: Any, + ) -> Dict: # Typing here should match the 'data' input of 'transform_data'. + """Extract data.""" + # pylint: disable=import-outside-toplevel + # from openbb_core.provider.utils.helpers import ( + # make_request, + # amake_request, + # amake_requests, + # get_querystring, + # ) Use these to make HTTP requests. + + # We import here so that items are imported on execution, not on initialization. + # Critical for modules that introduce a heavy load on the system. + # Generally, any module required for data retrieval and parsing should be 'lazy' imported. + # This is to ensure that the module is only imported when needed. + + print(query.some_param) # noqa: T201 + results = { + "date": datetime.now().date(), + "title": "Hello from the Empty Provider extension!", + } + return results + + @staticmethod + def transform_data( + query: EmptyQueryParams, + data: Dict, # Typing here matches the output of '(a)extract_data'. + **kwargs: Any, + ) -> EmptyData: # Typing here matches the Fetcher's definition. + """Transform data.""" + return EmptyData.model_validate(data) diff --git a/build/conda/installer/assets/examples/empty_provider/empty_provider/utils/__init__.py b/build/conda/installer/assets/examples/empty_provider/empty_provider/utils/__init__.py new file mode 100644 index 000000000000..da3e91ec2bdf --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/empty_provider/utils/__init__.py @@ -0,0 +1 @@ +"""Utilities and Helpers.""" diff --git a/build/conda/installer/assets/examples/empty_provider/pyproject.toml b/build/conda/installer/assets/examples/empty_provider/pyproject.toml new file mode 100644 index 000000000000..ddd23370ef69 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_provider/pyproject.toml @@ -0,0 +1,20 @@ +[tool.poetry] +name = "empty-provider" +version = "0.0.1" +description = "Empty provider extension for OpenBB" +authors = ["OpenBB Team "] +readme = "README.md" +packages = [{ include = "empty_provider" }] + +[tool.poetry.dependencies] +python = "^3.9,<3.13" +openbb-core = "^1" +openbb-platform-api = "^1" + + +[build-system] +requires = ["poetry-core"] +build-backend = "poetry.core.masonry.api" + +[tool.poetry.plugins."openbb_provider_extension"] +empty = "empty_provider:empty_provider" diff --git a/build/conda/installer/assets/examples/empty_router/README.md b/build/conda/installer/assets/examples/empty_router/README.md new file mode 100644 index 000000000000..e10523ea5805 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_router/README.md @@ -0,0 +1,9 @@ +# Empty Router Extension + +This is an empty OpenBB Platform Router Extension. + +Install this extension locally with: + +```console +poetry install --only-root +``` \ No newline at end of file diff --git a/build/conda/installer/assets/examples/empty_router/empty_router/__init__.py b/build/conda/installer/assets/examples/empty_router/empty_router/__init__.py new file mode 100644 index 000000000000..100f486d1016 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_router/empty_router/__init__.py @@ -0,0 +1 @@ +"""An Empty OpenBB Router extension.""" diff --git a/build/conda/installer/assets/examples/empty_router/empty_router/empty_router.py b/build/conda/installer/assets/examples/empty_router/empty_router/empty_router.py new file mode 100644 index 000000000000..142416f04e6d --- /dev/null +++ b/build/conda/installer/assets/examples/empty_router/empty_router/empty_router.py @@ -0,0 +1,69 @@ +"""Empty Router Extenision for OpenBB Platform.""" + +from datetime import datetime + +from openbb_core.app.model.command_context import CommandContext +from openbb_core.app.model.example import APIEx, PythonEx +from openbb_core.app.model.obbject import OBBject +from openbb_core.app.provider_interface import ( + ExtraParams, + ProviderChoices, + StandardParams, +) +from openbb_core.app.query import Query +from openbb_core.app.router import Router +from openbb_core.provider.abstract.data import Data + +router = Router(prefix="", description="An Empty OpenBB Router Extension.") + +# The first function call will take longer than the rest, as modules are loaded on the first call. + +# Note that all routers must return an instance of `OBBject`, where the output is the `results` attribute. + + +# This is a standard router "get" command. +@router.command( + methods=["GET"], + examples=[ + PythonEx( + description="Say Hello.", + code=[ + "result = obb.empty.hello()", + ], + ), + ], +) +async def hello() -> ( + OBBject[dict] +): # The output of every router command must be an instance of `OBBject`. + """OpenBB Hello World.""" + return OBBject( + results={ + datetime.now().strftime( + "%Y-%m-%d" + ): "Hello from the Empty Router extension!" + } + ) + + +# This uses the Provider Interface to call the empty provider fetcher. +@router.command( + model="Empty", + examples=[ + APIEx(parameters={"provider": "empty"}), + PythonEx( + description="Say Hello.", + code=[ + "result = obb.empty.empty_function()", + ], + ), + ], +) +async def empty_function( + cc: CommandContext, + provider_choices: ProviderChoices, + standard_params: StandardParams, + extra_params: ExtraParams, +) -> OBBject[Data]: + """An empty function using the Provider Interface.""" + return await OBBject.from_query(Query(**locals())) diff --git a/build/conda/installer/assets/examples/empty_router/empty_router/empty_views.py b/build/conda/installer/assets/examples/empty_router/empty_router/empty_views.py new file mode 100644 index 000000000000..aa9fa999b7d7 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_router/empty_router/empty_views.py @@ -0,0 +1,29 @@ +"""Views for the Empty Extension.""" + +# pylint: disable=unused-import +# flake8: noqa: F401 + +from typing import TYPE_CHECKING, Any, Dict, Tuple + +if TYPE_CHECKING: + from openbb_charting.core.openbb_figure import OpenBBFigure + +# If `openbb-charting` was installed, this will be used to create a chart. +# Process the data by accessing, "kwargs["obbject_item"]", the function results. +# The return is a Tuple of the OpenBBFigure and a Dict of the data, so it can be +# returned to the Fast API endpoint. Use `fig.to_plotly_json()` to convert the +# OpenBBFigure to a JSON serializable object. + + +class EmptyViews: + """Empty Views.""" + + # @staticmethod + # def empty_hello( # noqa: PLR0912 + # **kwargs, + # ) -> Tuple["OpenBBFigure", Dict[str, Any]]: + # """Get Derivatives Price Historical Chart.""" + # pylint: disable=import-outside-toplevel + # from openbb_charting.charts.price_historical import price_historical + + # return price_historical(**kwargs) diff --git a/build/conda/installer/assets/examples/empty_router/pyproject.toml b/build/conda/installer/assets/examples/empty_router/pyproject.toml new file mode 100644 index 000000000000..4aceb55fcaa5 --- /dev/null +++ b/build/conda/installer/assets/examples/empty_router/pyproject.toml @@ -0,0 +1,19 @@ +[tool.poetry] +name = "empty-router" +version = "0.0.1" +description = "An empty OpenBB Router extension" +authors = ["OpenBB Team "] +readme = "README.md" +packages = [{ include = "empty_router" }] + +[tool.poetry.dependencies] +python = "^3.9,<3.13" +openbb-core = "^1" +openbb-platform-api = "^1" + +[build-system] +requires = ["poetry-core"] +build-backend = "poetry.core.masonry.api" + +[tool.poetry.plugins."openbb_core_extension"] +empty = "empty_router.empty_router:router" diff --git a/build/conda/installer/assets/examples/install_examples.py b/build/conda/installer/assets/examples/install_examples.py new file mode 100644 index 000000000000..8a64b94c875c --- /dev/null +++ b/build/conda/installer/assets/examples/install_examples.py @@ -0,0 +1,48 @@ +"""Script to install the example extensions in develop mode to the current Python environment.""" + + +def main(): + """Run the setup script.""" + # pylint: disable=import-outside-toplevel + import glob + import os + import subprocess + from pathlib import Path + + try: + import openbb # noqa: F401 # pylint: disable=unused-import + except ImportError: + subprocess.check_call("openbb-build", shell=True) # noqa: S602, S607 + + base_dir = Path(__file__).parent + + directories = [ + os.path.join(base_dir, d) + for d in os.listdir(base_dir) + if os.path.isdir(os.path.join(base_dir, d)) + and glob.glob(os.path.join(base_dir, d, "*.toml")) + ] + + for directory in directories: + subprocess.check_call( + [ # noqa: S603 + os.sys.executable, + "-m", + "poetry", + "install", + "-C", + directory, + "--only-root", + ] + ) + + subprocess.check_call("openbb-build", shell=True) # noqa: S602, S607 + + print( # noqa: T201 + "\nExample extensions have been installed and are ready-to-use." + "\nTo connect the examples to OpenBB Pro and edit the code live, run: openbb-api --reload\n" + ) + + +if __name__ == "__main__": + main() diff --git a/build/conda/installer/assets/examples/python_basics.ipynb b/build/conda/installer/assets/examples/python_basics.ipynb new file mode 100644 index 000000000000..85ab032878d0 --- /dev/null +++ b/build/conda/installer/assets/examples/python_basics.ipynb @@ -0,0 +1,3848 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Getting The Python Basics Right\n", + "\n", + "Special thanks to PyQuantNews for donating this content. Subscribe [here](https://www.pyquantnews.com/) for free Python resources that will help you get started with Python for Quant Finance.\n", + "\n", + "## Code Comments\n", + "\n", + "A comment is a note made by a programmer in the source code of a program. Its purpose is to clarify the source code and make it easier for people to follow along with what is happening. Anything in a comment is generally ignored when the code is actually run, making comments useful for including explanations and reasoning as well as removing specific lines of code that you may be unsure about. Comments in Python are created by using the pound symbol (`# Insert Text Here`). Including a `#` in a line of code will comment out anything that follows it." + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": {}, + "outputs": [], + "source": [ + "# This is a comment\n", + "# These lines of code will not change any values\n", + "# Anything following the first # is not run as code" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You may hear text enclosed in triple quotes (`\"\"\" Insert Text Here \"\"\"`) referred to as multi-line comments, but this is not entirely accurate. This is a special type of `string` (a data type we will cover), called a `docstring`, used to explain the purpose of a function." + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "' This is a special string '" + ] + }, + "execution_count": 2, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "\"\"\" This is a special string \"\"\"" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "\u001b[0;31mInit signature:\u001b[0m \u001b[0mstr\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m/\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", + "\u001b[0;31mDocstring:\u001b[0m \n", + "str(object='') -> str\n", + "str(bytes_or_buffer[, encoding[, errors]]) -> str\n", + "\n", + "Create a new string object from the given object. If encoding or\n", + "errors is specified, then the object must expose a data buffer\n", + "that will be decoded using the given encoding and error handler.\n", + "Otherwise, returns the result of object.__str__() (if defined)\n", + "or repr(object).\n", + "encoding defaults to sys.getdefaultencoding().\n", + "errors defaults to 'strict'.\n", + "\u001b[0;31mType:\u001b[0m type\n", + "\u001b[0;31mSubclasses:\u001b[0m StrEnum, DeferredConfigString, FoldedCase, _rstr, _ScriptTarget, _ModuleTarget, LSString, include, Keys, InputMode, ..." + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "str??" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Make sure you read the comments within each code cell (if they are there). They will provide more real-time explanations of what is going on as you look at each line of code." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python Objects - Basic Types & Variables\n", + "\n", + "Everything in Python is an **object** and every object in Python has a **type**. Some of the basic types include:\n", + "\n", + "- **`int`** (integer; a whole number with no decimal place)\n", + " - `10`\n", + " - `-3`\n", + "- **`float`** (float; a number that has a decimal place)\n", + " - `7.41`\n", + " - `-0.006`\n", + "- **`str`** (string; a sequence of characters enclosed in single quotes, double quotes, or triple quotes)\n", + " - `'this is a string using single quotes'`\n", + " - `\"this is a string using double quotes\"`\n", + " - `'''this is a triple quoted string using single quotes'''`\n", + " - `\"\"\"this is a triple quoted string using double quotes\"\"\"`\n", + "- **`bool`** (boolean; a binary value that is either true or false)\n", + " - `True`\n", + " - `False`\n", + "- **`NoneType`** (a special type representing the absence of a value)\n", + " - `None`\n", + "\n", + "In Python, a **variable** is a name you specify in your code that maps to a particular **object**, object **instance**, or value.\n", + "\n", + "By defining variables, we can refer to things by names that make sense to us. Names for variables can only contain letters, underscores (`_`), or numbers (no spaces, dashes, or other characters). Variable names must start with a letter or underscore.\n", + "\n", + "

" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Operators\n", + "\n", + "In Python, there are different types of **operators** (special symbols) that operate on different values. Some of the basic operators include:\n", + "\n", + "- arithmetic operators\n", + " - **`+`** (addition)\n", + " - **`-`** (subtraction)\n", + " - **`*`** (multiplication)\n", + " - **`/`** (division)\n", + " - __`**`__ (exponent)\n", + "- assignment operators\n", + " - **`=`** (assign a value)\n", + " - **`+=`** (add and re-assign; increment)\n", + " - **`-=`** (subtract and re-assign; decrement)\n", + " - **`*=`** (multiply and re-assign)\n", + "- comparison operators (return either `True` or `False`)\n", + " - **`==`** (equal to)\n", + " - **`!=`** (not equal to)\n", + " - **`<`** (less than)\n", + " - **`<=`** (less than or equal to)\n", + " - **`>`** (greater than)\n", + " - **`>=`** (greater than or equal to)\n", + "\n", + "When multiple operators are used in a single expression, **operator precedence** determines which parts of the expression are evaluated in which order. Operators with higher precedence are evaluated first (like PEMDAS in math). Operators with the same precedence are evaluated from left to right.\n", + "\n", + "- `()` parentheses, for grouping\n", + "- `**` exponent\n", + "- `*`, `/` multiplication and division\n", + "- `+`, `-` addition and subtraction\n", + "- `==`, `!=`, `<`, `<=`, `>`, `>=` comparisons\n", + "\n", + "> See https://docs.python.org/3/reference/expressions.html#operator-precedence" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [], + "source": [ + "# Assigning some numbers to different variables\n", + "num_1 = 10\n", + "num_2 = -3\n", + "num_3 = 7.41\n", + "num_4 = -0.6\n", + "num_5 = 7\n", + "num_6 = 3\n", + "num_7 = 11.11" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "10" + ] + }, + "execution_count": 5, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "num_1" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "7" + ] + }, + "execution_count": 6, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Addition\n", + "num_1 + num_2" + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "-10.41" + ] + }, + "execution_count": 7, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Subtraction\n", + "num_2 - num_3" + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "-4.446" + ] + }, + "execution_count": 8, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiplication\n", + "num_3 * num_4" + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "-0.08571428571428572" + ] + }, + "execution_count": 9, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Division\n", + "num_4 / num_5" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "343" + ] + }, + "execution_count": 10, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Exponent\n", + "num_5**num_6" + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "15.11" + ] + }, + "execution_count": 11, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Increment existing variable\n", + "num_7 += 4 # num_7 = num_7 + 4\n", + "num_7" + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "1" + ] + }, + "execution_count": 12, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Decrement existing variable\n", + "num_6 -= 2\n", + "num_6" + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "37.05" + ] + }, + "execution_count": 13, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiply & re-assign\n", + "num_3 *= 5\n", + "num_3" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "-101.14999999999999" + ] + }, + "execution_count": 14, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Assign the value of an expression to a variable\n", + "num_8 = num_1 + num_2 * num_3\n", + "num_8" + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 15, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Are these two expressions equal to each other?\n", + "num_1 + num_2 == num_5" + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 16, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Are these two expressions not equal to each other?\n", + "num_3 != num_4" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 17, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Is the first expression less than the second expression?\n", + "num_5 < num_6" + ] + }, + { + "cell_type": "code", + "execution_count": 18, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 18, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Is this expression True?\n", + "5 > 3 > 1" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 19, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Is this expression True?\n", + "5 > 3 < 4 == 3 + 1" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [], + "source": [ + "# Assign some strings to different variables\n", + "simple_string_1 = \"an example\"\n", + "simple_string_2 = \"oranges \"" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'an example of using the + operator'" + ] + }, + "execution_count": 21, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Addition\n", + "simple_string_1 + \" of using the + operator\"" + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'an example'" + ] + }, + "execution_count": 22, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Notice that the string was not modified\n", + "simple_string_1" + ] + }, + { + "cell_type": "code", + "execution_count": 23, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'oranges oranges oranges oranges '" + ] + }, + "execution_count": 23, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiplication\n", + "simple_string_2 * 4" + ] + }, + { + "cell_type": "code", + "execution_count": 24, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'oranges '" + ] + }, + "execution_count": 24, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# This string wasn't modified either\n", + "simple_string_2" + ] + }, + { + "cell_type": "code", + "execution_count": 25, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 25, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Are these two expressions equal to each other?\n", + "simple_string_1 == simple_string_2" + ] + }, + { + "cell_type": "code", + "execution_count": 26, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 26, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Are these two expressions equal to each other?\n", + "simple_string_1 == \"an example\"" + ] + }, + { + "cell_type": "code", + "execution_count": 27, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'an example that re-assigned the original string'" + ] + }, + "execution_count": 27, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add and re-assign\n", + "simple_string_1 += \" that re-assigned the original string\"\n", + "simple_string_1" + ] + }, + { + "cell_type": "code", + "execution_count": 28, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'oranges oranges oranges '" + ] + }, + "execution_count": 28, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiply and re-assign\n", + "simple_string_2 *= 3\n", + "simple_string_2" + ] + }, + { + "cell_type": "code", + "execution_count": 29, + "metadata": {}, + "outputs": [], + "source": [ + "# Note: Subtraction, division, and decrement operators do not apply to strings." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Data Structures\n", + "\n", + "> Note: **mutable** objects can be modified after creation and **immutable** objects cannot.\n", + "\n", + "Containers are objects that can be used to group other objects together. The basic container types include:\n", + "\n", + "- **`str`** (string: immutable; indexed by integers; items are stored in the order they were added)\n", + "- **`list`** (list: mutable; indexed by integers; items are stored in the order they were added)\n", + " - `[3, 5, 6, 3, 'dog', 'cat', False]`\n", + "- **`tuple`** (tuple: immutable; indexed by integers; items are stored in the order they were added)\n", + " - `(3, 5, 6, 3, 'dog', 'cat', False)`\n", + "- **`set`** (set: mutable; not indexed at all; items are NOT stored in the order they were added; can only contain immutable objects; does NOT contain duplicate objects)\n", + " - `{3, 5, 6, 3, 'dog', 'cat', False}`\n", + "- **`dict`** (dictionary: mutable; key-value pairs are indexed by immutable keys; items are NOT stored in the order they were added)\n", + " - `{'name': 'Jane', 'age': 23, 'fav_foods': ['pizza', 'fruit', 'fish']}`\n", + "\n", + "When defining lists, tuples, or sets, use commas (,) to separate the individual items. When defining dicts, use a colon (:) to separate keys from values and commas (,) to separate the key-value pairs.\n", + "\n", + "Strings, lists, and tuples are all **sequence types** that can use the `+`, `*`, `+=`, and `*=` operators." + ] + }, + { + "cell_type": "code", + "execution_count": 30, + "metadata": {}, + "outputs": [], + "source": [ + "# Assign some containers to different variables\n", + "list_1 = [3, 5, 6, 3, \"dog\", \"cat\", False]\n", + "tuple_1 = (3, 5, 6, 3, \"dog\", \"cat\", False)\n", + "set_1 = {3, 5, 6, 3, \"dog\", \"cat\", False}\n", + "set_2 = set((\"jane\", \"jaya\", \"jukes\", \"jason\", \"john\"))\n", + "dict_1 = {\"name\": \"Jane\", \"age\": 23, \"fav_foods\": [\"pizza\", \"fruit\", \"fish\"]}\n", + "dict_2 = {\"name\": \"Javier\", \"age\": 45, \"fav_foods\": [\"chicken\", \"veg\", \"candy\"]}" + ] + }, + { + "cell_type": "code", + "execution_count": 31, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False]" + ] + }, + "execution_count": 31, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Items in the list object are stored in the order they were added\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 32, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "(3, 5, 6, 3, 'dog', 'cat', False)" + ] + }, + "execution_count": 32, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Items in the tuple object are stored in the order they were added\n", + "tuple_1" + ] + }, + { + "cell_type": "code", + "execution_count": 33, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3, 5, 6, False, 'cat', 'dog'}" + ] + }, + "execution_count": 33, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Items in the set object are not stored in the order they were added\n", + "# Also, notice that the value 3 only appears once in this set object\n", + "set_1" + ] + }, + { + "cell_type": "code", + "execution_count": 34, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Jane', 'age': 23, 'fav_foods': ['pizza', 'fruit', 'fish']}" + ] + }, + "execution_count": 34, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Items in the dict object are not stored in the order they were added\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 35, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes']" + ] + }, + "execution_count": 35, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add and re-assign\n", + "list_1 += [5, \"grapes\"]\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 36, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "(3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes')" + ] + }, + "execution_count": 36, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add and re-assign\n", + "tuple_1 += (5, \"grapes\")\n", + "tuple_1" + ] + }, + { + "cell_type": "code", + "execution_count": 37, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[1, 2, 3, 4, 1, 2, 3, 4]" + ] + }, + "execution_count": 37, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiply\n", + "[1, 2, 3, 4] * 2" + ] + }, + { + "cell_type": "code", + "execution_count": 38, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "(1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4)" + ] + }, + "execution_count": 38, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Multiply\n", + "(1, 2, 3, 4) * 3" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Accessing Data In Containers\n", + "\n", + "For strings, lists, tuples, and dicts, we can use **subscript notation** (square brackets) to access data at an index.\n", + "\n", + "- strings, lists, and tuples are indexed by integers, **starting at 0** for first item\n", + " - these sequence types also support accesing a range of items, known as **slicing**\n", + " - use **negative indexing** to start at the back of the sequence\n", + "- dicts are indexed by their keys\n", + "\n", + "> Note: sets are not indexed, so we cannot use subscript notation to access data elements." + ] + }, + { + "cell_type": "code", + "execution_count": 39, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes']" + ] + }, + "execution_count": 39, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remember what's in list_1\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 40, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3" + ] + }, + "execution_count": 40, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access the first item in a sequence\n", + "list_1[0]" + ] + }, + { + "cell_type": "code", + "execution_count": 41, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "(3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes')" + ] + }, + "execution_count": 41, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remember what's in tuple_1\n", + "tuple_1" + ] + }, + { + "cell_type": "code", + "execution_count": 42, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'grapes'" + ] + }, + "execution_count": 42, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access the last item in a sequence\n", + "tuple_1[-1]" + ] + }, + { + "cell_type": "code", + "execution_count": 43, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'an example that re-assigned the original string'" + ] + }, + "execution_count": 43, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access a range of items in a sequence\n", + "simple_string_1" + ] + }, + { + "cell_type": "code", + "execution_count": 44, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'n'" + ] + }, + "execution_count": 44, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "simple_string_1[1]" + ] + }, + { + "cell_type": "code", + "execution_count": 45, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'an ex'" + ] + }, + "execution_count": 45, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "simple_string_1[0:5]" + ] + }, + { + "cell_type": "code", + "execution_count": 46, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "(5, 'grapes')" + ] + }, + "execution_count": 46, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access a range of items in a sequence\n", + "tuple_1[-2:]" + ] + }, + { + "cell_type": "code", + "execution_count": 47, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['dog', 'cat', False, 5, 'grapes']" + ] + }, + "execution_count": 47, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access a range of items in a sequence\n", + "list_1[4:]" + ] + }, + { + "cell_type": "code", + "execution_count": 48, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Jane', 'age': 23, 'fav_foods': ['pizza', 'fruit', 'fish']}" + ] + }, + "execution_count": 48, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Rembember what's in dict_1\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 49, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'Jane'" + ] + }, + "execution_count": 49, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Access an item in a dictionary\n", + "# {'name': 'Jane', 'age': 23, 'fav_foods': ['pizza', 'fruit', 'fish']}\n", + "dict_1[\"name\"]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python Built-In Functions & Callables\n", + "\n", + "A **function** is a Python object that you can \"call\" to **perform an action** or compute and **return another object**. You call a function by placing parentheses to the right of the function name. Some functions allow you to pass **arguments** inside the parentheses (separating multiple arguments with a comma). Internal to the function, these arguments are treated like variables.\n", + "\n", + "Python has several useful built-in functions to help you work with different objects and/or your environment. Here is a small sample of them:\n", + "\n", + "- **`type(obj)`** to determine the type of an object\n", + "- **`isinstance(val, obj)`** to determine if `val` is an `obj`\n", + "- **`len(container)`** to determine how many items are in a container\n", + "- **`callable(obj)`** to determine if an object is callable\n", + "- **`sorted(container)`** to return a new list from a container, with the items sorted\n", + "- **`sum(container)`** to compute the sum of a container of numbers\n", + "- **`min(container)`** to determine the smallest item in a container\n", + "- **`max(container)`** to determine the largest item in a container\n", + "- **`abs(number)`** to determine the absolute value of a number\n", + "- **`repr(obj)`** to return a string representation of an object\n", + "\n", + "> Complete list of built-in functions: https://docs.python.org/3/library/functions.html\n", + "\n", + "There are also different ways of defining your own functions and callable objects that we will explore later." + ] + }, + { + "cell_type": "code", + "execution_count": 50, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "float" + ] + }, + "execution_count": 50, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the type() function to determine the type of an object\n", + "type(1.0)" + ] + }, + { + "cell_type": "code", + "execution_count": 51, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 51, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "price = \"1.11\"\n", + "isinstance(price, float)" + ] + }, + { + "cell_type": "code", + "execution_count": 52, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3" + ] + }, + "execution_count": 52, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the len() function to determine how many items are in a container\n", + "len([1, 2, 3])" + ] + }, + { + "cell_type": "code", + "execution_count": 53, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "24" + ] + }, + "execution_count": 53, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the len() function to determine how many items are in a container\n", + "len(simple_string_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 54, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 54, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the callable() function to determine if an object is callable\n", + "callable(\"a\")" + ] + }, + { + "cell_type": "code", + "execution_count": 55, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 55, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the callable() function to determine if an object is callable\n", + "callable(dict_1)" + ] + }, + { + "cell_type": "code", + "execution_count": 56, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[-3, 1, 2, 3.6, 5, 7, 10]" + ] + }, + "execution_count": 56, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the sorted() function to return a new list from a container, with the items sorted\n", + "sorted([10, 1, 3.6, 7, 5, 2, -3])" + ] + }, + { + "cell_type": "code", + "execution_count": 57, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['a', 'j', 'n', 'o', 's']" + ] + }, + "execution_count": 57, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "sorted(\"jason\")" + ] + }, + { + "cell_type": "code", + "execution_count": 58, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "['California', 'Chicago', 'ants', 'cats', 'dogs', 'mice', 'zebras']" + ] + }, + "execution_count": 58, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the sorted() function to return a new list from a container, with the items sorted\n", + "# - notice that capitalized strings come first\n", + "sorted([\"dogs\", \"cats\", \"zebras\", \"Chicago\", \"California\", \"ants\", \"mice\"])" + ] + }, + { + "cell_type": "code", + "execution_count": 59, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "25.6" + ] + }, + "execution_count": 59, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the sum() function to compute the sum of a container of numbers\n", + "sum([10, 1, 3.6, 7, 5, 2, -3])" + ] + }, + { + "cell_type": "code", + "execution_count": 60, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "-3" + ] + }, + "execution_count": 60, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the min() function to determine the smallest item in a container\n", + "min([10, 1, 3.6, 7, 5, 2, -3])" + ] + }, + { + "cell_type": "code", + "execution_count": 61, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'a'" + ] + }, + "execution_count": 61, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the min() function to determine the smallest item in a container\n", + "min([\"g\", \"z\", \"a\", \"y\"])" + ] + }, + { + "cell_type": "code", + "execution_count": 62, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "10" + ] + }, + "execution_count": 62, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the max() function to determine the largest item in a container\n", + "max([10, 1, 3.6, 7, 5, 2, -3])" + ] + }, + { + "cell_type": "code", + "execution_count": 63, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'s'" + ] + }, + "execution_count": 63, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the max() function to determine the largest item in a container\n", + "max(\"gibberish\")" + ] + }, + { + "cell_type": "code", + "execution_count": 64, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "10" + ] + }, + "execution_count": 64, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the abs() function to determine the absolute value of a number\n", + "abs(10)" + ] + }, + { + "cell_type": "code", + "execution_count": 65, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "12" + ] + }, + "execution_count": 65, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the abs() function to determine the absolute value of a number\n", + "abs(-12)" + ] + }, + { + "cell_type": "code", + "execution_count": 66, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 66, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use the repr() function to return a string representation of an object\n", + "isinstance(repr(list_1), str)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python Object Attributes (Methods & Properties)\n", + "\n", + "Different types of objects in Python have different **attributes** that can be referred to by name (similar to a variable). To access an attribute of an object, use a dot (`.`) after the object, then specify the attribute (i.e. `obj.attribute`)\n", + "\n", + "When an attribute of an object is a callable, that attribute is called a **method**. It is the same as a function, only this function is bound to a particular object.\n", + "\n", + "When an attribute of an object is not a callable, that attribute is called a **property**. It is just a piece of data about the object, that is itself another object.\n", + "\n", + "The built-in `dir()` function can be used to return a list of an object's attributes.\n", + "\n", + "
" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Some Methods On `string` Objects\n", + "\n", + "- **`.capitalize()`** to return a capitalized version of the string (only first char uppercase)\n", + "- **`.upper()`** to return an uppercase version of the string (all chars uppercase)\n", + "- **`.lower()`** to return an lowercase version of the string (all chars lowercase)\n", + "- **`.count(substring)`** to return the number of occurences of the substring in the string\n", + "- **`.startswith(substring)`** to determine if the string starts with the substring\n", + "- **`.endswith(substring)`** to determine if the string ends with the substring\n", + "- **`.replace(old, new)`** to return a copy of the string with occurences of the \"old\" replaced by \"new\"" + ] + }, + { + "cell_type": "code", + "execution_count": 67, + "metadata": {}, + "outputs": [], + "source": [ + "# Assign a string to a variable\n", + "a_string = \"tHis is a sTriNg\"" + ] + }, + { + "cell_type": "code", + "execution_count": 68, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'This is a string'" + ] + }, + "execution_count": 68, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return a capitalized version of the string\n", + "a_string.capitalize()" + ] + }, + { + "cell_type": "code", + "execution_count": 69, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'THIS IS A STRING'" + ] + }, + "execution_count": 69, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return an uppercase version of the string\n", + "a_string.upper()" + ] + }, + { + "cell_type": "code", + "execution_count": 70, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'this is a string'" + ] + }, + "execution_count": 70, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return a lowercase version of the string\n", + "a_string.lower()" + ] + }, + { + "cell_type": "code", + "execution_count": 71, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'tHis is a sTriNg'" + ] + }, + "execution_count": 71, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Notice that the methods called have not actually modified the string\n", + "a_string" + ] + }, + { + "cell_type": "code", + "execution_count": 72, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3" + ] + }, + "execution_count": 72, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Count number of occurences of a substring in the string\n", + "a_string.count(\"i\")" + ] + }, + { + "cell_type": "code", + "execution_count": 73, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "1" + ] + }, + "execution_count": 73, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Count number of occurences of a substring in the string after a certain position\n", + "a_string.count(\"i\", 7)" + ] + }, + { + "cell_type": "code", + "execution_count": 74, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "2" + ] + }, + "execution_count": 74, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Count number of occurences of a substring in the string\n", + "a_string.count(\"is\")" + ] + }, + { + "cell_type": "code", + "execution_count": 75, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 75, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Does the string start with 'this'?\n", + "a_string.startswith(\"this\")" + ] + }, + { + "cell_type": "code", + "execution_count": 76, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 76, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Does the lowercase string start with 'this'?\n", + "a_string.lower().startswith(\"this\")" + ] + }, + { + "cell_type": "code", + "execution_count": 77, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 77, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Does the string end with 'Ng'?\n", + "a_string.endswith(\"Ng\")" + ] + }, + { + "cell_type": "code", + "execution_count": 78, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'tHXYZ XYZ a sTriNg'" + ] + }, + "execution_count": 78, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return a version of the string with a substring replaced with something else\n", + "a_string.replace(\"is\", \"XYZ\")" + ] + }, + { + "cell_type": "code", + "execution_count": 79, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'tH!s !s a sTr!Ng'" + ] + }, + "execution_count": 79, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return a version of the string with a substring replaced with something else\n", + "a_string.replace(\"i\", \"!\")" + ] + }, + { + "cell_type": "code", + "execution_count": 80, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'tH!s !s a sTriNg'" + ] + }, + "execution_count": 80, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Return a version of the string with the first 2 occurences a substring replaced with something else\n", + "a_string.replace(\"i\", \"!\", 2)" + ] + }, + { + "cell_type": "markdown", + "metadata": { + "collapsed": true, + "jupyter": { + "outputs_hidden": true + } + }, + "source": [ + "## Some Methods On `list` Objects\n", + "\n", + "- **`.append(item)`** to add a single item to the list\n", + "- **`.extend([item1, item2, ...])`** to add multiple items to the list\n", + "- **`.remove(item)`** to remove a single item from the list\n", + "- **`.pop()`** to remove and return the item at the end of the list\n", + "- **`.pop(index)`** to remove and return an item at an index" + ] + }, + { + "cell_type": "code", + "execution_count": 81, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes']" + ] + }, + "execution_count": 81, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remember what's in list_1\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 82, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes', 'basketball']" + ] + }, + "execution_count": 82, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# append a string to a list\n", + "list_1.append(\"basketball\")\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 83, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', 'cat', False, 5, 'grapes', 'basketball', 'baseball', 1]" + ] + }, + "execution_count": 83, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Add multiple items to a list\n", + "list_1.extend([\"baseball\", 1]) # equiv. list + list\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 84, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', False, 5, 'grapes', 'basketball', 'baseball', 1]" + ] + }, + "execution_count": 84, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remove a sinle item from a list\n", + "list_1.remove(\"cat\")\n", + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 85, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "1" + ] + }, + "execution_count": 85, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remove the last item and return it\n", + "list_1.pop()" + ] + }, + { + "cell_type": "code", + "execution_count": 86, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[3, 5, 6, 3, 'dog', False, 5, 'grapes', 'basketball', 'baseball']" + ] + }, + "execution_count": 86, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "list_1" + ] + }, + { + "cell_type": "code", + "execution_count": 87, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3" + ] + }, + "execution_count": 87, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# remove an item at index 0 and return it\n", + "list_1.pop(0)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Some Methods On `set` Objects\n", + "\n", + "- **`.add(item)`** to add a single item to the set\n", + "- **`.update([item1, item2, ...])`** to add multiple items to the set\n", + "- **`.update(set_2, set3, ...)`** to add items from all provided sets to the set\n", + "- **`.remove(item)`** to remove a single item from the set\n", + "- **`.difference(set_2)`** to return items in the set that are not in another set\n", + "- **`.intersection(set_2)`** to return items in both sets\n", + "- **`.union(set_2)`** to return items that are in either set\n", + "- **`.symmetric_difference(set_2)`** to return items that are only in one set (not both)\n", + "- **`.issuperset(set_2)`** does the set contain everything in the other set?\n", + "- **`.issubset(set_2)`** is the set contained in the other set?" + ] + }, + { + "cell_type": "code", + "execution_count": 88, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'Jason', 'jason'}" + ] + }, + "execution_count": 88, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set([\"Jason\", \"jason\", \"jason\"])" + ] + }, + { + "cell_type": "code", + "execution_count": 89, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3, 5, 6, False, 'cat', 'dog', 'fuzz'}" + ] + }, + "execution_count": 89, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.add(\"fuzz\")\n", + "set_1" + ] + }, + { + "cell_type": "code", + "execution_count": 90, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3, 5, 6, False, 'cat', 'coke', 'dog', 'fuzz', 'pepsi'}" + ] + }, + "execution_count": 90, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.update([\"coke\", \"pepsi\"])\n", + "set_1" + ] + }, + { + "cell_type": "code", + "execution_count": 91, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3,\n", + " 5,\n", + " 6,\n", + " False,\n", + " 'cat',\n", + " 'coke',\n", + " 'dog',\n", + " 'fuzz',\n", + " 'jane',\n", + " 'jason',\n", + " 'jaya',\n", + " 'john',\n", + " 'jukes',\n", + " 'pepsi'}" + ] + }, + "execution_count": 91, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.update(set_2)\n", + "set_1" + ] + }, + { + "cell_type": "code", + "execution_count": 92, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3,\n", + " 5,\n", + " 6,\n", + " False,\n", + " 'coke',\n", + " 'dog',\n", + " 'fuzz',\n", + " 'jane',\n", + " 'jason',\n", + " 'jaya',\n", + " 'john',\n", + " 'jukes',\n", + " 'pepsi'}" + ] + }, + "execution_count": 92, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.remove(\"cat\")\n", + "set_1" + ] + }, + { + "cell_type": "code", + "execution_count": 93, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3, 5, 6, False, 'coke', 'dog', 'fuzz', 'pepsi'}" + ] + }, + "execution_count": 93, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.difference(set_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 94, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'jane', 'jason', 'jaya', 'john', 'jukes'}" + ] + }, + "execution_count": 94, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.intersection(set_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 95, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{3,\n", + " 5,\n", + " 6,\n", + " False,\n", + " 'coke',\n", + " 'dog',\n", + " 'fuzz',\n", + " 'jane',\n", + " 'jason',\n", + " 'jaya',\n", + " 'john',\n", + " 'jukes',\n", + " 'pepsi'}" + ] + }, + "execution_count": 95, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.union(set_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 96, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 96, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.issuperset(set_2)" + ] + }, + { + "cell_type": "code", + "execution_count": 97, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "False" + ] + }, + "execution_count": 97, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "set_1.issubset(set_2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Some Methods On `dict` Objects\n", + "\n", + "- **`.update([(key1, val1), (key2, val2), ...])`** to add multiple key-value pairs to the dict\n", + "- **`.update(dict_2)`** to add all keys and values from another dict to the dict\n", + "- **`.pop(key)`** to remove key and return its value from the dict (error if key not found)\n", + "- **`.pop(key, default_val)`** to remove key and return its value from the dict (or return default_val if key not found)\n", + "- **`.get(key)`** to return the value at a specified key in the dict (or None if key not found)\n", + "- **`.get(key, default_val)`** to return the value at a specified key in the dict (or default_val if key not found)\n", + "- **`.keys()`** to return a list of keys in the dict\n", + "- **`.values()`** to return a list of values in the dict\n", + "- **`.items()`** to return a list of key-value pairs (tuples) in the dict" + ] + }, + { + "cell_type": "code", + "execution_count": 98, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Jane', 'age': 23, 'fav_foods': ['pizza', 'fruit', 'fish']}" + ] + }, + "execution_count": 98, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remember what's in dict_1\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 99, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Jane',\n", + " 'age': 23,\n", + " 'fav_foods': ['pizza', 'fruit', 'fish'],\n", + " 'rain': True,\n", + " 'cars': 'a lot'}" + ] + }, + "execution_count": 99, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Update dict_1 with an iterable\n", + "dict_1.update([(\"rain\", True), (\"cars\", \"a lot\")])\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 100, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Javier',\n", + " 'age': 45,\n", + " 'fav_foods': ['chicken', 'veg', 'candy'],\n", + " 'rain': True,\n", + " 'cars': 'a lot'}" + ] + }, + "execution_count": 100, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Update dict_1 with another dict\n", + "dict_1.update(dict_2)\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 101, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "45" + ] + }, + "execution_count": 101, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Remove the key and value at age\n", + "dict_1.pop(\"age\")" + ] + }, + { + "cell_type": "code", + "execution_count": 102, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Javier',\n", + " 'fav_foods': ['chicken', 'veg', 'candy'],\n", + " 'rain': True,\n", + " 'cars': 'a lot'}" + ] + }, + "execution_count": 102, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Key and value are removed\n", + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 103, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "50" + ] + }, + "execution_count": 103, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use a default value\n", + "dict_1.pop(\"age\", 50)" + ] + }, + { + "cell_type": "code", + "execution_count": 104, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'No car found'" + ] + }, + "execution_count": 104, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Use get to set a default\n", + "dict_1.get(\"car\", \"No car found\")" + ] + }, + { + "cell_type": "code", + "execution_count": 105, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "dict_keys(['name', 'fav_foods', 'rain', 'cars'])" + ] + }, + "execution_count": 105, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Get the keys of a dict as an iterable\n", + "dict_1.keys()" + ] + }, + { + "cell_type": "code", + "execution_count": 106, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "dict_values(['Javier', ['chicken', 'veg', 'candy'], True, 'a lot'])" + ] + }, + "execution_count": 106, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Get the values of a dict as an iterable\n", + "dict_1.values()" + ] + }, + { + "cell_type": "code", + "execution_count": 107, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "dict_items([('name', 'Javier'), ('fav_foods', ['chicken', 'veg', 'candy']), ('rain', True), ('cars', 'a lot')])" + ] + }, + "execution_count": 107, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Get the key-value pairs of a dict as an iterable\n", + "dict_1.items()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Positional Arguments & Keyword Arguments To Callables\n", + "\n", + "You can call a function/method in a number of different ways:\n", + "\n", + "- `func()`: Call `func` with no arguments\n", + "- `func(arg)`: Call `func` with one positional argument\n", + "- `func(arg1, arg2)`: Call `func` with two positional arguments\n", + "- `func(arg1, arg2, ..., argn)`: Call `func` with many positional arguments\n", + "- `func(kwarg=value)`: Call `func` with one keyword argument \n", + "- `func(kwarg1=value1, kwarg2=value2)`: Call `func` with two keyword arguments\n", + "- `func(kwarg1=value1, kwarg2=value2, ..., kwargn=valuen)`: Call `func` with many keyword arguments\n", + "- `func(arg1, arg2, kwarg1=value1, kwarg2=value2)`: Call `func` with positonal arguments and keyword arguments\n", + "- `obj.method()`: Same for `func`.. and every other `func` example\n", + "\n", + "When using **positional arguments**, you must provide them in the order that the function defined them (the function's **signature**).\n", + "\n", + "When using **keyword arguments**, you can provide the arguments you want, in any order you want, as long as you specify each argument's name.\n", + "\n", + "When using positional and keyword arguments, positional arguments must come first." + ] + }, + { + "cell_type": "code", + "execution_count": 108, + "metadata": {}, + "outputs": [], + "source": [ + "def func_1():\n", + " return 1 + 1" + ] + }, + { + "cell_type": "code", + "execution_count": 109, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "2" + ] + }, + "execution_count": 109, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "func_1()" + ] + }, + { + "cell_type": "code", + "execution_count": 110, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "25" + ] + }, + "execution_count": 110, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "def func_2(x):\n", + " return x**2 # equiv. x^2\n", + "\n", + "\n", + "func_2(5)" + ] + }, + { + "cell_type": "code", + "execution_count": 111, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "4.0" + ] + }, + "execution_count": 111, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "def func_3(x, y):\n", + " return x / y\n", + "\n", + "\n", + "func_3(8, 2)" + ] + }, + { + "cell_type": "code", + "execution_count": 112, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'one': 1, 'two': 2, 'jason': 'banana'}\n" + ] + } + ], + "source": [ + "def func_4(**kwargs):\n", + " print(kwargs)\n", + "\n", + "\n", + "func_4(one=1, two=2, jason=\"banana\")" + ] + }, + { + "cell_type": "code", + "execution_count": 113, + "metadata": {}, + "outputs": [], + "source": [ + "def func_5(a, b, c, **kwargs):\n", + " pass\n", + "\n", + "\n", + "func_5(2, 3, c=5)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python \"for loops\"\n", + "\n", + "It is easy to **iterate** over a collection of items using a **for loop**. The strings, lists, tuples, sets, and dictionaries we defined are all **iterable** containers.\n", + "\n", + "The for loop will go through the specified container, one item at a time, and provide a temporary variable for the current item. You can use this temporary variable like a normal variable." + ] + }, + { + "cell_type": "code", + "execution_count": 114, + "metadata": { + "scrolled": true + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "5\n", + "6\n", + "3\n", + "dog\n", + "False\n", + "5\n", + "grapes\n", + "basketball\n", + "baseball\n" + ] + } + ], + "source": [ + "list_1\n", + "\n", + "for item in list_1:\n", + " print(item)" + ] + }, + { + "cell_type": "code", + "execution_count": 115, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "3\n", + "5\n", + "6\n", + "3\n", + "dog\n", + "cat\n", + "False\n", + "5\n", + "grapes\n" + ] + } + ], + "source": [ + "for item in tuple_1:\n", + " print(item)" + ] + }, + { + "cell_type": "code", + "execution_count": 116, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "False\n", + "3\n", + "5\n", + "6\n", + "john\n", + "jane\n", + "coke\n", + "jukes\n", + "jaya\n", + "jason\n", + "fuzz\n", + "pepsi\n", + "dog\n" + ] + } + ], + "source": [ + "for item in set_1:\n", + " print(item)" + ] + }, + { + "cell_type": "code", + "execution_count": 117, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Key:name -> Value:Javier\n", + "Key:fav_foods -> Value:['chicken', 'veg', 'candy']\n", + "Key:rain -> Value:True\n", + "Key:cars -> Value:a lot\n" + ] + } + ], + "source": [ + "for key, value in dict_1.items():\n", + " print(f\"Key:{key} -> Value:{value}\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Python \"if statements\" & \"while loops\"\n", + "\n", + "Conditional expressions can be used with these two **conditional statements**.\n", + "\n", + "The **if statement** allows you to test a condition and perform some actions if the condition evaluates to `True`. You can also provide `elif` and/or `else` clauses to an if statement to take alternative actions if the condition evaluates to `False`.\n", + "\n", + "The **while loop** will keep looping until its conditional expression evaluates to `False`.\n", + "\n", + "> Note: It is possible to \"loop forever\" when using a while loop with a conditional expression that never evaluates to `False`.\n", + ">\n", + "> Note: Since the **for loop** will iterate over a container of items until there are no more, there is no need to specify a \"stop looping\" condition." + ] + }, + { + "cell_type": "code", + "execution_count": 118, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Correct\n" + ] + } + ], + "source": [ + "if 1 < 2:\n", + " print(\"Correct\")" + ] + }, + { + "cell_type": "code", + "execution_count": 119, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "True" + ] + }, + "execution_count": 119, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "1 < 2" + ] + }, + { + "cell_type": "code", + "execution_count": 120, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Correct\n" + ] + } + ], + "source": [ + "if (1 < 2) and isinstance(\"jason\", str) and 1 and 12 < 20:\n", + " print(\"Correct\")" + ] + }, + { + "cell_type": "code", + "execution_count": 121, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Default\n" + ] + } + ], + "source": [ + "if 1 > 2:\n", + " print(\"Incorrect\")\n", + "elif 1 > 3:\n", + " print(\"Still incorrect\")\n", + "else:\n", + " print(\"Default\")" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## List Comprehensions" + ] + }, + { + "cell_type": "code", + "execution_count": 122, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[1, 2, 3, 4, 5]" + ] + }, + "execution_count": 122, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Create a simple list\n", + "l = [1, 2, 3, 4, 5]\n", + "l" + ] + }, + { + "cell_type": "code", + "execution_count": 123, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[1, 2, 3, 4, 5, 1, 2, 3, 4, 5]" + ] + }, + "execution_count": 123, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# This does not multiply each value by 2\n", + "l * 2" + ] + }, + { + "cell_type": "code", + "execution_count": 124, + "metadata": {}, + "outputs": [], + "source": [ + "# The long way to do it...\n", + "new_list = []\n", + "for item in l:\n", + " v = item * 2\n", + " new_list.append(v)" + ] + }, + { + "cell_type": "code", + "execution_count": 125, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[2, 4, 6, 8, 10]" + ] + }, + "execution_count": 125, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "new_list" + ] + }, + { + "cell_type": "code", + "execution_count": 126, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[2, 4, 6, 8, 10]" + ] + }, + "execution_count": 126, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Same result using a list comprehension\n", + "[item * 2 for item in l]" + ] + }, + { + "cell_type": "code", + "execution_count": 127, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[0.5, 1.0, 1.5, 2.0, 2.5]" + ] + }, + "execution_count": 127, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Another example\n", + "x = []\n", + "for i in [1, 2, 3, 4, 5]:\n", + " x.append(i / 2)\n", + "x" + ] + }, + { + "cell_type": "code", + "execution_count": 128, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[0.5, 1.0, 1.5, 2.0, 2.5]" + ] + }, + "execution_count": 128, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "[i / 2 for i in [1, 2, 3, 4, 5]]" + ] + }, + { + "cell_type": "code", + "execution_count": 129, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "[int, int, int, str, bool, int, str, str, str]" + ] + }, + "execution_count": 129, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "[type(i) for i in list_1]" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Importing Modules" + ] + }, + { + "cell_type": "code", + "execution_count": 130, + "metadata": {}, + "outputs": [], + "source": [ + "import math\n", + "import numpy" + ] + }, + { + "cell_type": "code", + "execution_count": 131, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3.0" + ] + }, + "execution_count": 131, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "math.sqrt(9)" + ] + }, + { + "cell_type": "code", + "execution_count": 132, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3.0" + ] + }, + "execution_count": 132, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "numpy.sqrt(9)" + ] + }, + { + "cell_type": "code", + "execution_count": 133, + "metadata": {}, + "outputs": [], + "source": [ + "import math as m" + ] + }, + { + "cell_type": "code", + "execution_count": 134, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3.0" + ] + }, + "execution_count": 134, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "m.sqrt(9)" + ] + }, + { + "cell_type": "code", + "execution_count": 135, + "metadata": {}, + "outputs": [], + "source": [ + "from math import sqrt\n", + "from numpy import sqrt" + ] + }, + { + "cell_type": "code", + "execution_count": 136, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "3.0" + ] + }, + "execution_count": 136, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "sqrt(9)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Exceptions" + ] + }, + { + "cell_type": "code", + "execution_count": 137, + "metadata": {}, + "outputs": [ + { + "ename": "KeyError", + "evalue": "'food'", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mKeyError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[137], line 2\u001b[0m\n\u001b[1;32m 1\u001b[0m dict3 \u001b[38;5;241m=\u001b[39m {\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mname\u001b[39m\u001b[38;5;124m\"\u001b[39m: \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mjason\u001b[39m\u001b[38;5;124m\"\u001b[39m, \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mcar\u001b[39m\u001b[38;5;124m\"\u001b[39m: \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mnope\u001b[39m\u001b[38;5;124m\"\u001b[39m}\n\u001b[0;32m----> 2\u001b[0m \u001b[43mdict3\u001b[49m\u001b[43m[\u001b[49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;124;43mfood\u001b[39;49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[43m]\u001b[49m\n", + "\u001b[0;31mKeyError\u001b[0m: 'food'" + ] + } + ], + "source": [ + "dict3 = {\"name\": \"jason\", \"car\": \"nope\"}\n", + "dict3[\"food\"]" + ] + }, + { + "cell_type": "code", + "execution_count": 138, + "metadata": {}, + "outputs": [ + { + "ename": "ZeroDivisionError", + "evalue": "division by zero", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mZeroDivisionError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[138], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[38;5;241;43m2\u001b[39;49m\u001b[43m \u001b[49m\u001b[38;5;241;43m/\u001b[39;49m\u001b[43m \u001b[49m\u001b[38;5;241;43m0\u001b[39;49m\n", + "\u001b[0;31mZeroDivisionError\u001b[0m: division by zero" + ] + } + ], + "source": [ + "2 / 0" + ] + }, + { + "cell_type": "code", + "execution_count": 139, + "metadata": {}, + "outputs": [ + { + "ename": "TypeError", + "evalue": "set expected at most 1 argument, got 3", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mTypeError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[139], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[38;5;28;43mset\u001b[39;49m\u001b[43m(\u001b[49m\u001b[38;5;241;43m1\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m2\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m3\u001b[39;49m\u001b[43m)\u001b[49m\n", + "\u001b[0;31mTypeError\u001b[0m: set expected at most 1 argument, got 3" + ] + } + ], + "source": [ + "set(1, 2, 3)" + ] + }, + { + "cell_type": "code", + "execution_count": 140, + "metadata": {}, + "outputs": [ + { + "ename": "NameError", + "evalue": "name 'jason' is not defined", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mNameError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[140], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43mjason\u001b[49m\n", + "\u001b[0;31mNameError\u001b[0m: name 'jason' is not defined" + ] + } + ], + "source": [ + "jason" + ] + }, + { + "cell_type": "code", + "execution_count": 141, + "metadata": {}, + "outputs": [ + { + "ename": "SyntaxError", + "evalue": "invalid syntax (1125386000.py, line 1)", + "output_type": "error", + "traceback": [ + "\u001b[0;36m Cell \u001b[0;32mIn[141], line 1\u001b[0;36m\u001b[0m\n\u001b[0;31m 1 + 2:\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid syntax\n" + ] + } + ], + "source": [ + "1 + 2:" + ] + }, + { + "cell_type": "code", + "execution_count": 150, + "metadata": {}, + "outputs": [ + { + "ename": "Exception", + "evalue": "My own exception", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mException\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[150], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m \u001b[38;5;167;01mException\u001b[39;00m(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mMy own exception\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n", + "\u001b[0;31mException\u001b[0m: My own exception" + ] + } + ], + "source": [ + "raise Exception(\"My own exception\")" + ] + }, + { + "cell_type": "code", + "execution_count": 151, + "metadata": {}, + "outputs": [ + { + "ename": "AssertionError", + "evalue": "Pass a number >=0", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mAssertionError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[151], line 6\u001b[0m\n\u001b[1;32m 2\u001b[0m \u001b[38;5;28;01massert\u001b[39;00m x \u001b[38;5;241m>\u001b[39m\u001b[38;5;241m=\u001b[39m \u001b[38;5;241m0\u001b[39m, \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mPass a number >=0\u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[1;32m 3\u001b[0m \u001b[38;5;28;01mreturn\u001b[39;00m math\u001b[38;5;241m.\u001b[39msqrt(x)\n\u001b[0;32m----> 6\u001b[0m \u001b[43mfcn\u001b[49m\u001b[43m(\u001b[49m\u001b[38;5;241;43m-\u001b[39;49m\u001b[38;5;241;43m1\u001b[39;49m\u001b[43m)\u001b[49m\n", + "Cell \u001b[0;32mIn[151], line 2\u001b[0m, in \u001b[0;36mfcn\u001b[0;34m(x)\u001b[0m\n\u001b[1;32m 1\u001b[0m \u001b[38;5;28;01mdef\u001b[39;00m \u001b[38;5;21mfcn\u001b[39m(x):\n\u001b[0;32m----> 2\u001b[0m \u001b[38;5;28;01massert\u001b[39;00m x \u001b[38;5;241m>\u001b[39m\u001b[38;5;241m=\u001b[39m \u001b[38;5;241m0\u001b[39m, \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mPass a number >=0\u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[1;32m 3\u001b[0m \u001b[38;5;28;01mreturn\u001b[39;00m math\u001b[38;5;241m.\u001b[39msqrt(x)\n", + "\u001b[0;31mAssertionError\u001b[0m: Pass a number >=0" + ] + } + ], + "source": [ + "def fcn(x):\n", + " assert x >= 0, \"Pass a number >=0\"\n", + " return math.sqrt(x)\n", + "\n", + "\n", + "fcn(-1)" + ] + }, + { + "cell_type": "code", + "execution_count": 152, + "metadata": {}, + "outputs": [ + { + "ename": "ModuleNotFoundError", + "evalue": "No module named 'my_module'", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mModuleNotFoundError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[152], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[38;5;28;01mimport\u001b[39;00m \u001b[38;5;21;01mmy_module\u001b[39;00m\n", + "\u001b[0;31mModuleNotFoundError\u001b[0m: No module named 'my_module'" + ] + } + ], + "source": [ + "import my_module" + ] + }, + { + "cell_type": "code", + "execution_count": 153, + "metadata": {}, + "outputs": [ + { + "ename": "NameError", + "evalue": "name 'calculate' is not defined", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mNameError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[153], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43mcalculate\u001b[49m(\u001b[38;5;241m5\u001b[39m, \u001b[38;5;241m5\u001b[39m)\n", + "\u001b[0;31mNameError\u001b[0m: name 'calculate' is not defined" + ] + } + ], + "source": [ + "calculate(5, 5)" + ] + }, + { + "cell_type": "code", + "execution_count": 154, + "metadata": {}, + "outputs": [ + { + "ename": "ValueError", + "evalue": "math domain error", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mValueError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[154], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43mmath\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43msqrt\u001b[49m\u001b[43m(\u001b[49m\u001b[38;5;241;43m-\u001b[39;49m\u001b[38;5;241;43m1\u001b[39;49m\u001b[43m)\u001b[49m\n", + "\u001b[0;31mValueError\u001b[0m: math domain error" + ] + } + ], + "source": [ + "math.sqrt(-1)" + ] + }, + { + "cell_type": "code", + "execution_count": 155, + "metadata": {}, + "outputs": [ + { + "ename": "AttributeError", + "evalue": "module 'math' has no attribute 'my_func'", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mAttributeError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[155], line 3\u001b[0m\n\u001b[1;32m 1\u001b[0m \u001b[38;5;28;01mimport\u001b[39;00m \u001b[38;5;21;01mmath\u001b[39;00m\n\u001b[0;32m----> 3\u001b[0m \u001b[43mmath\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mmy_func\u001b[49m(\u001b[38;5;241m2\u001b[39m)\n", + "\u001b[0;31mAttributeError\u001b[0m: module 'math' has no attribute 'my_func'" + ] + } + ], + "source": [ + "import math\n", + "\n", + "math.my_func(2)" + ] + }, + { + "cell_type": "code", + "execution_count": 156, + "metadata": {}, + "outputs": [ + { + "ename": "AttributeError", + "evalue": "'str' object has no attribute 'my_func'", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mAttributeError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[156], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;124;43mjason\u001b[39;49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mmy_func\u001b[49m()\n", + "\u001b[0;31mAttributeError\u001b[0m: 'str' object has no attribute 'my_func'" + ] + } + ], + "source": [ + "\"jason\".my_func()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Classes: Creating Your Own Objects" + ] + }, + { + "cell_type": "code", + "execution_count": 157, + "metadata": {}, + "outputs": [], + "source": [ + "class JasonStrimpel:\n", + " pass\n", + "\n", + "\n", + "class ThisIsMyClass:\n", + " pass" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + }, + { + "cell_type": "code", + "execution_count": 158, + "metadata": {}, + "outputs": [], + "source": [ + "# Define a new class called `Thing` that is derived from the base Python object\n", + "class Car(object):\n", + " color = \"red\"" + ] + }, + { + "cell_type": "code", + "execution_count": 159, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "__main__.Car" + ] + }, + "execution_count": 159, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "# Create \"instances\" of our new classes\n", + "a = Car()\n", + "b = Car()\n", + "c = Car()\n", + "\n", + "type(c)" + ] + }, + { + "cell_type": "code", + "execution_count": 160, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'red'" + ] + }, + "execution_count": 160, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "c.color" + ] + }, + { + "cell_type": "code", + "execution_count": 161, + "metadata": {}, + "outputs": [], + "source": [ + "# Interact with a DictThing instance just as you would a normal dictionary\n", + "# Define a new class called `DictThing` that is derived from the `dict` type\n", + "class DictThing(dict):\n", + " my_property = 'I am a \"DictThing\"'" + ] + }, + { + "cell_type": "code", + "execution_count": 162, + "metadata": {}, + "outputs": [], + "source": [ + "d = DictThing()" + ] + }, + { + "cell_type": "code", + "execution_count": 163, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "{'name': 'Javier',\n", + " 'fav_foods': ['chicken', 'veg', 'candy'],\n", + " 'rain': True,\n", + " 'cars': 'a lot'}" + ] + }, + "execution_count": 163, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "dict_1" + ] + }, + { + "cell_type": "code", + "execution_count": 164, + "metadata": {}, + "outputs": [ + { + "ename": "AttributeError", + "evalue": "'dict' object has no attribute 'my_property'", + "output_type": "error", + "traceback": [ + "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", + "\u001b[0;31mAttributeError\u001b[0m Traceback (most recent call last)", + "Cell \u001b[0;32mIn[164], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m \u001b[43mdict_1\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mmy_property\u001b[49m\n", + "\u001b[0;31mAttributeError\u001b[0m: 'dict' object has no attribute 'my_property'" + ] + } + ], + "source": [ + "dict_1.my_property" + ] + }, + { + "cell_type": "code", + "execution_count": 165, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "{'age': 13, 'fav_foods': ['pizza', 'sushi', 'pad thai', 'waffles'], 'fav_color': 'green'}\n" + ] + } + ], + "source": [ + "d.update(\n", + " {\n", + " \"age\": 13,\n", + " \"fav_foods\": [\"pizza\", \"sushi\", \"pad thai\", \"waffles\"],\n", + " \"fav_color\": \"green\",\n", + " }\n", + ")\n", + "print(d)" + ] + }, + { + "cell_type": "code", + "execution_count": 166, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "I am a \"DictThing\"\n" + ] + } + ], + "source": [ + "print(d.my_property)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Creating An Initializer Method For Classes" + ] + }, + { + "cell_type": "code", + "execution_count": 167, + "metadata": {}, + "outputs": [], + "source": [ + "class Car:\n", + "\n", + " color = \"red\"\n", + "\n", + " def __init__(self):\n", + " print(f\"The car is going fast.\")" + ] + }, + { + "cell_type": "code", + "execution_count": 168, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "The car is going fast.\n" + ] + } + ], + "source": [ + "a = Car()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Defining Attributes & Methods" + ] + }, + { + "cell_type": "code", + "execution_count": 169, + "metadata": {}, + "outputs": [], + "source": [ + "class Car:\n", + "\n", + " color = \"red\"\n", + "\n", + " def __init__(self):\n", + " print(f\"The car is going fast.\")\n", + "\n", + " def drive(self, how_fast):\n", + " return f\"The {self.color} car drives {how_fast} mph.\"" + ] + }, + { + "cell_type": "code", + "execution_count": 170, + "metadata": {}, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "The car is going fast.\n", + "The car is going fast.\n" + ] + } + ], + "source": [ + "car_a = Car()\n", + "car_b = Car()" + ] + }, + { + "cell_type": "code", + "execution_count": 171, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'red'" + ] + }, + "execution_count": 171, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "car_a.color" + ] + }, + { + "cell_type": "code", + "execution_count": 172, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'red'" + ] + }, + "execution_count": 172, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "car_b.color" + ] + }, + { + "cell_type": "code", + "execution_count": 173, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'The red car drives 55 mph.'" + ] + }, + "execution_count": 173, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "car_b.drive(55)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# `self` - Setting Attributes & Methods" + ] + }, + { + "cell_type": "code", + "execution_count": 174, + "metadata": {}, + "outputs": [], + "source": [ + "class Car:\n", + "\n", + " def __init__(self, color, make):\n", + " self.color = color\n", + " self.color_cap = color.upper()\n", + " self.make = make\n", + "\n", + " def mph_to_kph(self, mph):\n", + " return mph * 1.60934\n", + "\n", + " def drive(self, how_fast):\n", + " return f\"The {self.color} {self.make} drives {how_fast} mph.\"\n", + "\n", + " def drive_in_kph(self, how_fast):\n", + " kph = self.mph_to_kph(how_fast)\n", + " return f\"The {self.color} {self.make} drives {kph} kph.\"" + ] + }, + { + "cell_type": "code", + "execution_count": 175, + "metadata": {}, + "outputs": [], + "source": [ + "car_a = Car(\"Black\", \"Tahoe\")" + ] + }, + { + "cell_type": "code", + "execution_count": 176, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'The Black Tahoe drives 88.5137 kph.'" + ] + }, + "execution_count": 176, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "car_a.drive_in_kph(55)" + ] + }, + { + "cell_type": "code", + "execution_count": 177, + "metadata": {}, + "outputs": [ + { + "data": { + "text/plain": [ + "'The Black Audi drives 160.934 kph.'" + ] + }, + "execution_count": 177, + "metadata": {}, + "output_type": "execute_result" + } + ], + "source": [ + "car_b = Car(\"Black\", \"Audi\")\n", + "car_b.drive_in_kph(100)" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.12.5" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/build/conda/installer/assets/header_win.png b/build/conda/installer/assets/header_win.png new file mode 100644 index 0000000000000000000000000000000000000000..f7ffd7ea723b277a9fca030d304f1717bec1241f GIT binary patch literal 13096 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 iKL2Vk|Nl%7(aY 0 + MessageBox MB_YESNO|MB_ICONSTOP "Failed to uninstall, continue anyway?" /SD IDYES IDYES +2 + Abort + ${EndIf} +${EndIf} +FunctionEnd + +;-------------------------------- +; Section - Install App + + Section "-hidden app" + SectionIn RO + ${StrContains} $0 "\OpenBB" "$INSTDIR" + ; Making sure here if user manually removes \openbb from their path that it still installs there + ; so we dont have issues with uninstaller later. + StrCmp $0 "" notfound + ; MessageBox MB_OK 'Found string $0 $INSTDIR' + SetOutPath "$INSTDIR" + Goto done + notfound: + ; MessageBox MB_OK "$INSTDIR is 'bla'" + SetOutPath "$INSTDIR\OpenBB" + StrCpy $InstDir "$INSTDIR\OpenBB" + ; MessageBox MB_OK 'Did not find string "$INSTDIR\OpenBB" "$installerPath"' + done: + + ; File /r "app\*.*" + WriteRegStr HKCU "Software\${NAME}" "" $INSTDIR + WriteUninstaller "$INSTDIR\Uninstall.exe" + WriteRegStr HKCU "Software\Software\Microsoft\Windows\CurrentVersion\Uninstall\${UninstId}" "OpenBBPlatform" "OpenBB" + WriteRegStr HKCU "Software\Software\Microsoft\Windows\CurrentVersion\Uninstall\${UninstId}" "UninstallString" '"$InstDir\Uninstall.exe"' + WriteRegStr HKCU "Software\Software\Microsoft\Windows\CurrentVersion\Uninstall\${UninstId}" "QuietUninstallString" '"$InstDir\Uninstall.exe" /S' + SectionEnd + + +;-------------------------------- +; Remove empty parent directories + + Function un.RMDirUP + !define RMDirUP '!insertmacro RMDirUPCall' + + !macro RMDirUPCall _PATH + push '${_PATH}' + Call un.RMDirUP + !macroend + + ; $0 - current folder + ClearErrors + + Exch $0 + ;DetailPrint "ASDF - $0\.." + RMDir "$0\.." + + IfErrors Skip + ${RMDirUP} "$0\.." + Skip: + + Pop $0 + + FunctionEnd + +;-------------------------------- +; Section - Uninstaller + +Section "Uninstall" + + ;Delete Shortcut + Delete "$DESKTOP\${NAME}.lnk" + + ;Delete Directory + Delete '$SMPROGRAMS\${Company}\${NAME}' + + ;Delete Reg Key + DeleteRegKey HKCU "Software\Software\Microsoft\Windows\CurrentVersion\Uninstall\${UninstId}" + + ;Delete Uninstall + Delete "$INSTDIR\Uninstall.exe" + + + ;Delete Folder + RMDir /r "$INSTDIR" + ${RMDirUP} "$INSTDIR" + + DeleteRegKey /ifempty HKCU "Software\${NAME}" + +SectionEnd \ No newline at end of file diff --git a/build/conda/installer/assets/installer_conclusion.txt b/build/conda/installer/assets/installer_conclusion.txt new file mode 100644 index 000000000000..799b09ceb948 --- /dev/null +++ b/build/conda/installer/assets/installer_conclusion.txt @@ -0,0 +1,12 @@ +Thank you for installing OpenBB Platform! + +To get started, open the installed OpenBB folder, in the home folder of your user, and review the README.md file. Or, open one of the launchers using the provided shortcuts. + +The OpenBB Platform Documentation is found here: +https://docs.openbb.co + +Bugs/Issues/Requests can be posted here: +https://github.com/OpenBB-finance/OpenBB/issues + +Security vulnerabilities can be reported here: +https://github.com/OpenBB-finance/OpenBB/security/advisories diff --git a/build/conda/installer/assets/installer_license.txt b/build/conda/installer/assets/installer_license.txt new file mode 100644 index 000000000000..0749d9bc616a --- /dev/null +++ b/build/conda/installer/assets/installer_license.txt @@ -0,0 +1,661 @@ +GNU AFFERO GENERAL PUBLIC LICENSE +Version 3, 19 November 2007 + +Copyright (C) 2007 Free Software Foundation, Inc. +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. + +Preamble + +The GNU Affero General Public License is a free, copyleft license for +software and other kinds of works, specifically designed to ensure +cooperation with the community in the case of network server software. + +The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +our General Public Licenses are intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. + +When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + +Developers that use our General Public Licenses protect your rights +with two steps: (1) assert copyright on the software, and (2) offer +you this License which gives you legal permission to copy, distribute +and/or modify the software. + +A secondary benefit of defending all users' freedom is that +improvements made in alternate versions of the program, if they +receive widespread use, become available for other developers to +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of +software used on network servers, this result may fail to come about. +The GNU General Public License permits making a modified version and +letting the public access it on a server without ever releasing its +source code to the public. + +The GNU Affero General Public License is designed specifically to +ensure that, in such cases, the modified source code becomes available +to the community. It requires the operator of a network server to +provide the source code of the modified version running there to the +users of that server. Therefore, public use of a modified version, on +a publicly accessible server, gives the public access to the source +code of the modified version. + +An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is +a different license, not a version of the Affero GPL, but Affero has +released a new version of the Affero GPL which permits relicensing under +this license. + +The precise terms and conditions for copying, distribution and +modification follow. + +TERMS AND CONDITIONS + +1. Definitions. + +"This License" refers to version 3 of the GNU Affero General Public License. + +"Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + +"The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + +To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + +A "covered work" means either the unmodified Program or a work based +on the Program. + +To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + +To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + +An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + +1. Source Code. + +The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + +A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + +The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + +The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + +The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + +The Corresponding Source for a work in source code form is that +same work. + +2. Basic Permissions. + +All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + +You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + +Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + +3. Protecting Users' Legal Rights From Anti-Circumvention Law. + +No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + +When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + +4. Conveying Verbatim Copies. + +You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + +You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + +5. Conveying Modified Source Versions. + +You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + +A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + +6. Conveying Non-Source Forms. + +You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + +A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + +A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + +"Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + +If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + +The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + +Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + +7. Additional Terms. + +"Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + +Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + +All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + +If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + +8. Termination. + +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + +However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + +Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + +9. Acceptance Not Required for Having Copies. + +You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + +10. Automatic Licensing of Downstream Recipients. + +Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + +An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + +11. Patents. + +A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + +A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + +In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + +If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + +A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + +12. No Surrender of Others' Freedom. + +If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + +13. Remote Network Interaction; Use with the GNU General Public License. + +Notwithstanding any other provision of this License, if you modify the +Program, your modified version must prominently offer all users +interacting with it remotely through a computer network (if your version +supports such interaction) an opportunity to receive the Corresponding +Source of your version by providing access to the Corresponding Source +from a network server at no charge, through some standard or customary +means of facilitating copying of software. This Corresponding Source +shall include the Corresponding Source for any work covered by version 3 +of the GNU General Public License that is incorporated pursuant to the +following paragraph. + +Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + +14. Revised Versions of this License. + +The Free Software Foundation may publish revised and/or new versions of +the GNU Affero General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU Affero General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU Affero General Public License, you may choose any version ever published +by the Free Software Foundation. + +If the Program specifies that a proxy can decide which future +versions of the GNU Affero General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + +Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + +15. Disclaimer of Warranty. + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +16. Limitation of Liability. + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + +17. Interpretation of Sections 15 and 16. + +If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + +END OF TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + +If your software can interact with users remotely through a computer +network, you should also make sure that it provides a way for users to +get its source. For example, if your program is a web application, its +interface could display a "Source" link that leads users to an archive +of the code. There are many ways you could offer source, and different +solutions will be better for different programs; see section 13 for the +specific requirements. + +You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU AGPL, see +. diff --git a/build/conda/installer/assets/installer_readme.txt b/build/conda/installer/assets/installer_readme.txt new file mode 100644 index 000000000000..0fcb5311926b --- /dev/null +++ b/build/conda/installer/assets/installer_readme.txt @@ -0,0 +1,19 @@ +OpenBB Platform provides a convenient way to access raw financial data from multiple data providers. + +Important Notes: + +In order to install you need access to the Internet. + +The installation will take approximately 1-2 GB of storage and is for the current user only, system-wide installations are not allowed. + +If a folder named "OpenBB" already exists at the user home directory, please remove it before installing. + +The installed packages can be reconfigured, post-installation, for custom configurations. + +If the OpenBB folder is moved, post-installation, the shortcuts will not be updated to reflect the change. + + + +This application is intended strictly for research and educational purposes. + +By proceeding with the installation, you agree not to use this application for any purpose that is unlawful or prohibited by international and national laws, regulations, or governmental and industry requirements. diff --git a/build/conda/installer/assets/installer_welcome.txt b/build/conda/installer/assets/installer_welcome.txt new file mode 100644 index 000000000000..7c7383465682 --- /dev/null +++ b/build/conda/installer/assets/installer_welcome.txt @@ -0,0 +1,8 @@ +Welcome to the OpenBB Platform Installer. + + +This application will install the latest version of the OpenBB Platform on your computer in a self-contained, Python 3.12, Conda environment. It contains everything required to get started immediately, both as a user and a developer. + +Several launch scripts are included; OpenBB CLI, OpenBB API, Jupyter Notebook, IPython, Update, and shortcuts to key folders. + +Find them at the base of the installation folder, along with the README.md file for getting started. diff --git a/build/conda/installer/assets/openbb.icns b/build/conda/installer/assets/openbb.icns new file mode 100644 index 0000000000000000000000000000000000000000..d02e2301f45fcec1df7fc04f4322df8a53f77591 GIT binary patch literal 16654 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 AN&o-= literal 0 HcmV?d00001 diff --git a/build/conda/installer/assets/openbb_icon.ico b/build/conda/installer/assets/openbb_icon.ico new file mode 100644 index 0000000000000000000000000000000000000000..ec1a7d484f45fe4167e76d75284938679bcb3aff GIT binary patch literal 19566 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 CWR^() literal 0 HcmV?d00001 diff --git a/build/conda/installer/assets/openbb_platform_installer/README.md b/build/conda/installer/assets/openbb_platform_installer/README.md new file mode 100644 index 000000000000..2aa6233b823a --- /dev/null +++ b/build/conda/installer/assets/openbb_platform_installer/README.md @@ -0,0 +1,48 @@ +# OpenBB Platform Installer Package + +This package is for installing the OpenBB Platform packages into any Python environment. Versions between 3.9 and 3.12, inclusively, are supported. + +The `obb` virtual environment that came with the installation is pre-loaded, and this configuration can be duplicated by creating a new environment and running, `poetry install`, from this location. + +## Installation + +Assuming the current working directory is the location of this document, the code block below will create a new environment, activate it, update the dependencies, and then install the OpenBB Platform. + +Open the Terminal command line with the Bash/CMD shortcut. + +```sh +conda create -n my_env python=3.10 -y +conda activate my_env +pip install poetry +poetry lock +poetry install +openbb-build +``` + +## Updating Packages + +Update the environment dependencies with: + +```sh +poetry lock +poetry install +``` + +## Installation Groups + +The package can be installed in different configurations, using Poetry groups as `--with`, `--without`, or `--only` keyword arguments. + +- main +- openbb-all +- cli +- notebook + +To install, in a fresh environment, only the `openbb-core` package and the base dependencies: + +```sh +poetry install --only main --sync +``` + +The `--sync` flag with sync the environment to the `poetry.lock` file for the flagged group(s). All items are installed when no arguments are supplied. Use this as a way to restore corrupted environments. + +Do not use the `--sync` flag if you wish to keep installed packages that are not defined in the `pyproject.toml` and `poetry.lock` files. diff --git a/build/conda/installer/assets/openbb_platform_installer/obb-env.yml b/build/conda/installer/assets/openbb_platform_installer/obb-env.yml new file mode 100644 index 000000000000..a201e45b581a --- /dev/null +++ b/build/conda/installer/assets/openbb_platform_installer/obb-env.yml @@ -0,0 +1,5 @@ +name: obb +channels: + - conda-forge +dependencies: + - python=3.12 \ No newline at end of file diff --git a/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/__init__.py b/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/__init__.py new file mode 100644 index 000000000000..cf160bd8ddb3 --- /dev/null +++ b/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/__init__.py @@ -0,0 +1,3 @@ +"""Placeholder for the OpenBB Platform Installer package.""" + +__version__ = "1.0.0" diff --git a/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/update.py b/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/update.py new file mode 100644 index 000000000000..4c3b4feba150 --- /dev/null +++ b/build/conda/installer/assets/openbb_platform_installer/openbb_platform_installer/update.py @@ -0,0 +1,30 @@ +"""Entry point for the OpenBB Updater script.""" + +# pylint: disable=import-outside-toplevel,unused-import +# flake8: noqa + +def main(): + """Update the OpenBB Platform and rebuild the Python interface.""" + + import os + import sys + import subprocess + from pathlib import Path + + args = os.sys.argv[1:].copy() if os.sys.argv[1:] else [] + + cwd = Path(os.path.dirname(os.path.realpath(__file__))).parent.resolve() + + command = ( + f"{sys.executable} -m pip install -U pip && " + f"{sys.executable} -m poetry lock && " + f"{sys.executable} -m poetry install {' '.join(args)} && " + "openbb-build" + ) + + subprocess.run(command, shell=True, cwd=cwd) + + input("\nUpdate complete. Press Enter to exit...") + +if __name__ == "__main__": + main() diff --git a/build/conda/installer/assets/openbb_platform_installer/pyproject.toml b/build/conda/installer/assets/openbb_platform_installer/pyproject.toml new file mode 100644 index 000000000000..d867489e6353 --- /dev/null +++ b/build/conda/installer/assets/openbb_platform_installer/pyproject.toml @@ -0,0 +1,53 @@ +# If you will be using this as a template for your own package, please change the values accordingly. +[tool.poetry] +name = "openbb_platform_installer" # Change this to your package name +version = "1.0.0" # Change this to your package version +description = "A meta package for installing the OpenBB Platform: Investment research for everyone, anywhere." # Change this to your description +authors = ["OpenBB "] # Change this to your name and email +license = "AGPL-3.0-only" # This license must be compatible with the OpenBB license +readme = "README.md" # Change this to your README file +homepage = "https://openbb.co" # Change this to your website +repository = "https://github.com/openbb-finance/openbb" # Change this to your repository +documentation = "https://docs.openbb.co" # Change this to your documentation +packages = [{ include = "openbb_platform_installer" }] # Update accordingly - these are build scripts and entry points. + +[tool.poetry.scripts] +openbb-update = "openbb_platform_installer.update:main" + +[tool.poetry.dependencies] +python = ">=3.9,<3.13" +poetry = "^1.8" +setuptools = "*" +openbb-core = "^1" +openbb-platform-api = "^1" +deepdiff = "*" +types-python-dateutil = "*" +types-toml = "*" +pandas-stubs = "*" +codespell = "*" +ruff = "*" +mypy = "*" +black = "*" +pylint = "^3" +pydocstyle = "~6.3" + +[tool.poetry.group.openbb-all] + +[tool.poetry.group.openbb-all.dependencies] +openbb = { version = "^4", extras = ["all"] } + +[tool.poetry.group.cli] + +[tool.poetry.group.cli.dependencies] +openbb-cli = "^1" + +[tool.poetry.group.notebook] + +[tool.poetry.group.notebook.dependencies] +notebook = "^7" +nbclassic = "^1" +jedi-language-server = "^0.41" + +[build-system] +requires = ["poetry-core>=1.0.0"] +build-backend = "poetry.core.masonry.api" diff --git a/build/conda/installer/assets/openbb_win.png b/build/conda/installer/assets/openbb_win.png new file mode 100644 index 0000000000000000000000000000000000000000..c8540d22fc795051c25148c213b27c0bd0bebf2b GIT binary patch literal 2579 zcmeHIYgp1}AI3xZT8X2BY=(GfnFmyQGfVNXz1dVerD>U=V6@aM49No?o7Kd(g07|W z1bV$w@J-X^e3vE|ktVqa3N!MM;B!>{rv9x zDLxVwV7AF}69@z{3kvj)1c3}fKp?}ce{9rOz~=|aAdu-`kpJgVS@h{QeiV8-oUc}; zdJsLF)zTRYCrW`hIf1wnQJCzHtj6q4lG|>2wBMr00hV+tD#t+dYJpNYlV&q=!od#a zD2@pPxWS_qKewbjXY3K|6YY4x?(?5%YZVDns|O^FnDPqqgarnMBFCjbC2Li;#7A(>?(k3tqdWzIjx zAr})Bw%5avdvHXeT1YuKLrwYCEeFpH3_gaK|r!9EyR>f&>SK?)rC&U(bm4+=2}PEBCt zK_R;1(b^z|?bP){a~VDsr+U{j^Dy_juTvp{jHTT+WpcEM=^6Hnv(F{rEJk6&J104- zFu3@2qk~rs9dTYp~kV4a&K}dstn%aM6&oh4VY58Aq zxPmsv`MMww7>ztVE}U%oKfZH_{i(b>A6HEKM{-dOO(PfauWp9wOP%wG*E{YaD=1Z| z4?GF%>3fa&8{=d9X;iats?GN1+?ydIc%>CrNZwcKjQ9gdp@77Sc zl`!FhuDzZDPtB6NhCk4nSfAnAoLrf;I9fEusv=k_7pkhN)IyXhBwaN)7(1LUi91U6 zmR-XMD|FHVzv}#D#iW)+nmr;(r=v0nQ@D6e*52yexnAtMDe}-4wGo`PWo2P+j4?@A zSMr@i8R}Ag9wT;t)(IJ9TFb`?q)~C`!KzDKb7!}pivHJKLbnGz{OMg;-Zee-|x+lCE zwxTlQiA-g1Q_`iruWt8odhb0n22vGaPl#&TUI|BK>RX@L(+UD#kr@`+$|r^&CR`T!^X!`<<&U^ zyVPX_0@3}Ikx48UyWq+jHX`WZW3X5^pRq~;cXc64+kZS*bO{0O{owC$n2f%(wxYu0 z@wKI@+r!h;l+~%HZd}CoGH!O~$o{s^!N(Ww{a30gTh-hkPMn%Pv51eaeKFaf8mCX3 z-yIb_p}ULcJfiRGTkFv>$|ug>tbJFY16kSrCAsncvr3TB&op`dNv+uEwWmJzB=0xa zQusrmJ`a7J{>Z}$vC-rfQ7L$yT={13ld5p+x zhwdL*jY)R0(bTN jEPV%z{_Gza@`7uy^ig|gQ#}jw9wX>*n1A!XaD~4B-r2Yj literal 0 HcmV?d00001 diff --git a/build/conda/installer/construct.yaml b/build/conda/installer/construct.yaml new file mode 100644 index 000000000000..b591a1a67769 --- /dev/null +++ b/build/conda/installer/construct.yaml @@ -0,0 +1,96 @@ +name: "OpenBB" +version: "Platform" +company: OpenBB, Inc. +license_file: ./assets/installer_license.txt + +installer_type: all + +register_python: false # [win] +register_python_default: false # [win] +register_envs: false +initialize_by_default: false +initialize_conda: false +write_condarc: true + +default_location_pkg: OpenBB # [osx] +default_prefix_domain_user: "%USERPROFILE%\\OpenBB\\conda" # [win] +default_prefix: "${HOME}/OpenBB" # [linux] +default_prefix: "%USERPROFILE%\\OpenBB\\conda" # [win] +pkg_name: conda + +specs: + - conda + - bash # [unix] + - python=3.12 + +extra_envs: + obb: + environment_file: ./assets/openbb_platform_installer/obb-env.yml + +channels: + - conda-forge + +condarc: + {channels: [conda-forge], + default_channels: [conda-forge], + allow_softlinks: false, + auto_activate_base: false, + always_copy: true, + register_envs: false, + pip_interop_enabled: true} + +pkg_domains: + enable_anywhere: false + enable_currentUserHome: true + +post_install: post_install.sh # [unix] +post_install: post_install.bat # [win] + +extra_files: + # Bundle launcher assets + - ./README.md: ../README.md + - ./assets/openbb_platform_installer/obb-env.yml: ../extensions/openbb_platform_installer/obb-env.yml + - ./assets/openbb_platform_installer/pyproject.toml: ../extensions/openbb_platform_installer/pyproject.toml + - ./assets/openbb_platform_installer/README.md: ../extensions/openbb_platform_installer/README.md + - ./assets/openbb_platform_installer/openbb_platform_installer/__init__.py: ../extensions/openbb_platform_installer/openbb_platform_installer/__init__.py + - ./assets/openbb_platform_installer/openbb_platform_installer/update.py: ../extensions/openbb_platform_installer/openbb_platform_installer/update.py + - ./assets/openbb_icon.ico: assets/openbb_icon.ico # [win] + - ./assets/openbb.icns: ../openbb_icon.icns # [osx] + - ./assets/create_shortcut.vbs: assets/create_shortcut.vbs # [win] + - ./assets/installer_license.txt: assets/installer_license.txt # [win] + - ./assets/installer_vertical2.bmp: assets/installer_vertical2.bmp # [win] + - ./assets/installer_horizontal.bmp: assets/installer_horizontal.bmp # [win] + - ./assets/examples/README.md: ../extensions/examples/README.md + - ./assets/examples/install_examples.py: ../extensions/examples/install_examples.py + - ./assets/examples/empty_provider/pyproject.toml: ../extensions/examples/empty_provider/pyproject.toml + - ./assets/examples/empty_provider/README.md: ../extensions/examples/empty_provider/README.md + - ./assets/examples/empty_provider/empty_provider/__init__.py: ../extensions/examples/empty_provider/empty_provider/__init__.py + - ./assets/examples/empty_provider/empty_provider/models/__init__.py: ../extensions/examples/empty_provider/empty_provider/models/__init__.py + - ./assets/examples/empty_provider/empty_provider/models/empty_model.py: ../extensions/examples/empty_provider/empty_provider/models/empty_model.py + - ./assets/examples/empty_provider/empty_provider/utils/__init__.py: ../extensions/examples/empty_provider/empty_provider/utils/__init__.py + - ./assets/examples/empty_router/pyproject.toml: ../extensions/examples/empty_router/pyproject.toml + - ./assets/examples/empty_router/README.md: ../extensions/examples/empty_router/README.md + - ./assets/examples/empty_router/empty_router/__init__.py: ../extensions/examples/empty_router/empty_router/__init__.py + - ./assets/examples/empty_router/empty_router/empty_router.py: ../extensions/examples/empty_router/empty_router/empty_router.py + - ./assets/examples/empty_router/empty_router/empty_views.py: ../extensions/examples/empty_router/empty_router/empty_views.py + - ./assets/examples/empty_obbject/pyproject.toml: ../extensions/examples/empty_obbject/pyproject.toml + - ./assets/examples/empty_obbject/README.md: ../extensions/examples/empty_obbject/README.md + - ./assets/examples/empty_obbject/empty_obbject/__init__.py: ../extensions/examples/empty_obbject/empty_obbject/__init__.py + - ./assets/examples/python_basics.ipynb: ../notebooks/python_basics.ipynb + - ../../../examples/platform_standardization.ipynb: ../notebooks/how_platform_works.ipynb + +icon_image: ../openbb_icon.icns # [osx] +icon_image: ./assets/openbb_icon.ico # [win] +welcome_image: ./assets/openbb_osx.png # [unix] +welcome_image: ./assets/Installer_vertical2.bmp # [win] +header_image: ./assets/Installer_horizontal2.png # [win] +welcome_image_text: "OpenBB Platform" +readme_file: ./assets/installer_readme.txt # [unix] +conclusion_file: ./assets/installer_conclusion.txt # [unix] +welcome_file: ./assets/installer_welcome.txt # [unix] +welcome_file: ./assets/custom_welcome.nsi # [win] +conclusion_file: ./assets/custom_conclusion.nsi # [win] + +# Add extra files to the installer - this is another way - was playing with this +temp_extra_files: + - ./assets/Installer_vertical2.bmp: Installer_vertical2.bmp # [win] diff --git a/build/conda/installer/post_install.bat b/build/conda/installer/post_install.bat new file mode 100644 index 000000000000..0373ff0a15d7 --- /dev/null +++ b/build/conda/installer/post_install.bat @@ -0,0 +1,61 @@ +@echo off +echo Installing environment, this may take a few minutes... Watch for changes in post_install_log.txt file at the root of the installation directory. + +cd "%PREFIX%\..\extensions\openbb_platform_installer" + +PATH %PREFIX%;%PREFIX%\Scripts;%PREFIX%\Library\bin;%PATH% +SET LOG_FILE="%PREFIX%\..\post_install_log.txt" + +call "%PREFIX%\Scripts\activate.bat" + +call conda activate "%PREFIX%\envs\obb" >> "%LOG_FILE%" 2>&1 + +python -m pip install -U pip >> "%LOG_FILE%" 2>&1 + +pip install -U setuptools >> "%LOG_FILE%" 2>&1 + +pip install poetry >> "%LOG_FILE%" 2>&1 + +poetry config virtualenvs.path "%PREFIX%\envs" --local >> "%LOG_FILE%" 2>&1 + +poetry config virtualenvs.create false --local >> "%LOG_FILE%" 2>&1 + +poetry lock >> "%LOG_FILE%" 2>&1 + +poetry install >> "%LOG_FILE%" 2>&1 + +IF ERRORLEVEL 1 ( + echo %date% %time% "Error during post-installation: poetry install failed." >> %LOG_FILE% + exit /b 1 +) ELSE ( + echo %date% %time% "Python environment successfully installed... Building the OpenBB Python interface..." >> %LOG_FILE% +) + +echo Python environment successfully installed... Building the OpenBB Python interface... + +call openbb-build >> "%LOG_FILE%" 2>&1 +IF ERRORLEVEL 1 ( + call :log_with_timestamp "Error during post-installation: building OpenBB's Python interface failed." + exit /b 1 +) ELSE ( + call :log_with_timestamp "OpenBB's Python interface built successfully." +) + +cscript "%PREFIX%\assets\create_shortcut.vbs" >> "%LOG_FILE%" 2>&1 +IF ERRORLEVEL 1 ( + echo %date% %time% "Error during post-installation: creating shortcuts failed." >> %LOG_FILE% + exit /b 1 +) ELSE ( + echo %date% %time% "Shortcuts created successfully." >> %LOG_FILE% +) + +echo Post-installation steps completed successfully. + +exit /b 0 + +goto :eof + +REM Function to add timestamp +:log_with_timestamp + echo %date%_%time% %1 >> %LOG_FILE% + goto :eof \ No newline at end of file diff --git a/build/conda/installer/post_install.sh b/build/conda/installer/post_install.sh new file mode 100755 index 000000000000..554796ab9685 --- /dev/null +++ b/build/conda/installer/post_install.sh @@ -0,0 +1,156 @@ +#!/bin/bash + +# Setup environment. +export PATH="$PREFIX/bin:$PATH" +LOG_FILE="$PREFIX/../post_install_log.txt" + +# Function to add timestamp. +log_with_timestamp() { + echo "$(date '+%Y-%m-%d_%H:%M:%S') $1" >>"$LOG_FILE" +} + +cd "$PREFIX/../extensions/openbb_platform_installer" >>"$LOG_FILE" 2>&1 + +source "$PREFIX/etc/profile.d/conda.sh" && conda activate "$PREFIX" + +conda activate obb >>"$LOG_FILE" 2>&1 + +python -m pip install -U pip >>"$LOG_FILE" 2>&1 + +pip install -U setuptools poetry >>"$LOG_FILE" 2>&1 + +poetry config virtualenvs.path "$PREFIX/envs" --local >>"$LOG_FILE" 2>&1 + +poetry config virtualenvs.create false --local >>"$LOG_FILE" 2>&1 + +poetry lock >>"$LOG_FILE" 2>&1 + + +# Install OpenBB packages. +if poetry install >>"$LOG_FILE" 2>&1; then + log_with_timestamp "OpenBB Platform installation completed successfully." +else + log_with_timestamp "Error during post-installation: poetry install failed." + exit 1 +fi + +# Build OpenBB Python interface. +python - <>"$LOG_FILE" 2>&1 +import openbb +openbb.build() +EOF +log_with_timestamp "OpenBB's Python Interface built successfully." + +# IPython launcher script initialized with OpenBB. +IPYTHON_WRAPPER_SCRIPT="$PREFIX/envs/obb/bin/openbb-ipython-launcher" + +cat > "$IPYTHON_WRAPPER_SCRIPT" < "$SHELL_WRAPPER_SCRIPT" < "$NOTEBOOK_WRAPPER_SCRIPT" < "$API_WRAPPER_SCRIPT" < "$CLI_WRAPPER_SCRIPT" < "$OPENBB_UPDATER_SCRIPT" <>"$LOG_FILE" 2>&1 +else + log_with_timestamp "Error during post-installation: creating symlinks failed." >>"$LOG_FILE" 2>&1 +fi + +verify_symlink() { + if [ -L "$1" ] && [ -e "$1" ]; then + log_with_timestamp "Symlink $1 verified successfully." + else + log_with_timestamp "Error: Symlink $1 is not working." + exit 1 + fi +} + +verify_symlink "$TARGET_DIR/openbb-cli" +verify_symlink "$TARGET_DIR/openbb-api" +verify_symlink "$TARGET_DIR/openbb-notebook" +verify_symlink "$TARGET_DIR/openbb-ipython" +verify_symlink "$TARGET_DIR/Bash" +verify_symlink "$TARGET_DIR/Update" +verify_symlink "$TARGET_DIR/Settings" +verify_symlink "$TARGET_DIR/OpenBBUserData" +verify_symlink "$TARGET_DIR/Environments" diff --git a/build/pypi/openbb_platform/publish.py b/build/pypi/openbb_platform/publish.py index 90e690422d1d..7e1df02faea9 100644 --- a/build/pypi/openbb_platform/publish.py +++ b/build/pypi/openbb_platform/publish.py @@ -68,7 +68,7 @@ def parse_args(): "--semver", help="Semantic version.", default="patch", - choices=["patch", "minor", "major"], + choices=["patch", "minor", "major", "none"], dest="semver", ) return parser.parse_args() @@ -80,7 +80,7 @@ def publish( extensions: bool = False, openbb: bool = False, verbose: bool = False, - semver: Literal["patch", "minor", "major"] = "patch", + semver: Literal["patch", "minor", "major", "none"] = "patch", ): """Publish the Platform to PyPi with optional core or extensions.""" package_directories = [] @@ -127,10 +127,11 @@ def publish( cwd=path.parent, ) # Bump pyproject.toml version - partial_run( - [sys.executable, "-m", "poetry", "version", semver], - cwd=path.parent, - ) + if semver != "none": + partial_run( + [sys.executable, "-m", "poetry", "version", semver], + cwd=path.parent, + ) # Publish (if not dry running) if not dry_run: partial_run( diff --git a/openbb_platform/core/openbb_core/api/router/user.py b/openbb_platform/core/openbb_core/api/router/user.py index 042ec5efd661..063505164838 100644 --- a/openbb_platform/core/openbb_core/api/router/user.py +++ b/openbb_platform/core/openbb_core/api/router/user.py @@ -1,4 +1,4 @@ -"""OpenBB API Account Router.""" +"""OpenBB Platform API Account Router.""" from fastapi import APIRouter, Depends from openbb_core.api.auth.user import authenticate_user, get_user_settings diff --git a/openbb_platform/dev_install.py b/openbb_platform/dev_install.py index 58eeb24fa2e6..dddc7513b827 100644 --- a/openbb_platform/dev_install.py +++ b/openbb_platform/dev_install.py @@ -20,6 +20,7 @@ python = ">=3.9,<3.13" openbb-devtools = { path = "./extensions/devtools", develop = true, markers = "python_version >= '3.10'" } openbb-core = { path = "./core", develop = true } +openbb-platform-api = { path = "./extensions/platform_api", develop = true } openbb-benzinga = { path = "./providers/benzinga", develop = true } openbb-bls = { path = "./providers/bls", develop = true } diff --git a/openbb_platform/extensions/platform_api/README.md b/openbb_platform/extensions/platform_api/README.md new file mode 100644 index 000000000000..8d344e5938ea --- /dev/null +++ b/openbb_platform/extensions/platform_api/README.md @@ -0,0 +1,96 @@ +# OpenBB Platform API Meta Package + +This is a meta package for installing a command line script to launch the OpenBB Platform API, and the OpenBB Terminal Pro data connector widgets build script. + +## Installation + +Install this package within an existing [OpenBB Platform Python environment](https://docs.openbb.co/platform/installation). + +```sh +pip install openbb-platform-api +``` + +## Usage + +The script is run from the command line, with the environment active, by entering: + +```sh +openbb-api +``` + +This will launch a Fast API instance, via `uvicorn`, at `http://127.0.0.1:6900` + +### Keyword Arguments + +The behavior of the script can be configured with the use of arguments and keyword arguments. + +Launcher specific arguments: + + --build Build the widgets.json file. + --no-build Do not build the widgets.json file. + --login Login to the OpenBB Platform. + --no-filter Do not filter the widgets.json file. + + +All other arguments will be passed to uvicorn. Here are the most common ones: + + --host TEXT Host IP address or hostname. + [default: 127.0.0.1] + --port INTEGER Port number. + [default: 6900] + --ssl-keyfile TEXT SSL key file. + --ssl-certfile TEXT SSL certificate file. + --ssl-keyfile-password TEXT SSL keyfile password. + --ssl-version INTEGER SSL version to use. + (see stdlib ssl module's) + [default: 17] + --ssl-cert-reqs INTEGER Whether client certificate is required. + (see stdlib ssl module's) + [default: 0] + --ssl-ca-certs TEXT CA certificates file. + --ssl-ciphers TEXT Ciphers to use. + (see stdlib ssl module's) + [default: TLSv1] + +Run `uvicorn --help` to get the full list of arguments. + +### API Over HTTPS + +To run the API over the HTTPS protocol, you must first create a self-signed certificate and the associated key. After activating the environment, you can generate the files by entering this to the command line: + +```sh +openssl req -x509 -days 3650 -out localhost.crt -keyout localhost.key -newkey rsa:4096 -nodes -sha256 -subj '/CN=localhost' -extensions EXT -config <( \ + printf "[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth") +``` + +Two files will be created, in the current working directory, that are passed as keyword arguments to the `openbb-api` entry point. + +```sh +openbb-api --ssl_keyfile localhost.key --ssl_certfile localhost.crt +``` + +**Note**: Adjust the command to include the full path to the file if the current working directory is not where they are located. + +The certificate - `localhost.crt` - will need to be added to system's trust store. The process for this will depend on the operating system and the user account privilege. + +A quick solution is to visit the server's URL, show the details of the warning, and choose to continue anyways. + +Contact the system administrator if you are using a work device and require additional permissions to complete the configuration. + +![This Connection Is Not Private](https://in.norton.com/content/dam/blogs/images/norton/am/this_connection_not_is_private.png) + +### Location of `widgets.json` + +An OpenBB Terminal Pro data connector requires a file, `widgets.json`, to be served by the API. It contains the configuration for each widget available to be added to a dashboard. The file is stored, and served from, the environment's assets folder. + +```sh +/Path/to/environments/envs/obb/assets/widgets.json +``` + +It can be manually edited and served without the build process by passing `--no-build` to the API launch script. + +```sh +openbb-api --no-build +``` + +If you would like to construct this file manually for a custom backend configuration, save the file in the path above. diff --git a/openbb_platform/extensions/platform_api/integration/.gitkeep b/openbb_platform/extensions/platform_api/integration/.gitkeep new file mode 100644 index 000000000000..e69de29bb2d1 diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/__init__.py b/openbb_platform/extensions/platform_api/openbb_platform_api/__init__.py new file mode 100644 index 000000000000..2055db3048be --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/__init__.py @@ -0,0 +1 @@ +"""OpenBB Platform API Meta Package.""" diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/main.py b/openbb_platform/extensions/platform_api/openbb_platform_api/main.py new file mode 100644 index 000000000000..88b3665785b7 --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/main.py @@ -0,0 +1,147 @@ +"""OpenBB Platform API. + +Launch script and widgets builder for the OpenBB Terminal Custom Backend. +""" + +import json +import logging +import os +import sys + +import uvicorn +from fastapi.responses import JSONResponse +from openbb_core.api.rest_api import app + +from .utils.api import check_port, get_user_settings, get_widgets_json, parse_args + +logger = logging.getLogger("openbb_platform_api") +logger.setLevel(logging.INFO) +handler = logging.StreamHandler() +handler.setLevel(logging.INFO) +formatter = logging.Formatter("\n%(message)s\n") +handler.setFormatter(formatter) +logger.addHandler(handler) +logger.setLevel(logging.INFO) + + +FIRST_RUN = True + +HOME = os.environ.get("HOME") or os.environ.get("USERPROFILE") + +if not HOME: + raise ValueError("HOME or USERPROFILE environment variable not set.") + +CURRENT_USER_SETTINGS = os.path.join(HOME, ".openbb_platform", "user_settings.json") +USER_SETTINGS_COPY = os.path.join(HOME, ".openbb_platform", "user_settings_backup.json") + +# Widget filtering is optional and can be used to exclude widgets from the widgets.json file +# You can generate this filter on OpenBB Hub: https://my.openbb.co/app/platform/widgets +WIDGET_SETTINGS = os.path.join(HOME, ".openbb_platform", "widget_settings.json") + +kwargs = parse_args() +build = kwargs.pop("build", True) +build = False if kwargs.pop("no-build", None) else build +login = kwargs.pop("login", False) +dont_filter = kwargs.pop("no-filter", False) +widget_exclude_filter: list = [] + +if not dont_filter and os.path.exists(WIDGET_SETTINGS): + with open(WIDGET_SETTINGS) as f: + try: + widget_exclude_filter = json.load(f)["exclude"] + except json.JSONDecodeError as e: + logger.info("Error loading widget filter settings -> %s", e) + + +openapi = app.openapi() + +# We don't need the current settings, +# but we need to call the function to update, login, and/or identify the settings file. +current_settings = get_user_settings(login, CURRENT_USER_SETTINGS, USER_SETTINGS_COPY) + +widgets_json = get_widgets_json(build, openapi, widget_exclude_filter) + + +@app.get("/") +async def get_root(): + """Root response and welcome message.""" + return JSONResponse( + content="Welcome to the OpenBB Platform API." + + " Learn how to connect to Pro in https://docs.openbb.co/pro/custom-backend," + + " or see the API documentation here: /docs" + ) + + +@app.get("/widgets.json") +async def get_widgets(): + """Widgets configuration file for the OpenBB Terminal Pro.""" + # This allows us to serve an edited widgets.json file without reloading the server. + global FIRST_RUN # noqa PLW0603 # pylint: disable=global-statement + if FIRST_RUN is True: + FIRST_RUN = False + return JSONResponse(content=widgets_json) + return JSONResponse(content=get_widgets_json(False, openapi, widget_exclude_filter)) + + +def launch_api(**_kwargs): # noqa PRL0912 + """Main function.""" + host = _kwargs.pop("host", os.getenv("OPENBB_API_HOST", "127.0.0.1")) + if not host: + logger.info( + "OPENBB_API_HOST is set incorrectly. It should be an IP address or hostname." + ) + host = input("Enter the host IP address or hostname: ") + if not host: + host = "127.0.0.1" + + port = _kwargs.pop("port", os.getenv("OPENBB_API_PORT", "6900")) + + try: + port = int(port) + except ValueError: + logger.info("OPENBB_API_PORT is set incorrectly. It should be an port number.") + port = input("Enter the port number: ") + try: + port = int(port) + except ValueError: + logger.info("Invalid port number. Defaulting to 6900.") + port = 6900 + if port < 1025: + port = 6900 + logger.info("Invalid port number, must be above 1024. Defaulting to 6900.") + + free_port = check_port(host, port) + + if free_port != port: + logger.info("Port %d is already in use. Using port %d.", port, free_port) + port = free_port + + if "use_colors" not in _kwargs: + _kwargs["use_colors"] = "win" not in sys.platform or os.name != "nt" + + try: + package_name = __package__ + logger.info( + "\nTo access this data from OpenBB Terminal, use the link displayed after the application startup completes." + "\nChrome is the recommended browser. Other browsers may conflict or require additional configuration." + "\nDocumentation is available at /docs." + ) + uvicorn.run(f"{package_name}.main:app", host=host, port=port, **_kwargs) + finally: + # If user_settings_copy.json exists, then restore the original settings. + if os.path.exists(USER_SETTINGS_COPY): + logger.info("Restoring the original settings.") + os.replace(USER_SETTINGS_COPY, CURRENT_USER_SETTINGS) + + +def main(): + """Launch the API.""" + launch_api(**kwargs) + + +if __name__ == "__main__": + + try: + main() + except KeyboardInterrupt: + sys.exit(0) diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/utils/__init__.py b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/__init__.py new file mode 100644 index 000000000000..aa3b0ef651fa --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/__init__.py @@ -0,0 +1 @@ +"""OpenBB Platform API Utils.""" diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/utils/api.py b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/api.py new file mode 100644 index 000000000000..a191e2060cff --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/api.py @@ -0,0 +1,249 @@ +"""API Utils.""" + +import json +import os +import socket +import sys +from pathlib import Path + +from deepdiff import DeepDiff + +from .widgets import build_json + +LAUNCH_SCRIPT_DESCRIPTION = """ +Serve the OpenBB Platform API. + + +Launcher specific arguments: + + --build Build the widgets.json file. + --no-build Do not build the widgets.json file. + --login Login to the OpenBB Platform. + --no-filter Do not filter the widgets.json file. + + +All other arguments will be passed to uvicorn. Here are the most common ones: + + --host TEXT Host IP address or hostname. + [default: 127.0.0.1] + --port INTEGER Port number. + [default: 6900] + --ssl-keyfile TEXT SSL key file. + --ssl-certfile TEXT SSL certificate file. + --ssl-keyfile-password TEXT SSL keyfile password. + --ssl-version INTEGER SSL version to use. + (see stdlib ssl module's) + [default: 17] + --ssl-cert-reqs INTEGER Whether client certificate is required. + (see stdlib ssl module's) + [default: 0] + --ssl-ca-certs TEXT CA certificates file. + --ssl-ciphers TEXT Ciphers to use. + (see stdlib ssl module's) + [default: TLSv1] + +Run `uvicorn --help` to get the full list of arguments. +""" + + +def check_port(host, port): + """Check if the port number is free.""" + port = int(port) + not_free = True + while not_free: + with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as sock: + res = sock.connect_ex((host, port)) + if res != 0: + not_free = False + else: + port += 1 + return port + + +def get_user_settings( + _login: bool, current_user_settings: str, user_settings_copy: str +): + """Login to the OpenBB Platform.""" + # pylint: disable=import-outside-toplevel + import getpass + + if Path(current_user_settings).exists(): + with open(current_user_settings, encoding="utf-8") as f: + _current_settings = json.load(f) + else: + _current_settings = { + "credentials": {}, + "preferences": {}, + "defaults": {"commands": {}}, + } + if (isinstance(_login, str) and _login.lower() == "false") or not _login: + return _current_settings + + pat = getpass.getpass( + "\n\nEnter your personal access token (PAT) to authorize the API and update your local settings." + + "\nSkip to use a pre-configured 'user_settings.json' file." + + "\nPress Enter to skip or copy (entered values are not displayed on screen) your PAT to the command line: " + ) + + if pat: + from openbb_core.app.service.hub_service import HubService + + hub_credentials: dict = {} + hub_preferences: dict = {} + hub_defaults: dict = {} + try: + Hub = HubService() + _ = Hub.connect(pat=pat) + hub_settings = Hub.pull() + hub_credentials = json.loads( + hub_settings.credentials.model_dump_json() # pylint: disable=no-member + ) + hub_preferences = json.loads( + hub_settings.preferences.model_dump_json() # pylint: disable=no-member + ) + hub_defaults = json.loads( + hub_settings.defaults.model_dump_json() # pylint: disable=no-member + ) + except Exception as e: # pylint: disable=broad-exception-caught + print( # noqa: T201 + f"\n\nError connecting with Hub:\n{e}\n\nUsing the local settings.\n" + ) + + if hub_credentials: + # Prompt the user to ask if they want to persist the new settings + persist_input = ( + input( + "\n\nDo you want to persist the new settings?" + + " Not recommended for public machines. (yes/no): " + ) + .strip() + .lower() + ) + + if persist_input in ["yes", "y"]: + PERSIST = True + elif persist_input in ["no", "n"]: + PERSIST = False + else: + print( # noqa: T201 + "\n\nInvalid input. Defaulting to not persisting the new settings." + ) + PERSIST = False + + # Save the current settings to restore at the end of the session. + if PERSIST is False: + with open(user_settings_copy, "w", encoding="utf-8") as f: + json.dump(_current_settings, f, indent=4) + + new_settings = _current_settings.copy() + new_settings.setdefault("credentials", {}) + new_settings.setdefault("preferences", {}) + new_settings.setdefault("defaults", {"commands": {}}) + + # Update the current settings with the new settings + if hub_credentials: + for k, v in hub_credentials.items(): + if v: + new_settings["credentials"][k] = v.strip('"').strip("'") + + if hub_preferences: + for k, v in hub_preferences.items(): + if v: + new_settings["preferences"][k] = v + + if hub_defaults: + for k, v in hub_defaults.items(): + if k == "commands": + for key, value in hub_defaults["commands"].items(): + if value: + new_settings["defaults"]["commands"][key] = value + elif v: + new_settings["defaults"][k] = v + else: + continue + + # Write the new settings to the user_settings.json file + with open(current_user_settings, "w", encoding="utf-8") as f: + json.dump(new_settings, f, indent=4) + + _current_settings = new_settings + + return _current_settings + + +def get_widgets_json(_build: bool, _openapi, widget_exclude_filter: list): + """Generate and serve the widgets.json for the OpenBB Platform API.""" + python_path = Path(sys.executable) + parent_path = python_path.parent if os.name == "nt" else python_path.parents[1] + widgets_json_path = parent_path.joinpath("assets", "widgets.json").resolve() + json_exists = widgets_json_path.exists() + + if not json_exists: + widgets_json_path.parent.mkdir(parents=True, exist_ok=True) + _build = True + + existing_widgets_json: dict = {} + + if json_exists: + with open(widgets_json_path, encoding="utf-8") as f: + existing_widgets_json = json.load(f) + + _widgets_json = ( + existing_widgets_json + if _build is False + else build_json(_openapi, widget_exclude_filter) + ) + + if _build: + diff = DeepDiff(existing_widgets_json, _widgets_json, ignore_order=True) + merge_prompt = None + if diff and json_exists: + print("Differences found:", diff) # noqa: T201 + merge_prompt = input( + "\nDo you want to overwrite the existing widgets.json configuration?" + "\nEnter 'n' to append existing with only new entries, or 'i' to ignore all changes. (y/n/i): " + ) + if merge_prompt.lower().startswith("n"): + _widgets_json.update(existing_widgets_json) + elif merge_prompt.lower().startswith("i"): + _widgets_json = existing_widgets_json + + if merge_prompt is None or not merge_prompt.lower().startswith("i"): + try: + with open(widgets_json_path, "w", encoding="utf-8") as f: + json.dump(_widgets_json, f, ensure_ascii=False, indent=4) + except Exception as e: # pylint: disable=broad-exception-caught + print( # noqa: T201 + f"Error writing widgets.json: {e}. Loading from memory instead." + ) + _widgets_json = ( + existing_widgets_json + if existing_widgets_json + else build_json(_openapi, widget_exclude_filter) + ) + + return _widgets_json + + +def parse_args(): + """Parse the launch script command line arguments.""" + args = sys.argv[1:].copy() + _kwargs: dict = {} + for i, arg in enumerate(args): + if arg == "--help": + print(LAUNCH_SCRIPT_DESCRIPTION) # noqa: T201 + sys.exit(0) + if arg.startswith("--"): + key = arg[2:] + if key in ["no-use-colors", "use-colors"]: + _kwargs["use_colors"] = key == "use-colors" + elif i + 1 < len(args) and not args[i + 1].startswith("--"): + value = args[i + 1] + if isinstance(value, str) and value.lower() in ["false", "true"]: + _kwargs[key] = value.lower() == "true" + else: + _kwargs[key] = value + else: + _kwargs[key] = True + + return _kwargs diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/utils/openapi.py b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/openapi.py new file mode 100644 index 000000000000..a59cc274b5c6 --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/openapi.py @@ -0,0 +1,454 @@ +"""OpenAPI parsing Utils.""" + +from openbb_core.provider.utils.helpers import to_snake_case + + +def extract_providers(params: list[dict]) -> list[str]: + """ + Extract provider options from parameters. + + Parameters + ---------- + params : List[Dict] + List of parameter dictionaries. + + Returns + ------- + List[str] + List of provider options. + """ + provider_params = [p for p in params if p["name"] == "provider"] + if provider_params: + return provider_params[0].get("schema", {}).get("enum", []) + return [] + + +def set_parameter_type(p: dict, p_schema: dict): + """ + Determine and set the type for the parameter. + + Parameters + ---------- + p : Dict + Processed parameter dictionary. + p_schema : Dict + Schema dictionary for the parameter. + """ + p_type = p_schema.get("type") if not p.get("type") else p.get("type") + + if p_type == "string": + p["type"] = "text" + + if p_type in ("float", "integer") or ( + not isinstance(p["value"], bool) and isinstance(p["value"], (int, float)) + ): + p["type"] = "number" + + if ( + p_type == "boolean" + or p_schema.get("type") == "boolean" + or ("anyOf" in p_schema and p_schema["anyOf"][0].get("type") == "boolean") + ): + p["type"] = "boolean" + + if "date" in p["parameter_name"]: + p["type"] = "date" + + if "timeframe" in p["parameter_name"]: + p["type"] = "text" + + if p["parameter_name"] == "limit": + p["type"] = "number" + + if p.get("type") in ("array", "list") or isinstance(p.get("type"), list): + p["type"] = "text" + + return p + + +def set_parameter_options(p: dict, p_schema: dict, providers: list[str]) -> dict: + """ + Set options for the parameter based on the schema. + + Parameters + ---------- + p : Dict + Processed parameter dictionary. + p_schema : Dict + Schema dictionary for the parameter. + providers : List[str] + List of provider options. + + Returns + ------- + Dict + Updated parameter dictionary with options. + """ + choices: dict[str, list[dict[str, str]]] = {} + multiple_items_allowed_dict: dict = {} + is_provider_specific = False + available_providers: set = set() + unique_general_choices: list = [] + + # Handle provider-specific choices + for provider in providers: + if (provider in p_schema) or (len(providers) == 1): + is_provider_specific = True + provider_choices: list = [] + if provider not in available_providers: + available_providers.add(provider) + if provider in p_schema: + provider_choices = p_schema[provider].get("choices", []) + elif len(providers) == 1 and "enum" in p_schema: + provider_choices = p_schema["enum"] + p_schema.pop("enum") + if provider_choices: + choices[provider] = [ + {"label": str(c), "value": c} for c in provider_choices + ] + if provider in p_schema and p_schema[provider].get( + "multiple_items_allowed", False + ): + multiple_items_allowed_dict[provider] = True + + # Check title for provider-specific information + if "title" in p_schema: + title_providers = set(p_schema["title"].split(",")) + if title_providers.intersection(providers): + is_provider_specific = True + available_providers.update(title_providers) + + # Handle general choices + general_choices: list = [] + if "enum" in p_schema: + general_choices.extend( + [ + {"label": str(c), "value": c} + for c in p_schema["enum"] + if c not in ["null", None] + ] + ) + elif "anyOf" in p_schema: + for sub_schema in p_schema["anyOf"]: + if "enum" in sub_schema: + general_choices.extend( + [ + {"label": str(c), "value": c} + for c in sub_schema["enum"] + if c not in ["null", None] + ] + ) + + if general_choices: + # Remove duplicates by converting list of dicts to a set of tuples and back to list of dicts + unique_general_choices = [ + dict(t) for t in {tuple(d.items()) for d in general_choices} + ] + if not is_provider_specific: + if len(providers) == 1: + choices[providers[0]] = unique_general_choices + multiple_items_allowed_dict[providers[0]] = p_schema.get( + "multiple_items_allowed", False + ) + else: + choices["other"] = unique_general_choices + multiple_items_allowed_dict["other"] = p_schema.get( + "multiple_items_allowed", False + ) + + # Use general choices as fallback for providers without specific options + for provider in available_providers: + if provider not in choices: + if "anyOf" in p_schema and p_schema["anyOf"]: + fallback_choices = p_schema["anyOf"][0].get("enum", []) + choices[provider] = [ + {"label": str(c), "value": c} + for c in fallback_choices + if c not in ["null", None] + ] + else: + choices[provider] = unique_general_choices + + p["options"] = choices + p["multiple_items_allowed"] = multiple_items_allowed_dict + + if is_provider_specific: + p["available_providers"] = list(available_providers) + + return p + + +def process_parameter(param: dict, providers: list[str]) -> dict: + """ + Process a single parameter and return the processed dictionary. + + Parameters + ---------- + param : Dict + Parameter dictionary. + providers : List[str] + List of provider options. + + Returns + ------- + Dict + Processed parameter dictionary. + """ + p: dict = {} + param_name = param["name"] + p["parameter_name"] = param_name + p["label"] = ( + param_name.replace("_", " ").replace("fixedincome", "fixed income").title() + ) + p["description"] = ( + (param.get("description", param_name).split(" (provider:")[0].strip()) + .split("Multiple comma separated items allowed")[0] + .strip() + ) + p["optional"] = param.get("required", False) is False + + if param_name == "provider": + p["type"] = "text" + p["label"] = "Provider" + p["description"] = "Source of the data." + p["available_providers"] = providers + return p + + if param_name in ["symbol", "series_id", "release_id"]: + p["type"] = "text" + p["label"] = param_name.title().replace("_", " ").replace("Id", "ID") + p["description"] = ( + p["description"] + .split("Multiple comma separated items allowed for provider(s)")[0] + .strip() + ) + multiple_items_allowed_dict: dict = {} + for _provider in providers: + if _provider in param["schema"] and param["schema"][_provider].get( + "multiple_items_allowed", False + ): + multiple_items_allowed_dict[_provider] = True + p["multiple_items_allowed"] = multiple_items_allowed_dict + if "Multiple comma separated items allowed" in p["description"]: + p["description"] = ( + p["description"] + .split("Multiple comma separated items allowed")[0] + .strip() + ) + return p + + p_schema = param.get("schema", {}) + p["value"] = p_schema.get("default", None) + p = set_parameter_options(p, p_schema, providers) + p = set_parameter_type(p, p_schema) + + return p + + +def get_query_schema_for_widget( + openapi_json: dict, command_route: str +) -> tuple[list[dict], bool]: + """ + Extract the query schema for a widget. + + Parameters + ---------- + openapi_json : dict + The OpenAPI specification as a dictionary. + command_route : str + The route of the command in the OpenAPI specification. + + Returns + ------- + Tuple[List[Dict], bool] + A tuple containing the list of processed parameters and a boolean indicating if a chart is present. + """ + has_chart = False + command = openapi_json["paths"][command_route] + schema_method = list(command)[0] + command = command[schema_method] + params = command.get("parameters", []) + route_params: list[dict] = [] + providers: list[str] = extract_providers(params) + + for param in params: + if param["name"] in ["sort", "order"]: + continue + if param["name"] == "chart": + has_chart = True + continue + + p = process_parameter(param, providers) + p["show"] = True + route_params.append(p) + + return route_params, has_chart + + +def get_data_schema_for_widget(openapi_json, operation_id): + """ + Get the data schema for a widget based on its operationId. + + Args: + openapi (dict): The OpenAPI specification as a dictionary. + operation_id (str): The operationId of the widget. + + Returns: + dict: The schema dictionary for the widget's data. + """ + # Find the route and method for the given operationId + for _, methods in openapi_json["paths"].items(): + for _, details in methods.items(): + if details.get("operationId") == operation_id: + # Get the reference to the schema from the successful response + response_ref = details["responses"]["200"]["content"][ + "application/json" + ]["schema"]["$ref"] + # Extract the schema name from the reference + schema_name = response_ref.split("/")[-1] + # Fetch and return the schema from components + return ( + openapi_json["components"]["schemas"][schema_name] + .get("properties", {}) + .get("results", {}) + ) + + # Return None if the schema is not found + return None + + +def data_schema_to_columns_defs(openapi_json, operation_id, provider): + """Convert data schema to column definitions for the widget.""" + # Initialize an empty list to hold the schema references + schema_refs: list = [] + + result_schema_ref = get_data_schema_for_widget(openapi_json, operation_id) + # Check if 'anyOf' is in the result_schema_ref and handle the nested structure + if "anyOf" in result_schema_ref: + for item in result_schema_ref["anyOf"]: + # When there are multiple providers a 'oneOf' is used + if "items" in item and "oneOf" in item["items"]: + # Extract the $ref values + schema_refs.extend( + [ + oneOf_item["$ref"].split("/")[-1] + for oneOf_item in item["items"]["oneOf"] + if "$ref" in oneOf_item + ] + ) + # When there's only one model there is no oneOf + elif "items" in item and "$ref" in item["items"]: + schema_refs.append(item["items"]["$ref"].split("/")[-1]) + + # Fetch the schemas using the extracted references + schemas = [ + openapi_json["components"]["schemas"][ref] + for ref in schema_refs + if ref in openapi_json["components"]["schemas"] + ] + + # Proceed with finding common keys and generating column definitions + if not schemas: + return [] + + target_schema: dict = {} + + if len(schemas) == 1: + target_schema = schemas[0] + else: + for schema in schemas: + if ( + schema.get("description", "") + .lower() + .startswith(provider.lower().replace("tradingeconomics", "te")) + ) or (schema.get("description", "").lower().startswith("us government")): + target_schema = schema + break + + keys = list(target_schema.get("properties", {})) + + column_defs: list = [] + for key in keys: + cell_data_type = None + formatterFn = None + prop = target_schema.get("properties", {}).get(key) + # Handle prop types for both when there's a single prop type or multiple + if "anyOf" in prop: + types = [ + sub_prop.get("type") for sub_prop in prop["anyOf"] if "type" in sub_prop + ] + if "number" in types or "integer" in types or "float" in types: + cell_data_type = "number" + elif "string" in types and any( + sub_prop.get("format") in ["date", "date-time"] + for sub_prop in prop["anyOf"] + if "format" in sub_prop + ): + cell_data_type = "date" + else: + cell_data_type = "text" + else: + prop_type = prop.get("type", None) + if prop_type in ["number", "integer", "float"]: + cell_data_type = "number" + if prop_type == "integer": + formatterFn = "int" + elif "format" in prop and prop["format"] in ["date", "date-time"]: + cell_data_type = "date" + else: + cell_data_type = "text" + + column_def: dict = {} + # OpenAPI changes some of the field names. + k = to_snake_case(key) + column_def["field"] = k + if k in [ + "symbol", + "symbol_root", + "series_id", + "date", + "published", + "fiscal_year", + "period_ending", + "period_beginning", + "order", + "name", + "title", + "cusip", + "isin", + ]: + column_def["pinned"] = "left" + + column_def["formatterFn"] = formatterFn + column_def["headerName"] = prop.get("title", key.title()) + column_def["description"] = prop.get( + "description", prop.get("title", key.title()) + ) + column_def["cellDataType"] = cell_data_type + column_def["chartDataType"] = ( + "series" + if cell_data_type in ["number", "integer", "float"] + and column_def.get("pinned") != "left" + else "category" + ) + measurement = prop.get("x-unit_measurement") + + if measurement == "percent": + column_def["formatterFn"] = ( + "normalizedPercent" + if prop.get("x-frontend_multiply") == 100 + else "percent" + ) + column_def["renderFn"] = "greenRed" + elif cell_data_type == "number": + del column_def["formatterFn"] + + if k in ["cik", "isin", "figi", "cusip", "sedol", "symbol"]: + column_def["cellDataType"] = "text" + column_def["headerName"] = ( + column_def["headerName"].upper() if k != "symbol" else "Symbol" + ) + + column_defs.append(column_def) + + return column_defs diff --git a/openbb_platform/extensions/platform_api/openbb_platform_api/utils/widgets.py b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/widgets.py new file mode 100644 index 000000000000..45a597fd3a0c --- /dev/null +++ b/openbb_platform/extensions/platform_api/openbb_platform_api/utils/widgets.py @@ -0,0 +1,243 @@ +"""Utils for building the widgets.json file.""" + +from copy import deepcopy + +TO_CAPS_STRINGS = [ + "Pe", + "Sloos", + "Eps", + "Ebitda", + "Otc", + "Cpi", + "Pce", + "Gdp", + "Lbma", + "Ipo", + "Nbbo", + "Ameribor", + "Sonia", + "Effr", + "Sofr", + "Iorb", + "Estr", + "Ecb", + "Dpcredit", + "Tcm", + "Us", + "Ice", + "Bofa", + "Hqm", + "Sp500", + "Sec", + "Cftc", + "Cot", + "Etf", + "Eu", + "Tips", + "Rss", + "Sic", + "Cik", + "Bls", + "Fred", + "Cusip", +] + + +def modify_query_schema(query_schema: list[dict], provider_value: str): + """Modify query_schema and the description for the current provider.""" + modified_query_schema: list = [] + for item in query_schema: + # copy the item + _item = deepcopy(item) + provider_value_options: dict = {} + + # Exclude provider parameter. Those will be added last. + if "parameter_name" in _item and _item["parameter_name"] == "provider": + continue + + # Exclude parameters that are not available for the current provider. + if ( + "available_providers" in _item + and provider_value not in _item["available_providers"] + ): + continue + + if provider_value in _item["multiple_items_allowed"] and _item[ + "multiple_items_allowed" + ].get(provider_value, False): + _item["description"] = ( + _item["description"] + " Multiple comma separated items allowed." + ) + _item["type"] = "text" + _item["multiSelect"] = True + + if "options" in _item: + provider_value_options = _item.pop("options") + + if provider_value in provider_value_options and bool( + provider_value_options[provider_value] + ): + _item["options"] = provider_value_options[provider_value] + _item["type"] = "text" + elif len(provider_value_options) == 1 and "other" in provider_value_options: + _item["options"] = provider_value_options["other"] + _item["type"] = "text" + + _item.pop("multiple_items_allowed") + + if "available_providers" in _item: + _item.pop("available_providers") + + _item["paramName"] = _item.pop("parameter_name") + + modified_query_schema.append(_item) + + if provider_value != "custom": + modified_query_schema.append( + {"paramName": "provider", "value": provider_value, "show": False} + ) + + return modified_query_schema + + +def build_json(openapi: dict, widget_exclude_filter: list): + """Build the widgets.json file.""" + # pylint: disable=import-outside-toplevel + from .openapi import data_schema_to_columns_defs, get_query_schema_for_widget + + if not openapi: + return {} + + widgets_json: dict = {} + routes = [ + p + for p in openapi["paths"] + if p.startswith("/api") and "get" in openapi["paths"][p] + ] + for route in routes: + route_api = openapi["paths"][route] + method = list(route_api)[0] + widget_id = route_api[method]["operationId"] + + # Prepare the query schema of the widget + query_schema, has_chart = get_query_schema_for_widget(openapi, route) + + # Extract providers from the query schema + providers: list = [] + for item in query_schema: + if item["parameter_name"] == "provider": + providers = item["available_providers"] + + if not providers: + providers = ["custom"] + + for provider in providers: + columns_defs = data_schema_to_columns_defs(openapi, widget_id, provider) + _cat = route.split("v1/")[-1] + _cats = _cat.split("/") + category = _cats[0].title() + category = category.replace("Fixedincome", "Fixed Income") + subcat = _cats[1].title().replace("_", " ") if len(_cats) > 2 else None + name = ( + widget_id.replace("fixedincome", "fixed income") + .replace("_", " ") + .title() + .replace(category if category else "", "") + .replace(subcat if subcat else "", "") + .strip() + ) + + name = " ".join( + [ + (word.upper() if word in TO_CAPS_STRINGS else word) + for word in name.split() + ] + ) + + modified_query_schema = modify_query_schema(query_schema, provider) + + provider_map = { + "tmx": "TMX", + "ecb": "ECB", + "econdb": "EconDB", + "fmp": "FMP", + "oecd": "OECD", + "finra": "FINRA", + "fred": "FRED", + "imf": "IMF", + "bls": "BLS", + "yfinance": "yFinance", + "sec": "SEC", + "cftc": "CFTC", + "tradingeconomics": "Trading Economics", + "wsj": "WSJ", + } + provider_name = provider_map.get( + provider.lower(), provider.replace("_", " ").title() + ) + + widget_config = { + "name": f"{name}", + "description": route_api["get"]["description"], + "category": category, + "searchCategory": category, + "widgetId": f"{widget_id}_{provider}_obb", + "params": modified_query_schema, + "endpoint": route.replace("/api", "api"), + "gridData": {"w": 45, "h": 15}, + "data": { + "dataKey": "results", + "table": { + "showAll": True, + }, + }, + "source": [provider_name], + } + + if subcat: + subcat = " ".join( + [ + (word.upper() if word in TO_CAPS_STRINGS else word) + for word in subcat.split() + ] + ) + subcat = ( + subcat.replace("Estimates", "Analyst Estimates") + .replace("Fundamental", "Fundamental Analysis") + .replace("Compare", "Comparison Analysis") + ) + widget_config["subCategory"] = subcat + + if columns_defs: + widget_config["data"]["table"]["columnsDefs"] = columns_defs + + # Add the widget configuration to the widgets.json + if widget_config["widgetId"] not in widget_exclude_filter: + widgets_json[widget_config["widgetId"]] = widget_config + + if has_chart: + widget_config_chart = deepcopy(widget_config) + widget_config_chart["name"] = widget_config_chart["name"] + " (Chart)" + widget_config_chart["widgetId"] = ( + f"{widget_config_chart['widgetId']}_chart" + ) + widget_config_chart["params"].append( + { + "paramName": "chart", + "label": "Chart", + "description": "Returns chart", + "optional": True, + "value": True, + "type": "boolean", + "show": False, + }, + ) + widget_config_chart["searchCategory"] = "chart" + widget_config_chart["gridData"]["h"] = 20 + widget_config_chart["gridData"]["w"] = 50 + widget_config_chart["defaultViz"] = "chart" + widget_config_chart["data"]["dataKey"] = "chart.content" + if widget_config_chart["widgetId"] not in widget_exclude_filter: + widgets_json[widget_config_chart["widgetId"]] = widget_config_chart + + return widgets_json diff --git a/openbb_platform/extensions/platform_api/poetry.lock b/openbb_platform/extensions/platform_api/poetry.lock new file mode 100644 index 000000000000..d2fd2a2925ba --- /dev/null +++ b/openbb_platform/extensions/platform_api/poetry.lock @@ -0,0 +1,3024 @@ +# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand. + +[[package]] +name = "aiohappyeyeballs" +version = "2.4.3" +description = "Happy Eyeballs for asyncio" +optional = false +python-versions = ">=3.8" +files = [ + {file = "aiohappyeyeballs-2.4.3-py3-none-any.whl", hash = "sha256:8a7a83727b2756f394ab2895ea0765a0a8c475e3c71e98d43d76f22b4b435572"}, + {file = "aiohappyeyeballs-2.4.3.tar.gz", hash = "sha256:75cf88a15106a5002a8eb1dab212525c00d1f4c0fa96e551c9fbe6f09a621586"}, +] + +[[package]] +name = "aiohttp" +version = "3.10.9" +description = "Async http client/server framework (asyncio)" +optional = false +python-versions = ">=3.8" +files = [ + {file = "aiohttp-3.10.9-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:8b3fb28a9ac8f2558760d8e637dbf27aef1e8b7f1d221e8669a1074d1a266bb2"}, + {file = "aiohttp-3.10.9-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:91aa966858593f64c8a65cdefa3d6dc8fe3c2768b159da84c1ddbbb2c01ab4ef"}, + {file = "aiohttp-3.10.9-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:63649309da83277f06a15bbdc2a54fbe75efb92caa2c25bb57ca37762789c746"}, + {file = "aiohttp-3.10.9-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e3e7fabedb3fe06933f47f1538df7b3a8d78e13d7167195f51ca47ee12690373"}, + {file = "aiohttp-3.10.9-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5c070430fda1a550a1c3a4c2d7281d3b8cfc0c6715f616e40e3332201a253067"}, + {file = "aiohttp-3.10.9-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:51d0a4901b27272ae54e42067bc4b9a90e619a690b4dc43ea5950eb3070afc32"}, + {file = "aiohttp-3.10.9-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fec5fac7aea6c060f317f07494961236434928e6f4374e170ef50b3001e14581"}, + {file = "aiohttp-3.10.9-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:172ad884bb61ad31ed7beed8be776eb17e7fb423f1c1be836d5cb357a096bf12"}, + {file = "aiohttp-3.10.9-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:d646fdd74c25bbdd4a055414f0fe32896c400f38ffbdfc78c68e62812a9e0257"}, + {file = "aiohttp-3.10.9-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:e86260b76786c28acf0b5fe31c8dca4c2add95098c709b11e8c35b424ebd4f5b"}, + {file = "aiohttp-3.10.9-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:c7d7cafc11d70fdd8801abfc2ff276744ae4cb39d8060b6b542c7e44e5f2cfc2"}, + {file = "aiohttp-3.10.9-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:fc262c3df78c8ff6020c782d9ce02e4bcffe4900ad71c0ecdad59943cba54442"}, + {file = "aiohttp-3.10.9-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:482c85cf3d429844396d939b22bc2a03849cb9ad33344689ad1c85697bcba33a"}, + {file = "aiohttp-3.10.9-cp310-cp310-win32.whl", hash = "sha256:aeebd3061f6f1747c011e1d0b0b5f04f9f54ad1a2ca183e687e7277bef2e0da2"}, + {file = "aiohttp-3.10.9-cp310-cp310-win_amd64.whl", hash = "sha256:fa430b871220dc62572cef9c69b41e0d70fcb9d486a4a207a5de4c1f25d82593"}, + {file = "aiohttp-3.10.9-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:16e6a51d8bc96b77f04a6764b4ad03eeef43baa32014fce71e882bd71302c7e4"}, + {file = "aiohttp-3.10.9-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:8bd9125dd0cc8ebd84bff2be64b10fdba7dc6fd7be431b5eaf67723557de3a31"}, + {file = "aiohttp-3.10.9-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dcf354661f54e6a49193d0b5653a1b011ba856e0b7a76bda2c33e4c6892f34ea"}, + {file = "aiohttp-3.10.9-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42775de0ca04f90c10c5c46291535ec08e9bcc4756f1b48f02a0657febe89b10"}, + {file = "aiohttp-3.10.9-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:87d1e4185c5d7187684d41ebb50c9aeaaaa06ca1875f4c57593071b0409d2444"}, + {file = "aiohttp-3.10.9-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c2695c61cf53a5d4345a43d689f37fc0f6d3a2dc520660aec27ec0f06288d1f9"}, + {file = "aiohttp-3.10.9-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a3f063b41cc06e8d0b3fcbbfc9c05b7420f41287e0cd4f75ce0a1f3d80729e6"}, + {file = "aiohttp-3.10.9-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2d37f4718002863b82c6f391c8efd4d3a817da37030a29e2682a94d2716209de"}, + {file = "aiohttp-3.10.9-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:2746d8994ebca1bdc55a1e998feff4e94222da709623bb18f6e5cfec8ec01baf"}, + {file = "aiohttp-3.10.9-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:6f3c6648aa123bcd73d6f26607d59967b607b0da8ffcc27d418a4b59f4c98c7c"}, + {file = "aiohttp-3.10.9-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:558b3d223fd631ad134d89adea876e7fdb4c93c849ef195049c063ada82b7d08"}, + {file = "aiohttp-3.10.9-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:4e6cb75f8ddd9c2132d00bc03c9716add57f4beff1263463724f6398b813e7eb"}, + {file = "aiohttp-3.10.9-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:608cecd8d58d285bfd52dbca5b6251ca8d6ea567022c8a0eaae03c2589cd9af9"}, + {file = "aiohttp-3.10.9-cp311-cp311-win32.whl", hash = "sha256:36d4fba838be5f083f5490ddd281813b44d69685db910907636bc5dca6322316"}, + {file = "aiohttp-3.10.9-cp311-cp311-win_amd64.whl", hash = "sha256:8be1a65487bdfc285bd5e9baf3208c2132ca92a9b4020e9f27df1b16fab998a9"}, + {file = "aiohttp-3.10.9-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:4fd16b30567c5b8e167923be6e027eeae0f20cf2b8a26b98a25115f28ad48ee0"}, + {file = "aiohttp-3.10.9-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:40ff5b7660f903dc587ed36ef08a88d46840182d9d4b5694e7607877ced698a1"}, + {file = "aiohttp-3.10.9-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4edc3fd701e2b9a0d605a7b23d3de4ad23137d23fc0dbab726aa71d92f11aaaf"}, + {file = "aiohttp-3.10.9-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e525b69ee8a92c146ae5b4da9ecd15e518df4d40003b01b454ad694a27f498b5"}, + {file = "aiohttp-3.10.9-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5002a02c17fcfd796d20bac719981d2fca9c006aac0797eb8f430a58e9d12431"}, + {file = "aiohttp-3.10.9-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fd4ceeae2fb8cabdd1b71c82bfdd39662473d3433ec95b962200e9e752fb70d0"}, + {file = "aiohttp-3.10.9-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d6e395c3d1f773cf0651cd3559e25182eb0c03a2777b53b4575d8adc1149c6e9"}, + {file = "aiohttp-3.10.9-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:bbdb8def5268f3f9cd753a265756f49228a20ed14a480d151df727808b4531dd"}, + {file = "aiohttp-3.10.9-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:f82ace0ec57c94aaf5b0e118d4366cff5889097412c75aa14b4fd5fc0c44ee3e"}, + {file = "aiohttp-3.10.9-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:6ebdc3b3714afe1b134b3bbeb5f745eed3ecbcff92ab25d80e4ef299e83a5465"}, + {file = "aiohttp-3.10.9-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:f9ca09414003c0e96a735daa1f071f7d7ed06962ef4fa29ceb6c80d06696d900"}, + {file = "aiohttp-3.10.9-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:1298b854fd31d0567cbb916091be9d3278168064fca88e70b8468875ef9ff7e7"}, + {file = "aiohttp-3.10.9-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:60ad5b8a7452c0f5645c73d4dad7490afd6119d453d302cd5b72b678a85d6044"}, + {file = "aiohttp-3.10.9-cp312-cp312-win32.whl", hash = "sha256:1a0ee6c0d590c917f1b9629371fce5f3d3f22c317aa96fbdcce3260754d7ea21"}, + {file = "aiohttp-3.10.9-cp312-cp312-win_amd64.whl", hash = "sha256:c46131c6112b534b178d4e002abe450a0a29840b61413ac25243f1291613806a"}, + {file = "aiohttp-3.10.9-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2bd9f3eac515c16c4360a6a00c38119333901b8590fe93c3257a9b536026594d"}, + {file = "aiohttp-3.10.9-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8cc0d13b4e3b1362d424ce3f4e8c79e1f7247a00d792823ffd640878abf28e56"}, + {file = "aiohttp-3.10.9-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:ba1a599255ad6a41022e261e31bc2f6f9355a419575b391f9655c4d9e5df5ff5"}, + {file = "aiohttp-3.10.9-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:776e9f3c9b377fcf097c4a04b241b15691e6662d850168642ff976780609303c"}, + {file = "aiohttp-3.10.9-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8debb45545ad95b58cc16c3c1cc19ad82cffcb106db12b437885dbee265f0ab5"}, + {file = "aiohttp-3.10.9-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c2555e4949c8d8782f18ef20e9d39730d2656e218a6f1a21a4c4c0b56546a02e"}, + {file = "aiohttp-3.10.9-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c54dc329cd44f7f7883a9f4baaefe686e8b9662e2c6c184ea15cceee587d8d69"}, + {file = "aiohttp-3.10.9-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e709d6ac598c5416f879bb1bae3fd751366120ac3fa235a01de763537385d036"}, + {file = "aiohttp-3.10.9-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:17c272cfe7b07a5bb0c6ad3f234e0c336fb53f3bf17840f66bd77b5815ab3d16"}, + {file = "aiohttp-3.10.9-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:0c21c82df33b264216abffff9f8370f303dab65d8eee3767efbbd2734363f677"}, + {file = "aiohttp-3.10.9-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:9331dd34145ff105177855017920dde140b447049cd62bb589de320fd6ddd582"}, + {file = "aiohttp-3.10.9-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:ac3196952c673822ebed8871cf8802e17254fff2a2ed4835d9c045d9b88c5ec7"}, + {file = "aiohttp-3.10.9-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:2c33fa6e10bb7ed262e3ff03cc69d52869514f16558db0626a7c5c61dde3c29f"}, + {file = "aiohttp-3.10.9-cp313-cp313-win32.whl", hash = "sha256:a14e4b672c257a6b94fe934ee62666bacbc8e45b7876f9dd9502d0f0fe69db16"}, + {file = "aiohttp-3.10.9-cp313-cp313-win_amd64.whl", hash = "sha256:a35ed3d03910785f7d9d6f5381f0c24002b2b888b298e6f941b2fc94c5055fcd"}, + {file = "aiohttp-3.10.9-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5f392ef50e22c31fa49b5a46af7f983fa3f118f3eccb8522063bee8bfa6755f8"}, + {file = "aiohttp-3.10.9-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d1f5c9169e26db6a61276008582d945405b8316aae2bb198220466e68114a0f5"}, + {file = "aiohttp-3.10.9-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:8d9d10d10ec27c0d46ddaecc3c5598c4db9ce4e6398ca872cdde0525765caa2f"}, + {file = "aiohttp-3.10.9-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d97273a52d7f89a75b11ec386f786d3da7723d7efae3034b4dda79f6f093edc1"}, + {file = "aiohttp-3.10.9-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d271f770b52e32236d945911b2082f9318e90ff835d45224fa9e28374303f729"}, + {file = "aiohttp-3.10.9-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7003f33f5f7da1eb02f0446b0f8d2ccf57d253ca6c2e7a5732d25889da82b517"}, + {file = "aiohttp-3.10.9-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a6e00c8a92e7663ed2be6fcc08a2997ff06ce73c8080cd0df10cc0321a3168d7"}, + {file = "aiohttp-3.10.9-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a61df62966ce6507aafab24e124e0c3a1cfbe23c59732987fc0fd0d71daa0b88"}, + {file = "aiohttp-3.10.9-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:60555211a006d26e1a389222e3fab8cd379f28e0fbf7472ee55b16c6c529e3a6"}, + {file = "aiohttp-3.10.9-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:d15a29424e96fad56dc2f3abed10a89c50c099f97d2416520c7a543e8fddf066"}, + {file = "aiohttp-3.10.9-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:a19caae0d670771ea7854ca30df76f676eb47e0fd9b2ee4392d44708f272122d"}, + {file = "aiohttp-3.10.9-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:99f9678bf0e2b1b695e8028fedac24ab6770937932eda695815d5a6618c37e04"}, + {file = "aiohttp-3.10.9-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:2914caa46054f3b5ff910468d686742ff8cff54b8a67319d75f5d5945fd0a13d"}, + {file = "aiohttp-3.10.9-cp38-cp38-win32.whl", hash = "sha256:0bc059ecbce835630e635879f5f480a742e130d9821fbe3d2f76610a6698ee25"}, + {file = "aiohttp-3.10.9-cp38-cp38-win_amd64.whl", hash = "sha256:e883b61b75ca6efc2541fcd52a5c8ccfe288b24d97e20ac08fdf343b8ac672ea"}, + {file = "aiohttp-3.10.9-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:fcd546782d03181b0b1d20b43d612429a90a68779659ba8045114b867971ab71"}, + {file = "aiohttp-3.10.9-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:85711eec2d875cd88c7eb40e734c4ca6d9ae477d6f26bd2b5bb4f7f60e41b156"}, + {file = "aiohttp-3.10.9-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:02d1d6610588bcd743fae827bd6f2e47e0d09b346f230824b4c6fb85c6065f9c"}, + {file = "aiohttp-3.10.9-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3668d0c2a4d23fb136a753eba42caa2c0abbd3d9c5c87ee150a716a16c6deec1"}, + {file = "aiohttp-3.10.9-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d7c071235a47d407b0e93aa6262b49422dbe48d7d8566e1158fecc91043dd948"}, + {file = "aiohttp-3.10.9-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ac74e794e3aee92ae8f571bfeaa103a141e409863a100ab63a253b1c53b707eb"}, + {file = "aiohttp-3.10.9-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2bbf94d4a0447705b7775417ca8bb8086cc5482023a6e17cdc8f96d0b1b5aba6"}, + {file = "aiohttp-3.10.9-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cb0b2d5d51f96b6cc19e6ab46a7b684be23240426ae951dcdac9639ab111b45e"}, + {file = "aiohttp-3.10.9-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:e83dfefb4f7d285c2d6a07a22268344a97d61579b3e0dce482a5be0251d672ab"}, + {file = "aiohttp-3.10.9-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:f0a44bb40b6aaa4fb9a5c1ee07880570ecda2065433a96ccff409c9c20c1624a"}, + {file = "aiohttp-3.10.9-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:c2b627d3c8982691b06d89d31093cee158c30629fdfebe705a91814d49b554f8"}, + {file = "aiohttp-3.10.9-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:03690541e4cc866eef79626cfa1ef4dd729c5c1408600c8cb9e12e1137eed6ab"}, + {file = "aiohttp-3.10.9-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:ad3675c126f2a95bde637d162f8231cff6bc0bc9fbe31bd78075f9ff7921e322"}, + {file = "aiohttp-3.10.9-cp39-cp39-win32.whl", hash = "sha256:1321658f12b6caffafdc35cfba6c882cb014af86bef4e78c125e7e794dfb927b"}, + {file = "aiohttp-3.10.9-cp39-cp39-win_amd64.whl", hash = "sha256:9fdf5c839bf95fc67be5794c780419edb0dbef776edcfc6c2e5e2ffd5ee755fa"}, + {file = "aiohttp-3.10.9.tar.gz", hash = "sha256:143b0026a9dab07a05ad2dd9e46aa859bffdd6348ddc5967b42161168c24f857"}, +] + +[package.dependencies] +aiohappyeyeballs = ">=2.3.0" +aiosignal = ">=1.1.2" +async-timeout = {version = ">=4.0,<5.0", markers = "python_version < \"3.11\""} +attrs = ">=17.3.0" +frozenlist = ">=1.1.1" +multidict = ">=4.5,<7.0" +yarl = ">=1.12.0,<2.0" + +[package.extras] +speedups = ["Brotli", "aiodns (>=3.2.0)", "brotlicffi"] + +[[package]] +name = "aiosignal" +version = "1.3.1" +description = "aiosignal: a list of registered asynchronous callbacks" +optional = false +python-versions = ">=3.7" +files = [ + {file = "aiosignal-1.3.1-py3-none-any.whl", hash = "sha256:f8376fb07dd1e86a584e4fcdec80b36b7f81aac666ebc724e2c090300dd83b17"}, + {file = "aiosignal-1.3.1.tar.gz", hash = "sha256:54cd96e15e1649b75d6c87526a6ff0b6c1b0dd3459f43d9ca11d48c339b68cfc"}, +] + +[package.dependencies] +frozenlist = ">=1.1.0" + +[[package]] +name = "annotated-types" +version = "0.7.0" +description = "Reusable constraint types to use with typing.Annotated" +optional = false +python-versions = ">=3.8" +files = [ + {file = "annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53"}, + {file = "annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89"}, +] + +[[package]] +name = "anyio" +version = "4.6.0" +description = "High level compatibility layer for multiple asynchronous event loop implementations" +optional = false +python-versions = ">=3.9" +files = [ + {file = "anyio-4.6.0-py3-none-any.whl", hash = "sha256:c7d2e9d63e31599eeb636c8c5c03a7e108d73b345f064f1c19fdc87b79036a9a"}, + {file = "anyio-4.6.0.tar.gz", hash = "sha256:137b4559cbb034c477165047febb6ff83f390fc3b20bf181c1fc0a728cb8beeb"}, +] + +[package.dependencies] +exceptiongroup = {version = ">=1.0.2", markers = "python_version < \"3.11\""} +idna = ">=2.8" +sniffio = ">=1.1" +typing-extensions = {version = ">=4.1", markers = "python_version < \"3.11\""} + +[package.extras] +doc = ["Sphinx (>=7.4,<8.0)", "packaging", "sphinx-autodoc-typehints (>=1.2.0)", "sphinx-rtd-theme"] +test = ["anyio[trio]", "coverage[toml] (>=7)", "exceptiongroup (>=1.2.0)", "hypothesis (>=4.0)", "psutil (>=5.9)", "pytest (>=7.0)", "pytest-mock (>=3.6.1)", "trustme", "uvloop (>=0.21.0b1)"] +trio = ["trio (>=0.26.1)"] + +[[package]] +name = "async-timeout" +version = "4.0.3" +description = "Timeout context manager for asyncio programs" +optional = false +python-versions = ">=3.7" +files = [ + {file = "async-timeout-4.0.3.tar.gz", hash = "sha256:4640d96be84d82d02ed59ea2b7105a0f7b33abe8703703cd0ab0bf87c427522f"}, + {file = "async_timeout-4.0.3-py3-none-any.whl", hash = "sha256:7405140ff1230c310e51dc27b3145b9092d659ce68ff733fb0cefe3ee42be028"}, +] + +[[package]] +name = "attrs" +version = "24.2.0" +description = "Classes Without Boilerplate" +optional = false +python-versions = ">=3.7" +files = [ + {file = "attrs-24.2.0-py3-none-any.whl", hash = "sha256:81921eb96de3191c8258c199618104dd27ac608d9366f5e35d011eae1867ede2"}, + {file = "attrs-24.2.0.tar.gz", hash = "sha256:5cfb1b9148b5b086569baec03f20d7b6bf3bcacc9a42bebf87ffaaca362f6346"}, +] + +[package.extras] +benchmark = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-codspeed", "pytest-mypy-plugins", "pytest-xdist[psutil]"] +cov = ["cloudpickle", "coverage[toml] (>=5.3)", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"] +dev = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pre-commit", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"] +docs = ["cogapp", "furo", "myst-parser", "sphinx", "sphinx-notfound-page", "sphinxcontrib-towncrier", "towncrier (<24.7)"] +tests = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"] +tests-mypy = ["mypy (>=1.11.1)", "pytest-mypy-plugins"] + +[[package]] +name = "backoff" +version = "2.2.1" +description = "Function decoration for backoff and retry" +optional = false +python-versions = ">=3.7,<4.0" +files = [ + {file = "backoff-2.2.1-py3-none-any.whl", hash = "sha256:63579f9a0628e06278f7e47b7d7d5b6ce20dc65c5e96a6f3ca99a6adca0396e8"}, + {file = "backoff-2.2.1.tar.gz", hash = "sha256:03f829f5bb1923180821643f8753b0502c3b682293992485b0eef2807afa5cba"}, +] + +[[package]] +name = "black" +version = "24.8.0" +description = "The uncompromising code formatter." +optional = false +python-versions = ">=3.8" +files = [ + {file = "black-24.8.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:09cdeb74d494ec023ded657f7092ba518e8cf78fa8386155e4a03fdcc44679e6"}, + {file = "black-24.8.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:81c6742da39f33b08e791da38410f32e27d632260e599df7245cccee2064afeb"}, + {file = "black-24.8.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:707a1ca89221bc8a1a64fb5e15ef39cd755633daa672a9db7498d1c19de66a42"}, + {file = "black-24.8.0-cp310-cp310-win_amd64.whl", hash = "sha256:d6417535d99c37cee4091a2f24eb2b6d5ec42b144d50f1f2e436d9fe1916fe1a"}, + {file = "black-24.8.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:fb6e2c0b86bbd43dee042e48059c9ad7830abd5c94b0bc518c0eeec57c3eddc1"}, + {file = "black-24.8.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:837fd281f1908d0076844bc2b801ad2d369c78c45cf800cad7b61686051041af"}, + {file = "black-24.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:62e8730977f0b77998029da7971fa896ceefa2c4c4933fcd593fa599ecbf97a4"}, + {file = "black-24.8.0-cp311-cp311-win_amd64.whl", hash = "sha256:72901b4913cbac8972ad911dc4098d5753704d1f3c56e44ae8dce99eecb0e3af"}, + {file = "black-24.8.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:7c046c1d1eeb7aea9335da62472481d3bbf3fd986e093cffd35f4385c94ae368"}, + {file = "black-24.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:649f6d84ccbae73ab767e206772cc2d7a393a001070a4c814a546afd0d423aed"}, + {file = "black-24.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2b59b250fdba5f9a9cd9d0ece6e6d993d91ce877d121d161e4698af3eb9c1018"}, + {file = "black-24.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:6e55d30d44bed36593c3163b9bc63bf58b3b30e4611e4d88a0c3c239930ed5b2"}, + {file = "black-24.8.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:505289f17ceda596658ae81b61ebbe2d9b25aa78067035184ed0a9d855d18afd"}, + {file = "black-24.8.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b19c9ad992c7883ad84c9b22aaa73562a16b819c1d8db7a1a1a49fb7ec13c7d2"}, + {file = "black-24.8.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1f13f7f386f86f8121d76599114bb8c17b69d962137fc70efe56137727c7047e"}, + {file = "black-24.8.0-cp38-cp38-win_amd64.whl", hash = "sha256:f490dbd59680d809ca31efdae20e634f3fae27fba3ce0ba3208333b713bc3920"}, + {file = "black-24.8.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:eab4dd44ce80dea27dc69db40dab62d4ca96112f87996bca68cd75639aeb2e4c"}, + {file = "black-24.8.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3c4285573d4897a7610054af5a890bde7c65cb466040c5f0c8b732812d7f0e5e"}, + {file = "black-24.8.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9e84e33b37be070ba135176c123ae52a51f82306def9f7d063ee302ecab2cf47"}, + {file = "black-24.8.0-cp39-cp39-win_amd64.whl", hash = "sha256:73bbf84ed136e45d451a260c6b73ed674652f90a2b3211d6a35e78054563a9bb"}, + {file = "black-24.8.0-py3-none-any.whl", hash = "sha256:972085c618ee94f402da1af548a4f218c754ea7e5dc70acb168bfaca4c2542ed"}, + {file = "black-24.8.0.tar.gz", hash = "sha256:2500945420b6784c38b9ee885af039f5e7471ef284ab03fa35ecdde4688cd83f"}, +] + +[package.dependencies] +click = ">=8.0.0" +mypy-extensions = ">=0.4.3" +packaging = ">=22.0" +pathspec = ">=0.9.0" +platformdirs = ">=2" +tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""} +typing-extensions = {version = ">=4.0.1", markers = "python_version < \"3.11\""} + +[package.extras] +colorama = ["colorama (>=0.4.3)"] +d = ["aiohttp (>=3.7.4)", "aiohttp (>=3.7.4,!=3.9.0)"] +jupyter = ["ipython (>=7.8.0)", "tokenize-rt (>=3.2.0)"] +uvloop = ["uvloop (>=0.15.2)"] + +[[package]] +name = "build" +version = "1.2.2" +description = "A simple, correct Python build frontend" +optional = false +python-versions = ">=3.8" +files = [ + {file = "build-1.2.2-py3-none-any.whl", hash = "sha256:277ccc71619d98afdd841a0e96ac9fe1593b823af481d3b0cea748e8894e0613"}, + {file = "build-1.2.2.tar.gz", hash = "sha256:119b2fb462adef986483438377a13b2f42064a2a3a4161f24a0cca698a07ac8c"}, +] + +[package.dependencies] +colorama = {version = "*", markers = "os_name == \"nt\""} +importlib-metadata = {version = ">=4.6", markers = "python_full_version < \"3.10.2\""} +packaging = ">=19.1" +pyproject_hooks = "*" +tomli = {version = ">=1.1.0", markers = "python_version < \"3.11\""} + +[package.extras] +docs = ["furo (>=2023.08.17)", "sphinx (>=7.0,<8.0)", "sphinx-argparse-cli (>=1.5)", "sphinx-autodoc-typehints (>=1.10)", "sphinx-issues (>=3.0.0)"] +test = ["build[uv,virtualenv]", "filelock (>=3)", "pytest (>=6.2.4)", "pytest-cov (>=2.12)", "pytest-mock (>=2)", "pytest-rerunfailures (>=9.1)", "pytest-xdist (>=1.34)", "setuptools (>=42.0.0)", "setuptools (>=56.0.0)", "setuptools (>=56.0.0)", "setuptools (>=67.8.0)", "wheel (>=0.36.0)"] +typing = ["build[uv]", "importlib-metadata (>=5.1)", "mypy (>=1.9.0,<1.10.0)", "tomli", "typing-extensions (>=3.7.4.3)"] +uv = ["uv (>=0.1.18)"] +virtualenv = ["virtualenv (>=20.0.35)"] + +[[package]] +name = "cachecontrol" +version = "0.14.0" +description = "httplib2 caching for requests" +optional = false +python-versions = ">=3.7" +files = [ + {file = "cachecontrol-0.14.0-py3-none-any.whl", hash = "sha256:f5bf3f0620c38db2e5122c0726bdebb0d16869de966ea6a2befe92470b740ea0"}, + {file = "cachecontrol-0.14.0.tar.gz", hash = "sha256:7db1195b41c81f8274a7bbd97c956f44e8348265a1bc7641c37dfebc39f0c938"}, +] + +[package.dependencies] +filelock = {version = ">=3.8.0", optional = true, markers = "extra == \"filecache\""} +msgpack = ">=0.5.2,<2.0.0" +requests = ">=2.16.0" + +[package.extras] +dev = ["CacheControl[filecache,redis]", "black", "build", "cherrypy", "furo", "mypy", "pytest", "pytest-cov", "sphinx", "sphinx-copybutton", "tox", "types-redis", "types-requests"] +filecache = ["filelock (>=3.8.0)"] +redis = ["redis (>=2.10.5)"] + +[[package]] +name = "certifi" +version = "2024.8.30" +description = "Python package for providing Mozilla's CA Bundle." +optional = false +python-versions = ">=3.6" +files = [ + {file = "certifi-2024.8.30-py3-none-any.whl", hash = "sha256:922820b53db7a7257ffbda3f597266d435245903d80737e34f8a45ff3e3230d8"}, + {file = "certifi-2024.8.30.tar.gz", hash = "sha256:bec941d2aa8195e248a60b31ff9f0558284cf01a52591ceda73ea9afffd69fd9"}, +] + +[[package]] +name = "cffi" +version = "1.17.1" +description = "Foreign Function Interface for Python calling C code." +optional = false +python-versions = ">=3.8" +files = [ + {file = "cffi-1.17.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:df8b1c11f177bc2313ec4b2d46baec87a5f3e71fc8b45dab2ee7cae86d9aba14"}, + {file = "cffi-1.17.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8f2cdc858323644ab277e9bb925ad72ae0e67f69e804f4898c070998d50b1a67"}, + {file = "cffi-1.17.1-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:edae79245293e15384b51f88b00613ba9f7198016a5948b5dddf4917d4d26382"}, + {file = "cffi-1.17.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:45398b671ac6d70e67da8e4224a065cec6a93541bb7aebe1b198a61b58c7b702"}, + {file = "cffi-1.17.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ad9413ccdeda48c5afdae7e4fa2192157e991ff761e7ab8fdd8926f40b160cc3"}, + {file = "cffi-1.17.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5da5719280082ac6bd9aa7becb3938dc9f9cbd57fac7d2871717b1feb0902ab6"}, + {file = "cffi-1.17.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2bb1a08b8008b281856e5971307cc386a8e9c5b625ac297e853d36da6efe9c17"}, + {file = "cffi-1.17.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:045d61c734659cc045141be4bae381a41d89b741f795af1dd018bfb532fd0df8"}, + {file = "cffi-1.17.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:6883e737d7d9e4899a8a695e00ec36bd4e5e4f18fabe0aca0efe0a4b44cdb13e"}, + {file = "cffi-1.17.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:6b8b4a92e1c65048ff98cfe1f735ef8f1ceb72e3d5f0c25fdb12087a23da22be"}, + {file = "cffi-1.17.1-cp310-cp310-win32.whl", hash = "sha256:c9c3d058ebabb74db66e431095118094d06abf53284d9c81f27300d0e0d8bc7c"}, + {file = "cffi-1.17.1-cp310-cp310-win_amd64.whl", hash = "sha256:0f048dcf80db46f0098ccac01132761580d28e28bc0f78ae0d58048063317e15"}, + {file = "cffi-1.17.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:a45e3c6913c5b87b3ff120dcdc03f6131fa0065027d0ed7ee6190736a74cd401"}, + {file = "cffi-1.17.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:30c5e0cb5ae493c04c8b42916e52ca38079f1b235c2f8ae5f4527b963c401caf"}, + {file = "cffi-1.17.1-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f75c7ab1f9e4aca5414ed4d8e5c0e303a34f4421f8a0d47a4d019ceff0ab6af4"}, + {file = "cffi-1.17.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a1ed2dd2972641495a3ec98445e09766f077aee98a1c896dcb4ad0d303628e41"}, + {file = "cffi-1.17.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:46bf43160c1a35f7ec506d254e5c890f3c03648a4dbac12d624e4490a7046cd1"}, + {file = "cffi-1.17.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a24ed04c8ffd54b0729c07cee15a81d964e6fee0e3d4d342a27b020d22959dc6"}, + {file = "cffi-1.17.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:610faea79c43e44c71e1ec53a554553fa22321b65fae24889706c0a84d4ad86d"}, + {file = "cffi-1.17.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:a9b15d491f3ad5d692e11f6b71f7857e7835eb677955c00cc0aefcd0669adaf6"}, + {file = "cffi-1.17.1-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:de2ea4b5833625383e464549fec1bc395c1bdeeb5f25c4a3a82b5a8c756ec22f"}, + {file = "cffi-1.17.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:fc48c783f9c87e60831201f2cce7f3b2e4846bf4d8728eabe54d60700b318a0b"}, + {file = "cffi-1.17.1-cp311-cp311-win32.whl", hash = "sha256:85a950a4ac9c359340d5963966e3e0a94a676bd6245a4b55bc43949eee26a655"}, + {file = "cffi-1.17.1-cp311-cp311-win_amd64.whl", hash = "sha256:caaf0640ef5f5517f49bc275eca1406b0ffa6aa184892812030f04c2abf589a0"}, + {file = "cffi-1.17.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:805b4371bf7197c329fcb3ead37e710d1bca9da5d583f5073b799d5c5bd1eee4"}, + {file = "cffi-1.17.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:733e99bc2df47476e3848417c5a4540522f234dfd4ef3ab7fafdf555b082ec0c"}, + {file = "cffi-1.17.1-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1257bdabf294dceb59f5e70c64a3e2f462c30c7ad68092d01bbbfb1c16b1ba36"}, + {file = "cffi-1.17.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:da95af8214998d77a98cc14e3a3bd00aa191526343078b530ceb0bd710fb48a5"}, + {file = "cffi-1.17.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d63afe322132c194cf832bfec0dc69a99fb9bb6bbd550f161a49e9e855cc78ff"}, + {file = "cffi-1.17.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f79fc4fc25f1c8698ff97788206bb3c2598949bfe0fef03d299eb1b5356ada99"}, + {file = "cffi-1.17.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b62ce867176a75d03a665bad002af8e6d54644fad99a3c70905c543130e39d93"}, + {file = "cffi-1.17.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:386c8bf53c502fff58903061338ce4f4950cbdcb23e2902d86c0f722b786bbe3"}, + {file = "cffi-1.17.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:4ceb10419a9adf4460ea14cfd6bc43d08701f0835e979bf821052f1805850fe8"}, + {file = "cffi-1.17.1-cp312-cp312-win32.whl", hash = "sha256:a08d7e755f8ed21095a310a693525137cfe756ce62d066e53f502a83dc550f65"}, + {file = "cffi-1.17.1-cp312-cp312-win_amd64.whl", hash = "sha256:51392eae71afec0d0c8fb1a53b204dbb3bcabcb3c9b807eedf3e1e6ccf2de903"}, + {file = "cffi-1.17.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f3a2b4222ce6b60e2e8b337bb9596923045681d71e5a082783484d845390938e"}, + {file = "cffi-1.17.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0984a4925a435b1da406122d4d7968dd861c1385afe3b45ba82b750f229811e2"}, + {file = "cffi-1.17.1-cp313-cp313-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d01b12eeeb4427d3110de311e1774046ad344f5b1a7403101878976ecd7a10f3"}, + {file = "cffi-1.17.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:706510fe141c86a69c8ddc029c7910003a17353970cff3b904ff0686a5927683"}, + {file = "cffi-1.17.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:de55b766c7aa2e2a3092c51e0483d700341182f08e67c63630d5b6f200bb28e5"}, + {file = "cffi-1.17.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c59d6e989d07460165cc5ad3c61f9fd8f1b4796eacbd81cee78957842b834af4"}, + {file = "cffi-1.17.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dd398dbc6773384a17fe0d3e7eeb8d1a21c2200473ee6806bb5e6a8e62bb73dd"}, + {file = "cffi-1.17.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:3edc8d958eb099c634dace3c7e16560ae474aa3803a5df240542b305d14e14ed"}, + {file = "cffi-1.17.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:72e72408cad3d5419375fc87d289076ee319835bdfa2caad331e377589aebba9"}, + {file = "cffi-1.17.1-cp313-cp313-win32.whl", hash = "sha256:e03eab0a8677fa80d646b5ddece1cbeaf556c313dcfac435ba11f107ba117b5d"}, + {file = "cffi-1.17.1-cp313-cp313-win_amd64.whl", hash = "sha256:f6a16c31041f09ead72d69f583767292f750d24913dadacf5756b966aacb3f1a"}, + {file = "cffi-1.17.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:636062ea65bd0195bc012fea9321aca499c0504409f413dc88af450b57ffd03b"}, + {file = "cffi-1.17.1-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c7eac2ef9b63c79431bc4b25f1cd649d7f061a28808cbc6c47b534bd789ef964"}, + {file = "cffi-1.17.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e221cf152cff04059d011ee126477f0d9588303eb57e88923578ace7baad17f9"}, + {file = "cffi-1.17.1-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:31000ec67d4221a71bd3f67df918b1f88f676f1c3b535a7eb473255fdc0b83fc"}, + {file = "cffi-1.17.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:6f17be4345073b0a7b8ea599688f692ac3ef23ce28e5df79c04de519dbc4912c"}, + {file = "cffi-1.17.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0e2b1fac190ae3ebfe37b979cc1ce69c81f4e4fe5746bb401dca63a9062cdaf1"}, + {file = "cffi-1.17.1-cp38-cp38-win32.whl", hash = "sha256:7596d6620d3fa590f677e9ee430df2958d2d6d6de2feeae5b20e82c00b76fbf8"}, + {file = "cffi-1.17.1-cp38-cp38-win_amd64.whl", hash = "sha256:78122be759c3f8a014ce010908ae03364d00a1f81ab5c7f4a7a5120607ea56e1"}, + {file = "cffi-1.17.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b2ab587605f4ba0bf81dc0cb08a41bd1c0a5906bd59243d56bad7668a6fc6c16"}, + {file = "cffi-1.17.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:28b16024becceed8c6dfbc75629e27788d8a3f9030691a1dbf9821a128b22c36"}, + {file = "cffi-1.17.1-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1d599671f396c4723d016dbddb72fe8e0397082b0a77a4fab8028923bec050e8"}, + {file = "cffi-1.17.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca74b8dbe6e8e8263c0ffd60277de77dcee6c837a3d0881d8c1ead7268c9e576"}, + {file = "cffi-1.17.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f7f5baafcc48261359e14bcd6d9bff6d4b28d9103847c9e136694cb0501aef87"}, + {file = "cffi-1.17.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:98e3969bcff97cae1b2def8ba499ea3d6f31ddfdb7635374834cf89a1a08ecf0"}, + {file = "cffi-1.17.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cdf5ce3acdfd1661132f2a9c19cac174758dc2352bfe37d98aa7512c6b7178b3"}, + {file = "cffi-1.17.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9755e4345d1ec879e3849e62222a18c7174d65a6a92d5b346b1863912168b595"}, + {file = "cffi-1.17.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:f1e22e8c4419538cb197e4dd60acc919d7696e5ef98ee4da4e01d3f8cfa4cc5a"}, + {file = "cffi-1.17.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:c03e868a0b3bc35839ba98e74211ed2b05d2119be4e8a0f224fba9384f1fe02e"}, + {file = "cffi-1.17.1-cp39-cp39-win32.whl", hash = "sha256:e31ae45bc2e29f6b2abd0de1cc3b9d5205aa847cafaecb8af1476a609a2f6eb7"}, + {file = "cffi-1.17.1-cp39-cp39-win_amd64.whl", hash = "sha256:d016c76bdd850f3c626af19b0542c9677ba156e4ee4fccfdd7848803533ef662"}, + {file = "cffi-1.17.1.tar.gz", hash = "sha256:1c39c6016c32bc48dd54561950ebd6836e1670f2ae46128f67cf49e789c52824"}, +] + +[package.dependencies] +pycparser = "*" + +[[package]] +name = "charset-normalizer" +version = "3.3.2" +description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet." +optional = false +python-versions = ">=3.7.0" +files = [ + {file = "charset-normalizer-3.3.2.tar.gz", hash = "sha256:f30c3cb33b24454a82faecaf01b19c18562b1e89558fb6c56de4d9118a032fd5"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:25baf083bf6f6b341f4121c2f3c548875ee6f5339300e08be3f2b2ba1721cdd3"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:06435b539f889b1f6f4ac1758871aae42dc3a8c0e24ac9e60c2384973ad73027"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9063e24fdb1e498ab71cb7419e24622516c4a04476b17a2dab57e8baa30d6e03"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6897af51655e3691ff853668779c7bad41579facacf5fd7253b0133308cf000d"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1d3193f4a680c64b4b6a9115943538edb896edc190f0b222e73761716519268e"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cd70574b12bb8a4d2aaa0094515df2463cb429d8536cfb6c7ce983246983e5a6"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8465322196c8b4d7ab6d1e049e4c5cb460d0394da4a27d23cc242fbf0034b6b5"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a9a8e9031d613fd2009c182b69c7b2c1ef8239a0efb1df3f7c8da66d5dd3d537"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:beb58fe5cdb101e3a055192ac291b7a21e3b7ef4f67fa1d74e331a7f2124341c"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:e06ed3eb3218bc64786f7db41917d4e686cc4856944f53d5bdf83a6884432e12"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:2e81c7b9c8979ce92ed306c249d46894776a909505d8f5a4ba55b14206e3222f"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:572c3763a264ba47b3cf708a44ce965d98555f618ca42c926a9c1616d8f34269"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:fd1abc0d89e30cc4e02e4064dc67fcc51bd941eb395c502aac3ec19fab46b519"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-win32.whl", hash = "sha256:3d47fa203a7bd9c5b6cee4736ee84ca03b8ef23193c0d1ca99b5089f72645c73"}, + {file = "charset_normalizer-3.3.2-cp310-cp310-win_amd64.whl", hash = "sha256:10955842570876604d404661fbccbc9c7e684caf432c09c715ec38fbae45ae09"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:802fe99cca7457642125a8a88a084cef28ff0cf9407060f7b93dca5aa25480db"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:573f6eac48f4769d667c4442081b1794f52919e7edada77495aaed9236d13a96"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:549a3a73da901d5bc3ce8d24e0600d1fa85524c10287f6004fbab87672bf3e1e"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f27273b60488abe721a075bcca6d7f3964f9f6f067c8c4c605743023d7d3944f"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1ceae2f17a9c33cb48e3263960dc5fc8005351ee19db217e9b1bb15d28c02574"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:65f6f63034100ead094b8744b3b97965785388f308a64cf8d7c34f2f2e5be0c4"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:753f10e867343b4511128c6ed8c82f7bec3bd026875576dfd88483c5c73b2fd8"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4a78b2b446bd7c934f5dcedc588903fb2f5eec172f3d29e52a9096a43722adfc"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:e537484df0d8f426ce2afb2d0f8e1c3d0b114b83f8850e5f2fbea0e797bd82ae"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:eb6904c354526e758fda7167b33005998fb68c46fbc10e013ca97f21ca5c8887"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:deb6be0ac38ece9ba87dea880e438f25ca3eddfac8b002a2ec3d9183a454e8ae"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:4ab2fe47fae9e0f9dee8c04187ce5d09f48eabe611be8259444906793ab7cbce"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:80402cd6ee291dcb72644d6eac93785fe2c8b9cb30893c1af5b8fdd753b9d40f"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-win32.whl", hash = "sha256:7cd13a2e3ddeed6913a65e66e94b51d80a041145a026c27e6bb76c31a853c6ab"}, + {file = "charset_normalizer-3.3.2-cp311-cp311-win_amd64.whl", hash = "sha256:663946639d296df6a2bb2aa51b60a2454ca1cb29835324c640dafb5ff2131a77"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:0b2b64d2bb6d3fb9112bafa732def486049e63de9618b5843bcdd081d8144cd8"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:ddbb2551d7e0102e7252db79ba445cdab71b26640817ab1e3e3648dad515003b"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:55086ee1064215781fff39a1af09518bc9255b50d6333f2e4c74ca09fac6a8f6"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8f4a014bc36d3c57402e2977dada34f9c12300af536839dc38c0beab8878f38a"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a10af20b82360ab00827f916a6058451b723b4e65030c5a18577c8b2de5b3389"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8d756e44e94489e49571086ef83b2bb8ce311e730092d2c34ca8f7d925cb20aa"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90d558489962fd4918143277a773316e56c72da56ec7aa3dc3dbbe20fdfed15b"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6ac7ffc7ad6d040517be39eb591cac5ff87416c2537df6ba3cba3bae290c0fed"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:7ed9e526742851e8d5cc9e6cf41427dfc6068d4f5a3bb03659444b4cabf6bc26"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:8bdb58ff7ba23002a4c5808d608e4e6c687175724f54a5dade5fa8c67b604e4d"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:6b3251890fff30ee142c44144871185dbe13b11bab478a88887a639655be1068"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:b4a23f61ce87adf89be746c8a8974fe1c823c891d8f86eb218bb957c924bb143"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:efcb3f6676480691518c177e3b465bcddf57cea040302f9f4e6e191af91174d4"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-win32.whl", hash = "sha256:d965bba47ddeec8cd560687584e88cf699fd28f192ceb452d1d7ee807c5597b7"}, + {file = "charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl", hash = "sha256:96b02a3dc4381e5494fad39be677abcb5e6634bf7b4fa83a6dd3112607547001"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:95f2a5796329323b8f0512e09dbb7a1860c46a39da62ecb2324f116fa8fdc85c"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c002b4ffc0be611f0d9da932eb0f704fe2602a9a949d1f738e4c34c75b0863d5"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a981a536974bbc7a512cf44ed14938cf01030a99e9b3a06dd59578882f06f985"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3287761bc4ee9e33561a7e058c72ac0938c4f57fe49a09eae428fd88aafe7bb6"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:42cb296636fcc8b0644486d15c12376cb9fa75443e00fb25de0b8602e64c1714"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0a55554a2fa0d408816b3b5cedf0045f4b8e1a6065aec45849de2d6f3f8e9786"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:c083af607d2515612056a31f0a8d9e0fcb5876b7bfc0abad3ecd275bc4ebc2d5"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:87d1351268731db79e0f8e745d92493ee2841c974128ef629dc518b937d9194c"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_ppc64le.whl", hash = "sha256:bd8f7df7d12c2db9fab40bdd87a7c09b1530128315d047a086fa3ae3435cb3a8"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_s390x.whl", hash = "sha256:c180f51afb394e165eafe4ac2936a14bee3eb10debc9d9e4db8958fe36afe711"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:8c622a5fe39a48f78944a87d4fb8a53ee07344641b0562c540d840748571b811"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-win32.whl", hash = "sha256:db364eca23f876da6f9e16c9da0df51aa4f104a972735574842618b8c6d999d4"}, + {file = "charset_normalizer-3.3.2-cp37-cp37m-win_amd64.whl", hash = "sha256:86216b5cee4b06df986d214f664305142d9c76df9b6512be2738aa72a2048f99"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:6463effa3186ea09411d50efc7d85360b38d5f09b870c48e4600f63af490e56a"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:6c4caeef8fa63d06bd437cd4bdcf3ffefe6738fb1b25951440d80dc7df8c03ac"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:37e55c8e51c236f95b033f6fb391d7d7970ba5fe7ff453dad675e88cf303377a"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fb69256e180cb6c8a894fee62b3afebae785babc1ee98b81cdf68bbca1987f33"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ae5f4161f18c61806f411a13b0310bea87f987c7d2ecdbdaad0e94eb2e404238"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b2b0a0c0517616b6869869f8c581d4eb2dd83a4d79e0ebcb7d373ef9956aeb0a"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:45485e01ff4d3630ec0d9617310448a8702f70e9c01906b0d0118bdf9d124cf2"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:eb00ed941194665c332bf8e078baf037d6c35d7c4f3102ea2d4f16ca94a26dc8"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:2127566c664442652f024c837091890cb1942c30937add288223dc895793f898"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:a50aebfa173e157099939b17f18600f72f84eed3049e743b68ad15bd69b6bf99"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:4d0d1650369165a14e14e1e47b372cfcb31d6ab44e6e33cb2d4e57265290044d"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:923c0c831b7cfcb071580d3f46c4baf50f174be571576556269530f4bbd79d04"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:06a81e93cd441c56a9b65d8e1d043daeb97a3d0856d177d5c90ba85acb3db087"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-win32.whl", hash = "sha256:6ef1d82a3af9d3eecdba2321dc1b3c238245d890843e040e41e470ffa64c3e25"}, + {file = "charset_normalizer-3.3.2-cp38-cp38-win_amd64.whl", hash = "sha256:eb8821e09e916165e160797a6c17edda0679379a4be5c716c260e836e122f54b"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c235ebd9baae02f1b77bcea61bce332cb4331dc3617d254df3323aa01ab47bd4"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:5b4c145409bef602a690e7cfad0a15a55c13320ff7a3ad7ca59c13bb8ba4d45d"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:68d1f8a9e9e37c1223b656399be5d6b448dea850bed7d0f87a8311f1ff3dabb0"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:22afcb9f253dac0696b5a4be4a1c0f8762f8239e21b99680099abd9b2b1b2269"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e27ad930a842b4c5eb8ac0016b0a54f5aebbe679340c26101df33424142c143c"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1f79682fbe303db92bc2b1136016a38a42e835d932bab5b3b1bfcfbf0640e519"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b261ccdec7821281dade748d088bb6e9b69e6d15b30652b74cbbac25e280b796"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:122c7fa62b130ed55f8f285bfd56d5f4b4a5b503609d181f9ad85e55c89f4185"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:d0eccceffcb53201b5bfebb52600a5fb483a20b61da9dbc885f8b103cbe7598c"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f96df6923e21816da7e0ad3fd47dd8f94b2a5ce594e00677c0013018b813458"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:7f04c839ed0b6b98b1a7501a002144b76c18fb1c1850c8b98d458ac269e26ed2"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:34d1c8da1e78d2e001f363791c98a272bb734000fcef47a491c1e3b0505657a8"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:ff8fa367d09b717b2a17a052544193ad76cd49979c805768879cb63d9ca50561"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-win32.whl", hash = "sha256:aed38f6e4fb3f5d6bf81bfa990a07806be9d83cf7bacef998ab1a9bd660a581f"}, + {file = "charset_normalizer-3.3.2-cp39-cp39-win_amd64.whl", hash = "sha256:b01b88d45a6fcb69667cd6d2f7a9aeb4bf53760d7fc536bf679ec94fe9f3ff3d"}, + {file = "charset_normalizer-3.3.2-py3-none-any.whl", hash = "sha256:3e4d1f6587322d2788836a99c69062fbb091331ec940e02d12d179c1d53e25fc"}, +] + +[[package]] +name = "cleo" +version = "2.1.0" +description = "Cleo allows you to create beautiful and testable command-line interfaces." +optional = false +python-versions = ">=3.7,<4.0" +files = [ + {file = "cleo-2.1.0-py3-none-any.whl", hash = "sha256:4a31bd4dd45695a64ee3c4758f583f134267c2bc518d8ae9a29cf237d009b07e"}, + {file = "cleo-2.1.0.tar.gz", hash = "sha256:0b2c880b5d13660a7ea651001fb4acb527696c01f15c9ee650f377aa543fd523"}, +] + +[package.dependencies] +crashtest = ">=0.4.1,<0.5.0" +rapidfuzz = ">=3.0.0,<4.0.0" + +[[package]] +name = "click" +version = "8.1.7" +description = "Composable command line interface toolkit" +optional = false +python-versions = ">=3.7" +files = [ + {file = "click-8.1.7-py3-none-any.whl", hash = "sha256:ae74fb96c20a0277a1d615f1e4d73c8414f5a98db8b799a7931d1582f3390c28"}, + {file = "click-8.1.7.tar.gz", hash = "sha256:ca9853ad459e787e2192211578cc907e7594e294c7ccc834310722b41b9ca6de"}, +] + +[package.dependencies] +colorama = {version = "*", markers = "platform_system == \"Windows\""} + +[[package]] +name = "colorama" +version = "0.4.6" +description = "Cross-platform colored terminal text." +optional = false +python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7" +files = [ + {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, + {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, +] + +[[package]] +name = "crashtest" +version = "0.4.1" +description = "Manage Python errors with ease" +optional = false +python-versions = ">=3.7,<4.0" +files = [ + {file = "crashtest-0.4.1-py3-none-any.whl", hash = "sha256:8d23eac5fa660409f57472e3851dab7ac18aba459a8d19cbbba86d3d5aecd2a5"}, + {file = "crashtest-0.4.1.tar.gz", hash = "sha256:80d7b1f316ebfbd429f648076d6275c877ba30ba48979de4191714a75266f0ce"}, +] + +[[package]] +name = "cryptography" +version = "43.0.1" +description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers." +optional = false +python-versions = ">=3.7" +files = [ + {file = "cryptography-43.0.1-cp37-abi3-macosx_10_9_universal2.whl", hash = "sha256:8385d98f6a3bf8bb2d65a73e17ed87a3ba84f6991c155691c51112075f9ffc5d"}, + {file = "cryptography-43.0.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:27e613d7077ac613e399270253259d9d53872aaf657471473ebfc9a52935c062"}, + {file = "cryptography-43.0.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:68aaecc4178e90719e95298515979814bda0cbada1256a4485414860bd7ab962"}, + {file = "cryptography-43.0.1-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:de41fd81a41e53267cb020bb3a7212861da53a7d39f863585d13ea11049cf277"}, + {file = "cryptography-43.0.1-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:f98bf604c82c416bc829e490c700ca1553eafdf2912a91e23a79d97d9801372a"}, + {file = "cryptography-43.0.1-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:61ec41068b7b74268fa86e3e9e12b9f0c21fcf65434571dbb13d954bceb08042"}, + {file = "cryptography-43.0.1-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:014f58110f53237ace6a408b5beb6c427b64e084eb451ef25a28308270086494"}, + {file = "cryptography-43.0.1-cp37-abi3-win32.whl", hash = "sha256:2bd51274dcd59f09dd952afb696bf9c61a7a49dfc764c04dd33ef7a6b502a1e2"}, + {file = "cryptography-43.0.1-cp37-abi3-win_amd64.whl", hash = "sha256:666ae11966643886c2987b3b721899d250855718d6d9ce41b521252a17985f4d"}, + {file = "cryptography-43.0.1-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:ac119bb76b9faa00f48128b7f5679e1d8d437365c5d26f1c2c3f0da4ce1b553d"}, + {file = "cryptography-43.0.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1bbcce1a551e262dfbafb6e6252f1ae36a248e615ca44ba302df077a846a8806"}, + {file = "cryptography-43.0.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58d4e9129985185a06d849aa6df265bdd5a74ca6e1b736a77959b498e0505b85"}, + {file = "cryptography-43.0.1-cp39-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:d03a475165f3134f773d1388aeb19c2d25ba88b6a9733c5c590b9ff7bbfa2e0c"}, + {file = "cryptography-43.0.1-cp39-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:511f4273808ab590912a93ddb4e3914dfd8a388fed883361b02dea3791f292e1"}, + {file = "cryptography-43.0.1-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:80eda8b3e173f0f247f711eef62be51b599b5d425c429b5d4ca6a05e9e856baa"}, + {file = "cryptography-43.0.1-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:38926c50cff6f533f8a2dae3d7f19541432610d114a70808f0926d5aaa7121e4"}, + {file = "cryptography-43.0.1-cp39-abi3-win32.whl", hash = "sha256:a575913fb06e05e6b4b814d7f7468c2c660e8bb16d8d5a1faf9b33ccc569dd47"}, + {file = "cryptography-43.0.1-cp39-abi3-win_amd64.whl", hash = "sha256:d75601ad10b059ec832e78823b348bfa1a59f6b8d545db3a24fd44362a1564cb"}, + {file = "cryptography-43.0.1-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:ea25acb556320250756e53f9e20a4177515f012c9eaea17eb7587a8c4d8ae034"}, + {file = "cryptography-43.0.1-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:c1332724be35d23a854994ff0b66530119500b6053d0bd3363265f7e5e77288d"}, + {file = "cryptography-43.0.1-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:fba1007b3ef89946dbbb515aeeb41e30203b004f0b4b00e5e16078b518563289"}, + {file = "cryptography-43.0.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:5b43d1ea6b378b54a1dc99dd8a2b5be47658fe9a7ce0a58ff0b55f4b43ef2b84"}, + {file = "cryptography-43.0.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:88cce104c36870d70c49c7c8fd22885875d950d9ee6ab54df2745f83ba0dc365"}, + {file = "cryptography-43.0.1-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:9d3cdb25fa98afdd3d0892d132b8d7139e2c087da1712041f6b762e4f807cc96"}, + {file = "cryptography-43.0.1-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:e710bf40870f4db63c3d7d929aa9e09e4e7ee219e703f949ec4073b4294f6172"}, + {file = "cryptography-43.0.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:7c05650fe8023c5ed0d46793d4b7d7e6cd9c04e68eabe5b0aeea836e37bdcec2"}, + {file = "cryptography-43.0.1.tar.gz", hash = "sha256:203e92a75716d8cfb491dc47c79e17d0d9207ccffcbcb35f598fbe463ae3444d"}, +] + +[package.dependencies] +cffi = {version = ">=1.12", markers = "platform_python_implementation != \"PyPy\""} + +[package.extras] +docs = ["sphinx (>=5.3.0)", "sphinx-rtd-theme (>=1.1.1)"] +docstest = ["pyenchant (>=1.6.11)", "readme-renderer", "sphinxcontrib-spelling (>=4.0.1)"] +nox = ["nox"] +pep8test = ["check-sdist", "click", "mypy", "ruff"] +sdist = ["build"] +ssh = ["bcrypt (>=3.1.5)"] +test = ["certifi", "cryptography-vectors (==43.0.1)", "pretend", "pytest (>=6.2.0)", "pytest-benchmark", "pytest-cov", "pytest-xdist"] +test-randomorder = ["pytest-randomly"] + +[[package]] +name = "deepdiff" +version = "8.0.1" +description = "Deep Difference and Search of any Python object/data. Recreate objects by adding adding deltas to each other." +optional = false +python-versions = ">=3.8" +files = [ + {file = "deepdiff-8.0.1-py3-none-any.whl", hash = "sha256:42e99004ce603f9a53934c634a57b04ad5900e0d8ed0abb15e635767489cbc05"}, + {file = "deepdiff-8.0.1.tar.gz", hash = "sha256:245599a4586ab59bb599ca3517a9c42f3318ff600ded5e80a3432693c8ec3c4b"}, +] + +[package.dependencies] +orderly-set = "5.2.2" + +[package.extras] +cli = ["click (==8.1.7)", "pyyaml (==6.0.1)"] +optimize = ["orjson"] + +[[package]] +name = "distlib" +version = "0.3.8" +description = "Distribution utilities" +optional = false +python-versions = "*" +files = [ + {file = "distlib-0.3.8-py2.py3-none-any.whl", hash = "sha256:034db59a0b96f8ca18035f36290806a9a6e6bd9d1ff91e45a7f172eb17e51784"}, + {file = "distlib-0.3.8.tar.gz", hash = "sha256:1530ea13e350031b6312d8580ddb6b27a104275a31106523b8f123787f494f64"}, +] + +[[package]] +name = "dnspython" +version = "2.6.1" +description = "DNS toolkit" +optional = false +python-versions = ">=3.8" +files = [ + {file = "dnspython-2.6.1-py3-none-any.whl", hash = "sha256:5ef3b9680161f6fa89daf8ad451b5f1a33b18ae8a1c6778cdf4b43f08c0a6e50"}, + {file = "dnspython-2.6.1.tar.gz", hash = "sha256:e8f0f9c23a7b7cb99ded64e6c3a6f3e701d78f50c55e002b839dea7225cff7cc"}, +] + +[package.extras] +dev = ["black (>=23.1.0)", "coverage (>=7.0)", "flake8 (>=7)", "mypy (>=1.8)", "pylint (>=3)", "pytest (>=7.4)", "pytest-cov (>=4.1.0)", "sphinx (>=7.2.0)", "twine (>=4.0.0)", "wheel (>=0.42.0)"] +dnssec = ["cryptography (>=41)"] +doh = ["h2 (>=4.1.0)", "httpcore (>=1.0.0)", "httpx (>=0.26.0)"] +doq = ["aioquic (>=0.9.25)"] +idna = ["idna (>=3.6)"] +trio = ["trio (>=0.23)"] +wmi = ["wmi (>=1.5.1)"] + +[[package]] +name = "dulwich" +version = "0.21.7" +description = "Python Git Library" +optional = false +python-versions = ">=3.7" +files = [ + {file = "dulwich-0.21.7-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d4c0110798099bb7d36a110090f2688050703065448895c4f53ade808d889dd3"}, + {file = "dulwich-0.21.7-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2bc12697f0918bee324c18836053644035362bb3983dc1b210318f2fed1d7132"}, + {file = "dulwich-0.21.7-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:471305af74790827fcbafe330fc2e8bdcee4fb56ca1177c8c481b1c8f806c4a4"}, + {file = "dulwich-0.21.7-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d54c9d0e845be26f65f954dff13a1cd3f2b9739820c19064257b8fd7435ab263"}, + {file = "dulwich-0.21.7-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:12d61334a575474e707614f2e93d6ed4cdae9eb47214f9277076d9e5615171d3"}, + {file = "dulwich-0.21.7-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e274cebaf345f0b1e3b70197f2651de92b652386b68020cfd3bf61bc30f6eaaa"}, + {file = "dulwich-0.21.7-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:817822f970e196e757ae01281ecbf21369383285b9f4a83496312204cf889b8c"}, + {file = "dulwich-0.21.7-cp310-cp310-win32.whl", hash = "sha256:7836da3f4110ce684dcd53489015fb7fa94ed33c5276e3318b8b1cbcb5b71e08"}, + {file = "dulwich-0.21.7-cp310-cp310-win_amd64.whl", hash = "sha256:4a043b90958cec866b4edc6aef5fe3c2c96a664d0b357e1682a46f6c477273c4"}, + {file = "dulwich-0.21.7-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:ce8db196e79c1f381469410d26fb1d8b89c6b87a4e7f00ff418c22a35121405c"}, + {file = "dulwich-0.21.7-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:62bfb26bdce869cd40be443dfd93143caea7089b165d2dcc33de40f6ac9d812a"}, + {file = "dulwich-0.21.7-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c01a735b9a171dcb634a97a3cec1b174cfbfa8e840156870384b633da0460f18"}, + {file = "dulwich-0.21.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fa4d14767cf7a49c9231c2e52cb2a3e90d0c83f843eb6a2ca2b5d81d254cf6b9"}, + {file = "dulwich-0.21.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7bca4b86e96d6ef18c5bc39828ea349efb5be2f9b1f6ac9863f90589bac1084d"}, + {file = "dulwich-0.21.7-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:a7b5624b02ef808cdc62dabd47eb10cd4ac15e8ac6df9e2e88b6ac6b40133673"}, + {file = "dulwich-0.21.7-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c3a539b4696a42fbdb7412cb7b66a4d4d332761299d3613d90a642923c7560e1"}, + {file = "dulwich-0.21.7-cp311-cp311-win32.whl", hash = "sha256:675a612ce913081beb0f37b286891e795d905691dfccfb9bf73721dca6757cde"}, + {file = "dulwich-0.21.7-cp311-cp311-win_amd64.whl", hash = "sha256:460ba74bdb19f8d498786ae7776745875059b1178066208c0fd509792d7f7bfc"}, + {file = "dulwich-0.21.7-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:4c51058ec4c0b45dc5189225b9e0c671b96ca9713c1daf71d622c13b0ab07681"}, + {file = "dulwich-0.21.7-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:4bc4c5366eaf26dda3fdffe160a3b515666ed27c2419f1d483da285ac1411de0"}, + {file = "dulwich-0.21.7-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:a0650ec77d89cb947e3e4bbd4841c96f74e52b4650830112c3057a8ca891dc2f"}, + {file = "dulwich-0.21.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4f18f0a311fb7734b033a3101292b932158cade54b74d1c44db519e42825e5a2"}, + {file = "dulwich-0.21.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c589468e5c0cd84e97eb7ec209ab005a2cb69399e8c5861c3edfe38989ac3a8"}, + {file = "dulwich-0.21.7-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d62446797163317a397a10080c6397ffaaca51a7804c0120b334f8165736c56a"}, + {file = "dulwich-0.21.7-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:e84cc606b1f581733df4350ca4070e6a8b30be3662bbb81a590b177d0c996c91"}, + {file = "dulwich-0.21.7-cp312-cp312-win32.whl", hash = "sha256:c3d1685f320907a52c40fd5890627945c51f3a5fa4bcfe10edb24fec79caadec"}, + {file = "dulwich-0.21.7-cp312-cp312-win_amd64.whl", hash = "sha256:6bd69921fdd813b7469a3c77bc75c1783cc1d8d72ab15a406598e5a3ba1a1503"}, + {file = "dulwich-0.21.7-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:7d8ab29c660125db52106775caa1f8f7f77a69ed1fe8bc4b42bdf115731a25bf"}, + {file = "dulwich-0.21.7-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b0d2e4485b98695bf95350ce9d38b1bb0aaac2c34ad00a0df789aa33c934469b"}, + {file = "dulwich-0.21.7-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e138d516baa6b5bafbe8f030eccc544d0d486d6819b82387fc0e285e62ef5261"}, + {file = "dulwich-0.21.7-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:f34bf9b9fa9308376263fd9ac43143c7c09da9bc75037bb75c6c2423a151b92c"}, + {file = "dulwich-0.21.7-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:2e2c66888207b71cd1daa2acb06d3984a6bc13787b837397a64117aa9fc5936a"}, + {file = "dulwich-0.21.7-cp37-cp37m-win32.whl", hash = "sha256:10893105c6566fc95bc2a67b61df7cc1e8f9126d02a1df6a8b2b82eb59db8ab9"}, + {file = "dulwich-0.21.7-cp37-cp37m-win_amd64.whl", hash = "sha256:460b3849d5c3d3818a80743b4f7a0094c893c559f678e56a02fff570b49a644a"}, + {file = "dulwich-0.21.7-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:74700e4c7d532877355743336c36f51b414d01e92ba7d304c4f8d9a5946dbc81"}, + {file = "dulwich-0.21.7-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:c92e72c43c9e9e936b01a57167e0ea77d3fd2d82416edf9489faa87278a1cdf7"}, + {file = "dulwich-0.21.7-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:d097e963eb6b9fa53266146471531ad9c6765bf390849230311514546ed64db2"}, + {file = "dulwich-0.21.7-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:808e8b9cc0aa9ac74870b49db4f9f39a52fb61694573f84b9c0613c928d4caf8"}, + {file = "dulwich-0.21.7-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e1957b65f96e36c301e419d7adaadcff47647c30eb072468901bb683b1000bc5"}, + {file = "dulwich-0.21.7-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:4b09bc3a64fb70132ec14326ecbe6e0555381108caff3496898962c4136a48c6"}, + {file = "dulwich-0.21.7-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:d5882e70b74ac3c736a42d3fdd4f5f2e6570637f59ad5d3e684760290b58f041"}, + {file = "dulwich-0.21.7-cp38-cp38-win32.whl", hash = "sha256:29bb5c1d70eba155ded41ed8a62be2f72edbb3c77b08f65b89c03976292f6d1b"}, + {file = "dulwich-0.21.7-cp38-cp38-win_amd64.whl", hash = "sha256:25c3ab8fb2e201ad2031ddd32e4c68b7c03cb34b24a5ff477b7a7dcef86372f5"}, + {file = "dulwich-0.21.7-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:8929c37986c83deb4eb500c766ee28b6670285b512402647ee02a857320e377c"}, + {file = "dulwich-0.21.7-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:cc1e11be527ac06316539b57a7688bcb1b6a3e53933bc2f844397bc50734e9ae"}, + {file = "dulwich-0.21.7-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:0fc3078a1ba04c588fabb0969d3530efd5cd1ce2cf248eefb6baf7cbc15fc285"}, + {file = "dulwich-0.21.7-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:40dcbd29ba30ba2c5bfbab07a61a5f20095541d5ac66d813056c122244df4ac0"}, + {file = "dulwich-0.21.7-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8869fc8ec3dda743e03d06d698ad489b3705775fe62825e00fa95aa158097fc0"}, + {file = "dulwich-0.21.7-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:d96ca5e0dde49376fbcb44f10eddb6c30284a87bd03bb577c59bb0a1f63903fa"}, + {file = "dulwich-0.21.7-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:e0064363bd5e814359657ae32517fa8001e8573d9d040bd997908d488ab886ed"}, + {file = "dulwich-0.21.7-cp39-cp39-win32.whl", hash = "sha256:869eb7be48243e695673b07905d18b73d1054a85e1f6e298fe63ba2843bb2ca1"}, + {file = "dulwich-0.21.7-cp39-cp39-win_amd64.whl", hash = "sha256:404b8edeb3c3a86c47c0a498699fc064c93fa1f8bab2ffe919e8ab03eafaaad3"}, + {file = "dulwich-0.21.7-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:e598d743c6c0548ebcd2baf94aa9c8bfacb787ea671eeeb5828cfbd7d56b552f"}, + {file = "dulwich-0.21.7-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d4a2d76c96426e791556836ef43542b639def81be4f1d6d4322cd886c115eae1"}, + {file = "dulwich-0.21.7-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f6c88acb60a1f4d31bd6d13bfba465853b3df940ee4a0f2a3d6c7a0778c705b7"}, + {file = "dulwich-0.21.7-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:ecd315847dea406a4decfa39d388a2521e4e31acde3bd9c2609c989e817c6d62"}, + {file = "dulwich-0.21.7-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:d05d3c781bc74e2c2a2a8f4e4e2ed693540fbe88e6ac36df81deac574a6dad99"}, + {file = "dulwich-0.21.7-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6de6f8de4a453fdbae8062a6faa652255d22a3d8bce0cd6d2d6701305c75f2b3"}, + {file = "dulwich-0.21.7-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e25953c7acbbe4e19650d0225af1c0c0e6882f8bddd2056f75c1cc2b109b88ad"}, + {file = "dulwich-0.21.7-pp37-pypy37_pp73-win_amd64.whl", hash = "sha256:4637cbd8ed1012f67e1068aaed19fcc8b649bcf3e9e26649826a303298c89b9d"}, + {file = "dulwich-0.21.7-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:858842b30ad6486aacaa607d60bab9c9a29e7c59dc2d9cb77ae5a94053878c08"}, + {file = "dulwich-0.21.7-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:739b191f61e1c4ce18ac7d520e7a7cbda00e182c3489552408237200ce8411ad"}, + {file = "dulwich-0.21.7-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:274c18ec3599a92a9b67abaf110e4f181a4f779ee1aaab9e23a72e89d71b2bd9"}, + {file = "dulwich-0.21.7-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:2590e9b431efa94fc356ae33b38f5e64f1834ec3a94a6ac3a64283b206d07aa3"}, + {file = "dulwich-0.21.7-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:ed60d1f610ef6437586f7768254c2a93820ccbd4cfdac7d182cf2d6e615969bb"}, + {file = "dulwich-0.21.7-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8278835e168dd097089f9e53088c7a69c6ca0841aef580d9603eafe9aea8c358"}, + {file = "dulwich-0.21.7-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ffc27fb063f740712e02b4d2f826aee8bbed737ed799962fef625e2ce56e2d29"}, + {file = "dulwich-0.21.7-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:61e3451bd3d3844f2dca53f131982553be4d1b1e1ebd9db701843dd76c4dba31"}, + {file = "dulwich-0.21.7.tar.gz", hash = "sha256:a9e9c66833cea580c3ac12927e4b9711985d76afca98da971405d414de60e968"}, +] + +[package.dependencies] +urllib3 = ">=1.25" + +[package.extras] +fastimport = ["fastimport"] +https = ["urllib3 (>=1.24.1)"] +paramiko = ["paramiko"] +pgp = ["gpg"] + +[[package]] +name = "email-validator" +version = "2.2.0" +description = "A robust email address syntax and deliverability validation library." +optional = false +python-versions = ">=3.8" +files = [ + {file = "email_validator-2.2.0-py3-none-any.whl", hash = "sha256:561977c2d73ce3611850a06fa56b414621e0c8faa9d66f2611407d87465da631"}, + {file = "email_validator-2.2.0.tar.gz", hash = "sha256:cb690f344c617a714f22e66ae771445a1ceb46821152df8e165c5f9a364582b7"}, +] + +[package.dependencies] +dnspython = ">=2.0.0" +idna = ">=2.0.0" + +[[package]] +name = "exceptiongroup" +version = "1.2.2" +description = "Backport of PEP 654 (exception groups)" +optional = false +python-versions = ">=3.7" +files = [ + {file = "exceptiongroup-1.2.2-py3-none-any.whl", hash = "sha256:3111b9d131c238bec2f8f516e123e14ba243563fb135d3fe885990585aa7795b"}, + {file = "exceptiongroup-1.2.2.tar.gz", hash = "sha256:47c2edf7c6738fafb49fd34290706d1a1a2f4d1c6df275526b62cbb4aa5393cc"}, +] + +[package.extras] +test = ["pytest (>=6)"] + +[[package]] +name = "fastapi" +version = "0.111.1" +description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production" +optional = false +python-versions = ">=3.8" +files = [ + {file = "fastapi-0.111.1-py3-none-any.whl", hash = "sha256:4f51cfa25d72f9fbc3280832e84b32494cf186f50158d364a8765aabf22587bf"}, + {file = "fastapi-0.111.1.tar.gz", hash = "sha256:ddd1ac34cb1f76c2e2d7f8545a4bcb5463bce4834e81abf0b189e0c359ab2413"}, +] + +[package.dependencies] +email_validator = ">=2.0.0" +fastapi-cli = ">=0.0.2" +httpx = ">=0.23.0" +jinja2 = ">=2.11.2" +pydantic = ">=1.7.4,<1.8 || >1.8,<1.8.1 || >1.8.1,<2.0.0 || >2.0.0,<2.0.1 || >2.0.1,<2.1.0 || >2.1.0,<3.0.0" +python-multipart = ">=0.0.7" +starlette = ">=0.37.2,<0.38.0" +typing-extensions = ">=4.8.0" +uvicorn = {version = ">=0.12.0", extras = ["standard"]} + +[package.extras] +all = ["email_validator (>=2.0.0)", "httpx (>=0.23.0)", "itsdangerous (>=1.1.0)", "jinja2 (>=2.11.2)", "orjson (>=3.2.1)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.7)", "pyyaml (>=5.3.1)", "ujson (>=4.0.1,!=4.0.2,!=4.1.0,!=4.2.0,!=4.3.0,!=5.0.0,!=5.1.0)", "uvicorn[standard] (>=0.12.0)"] + +[[package]] +name = "fastapi-cli" +version = "0.0.5" +description = "Run and manage FastAPI apps from the command line with FastAPI CLI. 🚀" +optional = false +python-versions = ">=3.8" +files = [ + {file = "fastapi_cli-0.0.5-py3-none-any.whl", hash = "sha256:e94d847524648c748a5350673546bbf9bcaeb086b33c24f2e82e021436866a46"}, + {file = "fastapi_cli-0.0.5.tar.gz", hash = "sha256:d30e1239c6f46fcb95e606f02cdda59a1e2fa778a54b64686b3ff27f6211ff9f"}, +] + +[package.dependencies] +typer = ">=0.12.3" +uvicorn = {version = ">=0.15.0", extras = ["standard"]} + +[package.extras] +standard = ["uvicorn[standard] (>=0.15.0)"] + +[[package]] +name = "fastjsonschema" +version = "2.20.0" +description = "Fastest Python implementation of JSON schema" +optional = false +python-versions = "*" +files = [ + {file = "fastjsonschema-2.20.0-py3-none-any.whl", hash = "sha256:5875f0b0fa7a0043a91e93a9b8f793bcbbba9691e7fd83dca95c28ba26d21f0a"}, + {file = "fastjsonschema-2.20.0.tar.gz", hash = "sha256:3d48fc5300ee96f5d116f10fe6f28d938e6008f59a6a025c2649475b87f76a23"}, +] + +[package.extras] +devel = ["colorama", "json-spec", "jsonschema", "pylint", "pytest", "pytest-benchmark", "pytest-cache", "validictory"] + +[[package]] +name = "filelock" +version = "3.16.1" +description = "A platform independent file lock." +optional = false +python-versions = ">=3.8" +files = [ + {file = "filelock-3.16.1-py3-none-any.whl", hash = "sha256:2082e5703d51fbf98ea75855d9d5527e33d8ff23099bec374a134febee6946b0"}, + {file = "filelock-3.16.1.tar.gz", hash = "sha256:c249fbfcd5db47e5e2d6d62198e565475ee65e4831e2561c8e313fa7eb961435"}, +] + +[package.extras] +docs = ["furo (>=2024.8.6)", "sphinx (>=8.0.2)", "sphinx-autodoc-typehints (>=2.4.1)"] +testing = ["covdefaults (>=2.3)", "coverage (>=7.6.1)", "diff-cover (>=9.2)", "pytest (>=8.3.3)", "pytest-asyncio (>=0.24)", "pytest-cov (>=5)", "pytest-mock (>=3.14)", "pytest-timeout (>=2.3.1)", "virtualenv (>=20.26.4)"] +typing = ["typing-extensions (>=4.12.2)"] + +[[package]] +name = "frozenlist" +version = "1.4.1" +description = "A list-like structure which implements collections.abc.MutableSequence" +optional = false +python-versions = ">=3.8" +files = [ + {file = "frozenlist-1.4.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:f9aa1878d1083b276b0196f2dfbe00c9b7e752475ed3b682025ff20c1c1f51ac"}, + {file = "frozenlist-1.4.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:29acab3f66f0f24674b7dc4736477bcd4bc3ad4b896f5f45379a67bce8b96868"}, + {file = "frozenlist-1.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:74fb4bee6880b529a0c6560885fce4dc95936920f9f20f53d99a213f7bf66776"}, + {file = "frozenlist-1.4.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:590344787a90ae57d62511dd7c736ed56b428f04cd8c161fcc5e7232c130c69a"}, + {file = "frozenlist-1.4.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:068b63f23b17df8569b7fdca5517edef76171cf3897eb68beb01341131fbd2ad"}, + {file = "frozenlist-1.4.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5c849d495bf5154cd8da18a9eb15db127d4dba2968d88831aff6f0331ea9bd4c"}, + {file = "frozenlist-1.4.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9750cc7fe1ae3b1611bb8cfc3f9ec11d532244235d75901fb6b8e42ce9229dfe"}, + {file = "frozenlist-1.4.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a9b2de4cf0cdd5bd2dee4c4f63a653c61d2408055ab77b151c1957f221cabf2a"}, + {file = "frozenlist-1.4.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:0633c8d5337cb5c77acbccc6357ac49a1770b8c487e5b3505c57b949b4b82e98"}, + {file = "frozenlist-1.4.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:27657df69e8801be6c3638054e202a135c7f299267f1a55ed3a598934f6c0d75"}, + {file = "frozenlist-1.4.1-cp310-cp310-musllinux_1_1_ppc64le.whl", hash = "sha256:f9a3ea26252bd92f570600098783d1371354d89d5f6b7dfd87359d669f2109b5"}, + {file = "frozenlist-1.4.1-cp310-cp310-musllinux_1_1_s390x.whl", hash = "sha256:4f57dab5fe3407b6c0c1cc907ac98e8a189f9e418f3b6e54d65a718aaafe3950"}, + {file = "frozenlist-1.4.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:e02a0e11cf6597299b9f3bbd3f93d79217cb90cfd1411aec33848b13f5c656cc"}, + {file = "frozenlist-1.4.1-cp310-cp310-win32.whl", hash = "sha256:a828c57f00f729620a442881cc60e57cfcec6842ba38e1b19fd3e47ac0ff8dc1"}, + {file = "frozenlist-1.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:f56e2333dda1fe0f909e7cc59f021eba0d2307bc6f012a1ccf2beca6ba362439"}, + {file = "frozenlist-1.4.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:a0cb6f11204443f27a1628b0e460f37fb30f624be6051d490fa7d7e26d4af3d0"}, + {file = "frozenlist-1.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:b46c8ae3a8f1f41a0d2ef350c0b6e65822d80772fe46b653ab6b6274f61d4a49"}, + {file = "frozenlist-1.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:fde5bd59ab5357e3853313127f4d3565fc7dad314a74d7b5d43c22c6a5ed2ced"}, + {file = "frozenlist-1.4.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:722e1124aec435320ae01ee3ac7bec11a5d47f25d0ed6328f2273d287bc3abb0"}, + {file = "frozenlist-1.4.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2471c201b70d58a0f0c1f91261542a03d9a5e088ed3dc6c160d614c01649c106"}, + {file = "frozenlist-1.4.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c757a9dd70d72b076d6f68efdbb9bc943665ae954dad2801b874c8c69e185068"}, + {file = "frozenlist-1.4.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f146e0911cb2f1da549fc58fc7bcd2b836a44b79ef871980d605ec392ff6b0d2"}, + {file = "frozenlist-1.4.1-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4f9c515e7914626b2a2e1e311794b4c35720a0be87af52b79ff8e1429fc25f19"}, + {file = "frozenlist-1.4.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:c302220494f5c1ebeb0912ea782bcd5e2f8308037b3c7553fad0e48ebad6ad82"}, + {file = "frozenlist-1.4.1-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:442acde1e068288a4ba7acfe05f5f343e19fac87bfc96d89eb886b0363e977ec"}, + {file = "frozenlist-1.4.1-cp311-cp311-musllinux_1_1_ppc64le.whl", hash = "sha256:1b280e6507ea8a4fa0c0a7150b4e526a8d113989e28eaaef946cc77ffd7efc0a"}, + {file = "frozenlist-1.4.1-cp311-cp311-musllinux_1_1_s390x.whl", hash = "sha256:fe1a06da377e3a1062ae5fe0926e12b84eceb8a50b350ddca72dc85015873f74"}, + {file = "frozenlist-1.4.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:db9e724bebd621d9beca794f2a4ff1d26eed5965b004a97f1f1685a173b869c2"}, + {file = "frozenlist-1.4.1-cp311-cp311-win32.whl", hash = "sha256:e774d53b1a477a67838a904131c4b0eef6b3d8a651f8b138b04f748fccfefe17"}, + {file = "frozenlist-1.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:fb3c2db03683b5767dedb5769b8a40ebb47d6f7f45b1b3e3b4b51ec8ad9d9825"}, + {file = "frozenlist-1.4.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:1979bc0aeb89b33b588c51c54ab0161791149f2461ea7c7c946d95d5f93b56ae"}, + {file = "frozenlist-1.4.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:cc7b01b3754ea68a62bd77ce6020afaffb44a590c2289089289363472d13aedb"}, + {file = "frozenlist-1.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:c9c92be9fd329ac801cc420e08452b70e7aeab94ea4233a4804f0915c14eba9b"}, + {file = "frozenlist-1.4.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5c3894db91f5a489fc8fa6a9991820f368f0b3cbdb9cd8849547ccfab3392d86"}, + {file = "frozenlist-1.4.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ba60bb19387e13597fb059f32cd4d59445d7b18b69a745b8f8e5db0346f33480"}, + {file = "frozenlist-1.4.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8aefbba5f69d42246543407ed2461db31006b0f76c4e32dfd6f42215a2c41d09"}, + {file = "frozenlist-1.4.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:780d3a35680ced9ce682fbcf4cb9c2bad3136eeff760ab33707b71db84664e3a"}, + {file = "frozenlist-1.4.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9acbb16f06fe7f52f441bb6f413ebae6c37baa6ef9edd49cdd567216da8600cd"}, + {file = "frozenlist-1.4.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:23b701e65c7b36e4bf15546a89279bd4d8675faabc287d06bbcfac7d3c33e1e6"}, + {file = "frozenlist-1.4.1-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:3e0153a805a98f5ada7e09826255ba99fb4f7524bb81bf6b47fb702666484ae1"}, + {file = "frozenlist-1.4.1-cp312-cp312-musllinux_1_1_ppc64le.whl", hash = "sha256:dd9b1baec094d91bf36ec729445f7769d0d0cf6b64d04d86e45baf89e2b9059b"}, + {file = "frozenlist-1.4.1-cp312-cp312-musllinux_1_1_s390x.whl", hash = "sha256:1a4471094e146b6790f61b98616ab8e44f72661879cc63fa1049d13ef711e71e"}, + {file = "frozenlist-1.4.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:5667ed53d68d91920defdf4035d1cdaa3c3121dc0b113255124bcfada1cfa1b8"}, + {file = "frozenlist-1.4.1-cp312-cp312-win32.whl", hash = "sha256:beee944ae828747fd7cb216a70f120767fc9f4f00bacae8543c14a6831673f89"}, + {file = "frozenlist-1.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:64536573d0a2cb6e625cf309984e2d873979709f2cf22839bf2d61790b448ad5"}, + {file = "frozenlist-1.4.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:20b51fa3f588ff2fe658663db52a41a4f7aa6c04f6201449c6c7c476bd255c0d"}, + {file = "frozenlist-1.4.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:410478a0c562d1a5bcc2f7ea448359fcb050ed48b3c6f6f4f18c313a9bdb1826"}, + {file = "frozenlist-1.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:c6321c9efe29975232da3bd0af0ad216800a47e93d763ce64f291917a381b8eb"}, + {file = "frozenlist-1.4.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:48f6a4533887e189dae092f1cf981f2e3885175f7a0f33c91fb5b7b682b6bab6"}, + {file = "frozenlist-1.4.1-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6eb73fa5426ea69ee0e012fb59cdc76a15b1283d6e32e4f8dc4482ec67d1194d"}, + {file = "frozenlist-1.4.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fbeb989b5cc29e8daf7f976b421c220f1b8c731cbf22b9130d8815418ea45887"}, + {file = "frozenlist-1.4.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:32453c1de775c889eb4e22f1197fe3bdfe457d16476ea407472b9442e6295f7a"}, + {file = "frozenlist-1.4.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:693945278a31f2086d9bf3df0fe8254bbeaef1fe71e1351c3bd730aa7d31c41b"}, + {file = "frozenlist-1.4.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:1d0ce09d36d53bbbe566fe296965b23b961764c0bcf3ce2fa45f463745c04701"}, + {file = "frozenlist-1.4.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:3a670dc61eb0d0eb7080890c13de3066790f9049b47b0de04007090807c776b0"}, + {file = "frozenlist-1.4.1-cp38-cp38-musllinux_1_1_ppc64le.whl", hash = "sha256:dca69045298ce5c11fd539682cff879cc1e664c245d1c64da929813e54241d11"}, + {file = "frozenlist-1.4.1-cp38-cp38-musllinux_1_1_s390x.whl", hash = "sha256:a06339f38e9ed3a64e4c4e43aec7f59084033647f908e4259d279a52d3757d09"}, + {file = "frozenlist-1.4.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:b7f2f9f912dca3934c1baec2e4585a674ef16fe00218d833856408c48d5beee7"}, + {file = "frozenlist-1.4.1-cp38-cp38-win32.whl", hash = "sha256:e7004be74cbb7d9f34553a5ce5fb08be14fb33bc86f332fb71cbe5216362a497"}, + {file = "frozenlist-1.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:5a7d70357e7cee13f470c7883a063aae5fe209a493c57d86eb7f5a6f910fae09"}, + {file = "frozenlist-1.4.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bfa4a17e17ce9abf47a74ae02f32d014c5e9404b6d9ac7f729e01562bbee601e"}, + {file = "frozenlist-1.4.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:b7e3ed87d4138356775346e6845cccbe66cd9e207f3cd11d2f0b9fd13681359d"}, + {file = "frozenlist-1.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c99169d4ff810155ca50b4da3b075cbde79752443117d89429595c2e8e37fed8"}, + {file = "frozenlist-1.4.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:edb678da49d9f72c9f6c609fbe41a5dfb9a9282f9e6a2253d5a91e0fc382d7c0"}, + {file = "frozenlist-1.4.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6db4667b187a6742b33afbbaf05a7bc551ffcf1ced0000a571aedbb4aa42fc7b"}, + {file = "frozenlist-1.4.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:55fdc093b5a3cb41d420884cdaf37a1e74c3c37a31f46e66286d9145d2063bd0"}, + {file = "frozenlist-1.4.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:82e8211d69a4f4bc360ea22cd6555f8e61a1bd211d1d5d39d3d228b48c83a897"}, + {file = "frozenlist-1.4.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:89aa2c2eeb20957be2d950b85974b30a01a762f3308cd02bb15e1ad632e22dc7"}, + {file = "frozenlist-1.4.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:9d3e0c25a2350080e9319724dede4f31f43a6c9779be48021a7f4ebde8b2d742"}, + {file = "frozenlist-1.4.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:7268252af60904bf52c26173cbadc3a071cece75f873705419c8681f24d3edea"}, + {file = "frozenlist-1.4.1-cp39-cp39-musllinux_1_1_ppc64le.whl", hash = "sha256:0c250a29735d4f15321007fb02865f0e6b6a41a6b88f1f523ca1596ab5f50bd5"}, + {file = "frozenlist-1.4.1-cp39-cp39-musllinux_1_1_s390x.whl", hash = "sha256:96ec70beabbd3b10e8bfe52616a13561e58fe84c0101dd031dc78f250d5128b9"}, + {file = "frozenlist-1.4.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:23b2d7679b73fe0e5a4560b672a39f98dfc6f60df63823b0a9970525325b95f6"}, + {file = "frozenlist-1.4.1-cp39-cp39-win32.whl", hash = "sha256:a7496bfe1da7fb1a4e1cc23bb67c58fab69311cc7d32b5a99c2007b4b2a0e932"}, + {file = "frozenlist-1.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:e6a20a581f9ce92d389a8c7d7c3dd47c81fd5d6e655c8dddf341e14aa48659d0"}, + {file = "frozenlist-1.4.1-py3-none-any.whl", hash = "sha256:04ced3e6a46b4cfffe20f9ae482818e34eba9b5fb0ce4056e4cc9b6e212d09b7"}, + {file = "frozenlist-1.4.1.tar.gz", hash = "sha256:c037a86e8513059a2613aaba4d817bb90b9d9b6b69aace3ce9c877e8c8ed402b"}, +] + +[[package]] +name = "h11" +version = "0.14.0" +description = "A pure-Python, bring-your-own-I/O implementation of HTTP/1.1" +optional = false +python-versions = ">=3.7" +files = [ + {file = "h11-0.14.0-py3-none-any.whl", hash = "sha256:e3fe4ac4b851c468cc8363d500db52c2ead036020723024a109d37346efaa761"}, + {file = "h11-0.14.0.tar.gz", hash = "sha256:8f19fbbe99e72420ff35c00b27a34cb9937e902a8b810e2c88300c6f0a3b699d"}, +] + +[[package]] +name = "html5lib" +version = "1.1" +description = "HTML parser based on the WHATWG HTML specification" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" +files = [ + {file = "html5lib-1.1-py2.py3-none-any.whl", hash = "sha256:0d78f8fde1c230e99fe37986a60526d7049ed4bf8a9fadbad5f00e22e58e041d"}, + {file = "html5lib-1.1.tar.gz", hash = "sha256:b2e5b40261e20f354d198eae92afc10d750afb487ed5e50f9c4eaf07c184146f"}, +] + +[package.dependencies] +six = ">=1.9" +webencodings = "*" + +[package.extras] +all = ["chardet (>=2.2)", "genshi", "lxml"] +chardet = ["chardet (>=2.2)"] +genshi = ["genshi"] +lxml = ["lxml"] + +[[package]] +name = "httpcore" +version = "1.0.6" +description = "A minimal low-level HTTP client." +optional = false +python-versions = ">=3.8" +files = [ + {file = "httpcore-1.0.6-py3-none-any.whl", hash = "sha256:27b59625743b85577a8c0e10e55b50b5368a4f2cfe8cc7bcfa9cf00829c2682f"}, + {file = "httpcore-1.0.6.tar.gz", hash = "sha256:73f6dbd6eb8c21bbf7ef8efad555481853f5f6acdeaff1edb0694289269ee17f"}, +] + +[package.dependencies] +certifi = "*" +h11 = ">=0.13,<0.15" + +[package.extras] +asyncio = ["anyio (>=4.0,<5.0)"] +http2 = ["h2 (>=3,<5)"] +socks = ["socksio (==1.*)"] +trio = ["trio (>=0.22.0,<1.0)"] + +[[package]] +name = "httptools" +version = "0.6.1" +description = "A collection of framework independent HTTP protocol utils." +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "httptools-0.6.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d2f6c3c4cb1948d912538217838f6e9960bc4a521d7f9b323b3da579cd14532f"}, + {file = "httptools-0.6.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:00d5d4b68a717765b1fabfd9ca755bd12bf44105eeb806c03d1962acd9b8e563"}, + {file = "httptools-0.6.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:639dc4f381a870c9ec860ce5c45921db50205a37cc3334e756269736ff0aac58"}, + {file = "httptools-0.6.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e57997ac7fb7ee43140cc03664de5f268813a481dff6245e0075925adc6aa185"}, + {file = "httptools-0.6.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:0ac5a0ae3d9f4fe004318d64b8a854edd85ab76cffbf7ef5e32920faef62f142"}, + {file = "httptools-0.6.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:3f30d3ce413088a98b9db71c60a6ada2001a08945cb42dd65a9a9fe228627658"}, + {file = "httptools-0.6.1-cp310-cp310-win_amd64.whl", hash = "sha256:1ed99a373e327f0107cb513b61820102ee4f3675656a37a50083eda05dc9541b"}, + {file = "httptools-0.6.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7a7ea483c1a4485c71cb5f38be9db078f8b0e8b4c4dc0210f531cdd2ddac1ef1"}, + {file = "httptools-0.6.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:85ed077c995e942b6f1b07583e4eb0a8d324d418954fc6af913d36db7c05a5a0"}, + {file = "httptools-0.6.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8b0bb634338334385351a1600a73e558ce619af390c2b38386206ac6a27fecfc"}, + {file = "httptools-0.6.1-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7d9ceb2c957320def533671fc9c715a80c47025139c8d1f3797477decbc6edd2"}, + {file = "httptools-0.6.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4f0f8271c0a4db459f9dc807acd0eadd4839934a4b9b892f6f160e94da309837"}, + {file = "httptools-0.6.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:6a4f5ccead6d18ec072ac0b84420e95d27c1cdf5c9f1bc8fbd8daf86bd94f43d"}, + {file = "httptools-0.6.1-cp311-cp311-win_amd64.whl", hash = "sha256:5cceac09f164bcba55c0500a18fe3c47df29b62353198e4f37bbcc5d591172c3"}, + {file = "httptools-0.6.1-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:75c8022dca7935cba14741a42744eee13ba05db00b27a4b940f0d646bd4d56d0"}, + {file = "httptools-0.6.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:48ed8129cd9a0d62cf4d1575fcf90fb37e3ff7d5654d3a5814eb3d55f36478c2"}, + {file = "httptools-0.6.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6f58e335a1402fb5a650e271e8c2d03cfa7cea46ae124649346d17bd30d59c90"}, + {file = "httptools-0.6.1-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:93ad80d7176aa5788902f207a4e79885f0576134695dfb0fefc15b7a4648d503"}, + {file = "httptools-0.6.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:9bb68d3a085c2174c2477eb3ffe84ae9fb4fde8792edb7bcd09a1d8467e30a84"}, + {file = "httptools-0.6.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:b512aa728bc02354e5ac086ce76c3ce635b62f5fbc32ab7082b5e582d27867bb"}, + {file = "httptools-0.6.1-cp312-cp312-win_amd64.whl", hash = "sha256:97662ce7fb196c785344d00d638fc9ad69e18ee4bfb4000b35a52efe5adcc949"}, + {file = "httptools-0.6.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:8e216a038d2d52ea13fdd9b9c9c7459fb80d78302b257828285eca1c773b99b3"}, + {file = "httptools-0.6.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:3e802e0b2378ade99cd666b5bffb8b2a7cc8f3d28988685dc300469ea8dd86cb"}, + {file = "httptools-0.6.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4bd3e488b447046e386a30f07af05f9b38d3d368d1f7b4d8f7e10af85393db97"}, + {file = "httptools-0.6.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fe467eb086d80217b7584e61313ebadc8d187a4d95bb62031b7bab4b205c3ba3"}, + {file = "httptools-0.6.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:3c3b214ce057c54675b00108ac42bacf2ab8f85c58e3f324a4e963bbc46424f4"}, + {file = "httptools-0.6.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:8ae5b97f690badd2ca27cbf668494ee1b6d34cf1c464271ef7bfa9ca6b83ffaf"}, + {file = "httptools-0.6.1-cp38-cp38-win_amd64.whl", hash = "sha256:405784577ba6540fa7d6ff49e37daf104e04f4b4ff2d1ac0469eaa6a20fde084"}, + {file = "httptools-0.6.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:95fb92dd3649f9cb139e9c56604cc2d7c7bf0fc2e7c8d7fbd58f96e35eddd2a3"}, + {file = "httptools-0.6.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:dcbab042cc3ef272adc11220517278519adf8f53fd3056d0e68f0a6f891ba94e"}, + {file = "httptools-0.6.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cf2372e98406efb42e93bfe10f2948e467edfd792b015f1b4ecd897903d3e8d"}, + {file = "httptools-0.6.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:678fcbae74477a17d103b7cae78b74800d795d702083867ce160fc202104d0da"}, + {file = "httptools-0.6.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:e0b281cf5a125c35f7f6722b65d8542d2e57331be573e9e88bc8b0115c4a7a81"}, + {file = "httptools-0.6.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:95658c342529bba4e1d3d2b1a874db16c7cca435e8827422154c9da76ac4e13a"}, + {file = "httptools-0.6.1-cp39-cp39-win_amd64.whl", hash = "sha256:7ebaec1bf683e4bf5e9fbb49b8cc36da482033596a415b3e4ebab5a4c0d7ec5e"}, + {file = "httptools-0.6.1.tar.gz", hash = "sha256:c6e26c30455600b95d94b1b836085138e82f177351454ee841c148f93a9bad5a"}, +] + +[package.extras] +test = ["Cython (>=0.29.24,<0.30.0)"] + +[[package]] +name = "httpx" +version = "0.27.2" +description = "The next generation HTTP client." +optional = false +python-versions = ">=3.8" +files = [ + {file = "httpx-0.27.2-py3-none-any.whl", hash = "sha256:7bb2708e112d8fdd7829cd4243970f0c223274051cb35ee80c03301ee29a3df0"}, + {file = "httpx-0.27.2.tar.gz", hash = "sha256:f7c2be1d2f3c3c3160d441802406b206c2b76f5947b11115e6df10c6c65e66c2"}, +] + +[package.dependencies] +anyio = "*" +certifi = "*" +httpcore = "==1.*" +idna = "*" +sniffio = "*" + +[package.extras] +brotli = ["brotli", "brotlicffi"] +cli = ["click (==8.*)", "pygments (==2.*)", "rich (>=10,<14)"] +http2 = ["h2 (>=3,<5)"] +socks = ["socksio (==1.*)"] +zstd = ["zstandard (>=0.18.0)"] + +[[package]] +name = "idna" +version = "3.10" +description = "Internationalized Domain Names in Applications (IDNA)" +optional = false +python-versions = ">=3.6" +files = [ + {file = "idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3"}, + {file = "idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9"}, +] + +[package.extras] +all = ["flake8 (>=7.1.1)", "mypy (>=1.11.2)", "pytest (>=8.3.2)", "ruff (>=0.6.2)"] + +[[package]] +name = "importlib-metadata" +version = "6.11.0" +description = "Read metadata from Python packages" +optional = false +python-versions = ">=3.8" +files = [ + {file = "importlib_metadata-6.11.0-py3-none-any.whl", hash = "sha256:f0afba6205ad8f8947c7d338b5342d5db2afbfd82f9cbef7879a9539cc12eb9b"}, + {file = "importlib_metadata-6.11.0.tar.gz", hash = "sha256:1231cf92d825c9e03cfc4da076a16de6422c863558229ea0b22b675657463443"}, +] + +[package.dependencies] +zipp = ">=0.5" + +[package.extras] +docs = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "rst.linker (>=1.9)", "sphinx (<7.2.5)", "sphinx (>=3.5)", "sphinx-lint"] +perf = ["ipython"] +testing = ["flufl.flake8", "importlib-resources (>=1.3)", "packaging", "pyfakefs", "pytest (>=6)", "pytest-black (>=0.3.7)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-mypy (>=0.9.1)", "pytest-perf (>=0.9.2)", "pytest-ruff"] + +[[package]] +name = "installer" +version = "0.7.0" +description = "A library for installing Python wheels." +optional = false +python-versions = ">=3.7" +files = [ + {file = "installer-0.7.0-py3-none-any.whl", hash = "sha256:05d1933f0a5ba7d8d6296bb6d5018e7c94fa473ceb10cf198a92ccea19c27b53"}, + {file = "installer-0.7.0.tar.gz", hash = "sha256:a26d3e3116289bb08216e0d0f7d925fcef0b0194eedfa0c944bcaaa106c4b631"}, +] + +[[package]] +name = "jaraco-classes" +version = "3.4.0" +description = "Utility functions for Python class constructs" +optional = false +python-versions = ">=3.8" +files = [ + {file = "jaraco.classes-3.4.0-py3-none-any.whl", hash = "sha256:f662826b6bed8cace05e7ff873ce0f9283b5c924470fe664fff1c2f00f581790"}, + {file = "jaraco.classes-3.4.0.tar.gz", hash = "sha256:47a024b51d0239c0dd8c8540c6c7f484be3b8fcf0b2d85c13825780d3b3f3acd"}, +] + +[package.dependencies] +more-itertools = "*" + +[package.extras] +docs = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-lint"] +testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-mypy", "pytest-ruff (>=0.2.1)"] + +[[package]] +name = "jeepney" +version = "0.8.0" +description = "Low-level, pure Python DBus protocol wrapper." +optional = false +python-versions = ">=3.7" +files = [ + {file = "jeepney-0.8.0-py3-none-any.whl", hash = "sha256:c0a454ad016ca575060802ee4d590dd912e35c122fa04e70306de3d076cce755"}, + {file = "jeepney-0.8.0.tar.gz", hash = "sha256:5efe48d255973902f6badc3ce55e2aa6c5c3b3bc642059ef3a91247bcfcc5806"}, +] + +[package.extras] +test = ["async-timeout", "pytest", "pytest-asyncio (>=0.17)", "pytest-trio", "testpath", "trio"] +trio = ["async_generator", "trio"] + +[[package]] +name = "jinja2" +version = "3.1.4" +description = "A very fast and expressive template engine." +optional = false +python-versions = ">=3.7" +files = [ + {file = "jinja2-3.1.4-py3-none-any.whl", hash = "sha256:bc5dd2abb727a5319567b7a813e6a2e7318c39f4f487cfe6c89c6f9c7d25197d"}, + {file = "jinja2-3.1.4.tar.gz", hash = "sha256:4a3aee7acbbe7303aede8e9648d13b8bf88a429282aa6122a993f0ac800cb369"}, +] + +[package.dependencies] +MarkupSafe = ">=2.0" + +[package.extras] +i18n = ["Babel (>=2.7)"] + +[[package]] +name = "keyring" +version = "24.3.1" +description = "Store and access your passwords safely." +optional = false +python-versions = ">=3.8" +files = [ + {file = "keyring-24.3.1-py3-none-any.whl", hash = "sha256:df38a4d7419a6a60fea5cef1e45a948a3e8430dd12ad88b0f423c5c143906218"}, + {file = "keyring-24.3.1.tar.gz", hash = "sha256:c3327b6ffafc0e8befbdb597cacdb4928ffe5c1212f7645f186e6d9957a898db"}, +] + +[package.dependencies] +importlib-metadata = {version = ">=4.11.4", markers = "python_version < \"3.12\""} +"jaraco.classes" = "*" +jeepney = {version = ">=0.4.2", markers = "sys_platform == \"linux\""} +pywin32-ctypes = {version = ">=0.2.0", markers = "sys_platform == \"win32\""} +SecretStorage = {version = ">=3.2", markers = "sys_platform == \"linux\""} + +[package.extras] +completion = ["shtab (>=1.1.0)"] +docs = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "rst.linker (>=1.9)", "sphinx (<7.2.5)", "sphinx (>=3.5)", "sphinx-lint"] +testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-cov", "pytest-enabler (>=2.2)", "pytest-mypy", "pytest-ruff (>=0.2.1)"] + +[[package]] +name = "markdown-it-py" +version = "3.0.0" +description = "Python port of markdown-it. Markdown parsing, done right!" +optional = false +python-versions = ">=3.8" +files = [ + {file = "markdown-it-py-3.0.0.tar.gz", hash = "sha256:e3f60a94fa066dc52ec76661e37c851cb232d92f9886b15cb560aaada2df8feb"}, + {file = "markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1"}, +] + +[package.dependencies] +mdurl = ">=0.1,<1.0" + +[package.extras] +benchmarking = ["psutil", "pytest", "pytest-benchmark"] +code-style = ["pre-commit (>=3.0,<4.0)"] +compare = ["commonmark (>=0.9,<1.0)", "markdown (>=3.4,<4.0)", "mistletoe (>=1.0,<2.0)", "mistune (>=2.0,<3.0)", "panflute (>=2.3,<3.0)"] +linkify = ["linkify-it-py (>=1,<3)"] +plugins = ["mdit-py-plugins"] +profiling = ["gprof2dot"] +rtd = ["jupyter_sphinx", "mdit-py-plugins", "myst-parser", "pyyaml", "sphinx", "sphinx-copybutton", "sphinx-design", "sphinx_book_theme"] +testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions"] + +[[package]] +name = "markupsafe" +version = "2.1.5" +description = "Safely add untrusted strings to HTML/XML markup." +optional = false +python-versions = ">=3.7" +files = [ + {file = "MarkupSafe-2.1.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:a17a92de5231666cfbe003f0e4b9b3a7ae3afb1ec2845aadc2bacc93ff85febc"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:72b6be590cc35924b02c78ef34b467da4ba07e4e0f0454a2c5907f473fc50ce5"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e61659ba32cf2cf1481e575d0462554625196a1f2fc06a1c777d3f48e8865d46"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2174c595a0d73a3080ca3257b40096db99799265e1c27cc5a610743acd86d62f"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ae2ad8ae6ebee9d2d94b17fb62763125f3f374c25618198f40cbb8b525411900"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:075202fa5b72c86ad32dc7d0b56024ebdbcf2048c0ba09f1cde31bfdd57bcfff"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:598e3276b64aff0e7b3451b72e94fa3c238d452e7ddcd893c3ab324717456bad"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:fce659a462a1be54d2ffcacea5e3ba2d74daa74f30f5f143fe0c58636e355fdd"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-win32.whl", hash = "sha256:d9fad5155d72433c921b782e58892377c44bd6252b5af2f67f16b194987338a4"}, + {file = "MarkupSafe-2.1.5-cp310-cp310-win_amd64.whl", hash = "sha256:bf50cd79a75d181c9181df03572cdce0fbb75cc353bc350712073108cba98de5"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:629ddd2ca402ae6dbedfceeba9c46d5f7b2a61d9749597d4307f943ef198fc1f"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:5b7b716f97b52c5a14bffdf688f971b2d5ef4029127f1ad7a513973cfd818df2"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ec585f69cec0aa07d945b20805be741395e28ac1627333b1c5b0105962ffced"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b91c037585eba9095565a3556f611e3cbfaa42ca1e865f7b8015fe5c7336d5a5"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7502934a33b54030eaf1194c21c692a534196063db72176b0c4028e140f8f32c"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:0e397ac966fdf721b2c528cf028494e86172b4feba51d65f81ffd65c63798f3f"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:c061bb86a71b42465156a3ee7bd58c8c2ceacdbeb95d05a99893e08b8467359a"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:3a57fdd7ce31c7ff06cdfbf31dafa96cc533c21e443d57f5b1ecc6cdc668ec7f"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-win32.whl", hash = "sha256:397081c1a0bfb5124355710fe79478cdbeb39626492b15d399526ae53422b906"}, + {file = "MarkupSafe-2.1.5-cp311-cp311-win_amd64.whl", hash = "sha256:2b7c57a4dfc4f16f7142221afe5ba4e093e09e728ca65c51f5620c9aaeb9a617"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:8dec4936e9c3100156f8a2dc89c4b88d5c435175ff03413b443469c7c8c5f4d1"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:3c6b973f22eb18a789b1460b4b91bf04ae3f0c4234a0a6aa6b0a92f6f7b951d4"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ac07bad82163452a6884fe8fa0963fb98c2346ba78d779ec06bd7a6262132aee"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f5dfb42c4604dddc8e4305050aa6deb084540643ed5804d7455b5df8fe16f5e5"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ea3d8a3d18833cf4304cd2fc9cbb1efe188ca9b5efef2bdac7adc20594a0e46b"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:d050b3361367a06d752db6ead6e7edeb0009be66bc3bae0ee9d97fb326badc2a"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:bec0a414d016ac1a18862a519e54b2fd0fc8bbfd6890376898a6c0891dd82e9f"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:58c98fee265677f63a4385256a6d7683ab1832f3ddd1e66fe948d5880c21a169"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-win32.whl", hash = "sha256:8590b4ae07a35970728874632fed7bd57b26b0102df2d2b233b6d9d82f6c62ad"}, + {file = "MarkupSafe-2.1.5-cp312-cp312-win_amd64.whl", hash = "sha256:823b65d8706e32ad2df51ed89496147a42a2a6e01c13cfb6ffb8b1e92bc910bb"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:c8b29db45f8fe46ad280a7294f5c3ec36dbac9491f2d1c17345be8e69cc5928f"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ec6a563cff360b50eed26f13adc43e61bc0c04d94b8be985e6fb24b81f6dcfdf"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a549b9c31bec33820e885335b451286e2969a2d9e24879f83fe904a5ce59d70a"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4f11aa001c540f62c6166c7726f71f7573b52c68c31f014c25cc7901deea0b52"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:7b2e5a267c855eea6b4283940daa6e88a285f5f2a67f2220203786dfa59b37e9"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:2d2d793e36e230fd32babe143b04cec8a8b3eb8a3122d2aceb4a371e6b09b8df"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:ce409136744f6521e39fd8e2a24c53fa18ad67aa5bc7c2cf83645cce5b5c4e50"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-win32.whl", hash = "sha256:4096e9de5c6fdf43fb4f04c26fb114f61ef0bf2e5604b6ee3019d51b69e8c371"}, + {file = "MarkupSafe-2.1.5-cp37-cp37m-win_amd64.whl", hash = "sha256:4275d846e41ecefa46e2015117a9f491e57a71ddd59bbead77e904dc02b1bed2"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:656f7526c69fac7f600bd1f400991cc282b417d17539a1b228617081106feb4a"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:97cafb1f3cbcd3fd2b6fbfb99ae11cdb14deea0736fc2b0952ee177f2b813a46"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1f3fbcb7ef1f16e48246f704ab79d79da8a46891e2da03f8783a5b6fa41a9532"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fa9db3f79de01457b03d4f01b34cf91bc0048eb2c3846ff26f66687c2f6d16ab"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ffee1f21e5ef0d712f9033568f8344d5da8cc2869dbd08d87c84656e6a2d2f68"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:5dedb4db619ba5a2787a94d877bc8ffc0566f92a01c0ef214865e54ecc9ee5e0"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:30b600cf0a7ac9234b2638fbc0fb6158ba5bdcdf46aeb631ead21248b9affbc4"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:8dd717634f5a044f860435c1d8c16a270ddf0ef8588d4887037c5028b859b0c3"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-win32.whl", hash = "sha256:daa4ee5a243f0f20d528d939d06670a298dd39b1ad5f8a72a4275124a7819eff"}, + {file = "MarkupSafe-2.1.5-cp38-cp38-win_amd64.whl", hash = "sha256:619bc166c4f2de5caa5a633b8b7326fbe98e0ccbfacabd87268a2b15ff73a029"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:7a68b554d356a91cce1236aa7682dc01df0edba8d043fd1ce607c49dd3c1edcf"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:db0b55e0f3cc0be60c1f19efdde9a637c32740486004f20d1cff53c3c0ece4d2"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3e53af139f8579a6d5f7b76549125f0d94d7e630761a2111bc431fd820e163b8"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:17b950fccb810b3293638215058e432159d2b71005c74371d784862b7e4683f3"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4c31f53cdae6ecfa91a77820e8b151dba54ab528ba65dfd235c80b086d68a465"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:bff1b4290a66b490a2f4719358c0cdcd9bafb6b8f061e45c7a2460866bf50c2e"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:bc1667f8b83f48511b94671e0e441401371dfd0f0a795c7daa4a3cd1dde55bea"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5049256f536511ee3f7e1b3f87d1d1209d327e818e6ae1365e8653d7e3abb6a6"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-win32.whl", hash = "sha256:00e046b6dd71aa03a41079792f8473dc494d564611a8f89bbbd7cb93295ebdcf"}, + {file = "MarkupSafe-2.1.5-cp39-cp39-win_amd64.whl", hash = "sha256:fa173ec60341d6bb97a89f5ea19c85c5643c1e7dedebc22f5181eb73573142c5"}, + {file = "MarkupSafe-2.1.5.tar.gz", hash = "sha256:d283d37a890ba4c1ae73ffadf8046435c76e7bc2247bbb63c00bd1a709c6544b"}, +] + +[[package]] +name = "mdurl" +version = "0.1.2" +description = "Markdown URL utilities" +optional = false +python-versions = ">=3.7" +files = [ + {file = "mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8"}, + {file = "mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"}, +] + +[[package]] +name = "monotonic" +version = "1.6" +description = "An implementation of time.monotonic() for Python 2 & < 3.3" +optional = false +python-versions = "*" +files = [ + {file = "monotonic-1.6-py2.py3-none-any.whl", hash = "sha256:68687e19a14f11f26d140dd5c86f3dba4bf5df58003000ed467e0e2a69bca96c"}, + {file = "monotonic-1.6.tar.gz", hash = "sha256:3a55207bcfed53ddd5c5bae174524062935efed17792e9de2ad0205ce9ad63f7"}, +] + +[[package]] +name = "more-itertools" +version = "10.5.0" +description = "More routines for operating on iterables, beyond itertools" +optional = false +python-versions = ">=3.8" +files = [ + {file = "more-itertools-10.5.0.tar.gz", hash = "sha256:5482bfef7849c25dc3c6dd53a6173ae4795da2a41a80faea6700d9f5846c5da6"}, + {file = "more_itertools-10.5.0-py3-none-any.whl", hash = "sha256:037b0d3203ce90cca8ab1defbbdac29d5f993fc20131f3664dc8d6acfa872aef"}, +] + +[[package]] +name = "msgpack" +version = "1.1.0" +description = "MessagePack serializer" +optional = false +python-versions = ">=3.8" +files = [ + {file = "msgpack-1.1.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:7ad442d527a7e358a469faf43fda45aaf4ac3249c8310a82f0ccff9164e5dccd"}, + {file = "msgpack-1.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:74bed8f63f8f14d75eec75cf3d04ad581da6b914001b474a5d3cd3372c8cc27d"}, + {file = "msgpack-1.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:914571a2a5b4e7606997e169f64ce53a8b1e06f2cf2c3a7273aa106236d43dd5"}, + {file = "msgpack-1.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c921af52214dcbb75e6bdf6a661b23c3e6417f00c603dd2070bccb5c3ef499f5"}, + {file = "msgpack-1.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d8ce0b22b890be5d252de90d0e0d119f363012027cf256185fc3d474c44b1b9e"}, + {file = "msgpack-1.1.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:73322a6cc57fcee3c0c57c4463d828e9428275fb85a27aa2aa1a92fdc42afd7b"}, + {file = "msgpack-1.1.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:e1f3c3d21f7cf67bcf2da8e494d30a75e4cf60041d98b3f79875afb5b96f3a3f"}, + {file = "msgpack-1.1.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:64fc9068d701233effd61b19efb1485587560b66fe57b3e50d29c5d78e7fef68"}, + {file = "msgpack-1.1.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:42f754515e0f683f9c79210a5d1cad631ec3d06cea5172214d2176a42e67e19b"}, + {file = "msgpack-1.1.0-cp310-cp310-win32.whl", hash = "sha256:3df7e6b05571b3814361e8464f9304c42d2196808e0119f55d0d3e62cd5ea044"}, + {file = "msgpack-1.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:685ec345eefc757a7c8af44a3032734a739f8c45d1b0ac45efc5d8977aa4720f"}, + {file = "msgpack-1.1.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:3d364a55082fb2a7416f6c63ae383fbd903adb5a6cf78c5b96cc6316dc1cedc7"}, + {file = "msgpack-1.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:79ec007767b9b56860e0372085f8504db5d06bd6a327a335449508bbee9648fa"}, + {file = "msgpack-1.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:6ad622bf7756d5a497d5b6836e7fc3752e2dd6f4c648e24b1803f6048596f701"}, + {file = "msgpack-1.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e59bca908d9ca0de3dc8684f21ebf9a690fe47b6be93236eb40b99af28b6ea6"}, + {file = "msgpack-1.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5e1da8f11a3dd397f0a32c76165cf0c4eb95b31013a94f6ecc0b280c05c91b59"}, + {file = "msgpack-1.1.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:452aff037287acb1d70a804ffd022b21fa2bb7c46bee884dbc864cc9024128a0"}, + {file = "msgpack-1.1.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8da4bf6d54ceed70e8861f833f83ce0814a2b72102e890cbdfe4b34764cdd66e"}, + {file = "msgpack-1.1.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:41c991beebf175faf352fb940bf2af9ad1fb77fd25f38d9142053914947cdbf6"}, + {file = "msgpack-1.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:a52a1f3a5af7ba1c9ace055b659189f6c669cf3657095b50f9602af3a3ba0fe5"}, + {file = "msgpack-1.1.0-cp311-cp311-win32.whl", hash = "sha256:58638690ebd0a06427c5fe1a227bb6b8b9fdc2bd07701bec13c2335c82131a88"}, + {file = "msgpack-1.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:fd2906780f25c8ed5d7b323379f6138524ba793428db5d0e9d226d3fa6aa1788"}, + {file = "msgpack-1.1.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:d46cf9e3705ea9485687aa4001a76e44748b609d260af21c4ceea7f2212a501d"}, + {file = "msgpack-1.1.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:5dbad74103df937e1325cc4bfeaf57713be0b4f15e1c2da43ccdd836393e2ea2"}, + {file = "msgpack-1.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:58dfc47f8b102da61e8949708b3eafc3504509a5728f8b4ddef84bd9e16ad420"}, + {file = "msgpack-1.1.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4676e5be1b472909b2ee6356ff425ebedf5142427842aa06b4dfd5117d1ca8a2"}, + {file = "msgpack-1.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:17fb65dd0bec285907f68b15734a993ad3fc94332b5bb21b0435846228de1f39"}, + {file = "msgpack-1.1.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a51abd48c6d8ac89e0cfd4fe177c61481aca2d5e7ba42044fd218cfd8ea9899f"}, + {file = "msgpack-1.1.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2137773500afa5494a61b1208619e3871f75f27b03bcfca7b3a7023284140247"}, + {file = "msgpack-1.1.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:398b713459fea610861c8a7b62a6fec1882759f308ae0795b5413ff6a160cf3c"}, + {file = "msgpack-1.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:06f5fd2f6bb2a7914922d935d3b8bb4a7fff3a9a91cfce6d06c13bc42bec975b"}, + {file = "msgpack-1.1.0-cp312-cp312-win32.whl", hash = "sha256:ad33e8400e4ec17ba782f7b9cf868977d867ed784a1f5f2ab46e7ba53b6e1e1b"}, + {file = "msgpack-1.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:115a7af8ee9e8cddc10f87636767857e7e3717b7a2e97379dc2054712693e90f"}, + {file = "msgpack-1.1.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:071603e2f0771c45ad9bc65719291c568d4edf120b44eb36324dcb02a13bfddf"}, + {file = "msgpack-1.1.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0f92a83b84e7c0749e3f12821949d79485971f087604178026085f60ce109330"}, + {file = "msgpack-1.1.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:4a1964df7b81285d00a84da4e70cb1383f2e665e0f1f2a7027e683956d04b734"}, + {file = "msgpack-1.1.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:59caf6a4ed0d164055ccff8fe31eddc0ebc07cf7326a2aaa0dbf7a4001cd823e"}, + {file = "msgpack-1.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0907e1a7119b337971a689153665764adc34e89175f9a34793307d9def08e6ca"}, + {file = "msgpack-1.1.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:65553c9b6da8166e819a6aa90ad15288599b340f91d18f60b2061f402b9a4915"}, + {file = "msgpack-1.1.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:7a946a8992941fea80ed4beae6bff74ffd7ee129a90b4dd5cf9c476a30e9708d"}, + {file = "msgpack-1.1.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:4b51405e36e075193bc051315dbf29168d6141ae2500ba8cd80a522964e31434"}, + {file = "msgpack-1.1.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b4c01941fd2ff87c2a934ee6055bda4ed353a7846b8d4f341c428109e9fcde8c"}, + {file = "msgpack-1.1.0-cp313-cp313-win32.whl", hash = "sha256:7c9a35ce2c2573bada929e0b7b3576de647b0defbd25f5139dcdaba0ae35a4cc"}, + {file = "msgpack-1.1.0-cp313-cp313-win_amd64.whl", hash = "sha256:bce7d9e614a04d0883af0b3d4d501171fbfca038f12c77fa838d9f198147a23f"}, + {file = "msgpack-1.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c40ffa9a15d74e05ba1fe2681ea33b9caffd886675412612d93ab17b58ea2fec"}, + {file = "msgpack-1.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f1ba6136e650898082d9d5a5217d5906d1e138024f836ff48691784bbe1adf96"}, + {file = "msgpack-1.1.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e0856a2b7e8dcb874be44fea031d22e5b3a19121be92a1e098f46068a11b0870"}, + {file = "msgpack-1.1.0-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:471e27a5787a2e3f974ba023f9e265a8c7cfd373632247deb225617e3100a3c7"}, + {file = "msgpack-1.1.0-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:646afc8102935a388ffc3914b336d22d1c2d6209c773f3eb5dd4d6d3b6f8c1cb"}, + {file = "msgpack-1.1.0-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:13599f8829cfbe0158f6456374e9eea9f44eee08076291771d8ae93eda56607f"}, + {file = "msgpack-1.1.0-cp38-cp38-win32.whl", hash = "sha256:8a84efb768fb968381e525eeeb3d92857e4985aacc39f3c47ffd00eb4509315b"}, + {file = "msgpack-1.1.0-cp38-cp38-win_amd64.whl", hash = "sha256:879a7b7b0ad82481c52d3c7eb99bf6f0645dbdec5134a4bddbd16f3506947feb"}, + {file = "msgpack-1.1.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:53258eeb7a80fc46f62fd59c876957a2d0e15e6449a9e71842b6d24419d88ca1"}, + {file = "msgpack-1.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:7e7b853bbc44fb03fbdba34feb4bd414322180135e2cb5164f20ce1c9795ee48"}, + {file = "msgpack-1.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:f3e9b4936df53b970513eac1758f3882c88658a220b58dcc1e39606dccaaf01c"}, + {file = "msgpack-1.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:46c34e99110762a76e3911fc923222472c9d681f1094096ac4102c18319e6468"}, + {file = "msgpack-1.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8a706d1e74dd3dea05cb54580d9bd8b2880e9264856ce5068027eed09680aa74"}, + {file = "msgpack-1.1.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:534480ee5690ab3cbed89d4c8971a5c631b69a8c0883ecfea96c19118510c846"}, + {file = "msgpack-1.1.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:8cf9e8c3a2153934a23ac160cc4cba0ec035f6867c8013cc6077a79823370346"}, + {file = "msgpack-1.1.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:3180065ec2abbe13a4ad37688b61b99d7f9e012a535b930e0e683ad6bc30155b"}, + {file = "msgpack-1.1.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:c5a91481a3cc573ac8c0d9aace09345d989dc4a0202b7fcb312c88c26d4e71a8"}, + {file = "msgpack-1.1.0-cp39-cp39-win32.whl", hash = "sha256:f80bc7d47f76089633763f952e67f8214cb7b3ee6bfa489b3cb6a84cfac114cd"}, + {file = "msgpack-1.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:4d1b7ff2d6146e16e8bd665ac726a89c74163ef8cd39fa8c1087d4e52d3a2325"}, + {file = "msgpack-1.1.0.tar.gz", hash = "sha256:dd432ccc2c72b914e4cb77afce64aab761c1137cc698be3984eee260bcb2896e"}, +] + +[[package]] +name = "multidict" +version = "6.1.0" +description = "multidict implementation" +optional = false +python-versions = ">=3.8" +files = [ + {file = "multidict-6.1.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:3380252550e372e8511d49481bd836264c009adb826b23fefcc5dd3c69692f60"}, + {file = "multidict-6.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:99f826cbf970077383d7de805c0681799491cb939c25450b9b5b3ced03ca99f1"}, + {file = "multidict-6.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:a114d03b938376557927ab23f1e950827c3b893ccb94b62fd95d430fd0e5cf53"}, + {file = "multidict-6.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b1c416351ee6271b2f49b56ad7f308072f6f44b37118d69c2cad94f3fa8a40d5"}, + {file = "multidict-6.1.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6b5d83030255983181005e6cfbac1617ce9746b219bc2aad52201ad121226581"}, + {file = "multidict-6.1.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3e97b5e938051226dc025ec80980c285b053ffb1e25a3db2a3aa3bc046bf7f56"}, + {file = "multidict-6.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d618649d4e70ac6efcbba75be98b26ef5078faad23592f9b51ca492953012429"}, + {file = "multidict-6.1.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:10524ebd769727ac77ef2278390fb0068d83f3acb7773792a5080f2b0abf7748"}, + {file = "multidict-6.1.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:ff3827aef427c89a25cc96ded1759271a93603aba9fb977a6d264648ebf989db"}, + {file = "multidict-6.1.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:06809f4f0f7ab7ea2cabf9caca7d79c22c0758b58a71f9d32943ae13c7ace056"}, + {file = "multidict-6.1.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:f179dee3b863ab1c59580ff60f9d99f632f34ccb38bf67a33ec6b3ecadd0fd76"}, + {file = "multidict-6.1.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:aaed8b0562be4a0876ee3b6946f6869b7bcdb571a5d1496683505944e268b160"}, + {file = "multidict-6.1.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:3c8b88a2ccf5493b6c8da9076fb151ba106960a2df90c2633f342f120751a9e7"}, + {file = "multidict-6.1.0-cp310-cp310-win32.whl", hash = "sha256:4a9cb68166a34117d6646c0023c7b759bf197bee5ad4272f420a0141d7eb03a0"}, + {file = "multidict-6.1.0-cp310-cp310-win_amd64.whl", hash = "sha256:20b9b5fbe0b88d0bdef2012ef7dee867f874b72528cf1d08f1d59b0e3850129d"}, + {file = "multidict-6.1.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:3efe2c2cb5763f2f1b275ad2bf7a287d3f7ebbef35648a9726e3b69284a4f3d6"}, + {file = "multidict-6.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:c7053d3b0353a8b9de430a4f4b4268ac9a4fb3481af37dfe49825bf45ca24156"}, + {file = "multidict-6.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:27e5fc84ccef8dfaabb09d82b7d179c7cf1a3fbc8a966f8274fcb4ab2eb4cadb"}, + {file = "multidict-6.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0e2b90b43e696f25c62656389d32236e049568b39320e2735d51f08fd362761b"}, + {file = "multidict-6.1.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d83a047959d38a7ff552ff94be767b7fd79b831ad1cd9920662db05fec24fe72"}, + {file = "multidict-6.1.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d1a9dd711d0877a1ece3d2e4fea11a8e75741ca21954c919406b44e7cf971304"}, + {file = "multidict-6.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ec2abea24d98246b94913b76a125e855eb5c434f7c46546046372fe60f666351"}, + {file = "multidict-6.1.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4867cafcbc6585e4b678876c489b9273b13e9fff9f6d6d66add5e15d11d926cb"}, + {file = "multidict-6.1.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:5b48204e8d955c47c55b72779802b219a39acc3ee3d0116d5080c388970b76e3"}, + {file = "multidict-6.1.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:d8fff389528cad1618fb4b26b95550327495462cd745d879a8c7c2115248e399"}, + {file = "multidict-6.1.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:a7a9541cd308eed5e30318430a9c74d2132e9a8cb46b901326272d780bf2d423"}, + {file = "multidict-6.1.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:da1758c76f50c39a2efd5e9859ce7d776317eb1dd34317c8152ac9251fc574a3"}, + {file = "multidict-6.1.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:c943a53e9186688b45b323602298ab727d8865d8c9ee0b17f8d62d14b56f0753"}, + {file = "multidict-6.1.0-cp311-cp311-win32.whl", hash = "sha256:90f8717cb649eea3504091e640a1b8568faad18bd4b9fcd692853a04475a4b80"}, + {file = "multidict-6.1.0-cp311-cp311-win_amd64.whl", hash = "sha256:82176036e65644a6cc5bd619f65f6f19781e8ec2e5330f51aa9ada7504cc1926"}, + {file = "multidict-6.1.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:b04772ed465fa3cc947db808fa306d79b43e896beb677a56fb2347ca1a49c1fa"}, + {file = "multidict-6.1.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:6180c0ae073bddeb5a97a38c03f30c233e0a4d39cd86166251617d1bbd0af436"}, + {file = "multidict-6.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:071120490b47aa997cca00666923a83f02c7fbb44f71cf7f136df753f7fa8761"}, + {file = "multidict-6.1.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:50b3a2710631848991d0bf7de077502e8994c804bb805aeb2925a981de58ec2e"}, + {file = "multidict-6.1.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b58c621844d55e71c1b7f7c498ce5aa6985d743a1a59034c57a905b3f153c1ef"}, + {file = "multidict-6.1.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:55b6d90641869892caa9ca42ff913f7ff1c5ece06474fbd32fb2cf6834726c95"}, + {file = "multidict-6.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b820514bfc0b98a30e3d85462084779900347e4d49267f747ff54060cc33925"}, + {file = "multidict-6.1.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:10a9b09aba0c5b48c53761b7c720aaaf7cf236d5fe394cd399c7ba662d5f9966"}, + {file = "multidict-6.1.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1e16bf3e5fc9f44632affb159d30a437bfe286ce9e02754759be5536b169b305"}, + {file = "multidict-6.1.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:76f364861c3bfc98cbbcbd402d83454ed9e01a5224bb3a28bf70002a230f73e2"}, + {file = "multidict-6.1.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:820c661588bd01a0aa62a1283f20d2be4281b086f80dad9e955e690c75fb54a2"}, + {file = "multidict-6.1.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:0e5f362e895bc5b9e67fe6e4ded2492d8124bdf817827f33c5b46c2fe3ffaca6"}, + {file = "multidict-6.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:3ec660d19bbc671e3a6443325f07263be452c453ac9e512f5eb935e7d4ac28b3"}, + {file = "multidict-6.1.0-cp312-cp312-win32.whl", hash = "sha256:58130ecf8f7b8112cdb841486404f1282b9c86ccb30d3519faf301b2e5659133"}, + {file = "multidict-6.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:188215fc0aafb8e03341995e7c4797860181562380f81ed0a87ff455b70bf1f1"}, + {file = "multidict-6.1.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:d569388c381b24671589335a3be6e1d45546c2988c2ebe30fdcada8457a31008"}, + {file = "multidict-6.1.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:052e10d2d37810b99cc170b785945421141bf7bb7d2f8799d431e7db229c385f"}, + {file = "multidict-6.1.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f90c822a402cb865e396a504f9fc8173ef34212a342d92e362ca498cad308e28"}, + {file = "multidict-6.1.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b225d95519a5bf73860323e633a664b0d85ad3d5bede6d30d95b35d4dfe8805b"}, + {file = "multidict-6.1.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:23bfd518810af7de1116313ebd9092cb9aa629beb12f6ed631ad53356ed6b86c"}, + {file = "multidict-6.1.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5c09fcfdccdd0b57867577b719c69e347a436b86cd83747f179dbf0cc0d4c1f3"}, + {file = "multidict-6.1.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bf6bea52ec97e95560af5ae576bdac3aa3aae0b6758c6efa115236d9e07dae44"}, + {file = "multidict-6.1.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:57feec87371dbb3520da6192213c7d6fc892d5589a93db548331954de8248fd2"}, + {file = "multidict-6.1.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0c3f390dc53279cbc8ba976e5f8035eab997829066756d811616b652b00a23a3"}, + {file = "multidict-6.1.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:59bfeae4b25ec05b34f1956eaa1cb38032282cd4dfabc5056d0a1ec4d696d3aa"}, + {file = "multidict-6.1.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:b2f59caeaf7632cc633b5cf6fc449372b83bbdf0da4ae04d5be36118e46cc0aa"}, + {file = "multidict-6.1.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:37bb93b2178e02b7b618893990941900fd25b6b9ac0fa49931a40aecdf083fe4"}, + {file = "multidict-6.1.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4e9f48f58c2c523d5a06faea47866cd35b32655c46b443f163d08c6d0ddb17d6"}, + {file = "multidict-6.1.0-cp313-cp313-win32.whl", hash = "sha256:3a37ffb35399029b45c6cc33640a92bef403c9fd388acce75cdc88f58bd19a81"}, + {file = "multidict-6.1.0-cp313-cp313-win_amd64.whl", hash = "sha256:e9aa71e15d9d9beaad2c6b9319edcdc0a49a43ef5c0a4c8265ca9ee7d6c67774"}, + {file = "multidict-6.1.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:db7457bac39421addd0c8449933ac32d8042aae84a14911a757ae6ca3eef1392"}, + {file = "multidict-6.1.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:d094ddec350a2fb899fec68d8353c78233debde9b7d8b4beeafa70825f1c281a"}, + {file = "multidict-6.1.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:5845c1fd4866bb5dd3125d89b90e57ed3138241540897de748cdf19de8a2fca2"}, + {file = "multidict-6.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9079dfc6a70abe341f521f78405b8949f96db48da98aeb43f9907f342f627cdc"}, + {file = "multidict-6.1.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3914f5aaa0f36d5d60e8ece6a308ee1c9784cd75ec8151062614657a114c4478"}, + {file = "multidict-6.1.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c08be4f460903e5a9d0f76818db3250f12e9c344e79314d1d570fc69d7f4eae4"}, + {file = "multidict-6.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d093be959277cb7dee84b801eb1af388b6ad3ca6a6b6bf1ed7585895789d027d"}, + {file = "multidict-6.1.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3702ea6872c5a2a4eeefa6ffd36b042e9773f05b1f37ae3ef7264b1163c2dcf6"}, + {file = "multidict-6.1.0-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:2090f6a85cafc5b2db085124d752757c9d251548cedabe9bd31afe6363e0aff2"}, + {file = "multidict-6.1.0-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:f67f217af4b1ff66c68a87318012de788dd95fcfeb24cc889011f4e1c7454dfd"}, + {file = "multidict-6.1.0-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:189f652a87e876098bbc67b4da1049afb5f5dfbaa310dd67c594b01c10388db6"}, + {file = "multidict-6.1.0-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:6bb5992037f7a9eff7991ebe4273ea7f51f1c1c511e6a2ce511d0e7bdb754492"}, + {file = "multidict-6.1.0-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:ac10f4c2b9e770c4e393876e35a7046879d195cd123b4f116d299d442b335bcd"}, + {file = "multidict-6.1.0-cp38-cp38-win32.whl", hash = "sha256:e27bbb6d14416713a8bd7aaa1313c0fc8d44ee48d74497a0ff4c3a1b6ccb5167"}, + {file = "multidict-6.1.0-cp38-cp38-win_amd64.whl", hash = "sha256:22f3105d4fb15c8f57ff3959a58fcab6ce36814486500cd7485651230ad4d4ef"}, + {file = "multidict-6.1.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:4e18b656c5e844539d506a0a06432274d7bd52a7487e6828c63a63d69185626c"}, + {file = "multidict-6.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:a185f876e69897a6f3325c3f19f26a297fa058c5e456bfcff8015e9a27e83ae1"}, + {file = "multidict-6.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ab7c4ceb38d91570a650dba194e1ca87c2b543488fe9309b4212694174fd539c"}, + {file = "multidict-6.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e617fb6b0b6953fffd762669610c1c4ffd05632c138d61ac7e14ad187870669c"}, + {file = "multidict-6.1.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:16e5f4bf4e603eb1fdd5d8180f1a25f30056f22e55ce51fb3d6ad4ab29f7d96f"}, + {file = "multidict-6.1.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f4c035da3f544b1882bac24115f3e2e8760f10a0107614fc9839fd232200b875"}, + {file = "multidict-6.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:957cf8e4b6e123a9eea554fa7ebc85674674b713551de587eb318a2df3e00255"}, + {file = "multidict-6.1.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:483a6aea59cb89904e1ceabd2b47368b5600fb7de78a6e4a2c2987b2d256cf30"}, + {file = "multidict-6.1.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:87701f25a2352e5bf7454caa64757642734da9f6b11384c1f9d1a8e699758057"}, + {file = "multidict-6.1.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:682b987361e5fd7a139ed565e30d81fd81e9629acc7d925a205366877d8c8657"}, + {file = "multidict-6.1.0-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:ce2186a7df133a9c895dea3331ddc5ddad42cdd0d1ea2f0a51e5d161e4762f28"}, + {file = "multidict-6.1.0-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:9f636b730f7e8cb19feb87094949ba54ee5357440b9658b2a32a5ce4bce53972"}, + {file = "multidict-6.1.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:73eae06aa53af2ea5270cc066dcaf02cc60d2994bbb2c4ef5764949257d10f43"}, + {file = "multidict-6.1.0-cp39-cp39-win32.whl", hash = "sha256:1ca0083e80e791cffc6efce7660ad24af66c8d4079d2a750b29001b53ff59ada"}, + {file = "multidict-6.1.0-cp39-cp39-win_amd64.whl", hash = "sha256:aa466da5b15ccea564bdab9c89175c762bc12825f4659c11227f515cee76fa4a"}, + {file = "multidict-6.1.0-py3-none-any.whl", hash = "sha256:48e171e52d1c4d33888e529b999e5900356b9ae588c2f09a52dcefb158b27506"}, + {file = "multidict-6.1.0.tar.gz", hash = "sha256:22ae2ebf9b0c69d206c003e2f6a914ea33f0a932d4aa16f236afc049d9958f4a"}, +] + +[package.dependencies] +typing-extensions = {version = ">=4.1.0", markers = "python_version < \"3.11\""} + +[[package]] +name = "mypy-extensions" +version = "1.0.0" +description = "Type system extensions for programs checked with the mypy type checker." +optional = false +python-versions = ">=3.5" +files = [ + {file = "mypy_extensions-1.0.0-py3-none-any.whl", hash = "sha256:4392f6c0eb8a5668a69e23d168ffa70f0be9ccfd32b5cc2d26a34ae5b844552d"}, + {file = "mypy_extensions-1.0.0.tar.gz", hash = "sha256:75dbf8955dc00442a438fc4d0666508a9a97b6bd41aa2f0ffe9d2f2725af0782"}, +] + +[[package]] +name = "numpy" +version = "2.0.2" +description = "Fundamental package for array computing in Python" +optional = false +python-versions = ">=3.9" +files = [ + {file = "numpy-2.0.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:51129a29dbe56f9ca83438b706e2e69a39892b5eda6cedcb6b0c9fdc9b0d3ece"}, + {file = "numpy-2.0.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:f15975dfec0cf2239224d80e32c3170b1d168335eaedee69da84fbe9f1f9cd04"}, + {file = "numpy-2.0.2-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:8c5713284ce4e282544c68d1c3b2c7161d38c256d2eefc93c1d683cf47683e66"}, + {file = "numpy-2.0.2-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:becfae3ddd30736fe1889a37f1f580e245ba79a5855bff5f2a29cb3ccc22dd7b"}, + {file = "numpy-2.0.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2da5960c3cf0df7eafefd806d4e612c5e19358de82cb3c343631188991566ccd"}, + {file = "numpy-2.0.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:496f71341824ed9f3d2fd36cf3ac57ae2e0165c143b55c3a035ee219413f3318"}, + {file = "numpy-2.0.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a61ec659f68ae254e4d237816e33171497e978140353c0c2038d46e63282d0c8"}, + {file = "numpy-2.0.2-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:d731a1c6116ba289c1e9ee714b08a8ff882944d4ad631fd411106a30f083c326"}, + {file = "numpy-2.0.2-cp310-cp310-win32.whl", hash = "sha256:984d96121c9f9616cd33fbd0618b7f08e0cfc9600a7ee1d6fd9b239186d19d97"}, + {file = "numpy-2.0.2-cp310-cp310-win_amd64.whl", hash = "sha256:c7b0be4ef08607dd04da4092faee0b86607f111d5ae68036f16cc787e250a131"}, + {file = "numpy-2.0.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:49ca4decb342d66018b01932139c0961a8f9ddc7589611158cb3c27cbcf76448"}, + {file = "numpy-2.0.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:11a76c372d1d37437857280aa142086476136a8c0f373b2e648ab2c8f18fb195"}, + {file = "numpy-2.0.2-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:807ec44583fd708a21d4a11d94aedf2f4f3c3719035c76a2bbe1fe8e217bdc57"}, + {file = "numpy-2.0.2-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:8cafab480740e22f8d833acefed5cc87ce276f4ece12fdaa2e8903db2f82897a"}, + {file = "numpy-2.0.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a15f476a45e6e5a3a79d8a14e62161d27ad897381fecfa4a09ed5322f2085669"}, + {file = "numpy-2.0.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:13e689d772146140a252c3a28501da66dfecd77490b498b168b501835041f951"}, + {file = "numpy-2.0.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:9ea91dfb7c3d1c56a0e55657c0afb38cf1eeae4544c208dc465c3c9f3a7c09f9"}, + {file = "numpy-2.0.2-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c1c9307701fec8f3f7a1e6711f9089c06e6284b3afbbcd259f7791282d660a15"}, + {file = "numpy-2.0.2-cp311-cp311-win32.whl", hash = "sha256:a392a68bd329eafac5817e5aefeb39038c48b671afd242710b451e76090e81f4"}, + {file = "numpy-2.0.2-cp311-cp311-win_amd64.whl", hash = "sha256:286cd40ce2b7d652a6f22efdfc6d1edf879440e53e76a75955bc0c826c7e64dc"}, + {file = "numpy-2.0.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:df55d490dea7934f330006d0f81e8551ba6010a5bf035a249ef61a94f21c500b"}, + {file = "numpy-2.0.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8df823f570d9adf0978347d1f926b2a867d5608f434a7cff7f7908c6570dcf5e"}, + {file = "numpy-2.0.2-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:9a92ae5c14811e390f3767053ff54eaee3bf84576d99a2456391401323f4ec2c"}, + {file = "numpy-2.0.2-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:a842d573724391493a97a62ebbb8e731f8a5dcc5d285dfc99141ca15a3302d0c"}, + {file = "numpy-2.0.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c05e238064fc0610c840d1cf6a13bf63d7e391717d247f1bf0318172e759e692"}, + {file = "numpy-2.0.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0123ffdaa88fa4ab64835dcbde75dcdf89c453c922f18dced6e27c90d1d0ec5a"}, + {file = "numpy-2.0.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:96a55f64139912d61de9137f11bf39a55ec8faec288c75a54f93dfd39f7eb40c"}, + {file = "numpy-2.0.2-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ec9852fb39354b5a45a80bdab5ac02dd02b15f44b3804e9f00c556bf24b4bded"}, + {file = "numpy-2.0.2-cp312-cp312-win32.whl", hash = "sha256:671bec6496f83202ed2d3c8fdc486a8fc86942f2e69ff0e986140339a63bcbe5"}, + {file = "numpy-2.0.2-cp312-cp312-win_amd64.whl", hash = "sha256:cfd41e13fdc257aa5778496b8caa5e856dc4896d4ccf01841daee1d96465467a"}, + {file = "numpy-2.0.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9059e10581ce4093f735ed23f3b9d283b9d517ff46009ddd485f1747eb22653c"}, + {file = "numpy-2.0.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:423e89b23490805d2a5a96fe40ec507407b8ee786d66f7328be214f9679df6dd"}, + {file = "numpy-2.0.2-cp39-cp39-macosx_14_0_arm64.whl", hash = "sha256:2b2955fa6f11907cf7a70dab0d0755159bca87755e831e47932367fc8f2f2d0b"}, + {file = "numpy-2.0.2-cp39-cp39-macosx_14_0_x86_64.whl", hash = "sha256:97032a27bd9d8988b9a97a8c4d2c9f2c15a81f61e2f21404d7e8ef00cb5be729"}, + {file = "numpy-2.0.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1e795a8be3ddbac43274f18588329c72939870a16cae810c2b73461c40718ab1"}, + {file = "numpy-2.0.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f26b258c385842546006213344c50655ff1555a9338e2e5e02a0756dc3e803dd"}, + {file = "numpy-2.0.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5fec9451a7789926bcf7c2b8d187292c9f93ea30284802a0ab3f5be8ab36865d"}, + {file = "numpy-2.0.2-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:9189427407d88ff25ecf8f12469d4d39d35bee1db5d39fc5c168c6f088a6956d"}, + {file = "numpy-2.0.2-cp39-cp39-win32.whl", hash = "sha256:905d16e0c60200656500c95b6b8dca5d109e23cb24abc701d41c02d74c6b3afa"}, + {file = "numpy-2.0.2-cp39-cp39-win_amd64.whl", hash = "sha256:a3f4ab0caa7f053f6797fcd4e1e25caee367db3112ef2b6ef82d749530768c73"}, + {file = "numpy-2.0.2-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:7f0a0c6f12e07fa94133c8a67404322845220c06a9e80e85999afe727f7438b8"}, + {file = "numpy-2.0.2-pp39-pypy39_pp73-macosx_14_0_x86_64.whl", hash = "sha256:312950fdd060354350ed123c0e25a71327d3711584beaef30cdaa93320c392d4"}, + {file = "numpy-2.0.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:26df23238872200f63518dd2aa984cfca675d82469535dc7162dc2ee52d9dd5c"}, + {file = "numpy-2.0.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:a46288ec55ebbd58947d31d72be2c63cbf839f0a63b49cb755022310792a3385"}, + {file = "numpy-2.0.2.tar.gz", hash = "sha256:883c987dee1880e2a864ab0dc9892292582510604156762362d9326444636e78"}, +] + +[[package]] +name = "numpy" +version = "2.1.1" +description = "Fundamental package for array computing in Python" +optional = false +python-versions = ">=3.10" +files = [ + {file = "numpy-2.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:c8a0e34993b510fc19b9a2ce7f31cb8e94ecf6e924a40c0c9dd4f62d0aac47d9"}, + {file = "numpy-2.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:7dd86dfaf7c900c0bbdcb8b16e2f6ddf1eb1fe39c6c8cca6e94844ed3152a8fd"}, + {file = "numpy-2.1.1-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:5889dd24f03ca5a5b1e8a90a33b5a0846d8977565e4ae003a63d22ecddf6782f"}, + {file = "numpy-2.1.1-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:59ca673ad11d4b84ceb385290ed0ebe60266e356641428c845b39cd9df6713ab"}, + {file = "numpy-2.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:13ce49a34c44b6de5241f0b38b07e44c1b2dcacd9e36c30f9c2fcb1bb5135db7"}, + {file = "numpy-2.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:913cc1d311060b1d409e609947fa1b9753701dac96e6581b58afc36b7ee35af6"}, + {file = "numpy-2.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:caf5d284ddea7462c32b8d4a6b8af030b6c9fd5332afb70e7414d7fdded4bfd0"}, + {file = "numpy-2.1.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:57eb525e7c2a8fdee02d731f647146ff54ea8c973364f3b850069ffb42799647"}, + {file = "numpy-2.1.1-cp310-cp310-win32.whl", hash = "sha256:9a8e06c7a980869ea67bbf551283bbed2856915f0a792dc32dd0f9dd2fb56728"}, + {file = "numpy-2.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:d10c39947a2d351d6d466b4ae83dad4c37cd6c3cdd6d5d0fa797da56f710a6ae"}, + {file = "numpy-2.1.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0d07841fd284718feffe7dd17a63a2e6c78679b2d386d3e82f44f0108c905550"}, + {file = "numpy-2.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:b5613cfeb1adfe791e8e681128f5f49f22f3fcaa942255a6124d58ca59d9528f"}, + {file = "numpy-2.1.1-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:0b8cc2715a84b7c3b161f9ebbd942740aaed913584cae9cdc7f8ad5ad41943d0"}, + {file = "numpy-2.1.1-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:b49742cdb85f1f81e4dc1b39dcf328244f4d8d1ded95dea725b316bd2cf18c95"}, + {file = "numpy-2.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e8d5f8a8e3bc87334f025194c6193e408903d21ebaeb10952264943a985066ca"}, + {file = "numpy-2.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d51fc141ddbe3f919e91a096ec739f49d686df8af254b2053ba21a910ae518bf"}, + {file = "numpy-2.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:98ce7fb5b8063cfdd86596b9c762bf2b5e35a2cdd7e967494ab78a1fa7f8b86e"}, + {file = "numpy-2.1.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:24c2ad697bd8593887b019817ddd9974a7f429c14a5469d7fad413f28340a6d2"}, + {file = "numpy-2.1.1-cp311-cp311-win32.whl", hash = "sha256:397bc5ce62d3fb73f304bec332171535c187e0643e176a6e9421a6e3eacef06d"}, + {file = "numpy-2.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:ae8ce252404cdd4de56dcfce8b11eac3c594a9c16c231d081fb705cf23bd4d9e"}, + {file = "numpy-2.1.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:7c803b7934a7f59563db459292e6aa078bb38b7ab1446ca38dd138646a38203e"}, + {file = "numpy-2.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6435c48250c12f001920f0751fe50c0348f5f240852cfddc5e2f97e007544cbe"}, + {file = "numpy-2.1.1-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:3269c9eb8745e8d975980b3a7411a98976824e1fdef11f0aacf76147f662b15f"}, + {file = "numpy-2.1.1-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:fac6e277a41163d27dfab5f4ec1f7a83fac94e170665a4a50191b545721c6521"}, + {file = "numpy-2.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fcd8f556cdc8cfe35e70efb92463082b7f43dd7e547eb071ffc36abc0ca4699b"}, + {file = "numpy-2.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2b9cd92c8f8e7b313b80e93cedc12c0112088541dcedd9197b5dee3738c1201"}, + {file = "numpy-2.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:afd9c680df4de71cd58582b51e88a61feed4abcc7530bcd3d48483f20fc76f2a"}, + {file = "numpy-2.1.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8661c94e3aad18e1ea17a11f60f843a4933ccaf1a25a7c6a9182af70610b2313"}, + {file = "numpy-2.1.1-cp312-cp312-win32.whl", hash = "sha256:950802d17a33c07cba7fd7c3dcfa7d64705509206be1606f196d179e539111ed"}, + {file = "numpy-2.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:3fc5eabfc720db95d68e6646e88f8b399bfedd235994016351b1d9e062c4b270"}, + {file = "numpy-2.1.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:046356b19d7ad1890c751b99acad5e82dc4a02232013bd9a9a712fddf8eb60f5"}, + {file = "numpy-2.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6e5a9cb2be39350ae6c8f79410744e80154df658d5bea06e06e0ac5bb75480d5"}, + {file = "numpy-2.1.1-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:d4c57b68c8ef5e1ebf47238e99bf27657511ec3f071c465f6b1bccbef12d4136"}, + {file = "numpy-2.1.1-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:8ae0fd135e0b157365ac7cc31fff27f07a5572bdfc38f9c2d43b2aff416cc8b0"}, + {file = "numpy-2.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:981707f6b31b59c0c24bcda52e5605f9701cb46da4b86c2e8023656ad3e833cb"}, + {file = "numpy-2.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ca4b53e1e0b279142113b8c5eb7d7a877e967c306edc34f3b58e9be12fda8df"}, + {file = "numpy-2.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:e097507396c0be4e547ff15b13dc3866f45f3680f789c1a1301b07dadd3fbc78"}, + {file = "numpy-2.1.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7506387e191fe8cdb267f912469a3cccc538ab108471291636a96a54e599556"}, + {file = "numpy-2.1.1-cp313-cp313-win32.whl", hash = "sha256:251105b7c42abe40e3a689881e1793370cc9724ad50d64b30b358bbb3a97553b"}, + {file = "numpy-2.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:f212d4f46b67ff604d11fff7cc62d36b3e8714edf68e44e9760e19be38c03eb0"}, + {file = "numpy-2.1.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:920b0911bb2e4414c50e55bd658baeb78281a47feeb064ab40c2b66ecba85553"}, + {file = "numpy-2.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:bab7c09454460a487e631ffc0c42057e3d8f2a9ddccd1e60c7bb8ed774992480"}, + {file = "numpy-2.1.1-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:cea427d1350f3fd0d2818ce7350095c1a2ee33e30961d2f0fef48576ddbbe90f"}, + {file = "numpy-2.1.1-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:e30356d530528a42eeba51420ae8bf6c6c09559051887196599d96ee5f536468"}, + {file = "numpy-2.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e8dfa9e94fc127c40979c3eacbae1e61fda4fe71d84869cc129e2721973231ef"}, + {file = "numpy-2.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:910b47a6d0635ec1bd53b88f86120a52bf56dcc27b51f18c7b4a2e2224c29f0f"}, + {file = "numpy-2.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:13cc11c00000848702322af4de0147ced365c81d66053a67c2e962a485b3717c"}, + {file = "numpy-2.1.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:53e27293b3a2b661c03f79aa51c3987492bd4641ef933e366e0f9f6c9bf257ec"}, + {file = "numpy-2.1.1-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:7be6a07520b88214ea85d8ac8b7d6d8a1839b0b5cb87412ac9f49fa934eb15d5"}, + {file = "numpy-2.1.1-pp310-pypy310_pp73-macosx_14_0_x86_64.whl", hash = "sha256:52ac2e48f5ad847cd43c4755520a2317f3380213493b9d8a4c5e37f3b87df504"}, + {file = "numpy-2.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:50a95ca3560a6058d6ea91d4629a83a897ee27c00630aed9d933dff191f170cd"}, + {file = "numpy-2.1.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:99f4a9ee60eed1385a86e82288971a51e71df052ed0b2900ed30bc840c0f2e39"}, + {file = "numpy-2.1.1.tar.gz", hash = "sha256:d0cf7d55b1051387807405b3898efafa862997b4cba8aa5dbe657be794afeafd"}, +] + +[[package]] +name = "openbb-core" +version = "1.3.4" +description = "OpenBB package with core functionality." +optional = false +python-versions = "<4.0,>=3.9" +files = [ + {file = "openbb_core-1.3.4-py3-none-any.whl", hash = "sha256:890ae2f6c1d89fef34c595e9326715cadbcfd4bc4acbe9ef9d13074871f32d63"}, + {file = "openbb_core-1.3.4.tar.gz", hash = "sha256:c23207bdfc4be4cc4b25763802da1d91a2b3fe28e3339d20b685ef0a35df3820"}, +] + +[package.dependencies] +aiohttp = ">=3.10.4,<4.0.0" +fastapi = ">=0.111.0,<0.112.0" +html5lib = ">=1.1,<2.0" +importlib-metadata = ">=6.8.0,<7.0.0" +pandas = ">=1.5.3" +posthog = ">=3.3.1,<4.0.0" +pydantic = ">=2.5.1,<3.0.0" +pyjwt = ">=2.8.0,<3.0.0" +python-dotenv = ">=1.0.0,<2.0.0" +python-multipart = ">=0.0.7,<0.0.8" +requests = ">=2.32.1,<3.0.0" +ruff = ">=0.4.10" +uuid7 = ">=0.1.0,<0.2.0" +uvicorn = ">=0.24,<0.25" +websockets = ">=12.0,<13.0" + +[[package]] +name = "orderly-set" +version = "5.2.2" +description = "Orderly set" +optional = false +python-versions = ">=3.8" +files = [ + {file = "orderly_set-5.2.2-py3-none-any.whl", hash = "sha256:f7a37c95a38c01cdfe41c3ffb62925a318a2286ea0a41790c057fc802aec54da"}, + {file = "orderly_set-5.2.2.tar.gz", hash = "sha256:52a18b86aaf3f5d5a498bbdb27bf3253a4e5c57ab38e5b7a56fa00115cd28448"}, +] + +[[package]] +name = "packaging" +version = "24.1" +description = "Core utilities for Python packages" +optional = false +python-versions = ">=3.8" +files = [ + {file = "packaging-24.1-py3-none-any.whl", hash = "sha256:5b8f2217dbdbd2f7f384c41c628544e6d52f2d0f53c6d0c3ea61aa5d1d7ff124"}, + {file = "packaging-24.1.tar.gz", hash = "sha256:026ed72c8ed3fcce5bf8950572258698927fd1dbda10a5e981cdf0ac37f4f002"}, +] + +[[package]] +name = "pandas" +version = "2.2.3" +description = "Powerful data structures for data analysis, time series, and statistics" +optional = false +python-versions = ">=3.9" +files = [ + {file = "pandas-2.2.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:1948ddde24197a0f7add2bdc4ca83bf2b1ef84a1bc8ccffd95eda17fd836ecb5"}, + {file = "pandas-2.2.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:381175499d3802cde0eabbaf6324cce0c4f5d52ca6f8c377c29ad442f50f6348"}, + {file = "pandas-2.2.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d9c45366def9a3dd85a6454c0e7908f2b3b8e9c138f5dc38fed7ce720d8453ed"}, + {file = "pandas-2.2.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:86976a1c5b25ae3f8ccae3a5306e443569ee3c3faf444dfd0f41cda24667ad57"}, + {file = "pandas-2.2.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b8661b0238a69d7aafe156b7fa86c44b881387509653fdf857bebc5e4008ad42"}, + {file = "pandas-2.2.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:37e0aced3e8f539eccf2e099f65cdb9c8aa85109b0be6e93e2baff94264bdc6f"}, + {file = "pandas-2.2.3-cp310-cp310-win_amd64.whl", hash = "sha256:56534ce0746a58afaf7942ba4863e0ef81c9c50d3f0ae93e9497d6a41a057645"}, + {file = "pandas-2.2.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:66108071e1b935240e74525006034333f98bcdb87ea116de573a6a0dccb6c039"}, + {file = "pandas-2.2.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7c2875855b0ff77b2a64a0365e24455d9990730d6431b9e0ee18ad8acee13dbd"}, + {file = "pandas-2.2.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:cd8d0c3be0515c12fed0bdbae072551c8b54b7192c7b1fda0ba56059a0179698"}, + {file = "pandas-2.2.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c124333816c3a9b03fbeef3a9f230ba9a737e9e5bb4060aa2107a86cc0a497fc"}, + {file = "pandas-2.2.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:63cc132e40a2e084cf01adf0775b15ac515ba905d7dcca47e9a251819c575ef3"}, + {file = "pandas-2.2.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:29401dbfa9ad77319367d36940cd8a0b3a11aba16063e39632d98b0e931ddf32"}, + {file = "pandas-2.2.3-cp311-cp311-win_amd64.whl", hash = "sha256:3fc6873a41186404dad67245896a6e440baacc92f5b716ccd1bc9ed2995ab2c5"}, + {file = "pandas-2.2.3-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:b1d432e8d08679a40e2a6d8b2f9770a5c21793a6f9f47fdd52c5ce1948a5a8a9"}, + {file = "pandas-2.2.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:a5a1595fe639f5988ba6a8e5bc9649af3baf26df3998a0abe56c02609392e0a4"}, + {file = "pandas-2.2.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5de54125a92bb4d1c051c0659e6fcb75256bf799a732a87184e5ea503965bce3"}, + {file = "pandas-2.2.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fffb8ae78d8af97f849404f21411c95062db1496aeb3e56f146f0355c9989319"}, + {file = "pandas-2.2.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6dfcb5ee8d4d50c06a51c2fffa6cff6272098ad6540aed1a76d15fb9318194d8"}, + {file = "pandas-2.2.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:062309c1b9ea12a50e8ce661145c6aab431b1e99530d3cd60640e255778bd43a"}, + {file = "pandas-2.2.3-cp312-cp312-win_amd64.whl", hash = "sha256:59ef3764d0fe818125a5097d2ae867ca3fa64df032331b7e0917cf5d7bf66b13"}, + {file = "pandas-2.2.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f00d1345d84d8c86a63e476bb4955e46458b304b9575dcf71102b5c705320015"}, + {file = "pandas-2.2.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:3508d914817e153ad359d7e069d752cdd736a247c322d932eb89e6bc84217f28"}, + {file = "pandas-2.2.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:22a9d949bfc9a502d320aa04e5d02feab689d61da4e7764b62c30b991c42c5f0"}, + {file = "pandas-2.2.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f3a255b2c19987fbbe62a9dfd6cff7ff2aa9ccab3fc75218fd4b7530f01efa24"}, + {file = "pandas-2.2.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:800250ecdadb6d9c78eae4990da62743b857b470883fa27f652db8bdde7f6659"}, + {file = "pandas-2.2.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6374c452ff3ec675a8f46fd9ab25c4ad0ba590b71cf0656f8b6daa5202bca3fb"}, + {file = "pandas-2.2.3-cp313-cp313-win_amd64.whl", hash = "sha256:61c5ad4043f791b61dd4752191d9f07f0ae412515d59ba8f005832a532f8736d"}, + {file = "pandas-2.2.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:3b71f27954685ee685317063bf13c7709a7ba74fc996b84fc6821c59b0f06468"}, + {file = "pandas-2.2.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:38cf8125c40dae9d5acc10fa66af8ea6fdf760b2714ee482ca691fc66e6fcb18"}, + {file = "pandas-2.2.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ba96630bc17c875161df3818780af30e43be9b166ce51c9a18c1feae342906c2"}, + {file = "pandas-2.2.3-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db71525a1538b30142094edb9adc10be3f3e176748cd7acc2240c2f2e5aa3a4"}, + {file = "pandas-2.2.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:15c0e1e02e93116177d29ff83e8b1619c93ddc9c49083f237d4312337a61165d"}, + {file = "pandas-2.2.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:ad5b65698ab28ed8d7f18790a0dc58005c7629f227be9ecc1072aa74c0c1d43a"}, + {file = "pandas-2.2.3-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bc6b93f9b966093cb0fd62ff1a7e4c09e6d546ad7c1de191767baffc57628f39"}, + {file = "pandas-2.2.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:5dbca4c1acd72e8eeef4753eeca07de9b1db4f398669d5994086f788a5d7cc30"}, + {file = "pandas-2.2.3-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:8cd6d7cc958a3910f934ea8dbdf17b2364827bb4dafc38ce6eef6bb3d65ff09c"}, + {file = "pandas-2.2.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:99df71520d25fade9db7c1076ac94eb994f4d2673ef2aa2e86ee039b6746d20c"}, + {file = "pandas-2.2.3-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:31d0ced62d4ea3e231a9f228366919a5ea0b07440d9d4dac345376fd8e1477ea"}, + {file = "pandas-2.2.3-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:7eee9e7cea6adf3e3d24e304ac6b8300646e2a5d1cd3a3c2abed9101b0846761"}, + {file = "pandas-2.2.3-cp39-cp39-win_amd64.whl", hash = "sha256:4850ba03528b6dd51d6c5d273c46f183f39a9baf3f0143e566b89450965b105e"}, + {file = "pandas-2.2.3.tar.gz", hash = "sha256:4f18ba62b61d7e192368b84517265a99b4d7ee8912f8708660fb4a366cc82667"}, +] + +[package.dependencies] +numpy = [ + {version = ">=1.22.4", markers = "python_version < \"3.11\""}, + {version = ">=1.23.2", markers = "python_version == \"3.11\""}, + {version = ">=1.26.0", markers = "python_version >= \"3.12\""}, +] +python-dateutil = ">=2.8.2" +pytz = ">=2020.1" +tzdata = ">=2022.7" + +[package.extras] +all = ["PyQt5 (>=5.15.9)", "SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "adbc-driver-sqlite (>=0.8.0)", "beautifulsoup4 (>=4.11.2)", "bottleneck (>=1.3.6)", "dataframe-api-compat (>=0.1.7)", "fastparquet (>=2022.12.0)", "fsspec (>=2022.11.0)", "gcsfs (>=2022.11.0)", "html5lib (>=1.1)", "hypothesis (>=6.46.1)", "jinja2 (>=3.1.2)", "lxml (>=4.9.2)", "matplotlib (>=3.6.3)", "numba (>=0.56.4)", "numexpr (>=2.8.4)", "odfpy (>=1.4.1)", "openpyxl (>=3.1.0)", "pandas-gbq (>=0.19.0)", "psycopg2 (>=2.9.6)", "pyarrow (>=10.0.1)", "pymysql (>=1.0.2)", "pyreadstat (>=1.2.0)", "pytest (>=7.3.2)", "pytest-xdist (>=2.2.0)", "python-calamine (>=0.1.7)", "pyxlsb (>=1.0.10)", "qtpy (>=2.3.0)", "s3fs (>=2022.11.0)", "scipy (>=1.10.0)", "tables (>=3.8.0)", "tabulate (>=0.9.0)", "xarray (>=2022.12.0)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.0.5)", "zstandard (>=0.19.0)"] +aws = ["s3fs (>=2022.11.0)"] +clipboard = ["PyQt5 (>=5.15.9)", "qtpy (>=2.3.0)"] +compression = ["zstandard (>=0.19.0)"] +computation = ["scipy (>=1.10.0)", "xarray (>=2022.12.0)"] +consortium-standard = ["dataframe-api-compat (>=0.1.7)"] +excel = ["odfpy (>=1.4.1)", "openpyxl (>=3.1.0)", "python-calamine (>=0.1.7)", "pyxlsb (>=1.0.10)", "xlrd (>=2.0.1)", "xlsxwriter (>=3.0.5)"] +feather = ["pyarrow (>=10.0.1)"] +fss = ["fsspec (>=2022.11.0)"] +gcp = ["gcsfs (>=2022.11.0)", "pandas-gbq (>=0.19.0)"] +hdf5 = ["tables (>=3.8.0)"] +html = ["beautifulsoup4 (>=4.11.2)", "html5lib (>=1.1)", "lxml (>=4.9.2)"] +mysql = ["SQLAlchemy (>=2.0.0)", "pymysql (>=1.0.2)"] +output-formatting = ["jinja2 (>=3.1.2)", "tabulate (>=0.9.0)"] +parquet = ["pyarrow (>=10.0.1)"] +performance = ["bottleneck (>=1.3.6)", "numba (>=0.56.4)", "numexpr (>=2.8.4)"] +plot = ["matplotlib (>=3.6.3)"] +postgresql = ["SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "psycopg2 (>=2.9.6)"] +pyarrow = ["pyarrow (>=10.0.1)"] +spss = ["pyreadstat (>=1.2.0)"] +sql-other = ["SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "adbc-driver-sqlite (>=0.8.0)"] +test = ["hypothesis (>=6.46.1)", "pytest (>=7.3.2)", "pytest-xdist (>=2.2.0)"] +xml = ["lxml (>=4.9.2)"] + +[[package]] +name = "pathspec" +version = "0.12.1" +description = "Utility library for gitignore style pattern matching of file paths." +optional = false +python-versions = ">=3.8" +files = [ + {file = "pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08"}, + {file = "pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712"}, +] + +[[package]] +name = "pexpect" +version = "4.9.0" +description = "Pexpect allows easy control of interactive console applications." +optional = false +python-versions = "*" +files = [ + {file = "pexpect-4.9.0-py2.py3-none-any.whl", hash = "sha256:7236d1e080e4936be2dc3e326cec0af72acf9212a7e1d060210e70a47e253523"}, + {file = "pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f"}, +] + +[package.dependencies] +ptyprocess = ">=0.5" + +[[package]] +name = "pkginfo" +version = "1.11.1" +description = "Query metadata from sdists / bdists / installed packages." +optional = false +python-versions = ">=3.8" +files = [ + {file = "pkginfo-1.11.1-py3-none-any.whl", hash = "sha256:bfa76a714fdfc18a045fcd684dbfc3816b603d9d075febef17cb6582bea29573"}, + {file = "pkginfo-1.11.1.tar.gz", hash = "sha256:2e0dca1cf4c8e39644eed32408ea9966ee15e0d324c62ba899a393b3c6b467aa"}, +] + +[package.extras] +testing = ["pytest", "pytest-cov", "wheel"] + +[[package]] +name = "platformdirs" +version = "4.3.6" +description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`." +optional = false +python-versions = ">=3.8" +files = [ + {file = "platformdirs-4.3.6-py3-none-any.whl", hash = "sha256:73e575e1408ab8103900836b97580d5307456908a03e92031bab39e4554cc3fb"}, + {file = "platformdirs-4.3.6.tar.gz", hash = "sha256:357fb2acbc885b0419afd3ce3ed34564c13c9b95c89360cd9563f73aa5e2b907"}, +] + +[package.extras] +docs = ["furo (>=2024.8.6)", "proselint (>=0.14)", "sphinx (>=8.0.2)", "sphinx-autodoc-typehints (>=2.4)"] +test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=8.3.2)", "pytest-cov (>=5)", "pytest-mock (>=3.14)"] +type = ["mypy (>=1.11.2)"] + +[[package]] +name = "poetry" +version = "1.8.3" +description = "Python dependency management and packaging made easy." +optional = false +python-versions = "<4.0,>=3.8" +files = [ + {file = "poetry-1.8.3-py3-none-any.whl", hash = "sha256:88191c69b08d06f9db671b793d68f40048e8904c0718404b63dcc2b5aec62d13"}, + {file = "poetry-1.8.3.tar.gz", hash = "sha256:67f4eb68288eab41e841cc71a00d26cf6bdda9533022d0189a145a34d0a35f48"}, +] + +[package.dependencies] +build = ">=1.0.3,<2.0.0" +cachecontrol = {version = ">=0.14.0,<0.15.0", extras = ["filecache"]} +cleo = ">=2.1.0,<3.0.0" +crashtest = ">=0.4.1,<0.5.0" +dulwich = ">=0.21.2,<0.22.0" +fastjsonschema = ">=2.18.0,<3.0.0" +importlib-metadata = {version = ">=4.4", markers = "python_version < \"3.10\""} +installer = ">=0.7.0,<0.8.0" +keyring = ">=24.0.0,<25.0.0" +packaging = ">=23.1" +pexpect = ">=4.7.0,<5.0.0" +pkginfo = ">=1.10,<2.0" +platformdirs = ">=3.0.0,<5" +poetry-core = "1.9.0" +poetry-plugin-export = ">=1.6.0,<2.0.0" +pyproject-hooks = ">=1.0.0,<2.0.0" +requests = ">=2.26,<3.0" +requests-toolbelt = ">=1.0.0,<2.0.0" +shellingham = ">=1.5,<2.0" +tomli = {version = ">=2.0.1,<3.0.0", markers = "python_version < \"3.11\""} +tomlkit = ">=0.11.4,<1.0.0" +trove-classifiers = ">=2022.5.19" +virtualenv = ">=20.23.0,<21.0.0" +xattr = {version = ">=1.0.0,<2.0.0", markers = "sys_platform == \"darwin\""} + +[[package]] +name = "poetry-core" +version = "1.9.0" +description = "Poetry PEP 517 Build Backend" +optional = false +python-versions = ">=3.8,<4.0" +files = [ + {file = "poetry_core-1.9.0-py3-none-any.whl", hash = "sha256:4e0c9c6ad8cf89956f03b308736d84ea6ddb44089d16f2adc94050108ec1f5a1"}, + {file = "poetry_core-1.9.0.tar.gz", hash = "sha256:fa7a4001eae8aa572ee84f35feb510b321bd652e5cf9293249d62853e1f935a2"}, +] + +[[package]] +name = "poetry-plugin-export" +version = "1.8.0" +description = "Poetry plugin to export the dependencies to various formats" +optional = false +python-versions = "<4.0,>=3.8" +files = [ + {file = "poetry_plugin_export-1.8.0-py3-none-any.whl", hash = "sha256:adbe232cfa0cc04991ea3680c865cf748bff27593b9abcb1f35fb50ed7ba2c22"}, + {file = "poetry_plugin_export-1.8.0.tar.gz", hash = "sha256:1fa6168a85d59395d835ca564bc19862a7c76061e60c3e7dfaec70d50937fc61"}, +] + +[package.dependencies] +poetry = ">=1.8.0,<3.0.0" +poetry-core = ">=1.7.0,<3.0.0" + +[[package]] +name = "posthog" +version = "3.7.0" +description = "Integrate PostHog into any python application." +optional = false +python-versions = "*" +files = [ + {file = "posthog-3.7.0-py2.py3-none-any.whl", hash = "sha256:3555161c3a9557b5666f96d8e1f17f410ea0f07db56e399e336a1656d4e5c722"}, + {file = "posthog-3.7.0.tar.gz", hash = "sha256:b095d4354ba23f8b346ab5daed8ecfc5108772f922006982dfe8b2d29ebc6e0e"}, +] + +[package.dependencies] +backoff = ">=1.10.0" +monotonic = ">=1.5" +python-dateutil = ">2.1" +requests = ">=2.7,<3.0" +six = ">=1.5" + +[package.extras] +dev = ["black", "flake8", "flake8-print", "isort", "pre-commit"] +sentry = ["django", "sentry-sdk"] +test = ["coverage", "django", "flake8", "freezegun (==0.3.15)", "mock (>=2.0.0)", "pylint", "pytest", "pytest-timeout"] + +[[package]] +name = "ptyprocess" +version = "0.7.0" +description = "Run a subprocess in a pseudo terminal" +optional = false +python-versions = "*" +files = [ + {file = "ptyprocess-0.7.0-py2.py3-none-any.whl", hash = "sha256:4b41f3967fce3af57cc7e94b888626c18bf37a083e3651ca8feeb66d492fef35"}, + {file = "ptyprocess-0.7.0.tar.gz", hash = "sha256:5c5d0a3b48ceee0b48485e0c26037c0acd7d29765ca3fbb5cb3831d347423220"}, +] + +[[package]] +name = "pycparser" +version = "2.22" +description = "C parser in Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pycparser-2.22-py3-none-any.whl", hash = "sha256:c3702b6d3dd8c7abc1afa565d7e63d53a1d0bd86cdc24edd75470f4de499cfcc"}, + {file = "pycparser-2.22.tar.gz", hash = "sha256:491c8be9c040f5390f5bf44a5b07752bd07f56edf992381b05c701439eec10f6"}, +] + +[[package]] +name = "pydantic" +version = "2.9.2" +description = "Data validation using Python type hints" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pydantic-2.9.2-py3-none-any.whl", hash = "sha256:f048cec7b26778210e28a0459867920654d48e5e62db0958433636cde4254f12"}, + {file = "pydantic-2.9.2.tar.gz", hash = "sha256:d155cef71265d1e9807ed1c32b4c8deec042a44a50a4188b25ac67ecd81a9c0f"}, +] + +[package.dependencies] +annotated-types = ">=0.6.0" +pydantic-core = "2.23.4" +typing-extensions = {version = ">=4.6.1", markers = "python_version < \"3.13\""} + +[package.extras] +email = ["email-validator (>=2.0.0)"] +timezone = ["tzdata"] + +[[package]] +name = "pydantic-core" +version = "2.23.4" +description = "Core functionality for Pydantic validation and serialization" +optional = false +python-versions = ">=3.8" +files = [ + {file = "pydantic_core-2.23.4-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:b10bd51f823d891193d4717448fab065733958bdb6a6b351967bd349d48d5c9b"}, + {file = "pydantic_core-2.23.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4fc714bdbfb534f94034efaa6eadd74e5b93c8fa6315565a222f7b6f42ca1166"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:63e46b3169866bd62849936de036f901a9356e36376079b05efa83caeaa02ceb"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed1a53de42fbe34853ba90513cea21673481cd81ed1be739f7f2efb931b24916"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:cfdd16ab5e59fc31b5e906d1a3f666571abc367598e3e02c83403acabc092e07"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:255a8ef062cbf6674450e668482456abac99a5583bbafb73f9ad469540a3a232"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4a7cd62e831afe623fbb7aabbb4fe583212115b3ef38a9f6b71869ba644624a2"}, + {file = "pydantic_core-2.23.4-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f09e2ff1f17c2b51f2bc76d1cc33da96298f0a036a137f5440ab3ec5360b624f"}, + {file = "pydantic_core-2.23.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:e38e63e6f3d1cec5a27e0afe90a085af8b6806ee208b33030e65b6516353f1a3"}, + {file = "pydantic_core-2.23.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:0dbd8dbed2085ed23b5c04afa29d8fd2771674223135dc9bc937f3c09284d071"}, + {file = "pydantic_core-2.23.4-cp310-none-win32.whl", hash = "sha256:6531b7ca5f951d663c339002e91aaebda765ec7d61b7d1e3991051906ddde119"}, + {file = "pydantic_core-2.23.4-cp310-none-win_amd64.whl", hash = "sha256:7c9129eb40958b3d4500fa2467e6a83356b3b61bfff1b414c7361d9220f9ae8f"}, + {file = "pydantic_core-2.23.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:77733e3892bb0a7fa797826361ce8a9184d25c8dffaec60b7ffe928153680ba8"}, + {file = "pydantic_core-2.23.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1b84d168f6c48fabd1f2027a3d1bdfe62f92cade1fb273a5d68e621da0e44e6d"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:df49e7a0861a8c36d089c1ed57d308623d60416dab2647a4a17fe050ba85de0e"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ff02b6d461a6de369f07ec15e465a88895f3223eb75073ffea56b84d9331f607"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:996a38a83508c54c78a5f41456b0103c30508fed9abcad0a59b876d7398f25fd"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d97683ddee4723ae8c95d1eddac7c192e8c552da0c73a925a89fa8649bf13eea"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:216f9b2d7713eb98cb83c80b9c794de1f6b7e3145eef40400c62e86cee5f4e1e"}, + {file = "pydantic_core-2.23.4-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6f783e0ec4803c787bcea93e13e9932edab72068f68ecffdf86a99fd5918878b"}, + {file = "pydantic_core-2.23.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:d0776dea117cf5272382634bd2a5c1b6eb16767c223c6a5317cd3e2a757c61a0"}, + {file = "pydantic_core-2.23.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d5f7a395a8cf1621939692dba2a6b6a830efa6b3cee787d82c7de1ad2930de64"}, + {file = "pydantic_core-2.23.4-cp311-none-win32.whl", hash = "sha256:74b9127ffea03643e998e0c5ad9bd3811d3dac8c676e47db17b0ee7c3c3bf35f"}, + {file = "pydantic_core-2.23.4-cp311-none-win_amd64.whl", hash = "sha256:98d134c954828488b153d88ba1f34e14259284f256180ce659e8d83e9c05eaa3"}, + {file = "pydantic_core-2.23.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f3e0da4ebaef65158d4dfd7d3678aad692f7666877df0002b8a522cdf088f231"}, + {file = "pydantic_core-2.23.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f69a8e0b033b747bb3e36a44e7732f0c99f7edd5cea723d45bc0d6e95377ffee"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:723314c1d51722ab28bfcd5240d858512ffd3116449c557a1336cbe3919beb87"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bb2802e667b7051a1bebbfe93684841cc9351004e2badbd6411bf357ab8d5ac8"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d18ca8148bebe1b0a382a27a8ee60350091a6ddaf475fa05ef50dc35b5df6327"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:33e3d65a85a2a4a0dc3b092b938a4062b1a05f3a9abde65ea93b233bca0e03f2"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:128585782e5bfa515c590ccee4b727fb76925dd04a98864182b22e89a4e6ed36"}, + {file = "pydantic_core-2.23.4-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:68665f4c17edcceecc112dfed5dbe6f92261fb9d6054b47d01bf6371a6196126"}, + {file = "pydantic_core-2.23.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:20152074317d9bed6b7a95ade3b7d6054845d70584216160860425f4fbd5ee9e"}, + {file = "pydantic_core-2.23.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:9261d3ce84fa1d38ed649c3638feefeae23d32ba9182963e465d58d62203bd24"}, + {file = "pydantic_core-2.23.4-cp312-none-win32.whl", hash = "sha256:4ba762ed58e8d68657fc1281e9bb72e1c3e79cc5d464be146e260c541ec12d84"}, + {file = "pydantic_core-2.23.4-cp312-none-win_amd64.whl", hash = "sha256:97df63000f4fea395b2824da80e169731088656d1818a11b95f3b173747b6cd9"}, + {file = "pydantic_core-2.23.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:7530e201d10d7d14abce4fb54cfe5b94a0aefc87da539d0346a484ead376c3cc"}, + {file = "pydantic_core-2.23.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:df933278128ea1cd77772673c73954e53a1c95a4fdf41eef97c2b779271bd0bd"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cb3da3fd1b6a5d0279a01877713dbda118a2a4fc6f0d821a57da2e464793f05"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:42c6dcb030aefb668a2b7009c85b27f90e51e6a3b4d5c9bc4c57631292015b0d"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:696dd8d674d6ce621ab9d45b205df149399e4bb9aa34102c970b721554828510"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2971bb5ffe72cc0f555c13e19b23c85b654dd2a8f7ab493c262071377bfce9f6"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8394d940e5d400d04cad4f75c0598665cbb81aecefaca82ca85bd28264af7f9b"}, + {file = "pydantic_core-2.23.4-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:0dff76e0602ca7d4cdaacc1ac4c005e0ce0dcfe095d5b5259163a80d3a10d327"}, + {file = "pydantic_core-2.23.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:7d32706badfe136888bdea71c0def994644e09fff0bfe47441deaed8e96fdbc6"}, + {file = "pydantic_core-2.23.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:ed541d70698978a20eb63d8c5d72f2cc6d7079d9d90f6b50bad07826f1320f5f"}, + {file = "pydantic_core-2.23.4-cp313-none-win32.whl", hash = "sha256:3d5639516376dce1940ea36edf408c554475369f5da2abd45d44621cb616f769"}, + {file = "pydantic_core-2.23.4-cp313-none-win_amd64.whl", hash = "sha256:5a1504ad17ba4210df3a045132a7baeeba5a200e930f57512ee02909fc5c4cb5"}, + {file = "pydantic_core-2.23.4-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:d4488a93b071c04dc20f5cecc3631fc78b9789dd72483ba15d423b5b3689b555"}, + {file = "pydantic_core-2.23.4-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:81965a16b675b35e1d09dd14df53f190f9129c0202356ed44ab2728b1c905658"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4ffa2ebd4c8530079140dd2d7f794a9d9a73cbb8e9d59ffe24c63436efa8f271"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:61817945f2fe7d166e75fbfb28004034b48e44878177fc54d81688e7b85a3665"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:29d2c342c4bc01b88402d60189f3df065fb0dda3654744d5a165a5288a657368"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5e11661ce0fd30a6790e8bcdf263b9ec5988e95e63cf901972107efc49218b13"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9d18368b137c6295db49ce7218b1a9ba15c5bc254c96d7c9f9e924a9bc7825ad"}, + {file = "pydantic_core-2.23.4-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ec4e55f79b1c4ffb2eecd8a0cfba9955a2588497d96851f4c8f99aa4a1d39b12"}, + {file = "pydantic_core-2.23.4-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:374a5e5049eda9e0a44c696c7ade3ff355f06b1fe0bb945ea3cac2bc336478a2"}, + {file = "pydantic_core-2.23.4-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:5c364564d17da23db1106787675fc7af45f2f7b58b4173bfdd105564e132e6fb"}, + {file = "pydantic_core-2.23.4-cp38-none-win32.whl", hash = "sha256:d7a80d21d613eec45e3d41eb22f8f94ddc758a6c4720842dc74c0581f54993d6"}, + {file = "pydantic_core-2.23.4-cp38-none-win_amd64.whl", hash = "sha256:5f5ff8d839f4566a474a969508fe1c5e59c31c80d9e140566f9a37bba7b8d556"}, + {file = "pydantic_core-2.23.4-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:a4fa4fc04dff799089689f4fd502ce7d59de529fc2f40a2c8836886c03e0175a"}, + {file = "pydantic_core-2.23.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:0a7df63886be5e270da67e0966cf4afbae86069501d35c8c1b3b6c168f42cb36"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:dcedcd19a557e182628afa1d553c3895a9f825b936415d0dbd3cd0bbcfd29b4b"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5f54b118ce5de9ac21c363d9b3caa6c800341e8c47a508787e5868c6b79c9323"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:86d2f57d3e1379a9525c5ab067b27dbb8a0642fb5d454e17a9ac434f9ce523e3"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:de6d1d1b9e5101508cb37ab0d972357cac5235f5c6533d1071964c47139257df"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1278e0d324f6908e872730c9102b0112477a7f7cf88b308e4fc36ce1bdb6d58c"}, + {file = "pydantic_core-2.23.4-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:9a6b5099eeec78827553827f4c6b8615978bb4b6a88e5d9b93eddf8bb6790f55"}, + {file = "pydantic_core-2.23.4-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:e55541f756f9b3ee346b840103f32779c695a19826a4c442b7954550a0972040"}, + {file = "pydantic_core-2.23.4-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a5c7ba8ffb6d6f8f2ab08743be203654bb1aaa8c9dcb09f82ddd34eadb695605"}, + {file = "pydantic_core-2.23.4-cp39-none-win32.whl", hash = "sha256:37b0fe330e4a58d3c58b24d91d1eb102aeec675a3db4c292ec3928ecd892a9a6"}, + {file = "pydantic_core-2.23.4-cp39-none-win_amd64.whl", hash = "sha256:1498bec4c05c9c787bde9125cfdcc63a41004ff167f495063191b863399b1a29"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:f455ee30a9d61d3e1a15abd5068827773d6e4dc513e795f380cdd59932c782d5"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:1e90d2e3bd2c3863d48525d297cd143fe541be8bbf6f579504b9712cb6b643ec"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2e203fdf807ac7e12ab59ca2bfcabb38c7cf0b33c41efeb00f8e5da1d86af480"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e08277a400de01bc72436a0ccd02bdf596631411f592ad985dcee21445bd0068"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f220b0eea5965dec25480b6333c788fb72ce5f9129e8759ef876a1d805d00801"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:d06b0c8da4f16d1d1e352134427cb194a0a6e19ad5db9161bf32b2113409e728"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:ba1a0996f6c2773bd83e63f18914c1de3c9dd26d55f4ac302a7efe93fb8e7433"}, + {file = "pydantic_core-2.23.4-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:9a5bce9d23aac8f0cf0836ecfc033896aa8443b501c58d0602dbfd5bd5b37753"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:78ddaaa81421a29574a682b3179d4cf9e6d405a09b99d93ddcf7e5239c742e21"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:883a91b5dd7d26492ff2f04f40fbb652de40fcc0afe07e8129e8ae779c2110eb"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:88ad334a15b32a791ea935af224b9de1bf99bcd62fabf745d5f3442199d86d59"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:233710f069d251feb12a56da21e14cca67994eab08362207785cf8c598e74577"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:19442362866a753485ba5e4be408964644dd6a09123d9416c54cd49171f50744"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:624e278a7d29b6445e4e813af92af37820fafb6dcc55c012c834f9e26f9aaaef"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f5ef8f42bec47f21d07668a043f077d507e5bf4e668d5c6dfe6aaba89de1a5b8"}, + {file = "pydantic_core-2.23.4-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:aea443fffa9fbe3af1a9ba721a87f926fe548d32cab71d188a6ede77d0ff244e"}, + {file = "pydantic_core-2.23.4.tar.gz", hash = "sha256:2584f7cf844ac4d970fba483a717dbe10c1c1c96a969bf65d61ffe94df1b2863"}, +] + +[package.dependencies] +typing-extensions = ">=4.6.0,<4.7.0 || >4.7.0" + +[[package]] +name = "pygments" +version = "2.18.0" +description = "Pygments is a syntax highlighting package written in Python." +optional = false +python-versions = ">=3.8" +files = [ + {file = "pygments-2.18.0-py3-none-any.whl", hash = "sha256:b8e6aca0523f3ab76fee51799c488e38782ac06eafcf95e7ba832985c8e7b13a"}, + {file = "pygments-2.18.0.tar.gz", hash = "sha256:786ff802f32e91311bff3889f6e9a86e81505fe99f2735bb6d60ae0c5004f199"}, +] + +[package.extras] +windows-terminal = ["colorama (>=0.4.6)"] + +[[package]] +name = "pyjwt" +version = "2.9.0" +description = "JSON Web Token implementation in Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "PyJWT-2.9.0-py3-none-any.whl", hash = "sha256:3b02fb0f44517787776cf48f2ae25d8e14f300e6d7545a4315cee571a415e850"}, + {file = "pyjwt-2.9.0.tar.gz", hash = "sha256:7e1e5b56cc735432a7369cbfa0efe50fa113ebecdc04ae6922deba8b84582d0c"}, +] + +[package.extras] +crypto = ["cryptography (>=3.4.0)"] +dev = ["coverage[toml] (==5.0.4)", "cryptography (>=3.4.0)", "pre-commit", "pytest (>=6.0.0,<7.0.0)", "sphinx", "sphinx-rtd-theme", "zope.interface"] +docs = ["sphinx", "sphinx-rtd-theme", "zope.interface"] +tests = ["coverage[toml] (==5.0.4)", "pytest (>=6.0.0,<7.0.0)"] + +[[package]] +name = "pyproject-hooks" +version = "1.2.0" +description = "Wrappers to call pyproject.toml-based build backend hooks." +optional = false +python-versions = ">=3.7" +files = [ + {file = "pyproject_hooks-1.2.0-py3-none-any.whl", hash = "sha256:9e5c6bfa8dcc30091c74b0cf803c81fdd29d94f01992a7707bc97babb1141913"}, + {file = "pyproject_hooks-1.2.0.tar.gz", hash = "sha256:1e859bd5c40fae9448642dd871adf459e5e2084186e8d2c2a79a824c970da1f8"}, +] + +[[package]] +name = "python-dateutil" +version = "2.9.0.post0" +description = "Extensions to the standard Python datetime module" +optional = false +python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7" +files = [ + {file = "python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3"}, + {file = "python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427"}, +] + +[package.dependencies] +six = ">=1.5" + +[[package]] +name = "python-dotenv" +version = "1.0.1" +description = "Read key-value pairs from a .env file and set them as environment variables" +optional = false +python-versions = ">=3.8" +files = [ + {file = "python-dotenv-1.0.1.tar.gz", hash = "sha256:e324ee90a023d808f1959c46bcbc04446a10ced277783dc6ee09987c37ec10ca"}, + {file = "python_dotenv-1.0.1-py3-none-any.whl", hash = "sha256:f7b63ef50f1b690dddf550d03497b66d609393b40b564ed0d674909a68ebf16a"}, +] + +[package.extras] +cli = ["click (>=5.0)"] + +[[package]] +name = "python-multipart" +version = "0.0.7" +description = "A streaming multipart parser for Python" +optional = false +python-versions = ">=3.7" +files = [ + {file = "python_multipart-0.0.7-py3-none-any.whl", hash = "sha256:b1fef9a53b74c795e2347daac8c54b252d9e0df9c619712691c1cc8021bd3c49"}, + {file = "python_multipart-0.0.7.tar.gz", hash = "sha256:288a6c39b06596c1b988bb6794c6fbc80e6c369e35e5062637df256bee0c9af9"}, +] + +[package.extras] +dev = ["atomicwrites (==1.2.1)", "attrs (==19.2.0)", "coverage (==6.5.0)", "hatch", "invoke (==2.2.0)", "more-itertools (==4.3.0)", "pbr (==4.3.0)", "pluggy (==1.0.0)", "py (==1.11.0)", "pytest (==7.2.0)", "pytest-cov (==4.0.0)", "pytest-timeout (==2.1.0)", "pyyaml (==5.1)"] + +[[package]] +name = "pytz" +version = "2024.2" +description = "World timezone definitions, modern and historical" +optional = false +python-versions = "*" +files = [ + {file = "pytz-2024.2-py2.py3-none-any.whl", hash = "sha256:31c7c1817eb7fae7ca4b8c7ee50c72f93aa2dd863de768e1ef4245d426aa0725"}, + {file = "pytz-2024.2.tar.gz", hash = "sha256:2aa355083c50a0f93fa581709deac0c9ad65cca8a9e9beac660adcbd493c798a"}, +] + +[[package]] +name = "pywin32-ctypes" +version = "0.2.3" +description = "A (partial) reimplementation of pywin32 using ctypes/cffi" +optional = false +python-versions = ">=3.6" +files = [ + {file = "pywin32-ctypes-0.2.3.tar.gz", hash = "sha256:d162dc04946d704503b2edc4d55f3dba5c1d539ead017afa00142c38b9885755"}, + {file = "pywin32_ctypes-0.2.3-py3-none-any.whl", hash = "sha256:8a1513379d709975552d202d942d9837758905c8d01eb82b8bcc30918929e7b8"}, +] + +[[package]] +name = "pyyaml" +version = "6.0.2" +description = "YAML parser and emitter for Python" +optional = false +python-versions = ">=3.8" +files = [ + {file = "PyYAML-6.0.2-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:0a9a2848a5b7feac301353437eb7d5957887edbf81d56e903999a75a3d743086"}, + {file = "PyYAML-6.0.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:29717114e51c84ddfba879543fb232a6ed60086602313ca38cce623c1d62cfbf"}, + {file = "PyYAML-6.0.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8824b5a04a04a047e72eea5cec3bc266db09e35de6bdfe34c9436ac5ee27d237"}, + {file = "PyYAML-6.0.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7c36280e6fb8385e520936c3cb3b8042851904eba0e58d277dca80a5cfed590b"}, + {file = "PyYAML-6.0.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ec031d5d2feb36d1d1a24380e4db6d43695f3748343d99434e6f5f9156aaa2ed"}, + {file = "PyYAML-6.0.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:936d68689298c36b53b29f23c6dbb74de12b4ac12ca6cfe0e047bedceea56180"}, + {file = "PyYAML-6.0.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:23502f431948090f597378482b4812b0caae32c22213aecf3b55325e049a6c68"}, + {file = "PyYAML-6.0.2-cp310-cp310-win32.whl", hash = "sha256:2e99c6826ffa974fe6e27cdb5ed0021786b03fc98e5ee3c5bfe1fd5015f42b99"}, + {file = "PyYAML-6.0.2-cp310-cp310-win_amd64.whl", hash = "sha256:a4d3091415f010369ae4ed1fc6b79def9416358877534caf6a0fdd2146c87a3e"}, + {file = "PyYAML-6.0.2-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:cc1c1159b3d456576af7a3e4d1ba7e6924cb39de8f67111c735f6fc832082774"}, + {file = "PyYAML-6.0.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1e2120ef853f59c7419231f3bf4e7021f1b936f6ebd222406c3b60212205d2ee"}, + {file = "PyYAML-6.0.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5d225db5a45f21e78dd9358e58a98702a0302f2659a3c6cd320564b75b86f47c"}, + {file = "PyYAML-6.0.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5ac9328ec4831237bec75defaf839f7d4564be1e6b25ac710bd1a96321cc8317"}, + {file = "PyYAML-6.0.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3ad2a3decf9aaba3d29c8f537ac4b243e36bef957511b4766cb0057d32b0be85"}, + {file = "PyYAML-6.0.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:ff3824dc5261f50c9b0dfb3be22b4567a6f938ccce4587b38952d85fd9e9afe4"}, + {file = "PyYAML-6.0.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:797b4f722ffa07cc8d62053e4cff1486fa6dc094105d13fea7b1de7d8bf71c9e"}, + {file = "PyYAML-6.0.2-cp311-cp311-win32.whl", hash = "sha256:11d8f3dd2b9c1207dcaf2ee0bbbfd5991f571186ec9cc78427ba5bd32afae4b5"}, + {file = "PyYAML-6.0.2-cp311-cp311-win_amd64.whl", hash = "sha256:e10ce637b18caea04431ce14fabcf5c64a1c61ec9c56b071a4b7ca131ca52d44"}, + {file = "PyYAML-6.0.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:c70c95198c015b85feafc136515252a261a84561b7b1d51e3384e0655ddf25ab"}, + {file = "PyYAML-6.0.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ce826d6ef20b1bc864f0a68340c8b3287705cae2f8b4b1d932177dcc76721725"}, + {file = "PyYAML-6.0.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1f71ea527786de97d1a0cc0eacd1defc0985dcf6b3f17bb77dcfc8c34bec4dc5"}, + {file = "PyYAML-6.0.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9b22676e8097e9e22e36d6b7bda33190d0d400f345f23d4065d48f4ca7ae0425"}, + {file = "PyYAML-6.0.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:80bab7bfc629882493af4aa31a4cfa43a4c57c83813253626916b8c7ada83476"}, + {file = "PyYAML-6.0.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:0833f8694549e586547b576dcfaba4a6b55b9e96098b36cdc7ebefe667dfed48"}, + {file = "PyYAML-6.0.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8b9c7197f7cb2738065c481a0461e50ad02f18c78cd75775628afb4d7137fb3b"}, + {file = "PyYAML-6.0.2-cp312-cp312-win32.whl", hash = "sha256:ef6107725bd54b262d6dedcc2af448a266975032bc85ef0172c5f059da6325b4"}, + {file = "PyYAML-6.0.2-cp312-cp312-win_amd64.whl", hash = "sha256:7e7401d0de89a9a855c839bc697c079a4af81cf878373abd7dc625847d25cbd8"}, + {file = "PyYAML-6.0.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:efdca5630322a10774e8e98e1af481aad470dd62c3170801852d752aa7a783ba"}, + {file = "PyYAML-6.0.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:50187695423ffe49e2deacb8cd10510bc361faac997de9efef88badc3bb9e2d1"}, + {file = "PyYAML-6.0.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ffe8360bab4910ef1b9e87fb812d8bc0a308b0d0eef8c8f44e0254ab3b07133"}, + {file = "PyYAML-6.0.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:17e311b6c678207928d649faa7cb0d7b4c26a0ba73d41e99c4fff6b6c3276484"}, + {file = "PyYAML-6.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:70b189594dbe54f75ab3a1acec5f1e3faa7e8cf2f1e08d9b561cb41b845f69d5"}, + {file = "PyYAML-6.0.2-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:41e4e3953a79407c794916fa277a82531dd93aad34e29c2a514c2c0c5fe971cc"}, + {file = "PyYAML-6.0.2-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:68ccc6023a3400877818152ad9a1033e3db8625d899c72eacb5a668902e4d652"}, + {file = "PyYAML-6.0.2-cp313-cp313-win32.whl", hash = "sha256:bc2fa7c6b47d6bc618dd7fb02ef6fdedb1090ec036abab80d4681424b84c1183"}, + {file = "PyYAML-6.0.2-cp313-cp313-win_amd64.whl", hash = "sha256:8388ee1976c416731879ac16da0aff3f63b286ffdd57cdeb95f3f2e085687563"}, + {file = "PyYAML-6.0.2-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:24471b829b3bf607e04e88d79542a9d48bb037c2267d7927a874e6c205ca7e9a"}, + {file = "PyYAML-6.0.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d7fded462629cfa4b685c5416b949ebad6cec74af5e2d42905d41e257e0869f5"}, + {file = "PyYAML-6.0.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d84a1718ee396f54f3a086ea0a66d8e552b2ab2017ef8b420e92edbc841c352d"}, + {file = "PyYAML-6.0.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9056c1ecd25795207ad294bcf39f2db3d845767be0ea6e6a34d856f006006083"}, + {file = "PyYAML-6.0.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:82d09873e40955485746739bcb8b4586983670466c23382c19cffecbf1fd8706"}, + {file = "PyYAML-6.0.2-cp38-cp38-win32.whl", hash = "sha256:43fa96a3ca0d6b1812e01ced1044a003533c47f6ee8aca31724f78e93ccc089a"}, + {file = "PyYAML-6.0.2-cp38-cp38-win_amd64.whl", hash = "sha256:01179a4a8559ab5de078078f37e5c1a30d76bb88519906844fd7bdea1b7729ff"}, + {file = "PyYAML-6.0.2-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:688ba32a1cffef67fd2e9398a2efebaea461578b0923624778664cc1c914db5d"}, + {file = "PyYAML-6.0.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:a8786accb172bd8afb8be14490a16625cbc387036876ab6ba70912730faf8e1f"}, + {file = "PyYAML-6.0.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d8e03406cac8513435335dbab54c0d385e4a49e4945d2909a581c83647ca0290"}, + {file = "PyYAML-6.0.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f753120cb8181e736c57ef7636e83f31b9c0d1722c516f7e86cf15b7aa57ff12"}, + {file = "PyYAML-6.0.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3b1fdb9dc17f5a7677423d508ab4f243a726dea51fa5e70992e59a7411c89d19"}, + {file = "PyYAML-6.0.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:0b69e4ce7a131fe56b7e4d770c67429700908fc0752af059838b1cfb41960e4e"}, + {file = "PyYAML-6.0.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a9f8c2e67970f13b16084e04f134610fd1d374bf477b17ec1599185cf611d725"}, + {file = "PyYAML-6.0.2-cp39-cp39-win32.whl", hash = "sha256:6395c297d42274772abc367baaa79683958044e5d3835486c16da75d2a694631"}, + {file = "PyYAML-6.0.2-cp39-cp39-win_amd64.whl", hash = "sha256:39693e1f8320ae4f43943590b49779ffb98acb81f788220ea932a6b6c51004d8"}, + {file = "pyyaml-6.0.2.tar.gz", hash = "sha256:d584d9ec91ad65861cc08d42e834324ef890a082e591037abe114850ff7bbc3e"}, +] + +[[package]] +name = "rapidfuzz" +version = "3.10.0" +description = "rapid fuzzy string matching" +optional = false +python-versions = ">=3.9" +files = [ + {file = "rapidfuzz-3.10.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:884453860de029380dded8f3c1918af2d8eb5adf8010261645c7e5c88c2b5428"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:718c9bd369288aca5fa929df6dbf66fdbe9768d90940a940c0b5cdc96ade4309"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a68e3724b7dab761c01816aaa64b0903734d999d5589daf97c14ef5cc0629a8e"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1af60988d47534246d9525f77288fdd9de652608a4842815d9018570b959acc6"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3084161fc3e963056232ef8d937449a2943852e07101f5a136c8f3cfa4119217"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:6cd67d3d017296d98ff505529104299f78433e4b8af31b55003d901a62bbebe9"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b11a127ac590fc991e8a02c2d7e1ac86e8141c92f78546f18b5c904064a0552c"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:aadce42147fc09dcef1afa892485311e824c050352e1aa6e47f56b9b27af4cf0"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:b54853c2371bf0e38d67da379519deb6fbe70055efb32f6607081641af3dc752"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:ce19887268e90ee81a3957eef5e46a70ecc000713796639f83828b950343f49e"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:f39a2a5ded23b9b9194ec45740dce57177b80f86c6d8eba953d3ff1a25c97766"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:0ec338d5f4ad8d9339a88a08db5c23e7f7a52c2b2a10510c48a0cef1fb3f0ddc"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-win32.whl", hash = "sha256:56fd15ea8f4c948864fa5ebd9261c67cf7b89a1c517a0caef4df75446a7af18c"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-win_amd64.whl", hash = "sha256:43dfc5e733808962a822ff6d9c29f3039a3cfb3620706f5953e17cfe4496724c"}, + {file = "rapidfuzz-3.10.0-cp310-cp310-win_arm64.whl", hash = "sha256:ae7966f205b5a7fde93b44ca8fed37c1c8539328d7f179b1197de34eceaceb5f"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:bb0013795b40db5cf361e6f21ee7cda09627cf294977149b50e217d7fe9a2f03"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:69ef5b363afff7150a1fbe788007e307b9802a2eb6ad92ed51ab94e6ad2674c6"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c582c46b1bb0b19f1a5f4c1312f1b640c21d78c371a6615c34025b16ee56369b"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:288f6f6e7410cacb115fb851f3f18bf0e4231eb3f6cb5bd1cec0e7b25c4d039d"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c9e29a13d2fd9be3e7d8c26c7ef4ba60b5bc7efbc9dbdf24454c7e9ebba31768"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ea2da0459b951ee461bd4e02b8904890bd1c4263999d291c5cd01e6620177ad4"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:457827ba82261aa2ae6ac06a46d0043ab12ba7216b82d87ae1434ec0f29736d6"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:5d350864269d56f51ab81ab750c9259ae5cad3152c0680baef143dcec92206a1"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:a9b8f51e08c3f983d857c3889930af9ddecc768453822076683664772d87e374"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7f3a6aa6e70fc27e4ff5c479f13cc9fc26a56347610f5f8b50396a0d344c5f55"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:803f255f10d63420979b1909ef976e7d30dec42025c9b067fc1d2040cc365a7e"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:2026651761bf83a0f31495cc0f70840d5c0d54388f41316e3f9cb51bd85e49a5"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-win32.whl", hash = "sha256:4df75b3ebbb8cfdb9bf8b213b168620b88fd92d0c16a8bc9f9234630b282db59"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-win_amd64.whl", hash = "sha256:f9f0bbfb6787b97c51516f3ccf97737d504db5d239ad44527673b81f598b84ab"}, + {file = "rapidfuzz-3.10.0-cp311-cp311-win_arm64.whl", hash = "sha256:10fdad800441b9c97d471a937ba7d42625f1b530db05e572f1cb7d401d95c893"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7dc87073ba3a40dd65591a2100aa71602107443bf10770579ff9c8a3242edb94"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:a425a0a868cf8e9c6e93e1cda4b758cdfd314bb9a4fc916c5742c934e3613480"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a86d5d1d75e61df060c1e56596b6b0a4422a929dff19cc3dbfd5eee762c86b61"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:34f213d59219a9c3ca14e94a825f585811a68ac56b4118b4dc388b5b14afc108"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:96ad46f5f56f70fab2be9e5f3165a21be58d633b90bf6e67fc52a856695e4bcf"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9178277f72d144a6c7704d7ae7fa15b7b86f0f0796f0e1049c7b4ef748a662ef"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76a35e9e19a7c883c422ffa378e9a04bc98cb3b29648c5831596401298ee51e6"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8a6405d34c394c65e4f73a1d300c001f304f08e529d2ed6413b46ee3037956eb"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:bd393683129f446a75d8634306aed7e377627098a1286ff3af2a4f1736742820"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:b0445fa9880ead81f5a7d0efc0b9c977a947d8052c43519aceeaf56eabaf6843"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:c50bc308fa29767ed8f53a8d33b7633a9e14718ced038ed89d41b886e301da32"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e89605afebbd2d4b045bccfdc12a14b16fe8ccbae05f64b4b4c64a97dad1c891"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-win32.whl", hash = "sha256:2db9187f3acf3cd33424ecdbaad75414c298ecd1513470df7bda885dcb68cc15"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-win_amd64.whl", hash = "sha256:50e3d0c72ea15391ba9531ead7f2068a67c5b18a6a365fef3127583aaadd1725"}, + {file = "rapidfuzz-3.10.0-cp312-cp312-win_arm64.whl", hash = "sha256:9eac95b4278bd53115903d89118a2c908398ee8bdfd977ae844f1bd2b02b917c"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:fe5231e8afd069c742ac5b4f96344a0fe4aff52df8e53ef87faebf77f827822c"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:886882367dbc985f5736356105798f2ae6e794e671fc605476cbe2e73838a9bb"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b33e13e537e3afd1627d421a142a12bbbe601543558a391a6fae593356842f6e"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:094c26116d55bf9c53abd840d08422f20da78ec4c4723e5024322321caedca48"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:545fc04f2d592e4350f59deb0818886c1b444ffba3bec535b4fbb97191aaf769"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:916a6abf3632e592b937c3d04c00a6efadd8fd30539cdcd4e6e4d92be7ca5d90"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fb6ec40cef63b1922083d33bfef2f91fc0b0bc07b5b09bfee0b0f1717d558292"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:c77a7330dd15c7eb5fd3631dc646fc96327f98db8181138766bd14d3e905f0ba"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:949b5e9eeaa4ecb4c7e9c2a4689dddce60929dd1ff9c76a889cdbabe8bbf2171"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:b5363932a5aab67010ae1a6205c567d1ef256fb333bc23c27582481606be480c"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:5dd6eec15b13329abe66cc241b484002ecb0e17d694491c944a22410a6a9e5e2"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:79e7f98525b60b3c14524e0a4e1fedf7654657b6e02eb25f1be897ab097706f3"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-win32.whl", hash = "sha256:d29d1b9857c65f8cb3a29270732e1591b9bacf89de9d13fa764f79f07d8f1fd2"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-win_amd64.whl", hash = "sha256:fa9720e56663cc3649d62b4b5f3145e94b8f5611e8a8e1b46507777249d46aad"}, + {file = "rapidfuzz-3.10.0-cp313-cp313-win_arm64.whl", hash = "sha256:eda4c661e68dddd56c8fbfe1ca35e40dd2afd973f7ebb1605f4d151edc63dff8"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:cffbc50e0767396ed483900900dd58ce4351bc0d40e64bced8694bd41864cc71"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:c038b9939da3035afb6cb2f465f18163e8f070aba0482923ecff9443def67178"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca366c2e2a54e2f663f4529b189fdeb6e14d419b1c78b754ec1744f3c01070d4"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7c4c82b1689b23b1b5e6a603164ed2be41b6f6de292a698b98ba2381e889eb9d"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:98f6ebe28831a482981ecfeedc8237047878424ad0c1add2c7f366ba44a20452"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4bd1a7676ee2a4c8e2f7f2550bece994f9f89e58afb96088964145a83af7408b"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ec9139baa3f85b65adc700eafa03ed04995ca8533dd56c924f0e458ffec044ab"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:26de93e6495078b6af4c4d93a42ca067b16cc0e95699526c82ab7d1025b4d3bf"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:f3a0bda83c18195c361b5500377d0767749f128564ca95b42c8849fd475bb327"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:63e4c175cbce8c3adc22dca5e6154588ae673f6c55374d156f3dac732c88d7de"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:4dd3d8443970eaa02ab5ae45ce584b061f2799cd9f7e875190e2617440c1f9d4"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:e5ddb2388610799fc46abe389600625058f2a73867e63e20107c5ad5ffa57c47"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-win32.whl", hash = "sha256:2e9be5d05cd960914024412b5406fb75a82f8562f45912ff86255acbfdbfb78e"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-win_amd64.whl", hash = "sha256:47aca565a39c9a6067927871973ca827023e8b65ba6c5747f4c228c8d7ddc04f"}, + {file = "rapidfuzz-3.10.0-cp39-cp39-win_arm64.whl", hash = "sha256:b0732343cdc4273b5921268026dd7266f75466eb21873cb7635a200d9d9c3fac"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:f744b5eb1469bf92dd143d36570d2bdbbdc88fe5cb0b5405e53dd34f479cbd8a"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:b67cc21a14327a0eb0f47bc3d7e59ec08031c7c55220ece672f9476e7a8068d3"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2fe5783676f0afba4a522c80b15e99dbf4e393c149ab610308a8ef1f04c6bcc8"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d4688862f957c8629d557d084f20b2d803f8738b6c4066802a0b1cc472e088d9"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:20bd153aacc244e4c907d772c703fea82754c4db14f8aa64d75ff81b7b8ab92d"}, + {file = "rapidfuzz-3.10.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:50484d563f8bfa723c74c944b0bb15b9e054db9c889348c8c307abcbee75ab92"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:5897242d455461f2c5b82d7397b29341fd11e85bf3608a522177071044784ee8"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:116c71a81e046ba56551d8ab68067ca7034d94b617545316d460a452c5c3c289"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f0a547e4350d1fa32624d3eab51eff8cf329f4cae110b4ea0402486b1da8be40"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:399b9b79ccfcf50ca3bad7692bc098bb8eade88d7d5e15773b7f866c91156d0c"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7947a425d1be3e744707ee58c6cb318b93a56e08f080722dcc0347e0b7a1bb9a"}, + {file = "rapidfuzz-3.10.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:94c48b4a2a4b1d22246f48e2b11cae01ec7d23f0c9123f8bb822839ad79d0a88"}, + {file = "rapidfuzz-3.10.0.tar.gz", hash = "sha256:6b62af27e65bb39276a66533655a2fa3c60a487b03935721c45b7809527979be"}, +] + +[package.extras] +all = ["numpy"] + +[[package]] +name = "requests" +version = "2.32.3" +description = "Python HTTP for Humans." +optional = false +python-versions = ">=3.8" +files = [ + {file = "requests-2.32.3-py3-none-any.whl", hash = "sha256:70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6"}, + {file = "requests-2.32.3.tar.gz", hash = "sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760"}, +] + +[package.dependencies] +certifi = ">=2017.4.17" +charset-normalizer = ">=2,<4" +idna = ">=2.5,<4" +urllib3 = ">=1.21.1,<3" + +[package.extras] +socks = ["PySocks (>=1.5.6,!=1.5.7)"] +use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"] + +[[package]] +name = "requests-toolbelt" +version = "1.0.0" +description = "A utility belt for advanced users of python-requests" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*" +files = [ + {file = "requests-toolbelt-1.0.0.tar.gz", hash = "sha256:7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6"}, + {file = "requests_toolbelt-1.0.0-py2.py3-none-any.whl", hash = "sha256:cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06"}, +] + +[package.dependencies] +requests = ">=2.0.1,<3.0.0" + +[[package]] +name = "rich" +version = "13.9.2" +description = "Render rich text, tables, progress bars, syntax highlighting, markdown and more to the terminal" +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "rich-13.9.2-py3-none-any.whl", hash = "sha256:8c82a3d3f8dcfe9e734771313e606b39d8247bb6b826e196f4914b333b743cf1"}, + {file = "rich-13.9.2.tar.gz", hash = "sha256:51a2c62057461aaf7152b4d611168f93a9fc73068f8ded2790f29fe2b5366d0c"}, +] + +[package.dependencies] +markdown-it-py = ">=2.2.0" +pygments = ">=2.13.0,<3.0.0" +typing-extensions = {version = ">=4.0.0,<5.0", markers = "python_version < \"3.11\""} + +[package.extras] +jupyter = ["ipywidgets (>=7.5.1,<9)"] + +[[package]] +name = "ruff" +version = "0.6.9" +description = "An extremely fast Python linter and code formatter, written in Rust." +optional = false +python-versions = ">=3.7" +files = [ + {file = "ruff-0.6.9-py3-none-linux_armv6l.whl", hash = "sha256:064df58d84ccc0ac0fcd63bc3090b251d90e2a372558c0f057c3f75ed73e1ccd"}, + {file = "ruff-0.6.9-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:140d4b5c9f5fc7a7b074908a78ab8d384dd7f6510402267bc76c37195c02a7ec"}, + {file = "ruff-0.6.9-py3-none-macosx_11_0_arm64.whl", hash = "sha256:53fd8ca5e82bdee8da7f506d7b03a261f24cd43d090ea9db9a1dc59d9313914c"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:645d7d8761f915e48a00d4ecc3686969761df69fb561dd914a773c1a8266e14e"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:eae02b700763e3847595b9d2891488989cac00214da7f845f4bcf2989007d577"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:7d5ccc9e58112441de8ad4b29dcb7a86dc25c5f770e3c06a9d57e0e5eba48829"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:417b81aa1c9b60b2f8edc463c58363075412866ae4e2b9ab0f690dc1e87ac1b5"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3c866b631f5fbce896a74a6e4383407ba7507b815ccc52bcedabb6810fdb3ef7"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7b118afbb3202f5911486ad52da86d1d52305b59e7ef2031cea3425142b97d6f"}, + {file = "ruff-0.6.9-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a67267654edc23c97335586774790cde402fb6bbdb3c2314f1fc087dee320bfa"}, + {file = "ruff-0.6.9-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:3ef0cc774b00fec123f635ce5c547dac263f6ee9fb9cc83437c5904183b55ceb"}, + {file = "ruff-0.6.9-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:12edd2af0c60fa61ff31cefb90aef4288ac4d372b4962c2864aeea3a1a2460c0"}, + {file = "ruff-0.6.9-py3-none-musllinux_1_2_i686.whl", hash = "sha256:55bb01caeaf3a60b2b2bba07308a02fca6ab56233302406ed5245180a05c5625"}, + {file = "ruff-0.6.9-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:925d26471fa24b0ce5a6cdfab1bb526fb4159952385f386bdcc643813d472039"}, + {file = "ruff-0.6.9-py3-none-win32.whl", hash = "sha256:eb61ec9bdb2506cffd492e05ac40e5bc6284873aceb605503d8494180d6fc84d"}, + {file = "ruff-0.6.9-py3-none-win_amd64.whl", hash = "sha256:785d31851c1ae91f45b3d8fe23b8ae4b5170089021fbb42402d811135f0b7117"}, + {file = "ruff-0.6.9-py3-none-win_arm64.whl", hash = "sha256:a9641e31476d601f83cd602608739a0840e348bda93fec9f1ee816f8b6798b93"}, + {file = "ruff-0.6.9.tar.gz", hash = "sha256:b076ef717a8e5bc819514ee1d602bbdca5b4420ae13a9cf61a0c0a4f53a2baa2"}, +] + +[[package]] +name = "secretstorage" +version = "3.3.3" +description = "Python bindings to FreeDesktop.org Secret Service API" +optional = false +python-versions = ">=3.6" +files = [ + {file = "SecretStorage-3.3.3-py3-none-any.whl", hash = "sha256:f356e6628222568e3af06f2eba8df495efa13b3b63081dafd4f7d9a7b7bc9f99"}, + {file = "SecretStorage-3.3.3.tar.gz", hash = "sha256:2403533ef369eca6d2ba81718576c5e0f564d5cca1b58f73a8b23e7d4eeebd77"}, +] + +[package.dependencies] +cryptography = ">=2.0" +jeepney = ">=0.6" + +[[package]] +name = "setuptools" +version = "75.1.0" +description = "Easily download, build, install, upgrade, and uninstall Python packages" +optional = false +python-versions = ">=3.8" +files = [ + {file = "setuptools-75.1.0-py3-none-any.whl", hash = "sha256:35ab7fd3bcd95e6b7fd704e4a1539513edad446c097797f2985e0e4b960772f2"}, + {file = "setuptools-75.1.0.tar.gz", hash = "sha256:d59a21b17a275fb872a9c3dae73963160ae079f1049ed956880cd7c09b120538"}, +] + +[package.extras] +check = ["pytest-checkdocs (>=2.4)", "pytest-ruff (>=0.2.1)", "ruff (>=0.5.2)"] +core = ["importlib-metadata (>=6)", "importlib-resources (>=5.10.2)", "jaraco.collections", "jaraco.functools", "jaraco.text (>=3.7)", "more-itertools", "more-itertools (>=8.8)", "packaging", "packaging (>=24)", "platformdirs (>=2.6.2)", "tomli (>=2.0.1)", "wheel (>=0.43.0)"] +cover = ["pytest-cov"] +doc = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "pygments-github-lexers (==0.0.5)", "pyproject-hooks (!=1.1)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-favicon", "sphinx-inline-tabs", "sphinx-lint", "sphinx-notfound-page (>=1,<2)", "sphinx-reredirects", "sphinxcontrib-towncrier", "towncrier (<24.7)"] +enabler = ["pytest-enabler (>=2.2)"] +test = ["build[virtualenv] (>=1.0.3)", "filelock (>=3.4.0)", "ini2toml[lite] (>=0.14)", "jaraco.develop (>=7.21)", "jaraco.envs (>=2.2)", "jaraco.path (>=3.2.0)", "jaraco.test", "packaging (>=23.2)", "pip (>=19.1)", "pyproject-hooks (!=1.1)", "pytest (>=6,!=8.1.*)", "pytest-home (>=0.5)", "pytest-perf", "pytest-subprocess", "pytest-timeout", "pytest-xdist (>=3)", "tomli-w (>=1.0.0)", "virtualenv (>=13.0.0)", "wheel (>=0.44.0)"] +type = ["importlib-metadata (>=7.0.2)", "jaraco.develop (>=7.21)", "mypy (==1.11.*)", "pytest-mypy"] + +[[package]] +name = "shellingham" +version = "1.5.4" +description = "Tool to Detect Surrounding Shell" +optional = false +python-versions = ">=3.7" +files = [ + {file = "shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686"}, + {file = "shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de"}, +] + +[[package]] +name = "six" +version = "1.16.0" +description = "Python 2 and 3 compatibility utilities" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*" +files = [ + {file = "six-1.16.0-py2.py3-none-any.whl", hash = "sha256:8abb2f1d86890a2dfb989f9a77cfcfd3e47c2a354b01111771326f8aa26e0254"}, + {file = "six-1.16.0.tar.gz", hash = "sha256:1e61c37477a1626458e36f7b1d82aa5c9b094fa4802892072e49de9c60c4c926"}, +] + +[[package]] +name = "sniffio" +version = "1.3.1" +description = "Sniff out which async library your code is running under" +optional = false +python-versions = ">=3.7" +files = [ + {file = "sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2"}, + {file = "sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"}, +] + +[[package]] +name = "starlette" +version = "0.37.2" +description = "The little ASGI library that shines." +optional = false +python-versions = ">=3.8" +files = [ + {file = "starlette-0.37.2-py3-none-any.whl", hash = "sha256:6fe59f29268538e5d0d182f2791a479a0c64638e6935d1c6989e63fb2699c6ee"}, + {file = "starlette-0.37.2.tar.gz", hash = "sha256:9af890290133b79fc3db55474ade20f6220a364a0402e0b556e7cd5e1e093823"}, +] + +[package.dependencies] +anyio = ">=3.4.0,<5" +typing-extensions = {version = ">=3.10.0", markers = "python_version < \"3.10\""} + +[package.extras] +full = ["httpx (>=0.22.0)", "itsdangerous", "jinja2", "python-multipart (>=0.0.7)", "pyyaml"] + +[[package]] +name = "tomli" +version = "2.0.2" +description = "A lil' TOML parser" +optional = false +python-versions = ">=3.8" +files = [ + {file = "tomli-2.0.2-py3-none-any.whl", hash = "sha256:2ebe24485c53d303f690b0ec092806a085f07af5a5aa1464f3931eec36caaa38"}, + {file = "tomli-2.0.2.tar.gz", hash = "sha256:d46d457a85337051c36524bc5349dd91b1877838e2979ac5ced3e710ed8a60ed"}, +] + +[[package]] +name = "tomlkit" +version = "0.13.2" +description = "Style preserving TOML library" +optional = false +python-versions = ">=3.8" +files = [ + {file = "tomlkit-0.13.2-py3-none-any.whl", hash = "sha256:7a974427f6e119197f670fbbbeae7bef749a6c14e793db934baefc1b5f03efde"}, + {file = "tomlkit-0.13.2.tar.gz", hash = "sha256:fff5fe59a87295b278abd31bec92c15d9bc4a06885ab12bcea52c71119392e79"}, +] + +[[package]] +name = "trove-classifiers" +version = "2024.9.12" +description = "Canonical source for classifiers on PyPI (pypi.org)." +optional = false +python-versions = "*" +files = [ + {file = "trove_classifiers-2024.9.12-py3-none-any.whl", hash = "sha256:f88a27a892891c87c5f8bbdf110710ae9e0a4725ea8e0fb45f1bcadf088a491f"}, + {file = "trove_classifiers-2024.9.12.tar.gz", hash = "sha256:4b46b3e134a4d01999ac5bc6e528afcc10cc48f0f724f185f267e276005768f4"}, +] + +[[package]] +name = "typer" +version = "0.12.5" +description = "Typer, build great CLIs. Easy to code. Based on Python type hints." +optional = false +python-versions = ">=3.7" +files = [ + {file = "typer-0.12.5-py3-none-any.whl", hash = "sha256:62fe4e471711b147e3365034133904df3e235698399bc4de2b36c8579298d52b"}, + {file = "typer-0.12.5.tar.gz", hash = "sha256:f592f089bedcc8ec1b974125d64851029c3b1af145f04aca64d69410f0c9b722"}, +] + +[package.dependencies] +click = ">=8.0.0" +rich = ">=10.11.0" +shellingham = ">=1.3.0" +typing-extensions = ">=3.7.4.3" + +[[package]] +name = "typing-extensions" +version = "4.12.2" +description = "Backported and Experimental Type Hints for Python 3.8+" +optional = false +python-versions = ">=3.8" +files = [ + {file = "typing_extensions-4.12.2-py3-none-any.whl", hash = "sha256:04e5ca0351e0f3f85c6853954072df659d0d13fac324d0072316b67d7794700d"}, + {file = "typing_extensions-4.12.2.tar.gz", hash = "sha256:1a7ead55c7e559dd4dee8856e3a88b41225abfe1ce8df57b7c13915fe121ffb8"}, +] + +[[package]] +name = "tzdata" +version = "2024.2" +description = "Provider of IANA time zone data" +optional = false +python-versions = ">=2" +files = [ + {file = "tzdata-2024.2-py2.py3-none-any.whl", hash = "sha256:a48093786cdcde33cad18c2555e8532f34422074448fbc874186f0abd79565cd"}, + {file = "tzdata-2024.2.tar.gz", hash = "sha256:7d85cc416e9382e69095b7bdf4afd9e3880418a2413feec7069d533d6b4e31cc"}, +] + +[[package]] +name = "urllib3" +version = "2.2.3" +description = "HTTP library with thread-safe connection pooling, file post, and more." +optional = false +python-versions = ">=3.8" +files = [ + {file = "urllib3-2.2.3-py3-none-any.whl", hash = "sha256:ca899ca043dcb1bafa3e262d73aa25c465bfb49e0bd9dd5d59f1d0acba2f8fac"}, + {file = "urllib3-2.2.3.tar.gz", hash = "sha256:e7d814a81dad81e6caf2ec9fdedb284ecc9c73076b62654547cc64ccdcae26e9"}, +] + +[package.extras] +brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"] +h2 = ["h2 (>=4,<5)"] +socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"] +zstd = ["zstandard (>=0.18.0)"] + +[[package]] +name = "uuid7" +version = "0.1.0" +description = "UUID version 7, generating time-sorted UUIDs with 200ns time resolution and 48 bits of randomness" +optional = false +python-versions = ">=3.7" +files = [ + {file = "uuid7-0.1.0-py2.py3-none-any.whl", hash = "sha256:5e259bb63c8cb4aded5927ff41b444a80d0c7124e8a0ced7cf44efa1f5cccf61"}, + {file = "uuid7-0.1.0.tar.gz", hash = "sha256:8c57aa32ee7456d3cc68c95c4530bc571646defac01895cfc73545449894a63c"}, +] + +[[package]] +name = "uvicorn" +version = "0.24.0.post1" +description = "The lightning-fast ASGI server." +optional = false +python-versions = ">=3.8" +files = [ + {file = "uvicorn-0.24.0.post1-py3-none-any.whl", hash = "sha256:7c84fea70c619d4a710153482c0d230929af7bcf76c7bfa6de151f0a3a80121e"}, + {file = "uvicorn-0.24.0.post1.tar.gz", hash = "sha256:09c8e5a79dc466bdf28dead50093957db184de356fcdc48697bad3bde4c2588e"}, +] + +[package.dependencies] +click = ">=7.0" +colorama = {version = ">=0.4", optional = true, markers = "sys_platform == \"win32\" and extra == \"standard\""} +h11 = ">=0.8" +httptools = {version = ">=0.5.0", optional = true, markers = "extra == \"standard\""} +python-dotenv = {version = ">=0.13", optional = true, markers = "extra == \"standard\""} +pyyaml = {version = ">=5.1", optional = true, markers = "extra == \"standard\""} +typing-extensions = {version = ">=4.0", markers = "python_version < \"3.11\""} +uvloop = {version = ">=0.14.0,<0.15.0 || >0.15.0,<0.15.1 || >0.15.1", optional = true, markers = "(sys_platform != \"win32\" and sys_platform != \"cygwin\") and platform_python_implementation != \"PyPy\" and extra == \"standard\""} +watchfiles = {version = ">=0.13", optional = true, markers = "extra == \"standard\""} +websockets = {version = ">=10.4", optional = true, markers = "extra == \"standard\""} + +[package.extras] +standard = ["colorama (>=0.4)", "httptools (>=0.5.0)", "python-dotenv (>=0.13)", "pyyaml (>=5.1)", "uvloop (>=0.14.0,!=0.15.0,!=0.15.1)", "watchfiles (>=0.13)", "websockets (>=10.4)"] + +[[package]] +name = "uvloop" +version = "0.20.0" +description = "Fast implementation of asyncio event loop on top of libuv" +optional = false +python-versions = ">=3.8.0" +files = [ + {file = "uvloop-0.20.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:9ebafa0b96c62881d5cafa02d9da2e44c23f9f0cd829f3a32a6aff771449c996"}, + {file = "uvloop-0.20.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:35968fc697b0527a06e134999eef859b4034b37aebca537daeb598b9d45a137b"}, + {file = "uvloop-0.20.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b16696f10e59d7580979b420eedf6650010a4a9c3bd8113f24a103dfdb770b10"}, + {file = "uvloop-0.20.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9b04d96188d365151d1af41fa2d23257b674e7ead68cfd61c725a422764062ae"}, + {file = "uvloop-0.20.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:94707205efbe809dfa3a0d09c08bef1352f5d3d6612a506f10a319933757c006"}, + {file = "uvloop-0.20.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:89e8d33bb88d7263f74dc57d69f0063e06b5a5ce50bb9a6b32f5fcbe655f9e73"}, + {file = "uvloop-0.20.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:e50289c101495e0d1bb0bfcb4a60adde56e32f4449a67216a1ab2750aa84f037"}, + {file = "uvloop-0.20.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:e237f9c1e8a00e7d9ddaa288e535dc337a39bcbf679f290aee9d26df9e72bce9"}, + {file = "uvloop-0.20.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:746242cd703dc2b37f9d8b9f173749c15e9a918ddb021575a0205ec29a38d31e"}, + {file = "uvloop-0.20.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:82edbfd3df39fb3d108fc079ebc461330f7c2e33dbd002d146bf7c445ba6e756"}, + {file = "uvloop-0.20.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:80dc1b139516be2077b3e57ce1cb65bfed09149e1d175e0478e7a987863b68f0"}, + {file = "uvloop-0.20.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:4f44af67bf39af25db4c1ac27e82e9665717f9c26af2369c404be865c8818dcf"}, + {file = "uvloop-0.20.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:4b75f2950ddb6feed85336412b9a0c310a2edbcf4cf931aa5cfe29034829676d"}, + {file = "uvloop-0.20.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:77fbc69c287596880ecec2d4c7a62346bef08b6209749bf6ce8c22bbaca0239e"}, + {file = "uvloop-0.20.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6462c95f48e2d8d4c993a2950cd3d31ab061864d1c226bbf0ee2f1a8f36674b9"}, + {file = "uvloop-0.20.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:649c33034979273fa71aa25d0fe120ad1777c551d8c4cd2c0c9851d88fcb13ab"}, + {file = "uvloop-0.20.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:3a609780e942d43a275a617c0839d85f95c334bad29c4c0918252085113285b5"}, + {file = "uvloop-0.20.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aea15c78e0d9ad6555ed201344ae36db5c63d428818b4b2a42842b3870127c00"}, + {file = "uvloop-0.20.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:f0e94b221295b5e69de57a1bd4aeb0b3a29f61be6e1b478bb8a69a73377db7ba"}, + {file = "uvloop-0.20.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:fee6044b64c965c425b65a4e17719953b96e065c5b7e09b599ff332bb2744bdf"}, + {file = "uvloop-0.20.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:265a99a2ff41a0fd56c19c3838b29bf54d1d177964c300dad388b27e84fd7847"}, + {file = "uvloop-0.20.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b10c2956efcecb981bf9cfb8184d27d5d64b9033f917115a960b83f11bfa0d6b"}, + {file = "uvloop-0.20.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:e7d61fe8e8d9335fac1bf8d5d82820b4808dd7a43020c149b63a1ada953d48a6"}, + {file = "uvloop-0.20.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:2beee18efd33fa6fdb0976e18475a4042cd31c7433c866e8a09ab604c7c22ff2"}, + {file = "uvloop-0.20.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:d8c36fdf3e02cec92aed2d44f63565ad1522a499c654f07935c8f9d04db69e95"}, + {file = "uvloop-0.20.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:a0fac7be202596c7126146660725157d4813aa29a4cc990fe51346f75ff8fde7"}, + {file = "uvloop-0.20.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d0fba61846f294bce41eb44d60d58136090ea2b5b99efd21cbdf4e21927c56a"}, + {file = "uvloop-0.20.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:95720bae002ac357202e0d866128eb1ac82545bcf0b549b9abe91b5178d9b541"}, + {file = "uvloop-0.20.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:36c530d8fa03bfa7085af54a48f2ca16ab74df3ec7108a46ba82fd8b411a2315"}, + {file = "uvloop-0.20.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:e97152983442b499d7a71e44f29baa75b3b02e65d9c44ba53b10338e98dedb66"}, + {file = "uvloop-0.20.0.tar.gz", hash = "sha256:4603ca714a754fc8d9b197e325db25b2ea045385e8a3ad05d3463de725fdf469"}, +] + +[package.extras] +docs = ["Sphinx (>=4.1.2,<4.2.0)", "sphinx-rtd-theme (>=0.5.2,<0.6.0)", "sphinxcontrib-asyncio (>=0.3.0,<0.4.0)"] +test = ["Cython (>=0.29.36,<0.30.0)", "aiohttp (==3.9.0b0)", "aiohttp (>=3.8.1)", "flake8 (>=5.0,<6.0)", "mypy (>=0.800)", "psutil", "pyOpenSSL (>=23.0.0,<23.1.0)", "pycodestyle (>=2.9.0,<2.10.0)"] + +[[package]] +name = "virtualenv" +version = "20.26.6" +description = "Virtual Python Environment builder" +optional = false +python-versions = ">=3.7" +files = [ + {file = "virtualenv-20.26.6-py3-none-any.whl", hash = "sha256:7345cc5b25405607a624d8418154577459c3e0277f5466dd79c49d5e492995f2"}, + {file = "virtualenv-20.26.6.tar.gz", hash = "sha256:280aede09a2a5c317e409a00102e7077c6432c5a38f0ef938e643805a7ad2c48"}, +] + +[package.dependencies] +distlib = ">=0.3.7,<1" +filelock = ">=3.12.2,<4" +platformdirs = ">=3.9.1,<5" + +[package.extras] +docs = ["furo (>=2023.7.26)", "proselint (>=0.13)", "sphinx (>=7.1.2,!=7.3)", "sphinx-argparse (>=0.4)", "sphinxcontrib-towncrier (>=0.2.1a0)", "towncrier (>=23.6)"] +test = ["covdefaults (>=2.3)", "coverage (>=7.2.7)", "coverage-enable-subprocess (>=1)", "flaky (>=3.7)", "packaging (>=23.1)", "pytest (>=7.4)", "pytest-env (>=0.8.2)", "pytest-freezer (>=0.4.8)", "pytest-mock (>=3.11.1)", "pytest-randomly (>=3.12)", "pytest-timeout (>=2.1)", "setuptools (>=68)", "time-machine (>=2.10)"] + +[[package]] +name = "watchfiles" +version = "0.24.0" +description = "Simple, modern and high performance file watching and code reload in python." +optional = false +python-versions = ">=3.8" +files = [ + {file = "watchfiles-0.24.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:083dc77dbdeef09fa44bb0f4d1df571d2e12d8a8f985dccde71ac3ac9ac067a0"}, + {file = "watchfiles-0.24.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e94e98c7cb94cfa6e071d401ea3342767f28eb5a06a58fafdc0d2a4974f4f35c"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:82ae557a8c037c42a6ef26c494d0631cacca040934b101d001100ed93d43f361"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:acbfa31e315a8f14fe33e3542cbcafc55703b8f5dcbb7c1eecd30f141df50db3"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b74fdffce9dfcf2dc296dec8743e5b0332d15df19ae464f0e249aa871fc1c571"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:449f43f49c8ddca87c6b3980c9284cab6bd1f5c9d9a2b00012adaaccd5e7decd"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4abf4ad269856618f82dee296ac66b0cd1d71450fc3c98532d93798e73399b7a"}, + {file = "watchfiles-0.24.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f895d785eb6164678ff4bb5cc60c5996b3ee6df3edb28dcdeba86a13ea0465e"}, + {file = "watchfiles-0.24.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:7ae3e208b31be8ce7f4c2c0034f33406dd24fbce3467f77223d10cd86778471c"}, + {file = "watchfiles-0.24.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:2efec17819b0046dde35d13fb8ac7a3ad877af41ae4640f4109d9154ed30a188"}, + {file = "watchfiles-0.24.0-cp310-none-win32.whl", hash = "sha256:6bdcfa3cd6fdbdd1a068a52820f46a815401cbc2cb187dd006cb076675e7b735"}, + {file = "watchfiles-0.24.0-cp310-none-win_amd64.whl", hash = "sha256:54ca90a9ae6597ae6dc00e7ed0a040ef723f84ec517d3e7ce13e63e4bc82fa04"}, + {file = "watchfiles-0.24.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:bdcd5538e27f188dd3c804b4a8d5f52a7fc7f87e7fd6b374b8e36a4ca03db428"}, + {file = "watchfiles-0.24.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2dadf8a8014fde6addfd3c379e6ed1a981c8f0a48292d662e27cabfe4239c83c"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6509ed3f467b79d95fc62a98229f79b1a60d1b93f101e1c61d10c95a46a84f43"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8360f7314a070c30e4c976b183d1d8d1585a4a50c5cb603f431cebcbb4f66327"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:316449aefacf40147a9efaf3bd7c9bdd35aaba9ac5d708bd1eb5763c9a02bef5"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:73bde715f940bea845a95247ea3e5eb17769ba1010efdc938ffcb967c634fa61"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3770e260b18e7f4e576edca4c0a639f704088602e0bc921c5c2e721e3acb8d15"}, + {file = "watchfiles-0.24.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aa0fd7248cf533c259e59dc593a60973a73e881162b1a2f73360547132742823"}, + {file = "watchfiles-0.24.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:d7a2e3b7f5703ffbd500dabdefcbc9eafeff4b9444bbdd5d83d79eedf8428fab"}, + {file = "watchfiles-0.24.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d831ee0a50946d24a53821819b2327d5751b0c938b12c0653ea5be7dea9c82ec"}, + {file = "watchfiles-0.24.0-cp311-none-win32.whl", hash = "sha256:49d617df841a63b4445790a254013aea2120357ccacbed00253f9c2b5dc24e2d"}, + {file = "watchfiles-0.24.0-cp311-none-win_amd64.whl", hash = "sha256:d3dcb774e3568477275cc76554b5a565024b8ba3a0322f77c246bc7111c5bb9c"}, + {file = "watchfiles-0.24.0-cp311-none-win_arm64.whl", hash = "sha256:9301c689051a4857d5b10777da23fafb8e8e921bcf3abe6448a058d27fb67633"}, + {file = "watchfiles-0.24.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:7211b463695d1e995ca3feb38b69227e46dbd03947172585ecb0588f19b0d87a"}, + {file = "watchfiles-0.24.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4b8693502d1967b00f2fb82fc1e744df128ba22f530e15b763c8d82baee15370"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdab9555053399318b953a1fe1f586e945bc8d635ce9d05e617fd9fe3a4687d6"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:34e19e56d68b0dad5cff62273107cf5d9fbaf9d75c46277aa5d803b3ef8a9e9b"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:41face41f036fee09eba33a5b53a73e9a43d5cb2c53dad8e61fa6c9f91b5a51e"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5148c2f1ea043db13ce9b0c28456e18ecc8f14f41325aa624314095b6aa2e9ea"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7e4bd963a935aaf40b625c2499f3f4f6bbd0c3776f6d3bc7c853d04824ff1c9f"}, + {file = "watchfiles-0.24.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c79d7719d027b7a42817c5d96461a99b6a49979c143839fc37aa5748c322f234"}, + {file = "watchfiles-0.24.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:32aa53a9a63b7f01ed32e316e354e81e9da0e6267435c7243bf8ae0f10b428ef"}, + {file = "watchfiles-0.24.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:ce72dba6a20e39a0c628258b5c308779b8697f7676c254a845715e2a1039b968"}, + {file = "watchfiles-0.24.0-cp312-none-win32.whl", hash = "sha256:d9018153cf57fc302a2a34cb7564870b859ed9a732d16b41a9b5cb2ebed2d444"}, + {file = "watchfiles-0.24.0-cp312-none-win_amd64.whl", hash = "sha256:551ec3ee2a3ac9cbcf48a4ec76e42c2ef938a7e905a35b42a1267fa4b1645896"}, + {file = "watchfiles-0.24.0-cp312-none-win_arm64.whl", hash = "sha256:b52a65e4ea43c6d149c5f8ddb0bef8d4a1e779b77591a458a893eb416624a418"}, + {file = "watchfiles-0.24.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:3d2e3ab79a1771c530233cadfd277fcc762656d50836c77abb2e5e72b88e3a48"}, + {file = "watchfiles-0.24.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:327763da824817b38ad125dcd97595f942d720d32d879f6c4ddf843e3da3fe90"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bd82010f8ab451dabe36054a1622870166a67cf3fce894f68895db6f74bbdc94"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:d64ba08db72e5dfd5c33be1e1e687d5e4fcce09219e8aee893a4862034081d4e"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1cf1f6dd7825053f3d98f6d33f6464ebdd9ee95acd74ba2c34e183086900a827"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:43e3e37c15a8b6fe00c1bce2473cfa8eb3484bbeecf3aefbf259227e487a03df"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88bcd4d0fe1d8ff43675360a72def210ebad3f3f72cabfeac08d825d2639b4ab"}, + {file = "watchfiles-0.24.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:999928c6434372fde16c8f27143d3e97201160b48a614071261701615a2a156f"}, + {file = "watchfiles-0.24.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:30bbd525c3262fd9f4b1865cb8d88e21161366561cd7c9e1194819e0a33ea86b"}, + {file = "watchfiles-0.24.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:edf71b01dec9f766fb285b73930f95f730bb0943500ba0566ae234b5c1618c18"}, + {file = "watchfiles-0.24.0-cp313-none-win32.whl", hash = "sha256:f4c96283fca3ee09fb044f02156d9570d156698bc3734252175a38f0e8975f07"}, + {file = "watchfiles-0.24.0-cp313-none-win_amd64.whl", hash = "sha256:a974231b4fdd1bb7f62064a0565a6b107d27d21d9acb50c484d2cdba515b9366"}, + {file = "watchfiles-0.24.0-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:ee82c98bed9d97cd2f53bdb035e619309a098ea53ce525833e26b93f673bc318"}, + {file = "watchfiles-0.24.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:fd92bbaa2ecdb7864b7600dcdb6f2f1db6e0346ed425fbd01085be04c63f0b05"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f83df90191d67af5a831da3a33dd7628b02a95450e168785586ed51e6d28943c"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fca9433a45f18b7c779d2bae7beeec4f740d28b788b117a48368d95a3233ed83"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b995bfa6bf01a9e09b884077a6d37070464b529d8682d7691c2d3b540d357a0c"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ed9aba6e01ff6f2e8285e5aa4154e2970068fe0fc0998c4380d0e6278222269b"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5171ef898299c657685306d8e1478a45e9303ddcd8ac5fed5bd52ad4ae0b69b"}, + {file = "watchfiles-0.24.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4933a508d2f78099162da473841c652ad0de892719043d3f07cc83b33dfd9d91"}, + {file = "watchfiles-0.24.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:95cf3b95ea665ab03f5a54765fa41abf0529dbaf372c3b83d91ad2cfa695779b"}, + {file = "watchfiles-0.24.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:01def80eb62bd5db99a798d5e1f5f940ca0a05986dcfae21d833af7a46f7ee22"}, + {file = "watchfiles-0.24.0-cp38-none-win32.whl", hash = "sha256:4d28cea3c976499475f5b7a2fec6b3a36208656963c1a856d328aeae056fc5c1"}, + {file = "watchfiles-0.24.0-cp38-none-win_amd64.whl", hash = "sha256:21ab23fdc1208086d99ad3f69c231ba265628014d4aed31d4e8746bd59e88cd1"}, + {file = "watchfiles-0.24.0-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:b665caeeda58625c3946ad7308fbd88a086ee51ccb706307e5b1fa91556ac886"}, + {file = "watchfiles-0.24.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:5c51749f3e4e269231510da426ce4a44beb98db2dce9097225c338f815b05d4f"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:82b2509f08761f29a0fdad35f7e1638b8ab1adfa2666d41b794090361fb8b855"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9a60e2bf9dc6afe7f743e7c9b149d1fdd6dbf35153c78fe3a14ae1a9aee3d98b"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f7d9b87c4c55e3ea8881dfcbf6d61ea6775fffed1fedffaa60bd047d3c08c430"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:78470906a6be5199524641f538bd2c56bb809cd4bf29a566a75051610bc982c3"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:07cdef0c84c03375f4e24642ef8d8178e533596b229d32d2bbd69e5128ede02a"}, + {file = "watchfiles-0.24.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d337193bbf3e45171c8025e291530fb7548a93c45253897cd764a6a71c937ed9"}, + {file = "watchfiles-0.24.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:ec39698c45b11d9694a1b635a70946a5bad066b593af863460a8e600f0dff1ca"}, + {file = "watchfiles-0.24.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:2e28d91ef48eab0afb939fa446d8ebe77e2f7593f5f463fd2bb2b14132f95b6e"}, + {file = "watchfiles-0.24.0-cp39-none-win32.whl", hash = "sha256:7138eff8baa883aeaa074359daabb8b6c1e73ffe69d5accdc907d62e50b1c0da"}, + {file = "watchfiles-0.24.0-cp39-none-win_amd64.whl", hash = "sha256:b3ef2c69c655db63deb96b3c3e587084612f9b1fa983df5e0c3379d41307467f"}, + {file = "watchfiles-0.24.0-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:632676574429bee8c26be8af52af20e0c718cc7f5f67f3fb658c71928ccd4f7f"}, + {file = "watchfiles-0.24.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:a2a9891723a735d3e2540651184be6fd5b96880c08ffe1a98bae5017e65b544b"}, + {file = "watchfiles-0.24.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4a7fa2bc0efef3e209a8199fd111b8969fe9db9c711acc46636686331eda7dd4"}, + {file = "watchfiles-0.24.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:01550ccf1d0aed6ea375ef259706af76ad009ef5b0203a3a4cce0f6024f9b68a"}, + {file = "watchfiles-0.24.0-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:96619302d4374de5e2345b2b622dc481257a99431277662c30f606f3e22f42be"}, + {file = "watchfiles-0.24.0-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:85d5f0c7771dcc7a26c7a27145059b6bb0ce06e4e751ed76cdf123d7039b60b5"}, + {file = "watchfiles-0.24.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:951088d12d339690a92cef2ec5d3cfd957692834c72ffd570ea76a6790222777"}, + {file = "watchfiles-0.24.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:49fb58bcaa343fedc6a9e91f90195b20ccb3135447dc9e4e2570c3a39565853e"}, + {file = "watchfiles-0.24.0.tar.gz", hash = "sha256:afb72325b74fa7a428c009c1b8be4b4d7c2afedafb2982827ef2156646df2fe1"}, +] + +[package.dependencies] +anyio = ">=3.0.0" + +[[package]] +name = "webencodings" +version = "0.5.1" +description = "Character encoding aliases for legacy web content" +optional = false +python-versions = "*" +files = [ + {file = "webencodings-0.5.1-py2.py3-none-any.whl", hash = "sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78"}, + {file = "webencodings-0.5.1.tar.gz", hash = "sha256:b36a1c245f2d304965eb4e0a82848379241dc04b865afcc4aab16748587e1923"}, +] + +[[package]] +name = "websockets" +version = "12.0" +description = "An implementation of the WebSocket Protocol (RFC 6455 & 7692)" +optional = false +python-versions = ">=3.8" +files = [ + {file = "websockets-12.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d554236b2a2006e0ce16315c16eaa0d628dab009c33b63ea03f41c6107958374"}, + {file = "websockets-12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2d225bb6886591b1746b17c0573e29804619c8f755b5598d875bb4235ea639be"}, + {file = "websockets-12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:eb809e816916a3b210bed3c82fb88eaf16e8afcf9c115ebb2bacede1797d2547"}, + {file = "websockets-12.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c588f6abc13f78a67044c6b1273a99e1cf31038ad51815b3b016ce699f0d75c2"}, + {file = "websockets-12.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5aa9348186d79a5f232115ed3fa9020eab66d6c3437d72f9d2c8ac0c6858c558"}, + {file = "websockets-12.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6350b14a40c95ddd53e775dbdbbbc59b124a5c8ecd6fbb09c2e52029f7a9f480"}, + {file = "websockets-12.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:70ec754cc2a769bcd218ed8d7209055667b30860ffecb8633a834dde27d6307c"}, + {file = "websockets-12.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:6e96f5ed1b83a8ddb07909b45bd94833b0710f738115751cdaa9da1fb0cb66e8"}, + {file = "websockets-12.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:4d87be612cbef86f994178d5186add3d94e9f31cc3cb499a0482b866ec477603"}, + {file = "websockets-12.0-cp310-cp310-win32.whl", hash = "sha256:befe90632d66caaf72e8b2ed4d7f02b348913813c8b0a32fae1cc5fe3730902f"}, + {file = "websockets-12.0-cp310-cp310-win_amd64.whl", hash = "sha256:363f57ca8bc8576195d0540c648aa58ac18cf85b76ad5202b9f976918f4219cf"}, + {file = "websockets-12.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:5d873c7de42dea355d73f170be0f23788cf3fa9f7bed718fd2830eefedce01b4"}, + {file = "websockets-12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:3f61726cae9f65b872502ff3c1496abc93ffbe31b278455c418492016e2afc8f"}, + {file = "websockets-12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ed2fcf7a07334c77fc8a230755c2209223a7cc44fc27597729b8ef5425aa61a3"}, + {file = "websockets-12.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e332c210b14b57904869ca9f9bf4ca32f5427a03eeb625da9b616c85a3a506c"}, + {file = "websockets-12.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5693ef74233122f8ebab026817b1b37fe25c411ecfca084b29bc7d6efc548f45"}, + {file = "websockets-12.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6e9e7db18b4539a29cc5ad8c8b252738a30e2b13f033c2d6e9d0549b45841c04"}, + {file = "websockets-12.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:6e2df67b8014767d0f785baa98393725739287684b9f8d8a1001eb2839031447"}, + {file = "websockets-12.0-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:bea88d71630c5900690fcb03161ab18f8f244805c59e2e0dc4ffadae0a7ee0ca"}, + {file = "websockets-12.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:dff6cdf35e31d1315790149fee351f9e52978130cef6c87c4b6c9b3baf78bc53"}, + {file = "websockets-12.0-cp311-cp311-win32.whl", hash = "sha256:3e3aa8c468af01d70332a382350ee95f6986db479ce7af14d5e81ec52aa2b402"}, + {file = "websockets-12.0-cp311-cp311-win_amd64.whl", hash = "sha256:25eb766c8ad27da0f79420b2af4b85d29914ba0edf69f547cc4f06ca6f1d403b"}, + {file = "websockets-12.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:0e6e2711d5a8e6e482cacb927a49a3d432345dfe7dea8ace7b5790df5932e4df"}, + {file = "websockets-12.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:dbcf72a37f0b3316e993e13ecf32f10c0e1259c28ffd0a85cee26e8549595fbc"}, + {file = "websockets-12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:12743ab88ab2af1d17dd4acb4645677cb7063ef4db93abffbf164218a5d54c6b"}, + {file = "websockets-12.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7b645f491f3c48d3f8a00d1fce07445fab7347fec54a3e65f0725d730d5b99cb"}, + {file = "websockets-12.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9893d1aa45a7f8b3bc4510f6ccf8db8c3b62120917af15e3de247f0780294b92"}, + {file = "websockets-12.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1f38a7b376117ef7aff996e737583172bdf535932c9ca021746573bce40165ed"}, + {file = "websockets-12.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:f764ba54e33daf20e167915edc443b6f88956f37fb606449b4a5b10ba42235a5"}, + {file = "websockets-12.0-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:1e4b3f8ea6a9cfa8be8484c9221ec0257508e3a1ec43c36acdefb2a9c3b00aa2"}, + {file = "websockets-12.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:9fdf06fd06c32205a07e47328ab49c40fc1407cdec801d698a7c41167ea45113"}, + {file = "websockets-12.0-cp312-cp312-win32.whl", hash = "sha256:baa386875b70cbd81798fa9f71be689c1bf484f65fd6fb08d051a0ee4e79924d"}, + {file = "websockets-12.0-cp312-cp312-win_amd64.whl", hash = "sha256:ae0a5da8f35a5be197f328d4727dbcfafa53d1824fac3d96cdd3a642fe09394f"}, + {file = "websockets-12.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5f6ffe2c6598f7f7207eef9a1228b6f5c818f9f4d53ee920aacd35cec8110438"}, + {file = "websockets-12.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:9edf3fc590cc2ec20dc9d7a45108b5bbaf21c0d89f9fd3fd1685e223771dc0b2"}, + {file = "websockets-12.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:8572132c7be52632201a35f5e08348137f658e5ffd21f51f94572ca6c05ea81d"}, + {file = "websockets-12.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:604428d1b87edbf02b233e2c207d7d528460fa978f9e391bd8aaf9c8311de137"}, + {file = "websockets-12.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1a9d160fd080c6285e202327aba140fc9a0d910b09e423afff4ae5cbbf1c7205"}, + {file = "websockets-12.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:87b4aafed34653e465eb77b7c93ef058516cb5acf3eb21e42f33928616172def"}, + {file = "websockets-12.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:b2ee7288b85959797970114deae81ab41b731f19ebcd3bd499ae9ca0e3f1d2c8"}, + {file = "websockets-12.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:7fa3d25e81bfe6a89718e9791128398a50dec6d57faf23770787ff441d851967"}, + {file = "websockets-12.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:a571f035a47212288e3b3519944f6bf4ac7bc7553243e41eac50dd48552b6df7"}, + {file = "websockets-12.0-cp38-cp38-win32.whl", hash = "sha256:3c6cc1360c10c17463aadd29dd3af332d4a1adaa8796f6b0e9f9df1fdb0bad62"}, + {file = "websockets-12.0-cp38-cp38-win_amd64.whl", hash = "sha256:1bf386089178ea69d720f8db6199a0504a406209a0fc23e603b27b300fdd6892"}, + {file = "websockets-12.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:ab3d732ad50a4fbd04a4490ef08acd0517b6ae6b77eb967251f4c263011a990d"}, + {file = "websockets-12.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:a1d9697f3337a89691e3bd8dc56dea45a6f6d975f92e7d5f773bc715c15dde28"}, + {file = "websockets-12.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:1df2fbd2c8a98d38a66f5238484405b8d1d16f929bb7a33ed73e4801222a6f53"}, + {file = "websockets-12.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:23509452b3bc38e3a057382c2e941d5ac2e01e251acce7adc74011d7d8de434c"}, + {file = "websockets-12.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2e5fc14ec6ea568200ea4ef46545073da81900a2b67b3e666f04adf53ad452ec"}, + {file = "websockets-12.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:46e71dbbd12850224243f5d2aeec90f0aaa0f2dde5aeeb8fc8df21e04d99eff9"}, + {file = "websockets-12.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b81f90dcc6c85a9b7f29873beb56c94c85d6f0dac2ea8b60d995bd18bf3e2aae"}, + {file = "websockets-12.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:a02413bc474feda2849c59ed2dfb2cddb4cd3d2f03a2fedec51d6e959d9b608b"}, + {file = "websockets-12.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:bbe6013f9f791944ed31ca08b077e26249309639313fff132bfbf3ba105673b9"}, + {file = "websockets-12.0-cp39-cp39-win32.whl", hash = "sha256:cbe83a6bbdf207ff0541de01e11904827540aa069293696dd528a6640bd6a5f6"}, + {file = "websockets-12.0-cp39-cp39-win_amd64.whl", hash = "sha256:fc4e7fa5414512b481a2483775a8e8be7803a35b30ca805afa4998a84f9fd9e8"}, + {file = "websockets-12.0-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:248d8e2446e13c1d4326e0a6a4e9629cb13a11195051a73acf414812700badbd"}, + {file = "websockets-12.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f44069528d45a933997a6fef143030d8ca8042f0dfaad753e2906398290e2870"}, + {file = "websockets-12.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c4e37d36f0d19f0a4413d3e18c0d03d0c268ada2061868c1e6f5ab1a6d575077"}, + {file = "websockets-12.0-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3d829f975fc2e527a3ef2f9c8f25e553eb7bc779c6665e8e1d52aa22800bb38b"}, + {file = "websockets-12.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:2c71bd45a777433dd9113847af751aae36e448bc6b8c361a566cb043eda6ec30"}, + {file = "websockets-12.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:0bee75f400895aef54157b36ed6d3b308fcab62e5260703add87f44cee9c82a6"}, + {file = "websockets-12.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:423fc1ed29f7512fceb727e2d2aecb952c46aa34895e9ed96071821309951123"}, + {file = "websockets-12.0-pp38-pypy38_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:27a5e9964ef509016759f2ef3f2c1e13f403725a5e6a1775555994966a66e931"}, + {file = "websockets-12.0-pp38-pypy38_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c3181df4583c4d3994d31fb235dc681d2aaad744fbdbf94c4802485ececdecf2"}, + {file = "websockets-12.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:b067cb952ce8bf40115f6c19f478dc71c5e719b7fbaa511359795dfd9d1a6468"}, + {file = "websockets-12.0-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:00700340c6c7ab788f176d118775202aadea7602c5cc6be6ae127761c16d6b0b"}, + {file = "websockets-12.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e469d01137942849cff40517c97a30a93ae79917752b34029f0ec72df6b46399"}, + {file = "websockets-12.0-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ffefa1374cd508d633646d51a8e9277763a9b78ae71324183693959cf94635a7"}, + {file = "websockets-12.0-pp39-pypy39_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba0cab91b3956dfa9f512147860783a1829a8d905ee218a9837c18f683239611"}, + {file = "websockets-12.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:2cb388a5bfb56df4d9a406783b7f9dbefb888c09b71629351cc6b036e9259370"}, + {file = "websockets-12.0-py3-none-any.whl", hash = "sha256:dc284bbc8d7c78a6c69e0c7325ab46ee5e40bb4d50e494d8131a07ef47500e9e"}, + {file = "websockets-12.0.tar.gz", hash = "sha256:81df9cbcbb6c260de1e007e58c011bfebe2dafc8435107b0537f393dd38c8b1b"}, +] + +[[package]] +name = "xattr" +version = "1.1.0" +description = "Python wrapper for extended filesystem attributes" +optional = false +python-versions = ">=3.8" +files = [ + {file = "xattr-1.1.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ef2fa0f85458736178fd3dcfeb09c3cf423f0843313e25391db2cfd1acec8888"}, + {file = "xattr-1.1.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:ccab735d0632fe71f7d72e72adf886f45c18b7787430467ce0070207882cfe25"}, + {file = "xattr-1.1.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:9013f290387f1ac90bccbb1926555ca9aef75651271098d99217284d9e010f7c"}, + {file = "xattr-1.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9dcd5dfbcee73c7be057676ecb900cabb46c691aff4397bf48c579ffb30bb963"}, + {file = "xattr-1.1.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6480589c1dac7785d1f851347a32c4a97305937bf7b488b857fe8b28a25de9e9"}, + {file = "xattr-1.1.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:08f61cbed52dc6f7c181455826a9ff1e375ad86f67dd9d5eb7663574abb32451"}, + {file = "xattr-1.1.0-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:918e1f83f2e8a072da2671eac710871ee5af337e9bf8554b5ce7f20cdb113186"}, + {file = "xattr-1.1.0-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:0f06e0c1e4d06b4e0e49aaa1184b6f0e81c3758c2e8365597918054890763b53"}, + {file = "xattr-1.1.0-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:46a641ac038a9f53d2f696716147ca4dbd6a01998dc9cd4bc628801bc0df7f4d"}, + {file = "xattr-1.1.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7e4ca0956fd11679bb2e0c0d6b9cdc0f25470cc00d8da173bb7656cc9a9cf104"}, + {file = "xattr-1.1.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6881b120f9a4b36ccd8a28d933bc0f6e1de67218b6ce6e66874e0280fc006844"}, + {file = "xattr-1.1.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dab29d9288aa28e68a6f355ddfc3f0a7342b40c9012798829f3e7bd765e85c2c"}, + {file = "xattr-1.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e0c80bbf55339c93770fc294b4b6586b5bf8e85ec00a4c2d585c33dbd84b5006"}, + {file = "xattr-1.1.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d1418705f253b6b6a7224b69773842cac83fcbcd12870354b6e11dd1cd54630f"}, + {file = "xattr-1.1.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:687e7d18611ef8d84a6ecd8f4d1ab6757500c1302f4c2046ce0aa3585e13da3f"}, + {file = "xattr-1.1.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:b6ceb9efe0657a982ccb8b8a2efe96b690891779584c901d2f920784e5d20ae3"}, + {file = "xattr-1.1.0-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:b489b7916f239100956ea0b39c504f3c3a00258ba65677e4c8ba1bd0b5513446"}, + {file = "xattr-1.1.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:0a9c431b0e66516a078125e9a273251d4b8e5ba84fe644b619f2725050d688a0"}, + {file = "xattr-1.1.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:1a5921ea3313cc1c57f2f53b63ea8ca9a91e48f4cc7ebec057d2447ec82c7efe"}, + {file = "xattr-1.1.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:f6ad2a7bd5e6cf71d4a862413234a067cf158ca0ae94a40d4b87b98b62808498"}, + {file = "xattr-1.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:0683dae7609f7280b0c89774d00b5957e6ffcb181c6019c46632b389706b77e6"}, + {file = "xattr-1.1.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:54cb15cd94e5ef8a0ef02309f1bf973ba0e13c11e87686e983f371948cfee6af"}, + {file = "xattr-1.1.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ff6223a854229055e803c2ad0c0ea9a6da50c6be30d92c198cf5f9f28819a921"}, + {file = "xattr-1.1.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d44e8f955218638c9ab222eed21e9bd9ab430d296caf2176fb37abe69a714e5c"}, + {file = "xattr-1.1.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:caab2c2986c30f92301f12e9c50415d324412e8e6a739a52a603c3e6a54b3610"}, + {file = "xattr-1.1.0-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:d6eb7d5f281014cd44e2d847a9107491af1bf3087f5afeded75ed3e37ec87239"}, + {file = "xattr-1.1.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:47a3bdfe034b4fdb70e5941d97037405e3904accc28e10dbef6d1c9061fb6fd7"}, + {file = "xattr-1.1.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:00d2b415cf9d6a24112d019e721aa2a85652f7bbc9f3b9574b2d1cd8668eb491"}, + {file = "xattr-1.1.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:78b377832dd0ee408f9f121a354082c6346960f7b6b1480483ed0618b1912120"}, + {file = "xattr-1.1.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:6461a43b585e5f2e049b39bcbfcb6391bfef3c5118231f1b15d10bdb89ef17fe"}, + {file = "xattr-1.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:24d97f0d28f63695e3344ffdabca9fcc30c33e5c8ccc198c7524361a98d526f2"}, + {file = "xattr-1.1.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6ad47d89968c9097900607457a0c89160b4771601d813e769f68263755516065"}, + {file = "xattr-1.1.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dc53cab265f6e8449bd683d5ee3bc5a191e6dd940736f3de1a188e6da66b0653"}, + {file = "xattr-1.1.0-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:cd11e917f5b89f2a0ad639d9875943806c6c9309a3dd02da5a3e8ef92db7bed9"}, + {file = "xattr-1.1.0-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:9c5a78c7558989492c4cb7242e490ffb03482437bf782967dfff114e44242343"}, + {file = "xattr-1.1.0-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:cebcf8a303a44fbc439b68321408af7267507c0d8643229dbb107f6c132d389c"}, + {file = "xattr-1.1.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:b0d73150f2f9655b4da01c2369eb33a294b7f9d56eccb089819eafdbeb99f896"}, + {file = "xattr-1.1.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:793c01deaadac50926c0e1481702133260c7cb5e62116762f6fe1543d07b826f"}, + {file = "xattr-1.1.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e189e440bcd04ccaad0474720abee6ee64890823ec0db361fb0a4fb5e843a1bf"}, + {file = "xattr-1.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:afacebbc1fa519f41728f8746a92da891c7755e6745164bd0d5739face318e86"}, + {file = "xattr-1.1.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9b1664edf003153ac8d1911e83a0fc60db1b1b374ee8ac943f215f93754a1102"}, + {file = "xattr-1.1.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dda2684228798e937a7c29b0e1c7ef3d70e2b85390a69b42a1c61b2039ba81de"}, + {file = "xattr-1.1.0-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b735ac2625a4fc2c9343b19f806793db6494336338537d2911c8ee4c390dda46"}, + {file = "xattr-1.1.0-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:fa6a7af7a4ada43f15ccc58b6f9adcdbff4c36ba040013d2681e589e07ae280a"}, + {file = "xattr-1.1.0-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:d1059b2f726e2702c8bbf9bbf369acfc042202a4cc576c2dec6791234ad5e948"}, + {file = "xattr-1.1.0-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:e2255f36ebf2cb2dbf772a7437ad870836b7396e60517211834cf66ce678b595"}, + {file = "xattr-1.1.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:dba4f80b9855cc98513ddf22b7ad8551bc448c70d3147799ea4f6c0b758fb466"}, + {file = "xattr-1.1.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4cb70c16e7c3ae6ba0ab6c6835c8448c61d8caf43ea63b813af1f4dbe83dd156"}, + {file = "xattr-1.1.0-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:83652910ef6a368b77b00825ad67815e5c92bfab551a848ca66e9981d14a7519"}, + {file = "xattr-1.1.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:7a92aff66c43fa3e44cbeab7cbeee66266c91178a0f595e044bf3ce51485743b"}, + {file = "xattr-1.1.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d4f71b673339aeaae1f6ea9ef8ea6c9643c8cd0df5003b9a0eaa75403e2e06c"}, + {file = "xattr-1.1.0-pp38-pypy38_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a20de1c47b5cd7b47da61799a3b34e11e5815d716299351f82a88627a43f9a96"}, + {file = "xattr-1.1.0-pp38-pypy38_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:23705c7079b05761ff2fa778ad17396e7599c8759401abc05b312dfb3bc99f69"}, + {file = "xattr-1.1.0-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:27272afeba8422f2a9d27e1080a9a7b807394e88cce73db9ed8d2dde3afcfb87"}, + {file = "xattr-1.1.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:dd43978966de3baf4aea367c99ffa102b289d6c2ea5f3d9ce34a203dc2f2ab73"}, + {file = "xattr-1.1.0-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ded771eaf27bb4eb3c64c0d09866460ee8801d81dc21097269cf495b3cac8657"}, + {file = "xattr-1.1.0-pp39-pypy39_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:96ca300c0acca4f0cddd2332bb860ef58e1465d376364f0e72a1823fdd58e90d"}, + {file = "xattr-1.1.0.tar.gz", hash = "sha256:fecbf3b05043ed3487a28190dec3e4c4d879b2fcec0e30bafd8ec5d4b6043630"}, +] + +[package.dependencies] +cffi = ">=1.16.0" + +[package.extras] +test = ["pytest"] + +[[package]] +name = "yarl" +version = "1.13.1" +description = "Yet another URL library" +optional = false +python-versions = ">=3.8" +files = [ + {file = "yarl-1.13.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:82e692fb325013a18a5b73a4fed5a1edaa7c58144dc67ad9ef3d604eccd451ad"}, + {file = "yarl-1.13.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:df4e82e68f43a07735ae70a2d84c0353e58e20add20ec0af611f32cd5ba43fb4"}, + {file = "yarl-1.13.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:ec9dd328016d8d25702a24ee274932aebf6be9787ed1c28d021945d264235b3c"}, + {file = "yarl-1.13.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5820bd4178e6a639b3ef1db8b18500a82ceab6d8b89309e121a6859f56585b05"}, + {file = "yarl-1.13.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:86c438ce920e089c8c2388c7dcc8ab30dfe13c09b8af3d306bcabb46a053d6f7"}, + {file = "yarl-1.13.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3de86547c820e4f4da4606d1c8ab5765dd633189791f15247706a2eeabc783ae"}, + {file = "yarl-1.13.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8ca53632007c69ddcdefe1e8cbc3920dd88825e618153795b57e6ebcc92e752a"}, + {file = "yarl-1.13.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:d4ee1d240b84e2f213565f0ec08caef27a0e657d4c42859809155cf3a29d1735"}, + {file = "yarl-1.13.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:c49f3e379177f4477f929097f7ed4b0622a586b0aa40c07ac8c0f8e40659a1ac"}, + {file = "yarl-1.13.1-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:5c5e32fef09ce101fe14acd0f498232b5710effe13abac14cd95de9c274e689e"}, + {file = "yarl-1.13.1-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:ab9524e45ee809a083338a749af3b53cc7efec458c3ad084361c1dbf7aaf82a2"}, + {file = "yarl-1.13.1-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:b1481c048fe787f65e34cb06f7d6824376d5d99f1231eae4778bbe5c3831076d"}, + {file = "yarl-1.13.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:31497aefd68036d8e31bfbacef915826ca2e741dbb97a8d6c7eac66deda3b606"}, + {file = "yarl-1.13.1-cp310-cp310-win32.whl", hash = "sha256:1fa56f34b2236f5192cb5fceba7bbb09620e5337e0b6dfe2ea0ddbd19dd5b154"}, + {file = "yarl-1.13.1-cp310-cp310-win_amd64.whl", hash = "sha256:1bbb418f46c7f7355084833051701b2301092e4611d9e392360c3ba2e3e69f88"}, + {file = "yarl-1.13.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:216a6785f296169ed52cd7dcdc2612f82c20f8c9634bf7446327f50398732a51"}, + {file = "yarl-1.13.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:40c6e73c03a6befb85b72da213638b8aaa80fe4136ec8691560cf98b11b8ae6e"}, + {file = "yarl-1.13.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2430cf996113abe5aee387d39ee19529327205cda975d2b82c0e7e96e5fdabdc"}, + {file = "yarl-1.13.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9fb4134cc6e005b99fa29dbc86f1ea0a298440ab6b07c6b3ee09232a3b48f495"}, + {file = "yarl-1.13.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:309c104ecf67626c033845b860d31594a41343766a46fa58c3309c538a1e22b2"}, + {file = "yarl-1.13.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f90575e9fe3aae2c1e686393a9689c724cd00045275407f71771ae5d690ccf38"}, + {file = "yarl-1.13.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9d2e1626be8712333a9f71270366f4a132f476ffbe83b689dd6dc0d114796c74"}, + {file = "yarl-1.13.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5b66c87da3c6da8f8e8b648878903ca54589038a0b1e08dde2c86d9cd92d4ac9"}, + {file = "yarl-1.13.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:cf1ad338620249f8dd6d4b6a91a69d1f265387df3697ad5dc996305cf6c26fb2"}, + {file = "yarl-1.13.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:9915300fe5a0aa663c01363db37e4ae8e7c15996ebe2c6cce995e7033ff6457f"}, + {file = "yarl-1.13.1-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:703b0f584fcf157ef87816a3c0ff868e8c9f3c370009a8b23b56255885528f10"}, + {file = "yarl-1.13.1-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:1d8e3ca29f643dd121f264a7c89f329f0fcb2e4461833f02de6e39fef80f89da"}, + {file = "yarl-1.13.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:7055bbade838d68af73aea13f8c86588e4bcc00c2235b4b6d6edb0dbd174e246"}, + {file = "yarl-1.13.1-cp311-cp311-win32.whl", hash = "sha256:a3442c31c11088e462d44a644a454d48110f0588de830921fd201060ff19612a"}, + {file = "yarl-1.13.1-cp311-cp311-win_amd64.whl", hash = "sha256:81bad32c8f8b5897c909bf3468bf601f1b855d12f53b6af0271963ee67fff0d2"}, + {file = "yarl-1.13.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:f452cc1436151387d3d50533523291d5f77c6bc7913c116eb985304abdbd9ec9"}, + {file = "yarl-1.13.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:9cec42a20eae8bebf81e9ce23fb0d0c729fc54cf00643eb251ce7c0215ad49fe"}, + {file = "yarl-1.13.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:d959fe96e5c2712c1876d69af0507d98f0b0e8d81bee14cfb3f6737470205419"}, + {file = "yarl-1.13.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b8c837ab90c455f3ea8e68bee143472ee87828bff19ba19776e16ff961425b57"}, + {file = "yarl-1.13.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:94a993f976cdcb2dc1b855d8b89b792893220db8862d1a619efa7451817c836b"}, + {file = "yarl-1.13.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b2442a415a5f4c55ced0fade7b72123210d579f7d950e0b5527fc598866e62c"}, + {file = "yarl-1.13.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3fdbf0418489525231723cdb6c79e7738b3cbacbaed2b750cb033e4ea208f220"}, + {file = "yarl-1.13.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6b7f6e699304717fdc265a7e1922561b02a93ceffdaefdc877acaf9b9f3080b8"}, + {file = "yarl-1.13.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:bcd5bf4132e6a8d3eb54b8d56885f3d3a38ecd7ecae8426ecf7d9673b270de43"}, + {file = "yarl-1.13.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:2a93a4557f7fc74a38ca5a404abb443a242217b91cd0c4840b1ebedaad8919d4"}, + {file = "yarl-1.13.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:22b739f99c7e4787922903f27a892744189482125cc7b95b747f04dd5c83aa9f"}, + {file = "yarl-1.13.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:2db874dd1d22d4c2c657807562411ffdfabec38ce4c5ce48b4c654be552759dc"}, + {file = "yarl-1.13.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:4feaaa4742517eaceafcbe74595ed335a494c84634d33961214b278126ec1485"}, + {file = "yarl-1.13.1-cp312-cp312-win32.whl", hash = "sha256:bbf9c2a589be7414ac4a534d54e4517d03f1cbb142c0041191b729c2fa23f320"}, + {file = "yarl-1.13.1-cp312-cp312-win_amd64.whl", hash = "sha256:d07b52c8c450f9366c34aa205754355e933922c79135125541daae6cbf31c799"}, + {file = "yarl-1.13.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:95c6737f28069153c399d875317f226bbdea939fd48a6349a3b03da6829fb550"}, + {file = "yarl-1.13.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:cd66152561632ed4b2a9192e7f8e5a1d41e28f58120b4761622e0355f0fe034c"}, + {file = "yarl-1.13.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:6a2acde25be0cf9be23a8f6cbd31734536a264723fca860af3ae5e89d771cd71"}, + {file = "yarl-1.13.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9a18595e6a2ee0826bf7dfdee823b6ab55c9b70e8f80f8b77c37e694288f5de1"}, + {file = "yarl-1.13.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a31d21089894942f7d9a8df166b495101b7258ff11ae0abec58e32daf8088813"}, + {file = "yarl-1.13.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:45f209fb4bbfe8630e3d2e2052535ca5b53d4ce2d2026bed4d0637b0416830da"}, + {file = "yarl-1.13.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f722f30366474a99745533cc4015b1781ee54b08de73260b2bbe13316079851"}, + {file = "yarl-1.13.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f3bf60444269345d712838bb11cc4eadaf51ff1a364ae39ce87a5ca8ad3bb2c8"}, + {file = "yarl-1.13.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:942c80a832a79c3707cca46bd12ab8aa58fddb34b1626d42b05aa8f0bcefc206"}, + {file = "yarl-1.13.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:44b07e1690f010c3c01d353b5790ec73b2f59b4eae5b0000593199766b3f7a5c"}, + {file = "yarl-1.13.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:396e59b8de7e4d59ff5507fb4322d2329865b909f29a7ed7ca37e63ade7f835c"}, + {file = "yarl-1.13.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:3bb83a0f12701c0b91112a11148b5217617982e1e466069d0555be9b372f2734"}, + {file = "yarl-1.13.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:c92b89bffc660f1274779cb6fbb290ec1f90d6dfe14492523a0667f10170de26"}, + {file = "yarl-1.13.1-cp313-cp313-win32.whl", hash = "sha256:269c201bbc01d2cbba5b86997a1e0f73ba5e2f471cfa6e226bcaa7fd664b598d"}, + {file = "yarl-1.13.1-cp313-cp313-win_amd64.whl", hash = "sha256:1d0828e17fa701b557c6eaed5edbd9098eb62d8838344486248489ff233998b8"}, + {file = "yarl-1.13.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:8be8cdfe20787e6a5fcbd010f8066227e2bb9058331a4eccddec6c0db2bb85b2"}, + {file = "yarl-1.13.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:08d7148ff11cb8e886d86dadbfd2e466a76d5dd38c7ea8ebd9b0e07946e76e4b"}, + {file = "yarl-1.13.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:4afdf84610ca44dcffe8b6c22c68f309aff96be55f5ea2fa31c0c225d6b83e23"}, + {file = "yarl-1.13.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0d12fe78dcf60efa205e9a63f395b5d343e801cf31e5e1dda0d2c1fb618073d"}, + {file = "yarl-1.13.1-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:298c1eecfd3257aa16c0cb0bdffb54411e3e831351cd69e6b0739be16b1bdaa8"}, + {file = "yarl-1.13.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c14c16831b565707149c742d87a6203eb5597f4329278446d5c0ae7a1a43928e"}, + {file = "yarl-1.13.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5a9bacedbb99685a75ad033fd4de37129449e69808e50e08034034c0bf063f99"}, + {file = "yarl-1.13.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:658e8449b84b92a4373f99305de042b6bd0d19bf2080c093881e0516557474a5"}, + {file = "yarl-1.13.1-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:373f16f38721c680316a6a00ae21cc178e3a8ef43c0227f88356a24c5193abd6"}, + {file = "yarl-1.13.1-cp38-cp38-musllinux_1_2_i686.whl", hash = "sha256:45d23c4668d4925688e2ea251b53f36a498e9ea860913ce43b52d9605d3d8177"}, + {file = "yarl-1.13.1-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:f7917697bcaa3bc3e83db91aa3a0e448bf5cde43c84b7fc1ae2427d2417c0224"}, + {file = "yarl-1.13.1-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:5989a38ba1281e43e4663931a53fbf356f78a0325251fd6af09dd03b1d676a09"}, + {file = "yarl-1.13.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:11b3ca8b42a024513adce810385fcabdd682772411d95bbbda3b9ed1a4257644"}, + {file = "yarl-1.13.1-cp38-cp38-win32.whl", hash = "sha256:dcaef817e13eafa547cdfdc5284fe77970b891f731266545aae08d6cce52161e"}, + {file = "yarl-1.13.1-cp38-cp38-win_amd64.whl", hash = "sha256:7addd26594e588503bdef03908fc207206adac5bd90b6d4bc3e3cf33a829f57d"}, + {file = "yarl-1.13.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:a0ae6637b173d0c40b9c1462e12a7a2000a71a3258fa88756a34c7d38926911c"}, + {file = "yarl-1.13.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:576365c9f7469e1f6124d67b001639b77113cfd05e85ce0310f5f318fd02fe85"}, + {file = "yarl-1.13.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:78f271722423b2d4851cf1f4fa1a1c4833a128d020062721ba35e1a87154a049"}, + {file = "yarl-1.13.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9d74f3c335cfe9c21ea78988e67f18eb9822f5d31f88b41aec3a1ec5ecd32da5"}, + {file = "yarl-1.13.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1891d69a6ba16e89473909665cd355d783a8a31bc84720902c5911dbb6373465"}, + {file = "yarl-1.13.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fb382fd7b4377363cc9f13ba7c819c3c78ed97c36a82f16f3f92f108c787cbbf"}, + {file = "yarl-1.13.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9c8854b9f80693d20cec797d8e48a848c2fb273eb6f2587b57763ccba3f3bd4b"}, + {file = "yarl-1.13.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:bbf2c3f04ff50f16404ce70f822cdc59760e5e2d7965905f0e700270feb2bbfc"}, + {file = "yarl-1.13.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:fb9f59f3848edf186a76446eb8bcf4c900fe147cb756fbbd730ef43b2e67c6a7"}, + {file = "yarl-1.13.1-cp39-cp39-musllinux_1_2_i686.whl", hash = "sha256:ef9b85fa1bc91c4db24407e7c4da93a5822a73dd4513d67b454ca7064e8dc6a3"}, + {file = "yarl-1.13.1-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:098b870c18f1341786f290b4d699504e18f1cd050ed179af8123fd8232513424"}, + {file = "yarl-1.13.1-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:8c723c91c94a3bc8033dd2696a0f53e5d5f8496186013167bddc3fb5d9df46a3"}, + {file = "yarl-1.13.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:44a4c40a6f84e4d5955b63462a0e2a988f8982fba245cf885ce3be7618f6aa7d"}, + {file = "yarl-1.13.1-cp39-cp39-win32.whl", hash = "sha256:84bbcdcf393139f0abc9f642bf03f00cac31010f3034faa03224a9ef0bb74323"}, + {file = "yarl-1.13.1-cp39-cp39-win_amd64.whl", hash = "sha256:fc2931ac9ce9c61c9968989ec831d3a5e6fcaaff9474e7cfa8de80b7aff5a093"}, + {file = "yarl-1.13.1-py3-none-any.whl", hash = "sha256:6a5185ad722ab4dd52d5fb1f30dcc73282eb1ed494906a92d1a228d3f89607b0"}, + {file = "yarl-1.13.1.tar.gz", hash = "sha256:ec8cfe2295f3e5e44c51f57272afbd69414ae629ec7c6b27f5a410efc78b70a0"}, +] + +[package.dependencies] +idna = ">=2.0" +multidict = ">=4.0" + +[[package]] +name = "zipp" +version = "3.20.2" +description = "Backport of pathlib-compatible object wrapper for zip files" +optional = false +python-versions = ">=3.8" +files = [ + {file = "zipp-3.20.2-py3-none-any.whl", hash = "sha256:a817ac80d6cf4b23bf7f2828b7cabf326f15a001bea8b1f9b49631780ba28350"}, + {file = "zipp-3.20.2.tar.gz", hash = "sha256:bc9eb26f4506fda01b81bcde0ca78103b6e62f991b381fec825435c836edbc29"}, +] + +[package.extras] +check = ["pytest-checkdocs (>=2.4)", "pytest-ruff (>=0.2.1)"] +cover = ["pytest-cov"] +doc = ["furo", "jaraco.packaging (>=9.3)", "jaraco.tidelift (>=1.4)", "rst.linker (>=1.9)", "sphinx (>=3.5)", "sphinx-lint"] +enabler = ["pytest-enabler (>=2.2)"] +test = ["big-O", "importlib-resources", "jaraco.functools", "jaraco.itertools", "jaraco.test", "more-itertools", "pytest (>=6,!=8.1.*)", "pytest-ignore-flaky"] +type = ["pytest-mypy"] + +[metadata] +lock-version = "2.0" +python-versions = ">=3.9,<3.13" +content-hash = "70786bf9967005cdef72a45f900d84a0151253956449be87866ef71b44e2b8c7" diff --git a/openbb_platform/extensions/platform_api/pyproject.toml b/openbb_platform/extensions/platform_api/pyproject.toml new file mode 100644 index 000000000000..a73683189d36 --- /dev/null +++ b/openbb_platform/extensions/platform_api/pyproject.toml @@ -0,0 +1,27 @@ +[tool.poetry] +name = "openbb-platform-api" +version = "1.0.2" +description = "OpenBB Platform API: Launch script and widgets builder for the OpenBB Platform API and Terminal Pro Connector." +authors = ["OpenBB "] +license = "AGPL-3.0-only" +readme = "README.md" +homepage = "https://openbb.co" +repository = "https://github.com/openbb-finance/openbb" +documentation = "https://docs.openbb.co" +packages = [{ include = "openbb_platform_api" }] + +[tool.poetry.scripts] +openbb-api = "openbb_platform_api.main:main" + +[tool.poetry.dependencies] +python = ">=3.9,<3.13" +poetry = "^1.8" +setuptools = "*" +openbb-core = "*" +deepdiff = "*" +ruff = "*" +black = "*" + +[build-system] +requires = ["poetry-core>=1.0.0"] +build-backend = "poetry.core.masonry.api" diff --git a/openbb_platform/extensions/platform_api/tests/mock_openapi.json b/openbb_platform/extensions/platform_api/tests/mock_openapi.json new file mode 100644 index 000000000000..46822bebb32d --- /dev/null +++ b/openbb_platform/extensions/platform_api/tests/mock_openapi.json @@ -0,0 +1,6357 @@ +{ + "openapi": "3.1.0", + "info": { + "title": "OpenBB Platform API", + "description": "This is the OpenBB Platform API.", + "termsOfService": "http://example.com/terms/", + "contact": { + "name": "OpenBB Team", + "url": "https://openbb.co/", + "email": "hello@openbb.co" + }, + "license": { + "name": "MIT", + "url": "https://github.com/OpenBB-finance/OpenBB/blob/develop/LICENSE" + }, + "version": "1" + }, + "servers": [ + { + "url": "http://localhost:8000", + "description": "Local OpenBB development server" + } + ], + "paths": { + "/api/v1/economy/survey/sloos": { + "get": { + "tags": [ + "economy" + ], + "summary": "Sloos", + "description": "Get Senior Loan Officers Opinion Survey.", + "operationId": "economy_survey_sloos", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "category", + "in": "query", + "required": false, + "schema": { + "enum": [ + "spreads", + "consumer", + "auto", + "credit_card", + "firms", + "mortgage", + "commercial_real_estate", + "standards", + "demand", + "foreign_banks" + ], + "type": "string", + "title": "fred", + "description": "Category of survey response. (provider: fred)", + "default": "spreads" + }, + "description": "Category of survey response. (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + }, + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_SeniorLoanOfficerSurvey" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "SeniorLoanOfficerSurvey", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "parameters": { + "category": "credit_card", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/survey/university_of_michigan": { + "get": { + "tags": [ + "economy" + ], + "summary": "University Of Michigan", + "description": "Get University of Michigan Consumer Sentiment and Inflation Expectations Surveys.", + "operationId": "economy_survey_university_of_michigan", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "annual", + "quarter" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly. (provider: fred)" + }, + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly. (provider: fred)" + }, + { + "name": "aggregation_method", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "avg", + "sum", + "eop" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + }, + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_UniversityOfMichigan" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "UniversityOfMichigan", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/survey/economic_conditions_chicago": { + "get": { + "tags": [ + "economy" + ], + "summary": "Economic Conditions Chicago", + "description": "Get The Survey Of Economic Conditions For The Chicago Region.", + "operationId": "economy_survey_economic_conditions_chicago", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "annual", + "quarter" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly. (provider: fred)" + }, + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly. (provider: fred)" + }, + { + "name": "aggregation_method", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "avg", + "sum", + "eop" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + }, + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_SurveyOfEconomicConditionsChicago" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "SurveyOfEconomicConditionsChicago", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/survey/manufacturing_outlook_texas": { + "get": { + "tags": [ + "economy" + ], + "summary": "Manufacturing Outlook Texas", + "description": "Get The Manufacturing Outlook Survey For The Texas Region.", + "operationId": "economy_survey_manufacturing_outlook_texas", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "topic", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "business_activity", + "business_outlook", + "capex", + "prices_paid", + "production", + "inventory", + "new_orders", + "new_orders_growth", + "unfilled_orders", + "shipments", + "delivery_time", + "employment", + "wages", + "hours_worked" + ], + "type": "string" + }, + { + "type": "string" + } + ], + "title": "fred", + "description": "The topic for the survey response. Multiple comma separated items allowed. (provider: fred)", + "fred": { + "multiple_items_allowed": true, + "choices": [ + "business_activity", + "business_outlook", + "capex", + "prices_paid", + "production", + "inventory", + "new_orders", + "new_orders_growth", + "unfilled_orders", + "shipments", + "delivery_time", + "employment", + "wages", + "hours_worked" + ] + }, + "default": "new_orders_growth" + }, + "description": "The topic for the survey response. Multiple comma separated items allowed. (provider: fred)" + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "annual", + "quarter" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "\n Frequency aggregation to convert monthly data to lower frequency. None is monthly.\n (provider: fred)" + }, + "description": "\n Frequency aggregation to convert monthly data to lower frequency. None is monthly.\n (provider: fred)" + }, + { + "name": "aggregation_method", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "avg", + "sum", + "eop" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "\n A key that indicates the aggregation method used for frequency aggregation.\n avg = Average\n sum = Sum\n eop = End of Period\n (provider: fred)" + }, + "description": "\n A key that indicates the aggregation method used for frequency aggregation.\n avg = Average\n sum = Sum\n eop = End of Period\n (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + }, + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_ManufacturingOutlookTexas" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "ManufacturingOutlookTexas", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "parameters": { + "topic": "business_outlook,new_orders", + "transform": "pc1", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/survey/nonfarm_payrolls": { + "get": { + "tags": [ + "economy" + ], + "summary": "Nonfarm Payrolls", + "description": "Get Nonfarm Payrolls Survey.", + "operationId": "economy_survey_nonfarm_payrolls", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed for provider(s): fred.", + "fred": { + "multiple_items_allowed": true + }, + "title": "Date" + }, + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed for provider(s): fred." + }, + { + "name": "category", + "in": "query", + "required": false, + "schema": { + "enum": [ + "employees_nsa", + "employees_sa", + "employees_production_and_nonsupervisory", + "employees_women", + "employees_women_percent", + "avg_hours", + "avg_hours_production_and_nonsupervisory", + "avg_hours_overtime", + "avg_hours_overtime_production_and_nonsupervisory", + "avg_earnings_hourly", + "avg_earnings_hourly_production_and_nonsupervisory", + "avg_earnings_weekly", + "avg_earnings_weekly_production_and_nonsupervisory", + "index_weekly_hours", + "index_weekly_hours_production_and_nonsupervisory", + "index_weekly_payrolls", + "index_weekly_payrolls_production_and_nonsupervisory" + ], + "type": "string", + "title": "fred", + "description": "The category to query. (provider: fred)", + "default": "employees_nsa" + }, + "description": "The category to query. (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_NonFarmPayrolls" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "NonFarmPayrolls", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "parameters": { + "category": "avg_hours", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/cpi": { + "get": { + "tags": [ + "economy" + ], + "summary": "Cpi", + "description": "Get Consumer Price Index (CPI).\n\nReturns either the rescaled index value, or a rate of change (inflation).", + "operationId": "economy_cpi", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "country", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "The country to get data. Multiple comma separated items allowed for provider(s): fred.", + "fred": { + "multiple_items_allowed": true, + "choices": [ + "australia", + "austria", + "belgium", + "brazil", + "bulgaria", + "canada", + "chile", + "china", + "croatia", + "cyprus", + "czech_republic", + "denmark", + "estonia", + "euro_area", + "finland", + "france", + "germany", + "greece", + "hungary", + "iceland", + "india", + "indonesia", + "ireland", + "israel", + "italy", + "japan", + "korea", + "latvia", + "lithuania", + "luxembourg", + "malta", + "mexico", + "netherlands", + "new_zealand", + "norway", + "poland", + "portugal", + "romania", + "russian_federation", + "slovak_republic", + "slovakia", + "slovenia", + "south_africa", + "spain", + "sweden", + "switzerland", + "turkey", + "united_kingdom", + "united_states" + ] + }, + "default": "united_states", + "title": "Country" + }, + "description": "The country to get data. Multiple comma separated items allowed for provider(s): fred." + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "enum": [ + "index", + "yoy", + "period" + ], + "type": "string", + "description": "Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy).", + "default": "yoy", + "title": "Transform" + }, + "description": "Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy)." + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "enum": [ + "annual", + "quarter", + "monthly" + ], + "type": "string", + "description": "The frequency of the data.", + "default": "monthly", + "title": "Frequency" + }, + "description": "The frequency of the data." + }, + { + "name": "harmonized", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "description": "If true, returns harmonized data.", + "default": false, + "title": "Harmonized" + }, + "description": "If true, returns harmonized data." + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_ConsumerPriceIndex" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "ConsumerPriceIndex", + "examples": [ + { + "scope": "api", + "parameters": { + "country": "japan,china,turkey", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/balance_of_payments": { + "get": { + "tags": [ + "economy" + ], + "summary": "Balance Of Payments", + "description": "Balance of Payments Reports.", + "operationId": "economy_balance_of_payments", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "country", + "in": "query", + "required": false, + "schema": { + "enum": [ + "argentina", + "australia", + "austria", + "belgium", + "brazil", + "canada", + "chile", + "china", + "colombia", + "costa_rica", + "czechia", + "denmark", + "estonia", + "finland", + "france", + "germany", + "greece", + "hungary", + "iceland", + "india", + "indonesia", + "ireland", + "israel", + "italy", + "japan", + "korea", + "latvia", + "lithuania", + "luxembourg", + "mexico", + "netherlands", + "new_zealand", + "norway", + "poland", + "portugal", + "russia", + "saudi_arabia", + "slovak_republic", + "slovenia", + "south_africa", + "spain", + "sweden", + "switzerland", + "turkey", + "united_kingdom", + "united_states", + "g7", + "g20" + ], + "type": "string", + "title": "fred", + "description": "The country to get data. Enter as a 3-letter ISO country code, default is USA. (provider: fred)", + "default": "united_states" + }, + "description": "The country to get data. Enter as a 3-letter ISO country code, default is USA. (provider: fred)" + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Start date of the data, in YYYY-MM-DD format. (provider: fred)" + }, + "description": "Start date of the data, in YYYY-MM-DD format. (provider: fred)" + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "End date of the data, in YYYY-MM-DD format. (provider: fred)" + }, + "description": "End date of the data, in YYYY-MM-DD format. (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_BalanceOfPayments" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "BalanceOfPayments", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "parameters": { + "provider": "fred", + "country": "brazil" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/fred_search": { + "get": { + "tags": [ + "economy" + ], + "summary": "Fred Search", + "description": "Search for FRED series or economic releases by ID or string.\n\nThis does not return the observation values, only the metadata.\nUse this function to find series IDs for `fred_series()`.", + "operationId": "economy_fred_search", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "query", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "The search word(s).", + "title": "Query" + }, + "description": "The search word(s)." + }, + { + "name": "is_release", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Is release? If True, other search filter variables are ignored. If no query text or release_id is supplied, this defaults to True. (provider: fred)", + "default": false + }, + "description": "Is release? If True, other search filter variables are ignored. If no query text or release_id is supplied, this defaults to True. (provider: fred)" + }, + { + "name": "release_id", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A specific release ID to target. (provider: fred)" + }, + "description": "A specific release ID to target. (provider: fred)" + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "The number of data entries to return. (1-1000) (provider: fred)" + }, + "description": "The number of data entries to return. (1-1000) (provider: fred)" + }, + { + "name": "offset", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "integer", + "minimum": 0 + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Offset the results in conjunction with limit. (provider: fred)", + "default": 0 + }, + "description": "Offset the results in conjunction with limit. (provider: fred)" + }, + { + "name": "filter_variable", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "frequency", + "units", + "seasonal_adjustment" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Filter by an attribute. (provider: fred)" + }, + "description": "Filter by an attribute. (provider: fred)" + }, + { + "name": "filter_value", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "String value to filter the variable by. Used in conjunction with filter_variable. (provider: fred)" + }, + "description": "String value to filter the variable by. Used in conjunction with filter_variable. (provider: fred)" + }, + { + "name": "tag_names", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A semicolon delimited list of tag names that series match all of. Example: 'japan;imports' Multiple comma separated items allowed. (provider: fred)", + "fred": { + "multiple_items_allowed": true + } + }, + "description": "A semicolon delimited list of tag names that series match all of. Example: 'japan;imports' Multiple comma separated items allowed. (provider: fred)" + }, + { + "name": "exclude_tag_names", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A semicolon delimited list of tag names that series match none of. Example: 'imports;services'. Requires that variable tag_names also be set to limit the number of matching series. Multiple comma separated items allowed. (provider: fred)", + "fred": { + "multiple_items_allowed": true + } + }, + "description": "A semicolon delimited list of tag names that series match none of. Example: 'imports;services'. Requires that variable tag_names also be set to limit the number of matching series. Multiple comma separated items allowed. (provider: fred)" + }, + { + "name": "series_id", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A FRED Series ID to return series group information for. This returns the required information to query for regional data. Not all series that are in FRED have geographical data. Entering a value for series_id will override all other parameters. Multiple series_ids can be separated by commas. (provider: fred)" + }, + "description": "A FRED Series ID to return series group information for. This returns the required information to query for regional data. Not all series that are in FRED have geographical data. Entering a value for series_id will override all other parameters. Multiple series_ids can be separated by commas. (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_FredSearch" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "FredSearch", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/fred_series": { + "get": { + "tags": [ + "economy" + ], + "summary": "Fred Series", + "description": "Get data by series ID from FRED.", + "operationId": "economy_fred_series", + "parameters": [ + { + "name": "chart", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "default": false, + "title": "Chart" + } + }, + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "symbol", + "in": "query", + "required": true, + "schema": { + "type": "string", + "description": "Symbol to get data for. Multiple comma separated items allowed for provider(s): fred.", + "fred": { + "multiple_items_allowed": true + }, + "title": "Symbol" + }, + "description": "Symbol to get data for. Multiple comma separated items allowed for provider(s): fred." + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "The number of data entries to return.", + "default": 100000, + "title": "Limit" + }, + "description": "The number of data entries to return." + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "a", + "q", + "m", + "w", + "d", + "wef", + "weth", + "wew", + "wetu", + "wem", + "wesu", + "wesa", + "bwew", + "bwem" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday\n (provider: fred)" + }, + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday\n (provider: fred)" + }, + { + "name": "aggregation_method", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "avg", + "sum", + "eop" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)", + "default": "eop" + }, + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + }, + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_FredSeries" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "FredSeries", + "examples": [ + { + "scope": "api", + "parameters": { + "symbol": "NFCI", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "Multiple series can be passed in as a list.", + "parameters": { + "symbol": "NFCI,STLFSI4", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "Use the `transform` parameter to transform the data as change, log, or percent change.", + "parameters": { + "symbol": "CBBTCUSD", + "transform": "pc1", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/fred_release_table": { + "get": { + "tags": [ + "economy" + ], + "summary": "Fred Release Table", + "description": "Get economic release data by ID and/or element from FRED.", + "operationId": "economy_fred_release_table", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "release_id", + "in": "query", + "required": true, + "schema": { + "type": "string", + "description": "The ID of the release. Use `fred_search` to find releases.", + "title": "Release Id" + }, + "description": "The ID of the release. Use `fred_search` to find releases." + }, + { + "name": "element_id", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "The element ID of a specific table in the release.", + "title": "Element Id" + }, + "description": "The element ID of a specific table in the release." + }, + { + "name": "date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "A specific date to get data for. Multiple comma separated items allowed for provider(s): fred.", + "fred": { + "multiple_items_allowed": true + }, + "title": "Date" + }, + "description": "A specific date to get data for. Multiple comma separated items allowed for provider(s): fred." + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_FredReleaseTable" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "FredReleaseTable", + "examples": [ + { + "scope": "api", + "description": "Get the top-level elements of a release by not supplying an element ID.", + "parameters": { + "release_id": "50", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "Drill down on a specific section of the release.", + "parameters": { + "release_id": "50", + "element_id": "4880", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "Drill down on a specific table of the release.", + "parameters": { + "release_id": "50", + "element_id": "4881", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/fred_regional": { + "get": { + "tags": [ + "economy" + ], + "summary": "Fred Regional", + "description": "Query the Geo Fred API for regional economic data by series group.\n\nThe series group ID is found by using `fred_search` and the `series_id` parameter.", + "operationId": "economy_fred_regional", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "symbol", + "in": "query", + "required": true, + "schema": { + "type": "string", + "description": "Symbol to get data for.", + "title": "Symbol" + }, + "description": "Symbol to get data for." + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "limit", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "description": "The number of data entries to return.", + "default": 100000, + "title": "Limit" + }, + "description": "The number of data entries to return." + }, + { + "name": "is_series_group", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "title": "fred", + "description": "When True, the symbol provided is for a series_group, else it is for a series ID. (provider: fred)", + "default": false + }, + "description": "When True, the symbol provided is for a series_group, else it is for a series ID. (provider: fred)" + }, + { + "name": "region_type", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "bea", + "msa", + "frb", + "necta", + "state", + "country", + "county", + "censusregion" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "The type of regional data. Parameter is only valid when `is_series_group` is True. (provider: fred)" + }, + "description": "The type of regional data. Parameter is only valid when `is_series_group` is True. (provider: fred)" + }, + { + "name": "season", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sa", + "nsa", + "ssa" + ], + "type": "string", + "title": "fred", + "description": "The seasonal adjustments to the data. Parameter is only valid when `is_series_group` is True. (provider: fred)", + "default": "nsa" + }, + "description": "The seasonal adjustments to the data. Parameter is only valid when `is_series_group` is True. (provider: fred)" + }, + { + "name": "units", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "The units of the data. This should match the units returned from searching by series ID. An incorrect field will not necessarily return an error. Parameter is only valid when `is_series_group` is True. (provider: fred)" + }, + "description": "The units of the data. This should match the units returned from searching by series ID. An incorrect field will not necessarily return an error. Parameter is only valid when `is_series_group` is True. (provider: fred)" + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "a", + "q", + "m", + "w", + "d", + "wef", + "weth", + "wew", + "wetu", + "wem", + "wesu", + "wesa", + "bwew", + "bwem" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday\n (provider: fred)" + }, + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday\n (provider: fred)" + }, + { + "name": "aggregation_method", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "avg", + "sum", + "eop" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)", + "default": "eop" + }, + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period\n (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + }, + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_FredRegional" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "FredRegional", + "examples": [ + { + "scope": "api", + "parameters": { + "symbol": "NYICLAIMS", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "With a date, time series data is returned.", + "parameters": { + "symbol": "NYICLAIMS", + "start_date": "2021-01-01", + "end_date": "2021-12-31", + "limit": 10, + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/retail_prices": { + "get": { + "tags": [ + "economy" + ], + "summary": "Retail Prices", + "description": "Get retail prices for common items.", + "operationId": "economy_retail_prices", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "item", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "The item or basket of items to query.", + "title": "Item" + }, + "description": "The item or basket of items to query." + }, + { + "name": "country", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "The country to get data.", + "default": "united_states", + "title": "Country" + }, + "description": "The country to get data." + }, + { + "name": "start_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "Start date of the data, in YYYY-MM-DD format.", + "title": "Start Date" + }, + "description": "Start date of the data, in YYYY-MM-DD format." + }, + { + "name": "end_date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "description": "End date of the data, in YYYY-MM-DD format.", + "title": "End Date" + }, + "description": "End date of the data, in YYYY-MM-DD format." + }, + { + "name": "region", + "in": "query", + "required": false, + "schema": { + "enum": [ + "all_city", + "northeast", + "midwest", + "south", + "west" + ], + "type": "string", + "title": "fred", + "description": "The region to get average price levels for. (provider: fred)", + "default": "all_city" + }, + "description": "The region to get average price levels for. (provider: fred)" + }, + { + "name": "frequency", + "in": "query", + "required": false, + "schema": { + "enum": [ + "annual", + "quarter", + "monthly" + ], + "type": "string", + "title": "fred", + "description": "The frequency of the data. (provider: fred)", + "default": "monthly" + }, + "description": "The frequency of the data. (provider: fred)" + }, + { + "name": "transform", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "enum": [ + "chg", + "ch1", + "pch", + "pc1", + "pca", + "cch", + "cca", + "log" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "fred", + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + }, + "description": "\n Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log\n (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_RetailPrices" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "RetailPrices", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "The price of eggs in the northeast census region.", + "parameters": { + "item": "eggs", + "region": "northeast", + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "The percentage change in price, from one-year ago, of various meats, US City Average.", + "parameters": { + "item": "meats", + "transform": "pc1", + "provider": "fred" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/economy/pce": { + "get": { + "tags": [ + "economy" + ], + "summary": "Pce", + "description": "Get Personal Consumption Expenditures (PCE) reports.", + "operationId": "economy_pce", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "fred" + ], + "const": "fred", + "type": "string", + "default": "fred", + "title": "Provider" + } + }, + { + "name": "date", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed for provider(s): fred.", + "fred": { + "multiple_items_allowed": true + }, + "title": "Date" + }, + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed for provider(s): fred." + }, + { + "name": "category", + "in": "query", + "required": false, + "schema": { + "enum": [ + "personal_income", + "wages_by_industry", + "real_pce_percent_change", + "real_pce_quantity_index", + "pce_price_index", + "pce_dollars", + "real_pce_chained_dollars", + "pce_price_percent_change" + ], + "type": "string", + "title": "fred", + "description": "The category to query. (provider: fred)", + "default": "personal_income" + }, + "description": "The category to query. (provider: fred)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_PersonalConsumptionExpenditures" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "PersonalConsumptionExpenditures", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "fred" + }, + "provider": "fred" + }, + { + "scope": "api", + "description": "Get reports for multiple dates, entered as a comma-separated string.", + "parameters": { + "provider": "fred", + "date": "2024-05-01,2024-04-01,2023-05-01", + "category": "pce_price_index" + }, + "provider": "fred" + } + ] + } + }, + "/api/v1/regulators/sec/cik_map": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Cik Map", + "description": "Map a ticker symbol to a CIK number.", + "operationId": "regulators_sec_cik_map", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + }, + { + "name": "symbol", + "in": "query", + "required": true, + "schema": { + "type": "string", + "description": "Symbol to get data for.", + "title": "Symbol" + }, + "description": "Symbol to get data for." + }, + { + "name": "use_cache", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "title": "sec", + "description": "Whether or not to use cache for the request, default is True. (provider: sec)", + "default": true + }, + "description": "Whether or not to use cache for the request, default is True. (provider: sec)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_CikMap" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "CikMap", + "examples": [ + { + "scope": "api", + "parameters": { + "symbol": "MSFT", + "provider": "sec" + }, + "provider": "sec" + } + ] + } + }, + "/api/v1/regulators/sec/institutions_search": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Institutions Search", + "description": "Search SEC-regulated institutions by name and return a list of results with CIK numbers.", + "operationId": "regulators_sec_institutions_search", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + }, + { + "name": "query", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Search query.", + "default": "", + "title": "Query" + }, + "description": "Search query." + }, + { + "name": "use_cache", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "description": "Whether or not to use cache.", + "default": true, + "title": "Use Cache" + }, + "description": "Whether or not to use cache." + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_InstitutionsSearch" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "InstitutionsSearch", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "sec" + }, + "provider": "sec" + }, + { + "scope": "api", + "parameters": { + "query": "blackstone real estate", + "provider": "sec" + }, + "provider": "sec" + } + ] + } + }, + "/api/v1/regulators/sec/schema_files": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Schema Files", + "description": "Use tool for navigating the directory of SEC XML schema files by year.", + "operationId": "regulators_sec_schema_files", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + }, + { + "name": "query", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Search query.", + "default": "", + "title": "Query" + }, + "description": "Search query." + }, + { + "name": "use_cache", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "description": "Whether or not to use cache.", + "default": true, + "title": "Use Cache" + }, + "description": "Whether or not to use cache." + }, + { + "name": "url", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "sec", + "description": "Enter an optional URL path to fetch the next level. (provider: sec)" + }, + "description": "Enter an optional URL path to fetch the next level. (provider: sec)" + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_SchemaFiles" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "SchemaFiles", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "sec" + }, + "provider": "sec" + }, + { + "scope": "python", + "description": "Get a list of schema files.", + "code": [ + "data = obb.regulators.sec.schema_files().results", + "data.files[0]", + "'https://xbrl.fasb.org/us-gaap/'", + "# The directory structure can be navigated by constructing a URL from the 'results' list.", + "url = data.files[0]+data.files[-1]", + "# The URL base will always be the 0 position in the list, feed the URL back in as a parameter.", + "obb.regulators.sec.schema_files(url=url).results.files", + "['https://xbrl.fasb.org/us-gaap/2024/'", + "'USGAAP2024FileList.xml'", + "'dis/'", + "'dqcrules/'", + "'ebp/'", + "'elts/'", + "'entire/'", + "'meta/'", + "'stm/'", + "'us-gaap-2024.zip']" + ] + } + ] + } + }, + "/api/v1/regulators/sec/symbol_map": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Symbol Map", + "description": "Map a CIK number to a ticker symbol, leading 0s can be omitted or included.", + "operationId": "regulators_sec_symbol_map", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + }, + { + "name": "query", + "in": "query", + "required": true, + "schema": { + "type": "string", + "description": "Search query.", + "title": "Query" + }, + "description": "Search query." + }, + { + "name": "use_cache", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "description": "Whether or not to use cache. If True, cache will store for seven days.", + "default": true, + "title": "Use Cache" + }, + "description": "Whether or not to use cache. If True, cache will store for seven days." + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_SymbolMap" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "SymbolMap", + "examples": [ + { + "scope": "api", + "parameters": { + "query": "0000789019", + "provider": "sec" + }, + "provider": "sec" + } + ] + } + }, + "/api/v1/regulators/sec/rss_litigation": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Rss Litigation", + "description": "Get the RSS feed that provides links to litigation releases concerning civil lawsuits brought by the Commission in federal court.", + "operationId": "regulators_sec_rss_litigation", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_RssLitigation" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "RssLitigation", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "sec" + }, + "provider": "sec" + } + ] + } + }, + "/api/v1/regulators/sec/sic_search": { + "get": { + "tags": [ + "regulators" + ], + "summary": "Sic Search", + "description": "Search for Industry Titles, Reporting Office, and SIC Codes. An empty query string returns all results.", + "operationId": "regulators_sec_sic_search", + "parameters": [ + { + "name": "provider", + "in": "query", + "required": false, + "schema": { + "enum": [ + "sec" + ], + "const": "sec", + "type": "string", + "default": "sec", + "title": "Provider" + } + }, + { + "name": "query", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Search query.", + "default": "", + "title": "Query" + }, + "description": "Search query." + }, + { + "name": "use_cache", + "in": "query", + "required": false, + "schema": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "description": "Whether or not to use cache.", + "default": true, + "title": "Use Cache" + }, + "description": "Whether or not to use cache." + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OBBject_SicSearch" + } + } + } + }, + "404": { + "description": "Not found" + }, + "400": { + "description": "No Results Found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "500": { + "description": "Internal Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OpenBBErrorResponse" + } + } + } + }, + "422": { + "description": "Validation Error", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/HTTPValidationError" + } + } + } + } + }, + "model": "SicSearch", + "examples": [ + { + "scope": "api", + "parameters": { + "provider": "sec" + }, + "provider": "sec" + }, + { + "scope": "api", + "parameters": { + "query": "real estate investment trusts", + "provider": "sec" + }, + "provider": "sec" + } + ] + } + } + }, + "components": { + "schemas": { + "Chart": { + "properties": { + "content": { + "anyOf": [ + { + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Content", + "description": "Raw textual representation of the chart." + }, + "format": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Format", + "description": "Complementary attribute to the `content` attribute. It specifies the format of the chart." + }, + "fig": { + "anyOf": [ + { + + }, + { + "type": "null" + } + ], + "title": "Fig", + "description": "The figure object.", + "exclude_from_api": true + } + }, + "type": "object", + "title": "Chart", + "description": "Model for Chart." + }, + "FREDConsumerPriceIndexData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "country": { + "type": "string", + "title": "Country" + }, + "value": { + "type": "number", + "title": "Value", + "description": "CPI index value or period change." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "country", + "value" + ], + "title": "FREDConsumerPriceIndexData", + "description": "FRED Consumer Price Index Data." + }, + "FredBalanceOfPaymentsData": { + "properties": { + "period": { + "type": "string", + "format": "date", + "title": "Period", + "description": "The date representing the beginning of the reporting period." + }, + "balance_percent_of_gdp": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Percent Of Gdp", + "description": "Current Account Balance as Percent of GDP", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "balance_total": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Total", + "description": "Current Account Total Balance (USD)" + }, + "balance_total_services": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Total Services", + "description": "Current Account Total Services Balance (USD)" + }, + "balance_total_secondary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Total Secondary Income", + "description": "Current Account Total Secondary Income Balance (USD)" + }, + "balance_total_goods": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Total Goods", + "description": "Current Account Total Goods Balance (USD)" + }, + "balance_total_primary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Balance Total Primary Income", + "description": "Current Account Total Primary Income Balance (USD)" + }, + "credits_services_percent_of_goods_and_services": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Services Percent Of Goods And Services", + "description": "Current Account Credits Services as Percent of Goods and Services", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "credits_services_percent_of_current_account": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Services Percent Of Current Account", + "description": "Current Account Credits Services as Percent of Current Account", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "credits_total_services": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Total Services", + "description": "Current Account Credits Total Services (USD)" + }, + "credits_total_goods": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Total Goods", + "description": "Current Account Credits Total Goods (USD)" + }, + "credits_total_primary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Total Primary Income", + "description": "Current Account Credits Total Primary Income (USD)" + }, + "credits_total_secondary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Total Secondary Income", + "description": "Current Account Credits Total Secondary Income (USD)" + }, + "credits_total": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Credits Total", + "description": "Current Account Credits Total (USD)" + }, + "debits_services_percent_of_goods_and_services": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Services Percent Of Goods And Services", + "description": "Current Account Debits Services as Percent of Goods and Services", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "debits_services_percent_of_current_account": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Services Percent Of Current Account", + "description": "Current Account Debits Services as Percent of Current Account", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "debits_total_services": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Total Services", + "description": "Current Account Debits Total Services (USD)" + }, + "debits_total_goods": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Total Goods", + "description": "Current Account Debits Total Goods (USD)" + }, + "debits_total_primary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Total Primary Income", + "description": "Current Account Debits Total Primary Income (USD)" + }, + "debits_total": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Total", + "description": "Current Account Debits Total (USD)" + }, + "debits_total_secondary_income": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Debits Total Secondary Income", + "description": "Current Account Debits Total Secondary Income (USD)" + } + }, + "additionalProperties": true, + "type": "object", + "title": "FredBalanceOfPaymentsData", + "description": "FRED Balance Of Payments Data." + }, + "FredManufacturingOutlookTexasData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "topic": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Topic", + "description": "Topic of the survey response." + }, + "diffusion_index": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Diffusion Index", + "description": "Diffusion Index." + }, + "percent_reporting_increase": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Percent Reporting Increase", + "description": "Percent of respondents reporting an increase over the last month.", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "percent_reporting_decrease": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Percent Reporting Decrease", + "description": "Percent of respondents reporting a decrease over the last month.", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + }, + "percent_reporting_no_change": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Percent Reporting No Change", + "description": "Percent of respondents reporting no change over the last month.", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date" + ], + "title": "FredManufacturingOutlookTexasData", + "description": "FRED Manufacturing Outlook - Texas - Data." + }, + "FredNonFarmPayrollsData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "symbol": { + "type": "string", + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + }, + "value": { + "type": "number", + "title": "Value", + "description": "" + }, + "name": { + "type": "string", + "title": "Name", + "description": "The name of the series." + }, + "element_id": { + "type": "string", + "title": "Element Id", + "description": "The element id in the parent/child relationship." + }, + "parent_id": { + "type": "string", + "title": "Parent Id", + "description": "The parent id in the parent/child relationship." + }, + "children": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Children", + "description": "The element_id of each child, as a comma-separated string." + }, + "level": { + "type": "integer", + "title": "Level", + "description": "The indentation level of the element." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "symbol", + "value", + "name", + "element_id", + "parent_id", + "level" + ], + "title": "FredNonFarmPayrollsData", + "description": "FRED NonFarm Payrolls Data." + }, + "FredPersonalConsumptionExpendituresData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "symbol": { + "type": "string", + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + }, + "value": { + "type": "number", + "title": "Value", + "description": "" + }, + "name": { + "type": "string", + "title": "Name", + "description": "The name of the series." + }, + "element_id": { + "type": "string", + "title": "Element Id", + "description": "The element id in the parent/child relationship." + }, + "parent_id": { + "type": "string", + "title": "Parent Id", + "description": "The parent id in the parent/child relationship." + }, + "children": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Children", + "description": "The element_id of each child, as a comma-separated string." + }, + "level": { + "type": "integer", + "title": "Level", + "description": "The indentation level of the element." + }, + "line": { + "type": "integer", + "title": "Line", + "description": "The line number of the series in the table." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "symbol", + "value", + "name", + "element_id", + "parent_id", + "level", + "line" + ], + "title": "FredPersonalConsumptionExpendituresData", + "description": "FRED Personal Consumption Expenditures Data." + }, + "FredRegionalData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "region": { + "type": "string", + "title": "Region", + "description": "The name of the region." + }, + "code": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + } + ], + "title": "Code", + "description": "The code of the region." + }, + "value": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Value", + "description": "The obersvation value. The units are defined in the search results by series ID." + }, + "series_id": { + "type": "string", + "title": "Series Id", + "description": "The individual series ID for the region." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "region", + "code", + "series_id" + ], + "title": "FredRegionalData", + "description": "FRED Regional Data." + }, + "FredReleaseTableData": { + "properties": { + "date": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "Date", + "description": "The date of the data." + }, + "level": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Level", + "description": "The indentation level of the element." + }, + "element_type": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Element Type", + "description": "The type of the element." + }, + "line": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Line", + "description": "The line number of the element." + }, + "element_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Element Id", + "description": "The element id in the parent/child relationship." + }, + "parent_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Parent Id", + "description": "The parent id in the parent/child relationship." + }, + "children": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Children", + "description": "The element_id of each child, as a comma-separated string." + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + }, + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Name", + "description": "The name of the series." + }, + "value": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Value", + "description": "The reported value of the series." + } + }, + "additionalProperties": true, + "type": "object", + "title": "FredReleaseTableData", + "description": "FRED Release Table Data." + }, + "FredRetailPricesData": { + "properties": { + "date": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "Date", + "description": "The date of the data." + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + }, + "country": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Country", + "description": "" + }, + "description": { + "type": "string", + "title": "Description", + "description": "Description of the item." + }, + "value": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Value", + "description": "Price, or change in price, per unit." + } + }, + "additionalProperties": true, + "type": "object", + "title": "FredRetailPricesData", + "description": "FRED Retail Prices Data." + }, + "FredSearchData": { + "properties": { + "release_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Release Id", + "description": "The release ID for queries." + }, + "series_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Series Id", + "description": "The series ID for the item in the release." + }, + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Name", + "description": "The name of the release." + }, + "title": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Title", + "description": "The title of the series." + }, + "observation_start": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "Observation Start", + "description": "The date of the first observation in the series." + }, + "observation_end": { + "anyOf": [ + { + "type": "string", + "format": "date" + }, + { + "type": "null" + } + ], + "title": "Observation End", + "description": "The date of the last observation in the series." + }, + "frequency": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Frequency", + "description": "The frequency of the data." + }, + "frequency_short": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Frequency Short", + "description": "Short form of the data frequency." + }, + "units": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Units", + "description": "The units of the data." + }, + "units_short": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Units Short", + "description": "Short form of the data units." + }, + "seasonal_adjustment": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Seasonal Adjustment", + "description": "The seasonal adjustment of the data." + }, + "seasonal_adjustment_short": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Seasonal Adjustment Short", + "description": "Short form of the data seasonal adjustment." + }, + "last_updated": { + "anyOf": [ + { + "type": "string", + "format": "date-time" + }, + { + "type": "null" + } + ], + "title": "Last Updated", + "description": "The datetime of the last update to the data." + }, + "notes": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Notes", + "description": "Description of the release." + }, + "press_release": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "title": "Press Release", + "description": "If the release is a press release." + }, + "url": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Url", + "description": "URL to the release." + }, + "popularity": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Popularity", + "description": "Popularity of the series" + }, + "group_popularity": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Group Popularity", + "description": "Group popularity of the release" + }, + "region_type": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Region Type", + "description": "The region type of the series." + }, + "series_group": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Series Group", + "description": "The series group ID of the series. This value is used to query for regional data." + } + }, + "additionalProperties": true, + "type": "object", + "title": "FredSearchData", + "description": "FRED Search Data." + }, + "FredSeniorLoanOfficerSurveyData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + }, + "value": { + "type": "number", + "title": "Value", + "description": "Survey value." + }, + "title": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Title", + "description": "Survey title." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "value", + "title" + ], + "title": "FredSeniorLoanOfficerSurveyData", + "description": "FRED Senior Loan Officer Opinion Survey Data." + }, + "FredSeriesData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date" + ], + "title": "FredSeriesData", + "description": "FRED Series Data." + }, + "FredSurveyOfEconomicConditionsChicagoData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "activity_index": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Activity Index", + "description": "Activity Index." + }, + "one_year_outlook": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "One Year Outlook", + "description": "One Year Outlook Index." + }, + "manufacturing_activity": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Manufacturing Activity", + "description": "Manufacturing Activity Index." + }, + "non_manufacturing_activity": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Non Manufacturing Activity", + "description": "Non-Manufacturing Activity Index." + }, + "capital_expenditures_expectations": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Capital Expenditures Expectations", + "description": "Capital Expenditures Expectations Index." + }, + "hiring_expectations": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Hiring Expectations", + "description": "Hiring Expectations Index." + }, + "current_hiring": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Current Hiring", + "description": "Current Hiring Index." + }, + "labor_costs": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Labor Costs", + "description": "Labor Costs Index." + }, + "non_labor_costs": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Non Labor Costs", + "description": "Non-Labor Costs Index." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date" + ], + "title": "FredSurveyOfEconomicConditionsChicagoData", + "description": "FRED Survey Of Economic Conditions - Chicago - Data." + }, + "FredUofMichiganData": { + "properties": { + "date": { + "type": "string", + "format": "date", + "title": "Date", + "description": "The date of the data." + }, + "consumer_sentiment": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Consumer Sentiment", + "description": "Index of the results of the University of Michigan's monthly Survey of Consumers, which is used to estimate future spending and saving. (1966:Q1=100)." + }, + "inflation_expectation": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Inflation Expectation", + "description": "Median expected price change next 12 months, Surveys of Consumers.", + "x-frontend_multiply": 100, + "x-unit_measurement": "percent" + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date" + ], + "title": "FredUofMichiganData", + "description": "FRED University of Michigan Survey Data." + }, + "HTTPValidationError": { + "properties": { + "detail": { + "items": { + "$ref": "#/components/schemas/ValidationError" + }, + "type": "array", + "title": "Detail" + } + }, + "type": "object", + "title": "HTTPValidationError" + }, + "OBBject_BalanceOfPayments": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredBalanceOfPaymentsData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_BalanceOfPayments", + "description": "OBBject with results of type BalanceOfPayments" + }, + "OBBject_CikMap": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "$ref": "#/components/schemas/SecCikMapData" + }, + { + "type": "null" + } + ], + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_CikMap", + "description": "OBBject with results of type CikMap" + }, + "OBBject_ConsumerPriceIndex": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FREDConsumerPriceIndexData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_ConsumerPriceIndex", + "description": "OBBject with results of type ConsumerPriceIndex" + }, + "OBBject_FredRegional": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredRegionalData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_FredRegional", + "description": "OBBject with results of type FredRegional" + }, + "OBBject_FredReleaseTable": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredReleaseTableData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_FredReleaseTable", + "description": "OBBject with results of type FredReleaseTable" + }, + "OBBject_FredSearch": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredSearchData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_FredSearch", + "description": "OBBject with results of type FredSearch" + }, + "OBBject_FredSeries": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredSeriesData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_FredSeries", + "description": "OBBject with results of type FredSeries" + }, + "OBBject_InstitutionsSearch": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/SecInstitutionsSearchData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_InstitutionsSearch", + "description": "OBBject with results of type InstitutionsSearch" + }, + "OBBject_ManufacturingOutlookTexas": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredManufacturingOutlookTexasData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_ManufacturingOutlookTexas", + "description": "OBBject with results of type ManufacturingOutlookTexas" + }, + "OBBject_NonFarmPayrolls": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredNonFarmPayrollsData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_NonFarmPayrolls", + "description": "OBBject with results of type NonFarmPayrolls" + }, + "OBBject_PersonalConsumptionExpenditures": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredPersonalConsumptionExpendituresData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_PersonalConsumptionExpenditures", + "description": "OBBject with results of type PersonalConsumptionExpenditures" + }, + "OBBject_RetailPrices": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredRetailPricesData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_RetailPrices", + "description": "OBBject with results of type RetailPrices" + }, + "OBBject_RssLitigation": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/SecRssLitigationData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_RssLitigation", + "description": "OBBject with results of type RssLitigation" + }, + "OBBject_SchemaFiles": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "$ref": "#/components/schemas/SecSchemaFilesData" + }, + { + "type": "null" + } + ], + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_SchemaFiles", + "description": "OBBject with results of type SchemaFiles" + }, + "OBBject_SeniorLoanOfficerSurvey": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredSeniorLoanOfficerSurveyData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_SeniorLoanOfficerSurvey", + "description": "OBBject with results of type SeniorLoanOfficerSurvey" + }, + "OBBject_SicSearch": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/SecSicSearchData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_SicSearch", + "description": "OBBject with results of type SicSearch" + }, + "OBBject_SurveyOfEconomicConditionsChicago": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredSurveyOfEconomicConditionsChicagoData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_SurveyOfEconomicConditionsChicago", + "description": "OBBject with results of type SurveyOfEconomicConditionsChicago" + }, + "OBBject_SymbolMap": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "$ref": "#/components/schemas/SecSymbolMapData" + }, + { + "type": "null" + } + ], + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_SymbolMap", + "description": "OBBject with results of type SymbolMap" + }, + "OBBject_UniversityOfMichigan": { + "properties": { + "_id": { + "type": "string", + "title": " Id" + }, + "results": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/FredUofMichiganData" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Results", + "description": "Serializable results." + }, + "provider": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Provider", + "description": "Provider name." + }, + "warnings": { + "anyOf": [ + { + "items": { + "$ref": "#/components/schemas/Warning_" + }, + "type": "array" + }, + { + "type": "null" + } + ], + "title": "Warnings", + "description": "List of warnings." + }, + "chart": { + "anyOf": [ + { + "$ref": "#/components/schemas/Chart" + }, + { + "type": "null" + } + ], + "description": "Chart object." + }, + "extra": { + "type": "object", + "title": "Extra", + "description": "Extra info." + } + }, + "type": "object", + "title": "OBBject_UniversityOfMichigan", + "description": "OBBject with results of type UniversityOfMichigan" + }, + "OpenBBErrorResponse": { + "properties": { + "detail": { + "type": "string", + "title": "Detail" + }, + "error_kind": { + "type": "string", + "title": "Error Kind" + } + }, + "type": "object", + "required": [ + "detail", + "error_kind" + ], + "title": "OpenBBErrorResponse", + "description": "OpenBB Error Response." + }, + "SecCikMapData": { + "properties": { + "cik": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Cik", + "description": "Central Index Key (CIK) for the requested entity." + } + }, + "additionalProperties": true, + "type": "object", + "title": "SecCikMapData", + "description": "SEC CIK Mapping Data." + }, + "SecInstitutionsSearchData": { + "properties": { + "Institution": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Institution", + "description": "The name of the institution." + }, + "CIK Number": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Cik Number", + "description": "Central Index Key (CIK)" + } + }, + "additionalProperties": true, + "type": "object", + "title": "SecInstitutionsSearchData", + "description": "SEC Institutions Search Data." + }, + "SecRssLitigationData": { + "properties": { + "date": { + "type": "string", + "format": "date-time", + "title": "Date", + "description": "The date of publication." + }, + "title": { + "type": "string", + "title": "Title", + "description": "The title of the release." + }, + "summary": { + "type": "string", + "title": "Summary", + "description": "Short summary of the release." + }, + "id": { + "type": "string", + "title": "Id", + "description": "The identifier associated with the release." + }, + "link": { + "type": "string", + "title": "Link", + "description": "URL to the release." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "date", + "title", + "summary", + "id", + "link" + ], + "title": "SecRssLitigationData", + "description": "SEC Litigation RSS Feed Data." + }, + "SecSchemaFilesData": { + "properties": { + "files": { + "items": { + "type": "string" + }, + "type": "array", + "title": "Files", + "description": "Dictionary of URLs to SEC Schema Files" + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "files" + ], + "title": "SecSchemaFilesData", + "description": "SEC Schema Files List Data." + }, + "SecSicSearchData": { + "properties": { + "SIC Code": { + "type": "integer", + "title": "Sic Code", + "description": "Sector Industrial Code (SIC)" + }, + "Industry Title": { + "type": "string", + "title": "Industry Title", + "description": "Industry title." + }, + "Office": { + "type": "string", + "title": "Office", + "description": "Reporting office within the Corporate Finance Office" + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "SIC Code", + "Industry Title", + "Office" + ], + "title": "SecSicSearchData", + "description": "SEC Standard Industrial Classification Code (SIC) Data." + }, + "SecSymbolMapData": { + "properties": { + "symbol": { + "type": "string", + "title": "Symbol", + "description": "Symbol representing the entity requested in the data." + } + }, + "additionalProperties": true, + "type": "object", + "required": [ + "symbol" + ], + "title": "SecSymbolMapData", + "description": "SEC symbol map Data." + }, + "ValidationError": { + "properties": { + "loc": { + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "integer" + } + ] + }, + "type": "array", + "title": "Location" + }, + "msg": { + "type": "string", + "title": "Message" + }, + "type": { + "type": "string", + "title": "Error Type" + } + }, + "type": "object", + "required": [ + "loc", + "msg", + "type" + ], + "title": "ValidationError" + }, + "Warning_": { + "properties": { + "category": { + "type": "string", + "title": "Category" + }, + "message": { + "type": "string", + "title": "Message" + } + }, + "type": "object", + "required": [ + "category", + "message" + ], + "title": "Warning_", + "description": "Model for Warning." + } + } + }, + "tags": [ + { + "name": "economy", + "description": "Economic data." + }, + { + "name": "regulators", + "description": "Financial market regulators data." + } + ] +} diff --git a/openbb_platform/extensions/platform_api/tests/mock_widgets.json b/openbb_platform/extensions/platform_api/tests/mock_widgets.json new file mode 100644 index 000000000000..6c4b8d325cfe --- /dev/null +++ b/openbb_platform/extensions/platform_api/tests/mock_widgets.json @@ -0,0 +1,3615 @@ +{ + "economy_survey_sloos_fred_obb": { + "name": "SLOOS", + "description": "Get Senior Loan Officers Opinion Survey.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_survey_sloos_fred_obb", + "params": [ + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Category", + "description": "Category of survey response.", + "optional": true, + "value": "spreads", + "type": "text", + "show": true, + "options": [ + { + "label": "spreads", + "value": "spreads" + }, + { + "label": "consumer", + "value": "consumer" + }, + { + "label": "auto", + "value": "auto" + }, + { + "label": "credit_card", + "value": "credit_card" + }, + { + "label": "firms", + "value": "firms" + }, + { + "label": "mortgage", + "value": "mortgage" + }, + { + "label": "commercial_real_estate", + "value": "commercial_real_estate" + }, + { + "label": "standards", + "value": "standards" + }, + { + "label": "demand", + "value": "demand" + }, + { + "label": "foreign_banks", + "value": "foreign_banks" + } + ], + "paramName": "category" + }, + { + "label": "Transform", + "description": "Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/survey/sloos", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "symbol", + "pinned": "left", + "formatterFn": null, + "headerName": "Symbol", + "description": "Symbol representing the entity requested in the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "Survey value.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "title", + "pinned": "left", + "formatterFn": null, + "headerName": "Title", + "description": "Survey title.", + "cellDataType": "text", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "FRED" + ], + "subCategory": "Survey" + }, + "economy_survey_university_of_michigan_fred_obb": { + "name": "University Of Michigan", + "description": "Get University of Michigan Consumer Sentiment and Inflation Expectations Surveys.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_survey_university_of_michigan_fred_obb", + "params": [ + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly.", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "annual", + "value": "annual" + }, + { + "label": "quarter", + "value": "quarter" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/survey/university_of_michigan", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "consumer_sentiment", + "headerName": "Consumer Sentiment", + "description": "Index of the results of the University of Michigan's monthly Survey of Consumers, which is used to estimate future spending and saving. (1966:Q1=100).", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "inflation_expectation", + "formatterFn": "normalizedPercent", + "headerName": "Inflation Expectation", + "description": "Median expected price change next 12 months, Surveys of Consumers.", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + } + ] + } + }, + "source": [ + "FRED" + ], + "subCategory": "Survey" + }, + "economy_survey_economic_conditions_chicago_fred_obb": { + "name": "Economic Conditions Chicago", + "description": "Get The Survey Of Economic Conditions For The Chicago Region.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_survey_economic_conditions_chicago_fred_obb", + "params": [ + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly.", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "annual", + "value": "annual" + }, + { + "label": "quarter", + "value": "quarter" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/survey/economic_conditions_chicago", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "activity_index", + "headerName": "Activity Index", + "description": "Activity Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "one_year_outlook", + "headerName": "One Year Outlook", + "description": "One Year Outlook Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "manufacturing_activity", + "headerName": "Manufacturing Activity", + "description": "Manufacturing Activity Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "non_manufacturing_activity", + "headerName": "Non Manufacturing Activity", + "description": "Non-Manufacturing Activity Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "capital_expenditures_expectations", + "headerName": "Capital Expenditures Expectations", + "description": "Capital Expenditures Expectations Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "hiring_expectations", + "headerName": "Hiring Expectations", + "description": "Hiring Expectations Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "current_hiring", + "headerName": "Current Hiring", + "description": "Current Hiring Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "labor_costs", + "headerName": "Labor Costs", + "description": "Labor Costs Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "non_labor_costs", + "headerName": "Non Labor Costs", + "description": "Non-Labor Costs Index.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ], + "subCategory": "Survey" + }, + "economy_survey_manufacturing_outlook_texas_fred_obb": { + "name": "Manufacturing Outlook Texas", + "description": "Get The Manufacturing Outlook Survey For The Texas Region.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_survey_manufacturing_outlook_texas_fred_obb", + "params": [ + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Topic", + "description": "The topic for the survey response. Multiple comma separated items allowed.", + "optional": true, + "value": "new_orders_growth", + "show": true, + "type": "text", + "multiSelect": true, + "options": [ + { + "label": "business_activity", + "value": "business_activity" + }, + { + "label": "business_outlook", + "value": "business_outlook" + }, + { + "label": "capex", + "value": "capex" + }, + { + "label": "prices_paid", + "value": "prices_paid" + }, + { + "label": "production", + "value": "production" + }, + { + "label": "inventory", + "value": "inventory" + }, + { + "label": "new_orders", + "value": "new_orders" + }, + { + "label": "new_orders_growth", + "value": "new_orders_growth" + }, + { + "label": "unfilled_orders", + "value": "unfilled_orders" + }, + { + "label": "shipments", + "value": "shipments" + }, + { + "label": "delivery_time", + "value": "delivery_time" + }, + { + "label": "employment", + "value": "employment" + }, + { + "label": "wages", + "value": "wages" + }, + { + "label": "hours_worked", + "value": "hours_worked" + } + ], + "paramName": "topic" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert monthly data to lower frequency. None is monthly.", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "annual", + "value": "annual" + }, + { + "label": "quarter", + "value": "quarter" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n avg = Average\n sum = Sum\n eop = End of Period", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/survey/manufacturing_outlook_texas", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "topic", + "formatterFn": null, + "headerName": "Topic", + "description": "Topic of the survey response.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "diffusion_index", + "headerName": "Diffusion Index", + "description": "Diffusion Index.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "percent_reporting_increase", + "formatterFn": "normalizedPercent", + "headerName": "Percent Reporting Increase", + "description": "Percent of respondents reporting an increase over the last month.", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "percent_reporting_decrease", + "formatterFn": "normalizedPercent", + "headerName": "Percent Reporting Decrease", + "description": "Percent of respondents reporting a decrease over the last month.", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "percent_reporting_no_change", + "formatterFn": "normalizedPercent", + "headerName": "Percent Reporting No Change", + "description": "Percent of respondents reporting no change over the last month.", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + } + ] + } + }, + "source": [ + "FRED" + ], + "subCategory": "Survey" + }, + "economy_survey_nonfarm_payrolls_fred_obb": { + "name": "Nonfarm Payrolls", + "description": "Get Nonfarm Payrolls Survey.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_survey_nonfarm_payrolls_fred_obb", + "params": [ + { + "label": "Date", + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed.", + "optional": true, + "value": null, + "type": "text", + "show": true, + "multiSelect": true, + "paramName": "date" + }, + { + "label": "Category", + "description": "The category to query.", + "optional": true, + "value": "employees_nsa", + "type": "text", + "show": true, + "options": [ + { + "label": "employees_nsa", + "value": "employees_nsa" + }, + { + "label": "employees_sa", + "value": "employees_sa" + }, + { + "label": "employees_production_and_nonsupervisory", + "value": "employees_production_and_nonsupervisory" + }, + { + "label": "employees_women", + "value": "employees_women" + }, + { + "label": "employees_women_percent", + "value": "employees_women_percent" + }, + { + "label": "avg_hours", + "value": "avg_hours" + }, + { + "label": "avg_hours_production_and_nonsupervisory", + "value": "avg_hours_production_and_nonsupervisory" + }, + { + "label": "avg_hours_overtime", + "value": "avg_hours_overtime" + }, + { + "label": "avg_hours_overtime_production_and_nonsupervisory", + "value": "avg_hours_overtime_production_and_nonsupervisory" + }, + { + "label": "avg_earnings_hourly", + "value": "avg_earnings_hourly" + }, + { + "label": "avg_earnings_hourly_production_and_nonsupervisory", + "value": "avg_earnings_hourly_production_and_nonsupervisory" + }, + { + "label": "avg_earnings_weekly", + "value": "avg_earnings_weekly" + }, + { + "label": "avg_earnings_weekly_production_and_nonsupervisory", + "value": "avg_earnings_weekly_production_and_nonsupervisory" + }, + { + "label": "index_weekly_hours", + "value": "index_weekly_hours" + }, + { + "label": "index_weekly_hours_production_and_nonsupervisory", + "value": "index_weekly_hours_production_and_nonsupervisory" + }, + { + "label": "index_weekly_payrolls", + "value": "index_weekly_payrolls" + }, + { + "label": "index_weekly_payrolls_production_and_nonsupervisory", + "value": "index_weekly_payrolls_production_and_nonsupervisory" + } + ], + "paramName": "category" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/survey/nonfarm_payrolls", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "symbol", + "pinned": "left", + "formatterFn": null, + "headerName": "Symbol", + "description": "Symbol representing the entity requested in the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "name", + "pinned": "left", + "formatterFn": null, + "headerName": "Name", + "description": "The name of the series.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "element_id", + "formatterFn": null, + "headerName": "Element Id", + "description": "The element id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "parent_id", + "formatterFn": null, + "headerName": "Parent Id", + "description": "The parent id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "children", + "formatterFn": null, + "headerName": "Children", + "description": "The element_id of each child, as a comma-separated string.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "level", + "headerName": "Level", + "description": "The indentation level of the element.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ], + "subCategory": "Survey" + }, + "economy_cpi_fred_obb": { + "name": "CPI", + "description": "Get Consumer Price Index (CPI).\n\nReturns either the rescaled index value, or a rate of change (inflation).", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_cpi_fred_obb", + "params": [ + { + "label": "Country", + "description": "The country to get data. Multiple comma separated items allowed.", + "optional": true, + "value": "united_states", + "type": "text", + "show": true, + "multiSelect": true, + "options": [ + { + "label": "australia", + "value": "australia" + }, + { + "label": "austria", + "value": "austria" + }, + { + "label": "belgium", + "value": "belgium" + }, + { + "label": "brazil", + "value": "brazil" + }, + { + "label": "bulgaria", + "value": "bulgaria" + }, + { + "label": "canada", + "value": "canada" + }, + { + "label": "chile", + "value": "chile" + }, + { + "label": "china", + "value": "china" + }, + { + "label": "croatia", + "value": "croatia" + }, + { + "label": "cyprus", + "value": "cyprus" + }, + { + "label": "czech_republic", + "value": "czech_republic" + }, + { + "label": "denmark", + "value": "denmark" + }, + { + "label": "estonia", + "value": "estonia" + }, + { + "label": "euro_area", + "value": "euro_area" + }, + { + "label": "finland", + "value": "finland" + }, + { + "label": "france", + "value": "france" + }, + { + "label": "germany", + "value": "germany" + }, + { + "label": "greece", + "value": "greece" + }, + { + "label": "hungary", + "value": "hungary" + }, + { + "label": "iceland", + "value": "iceland" + }, + { + "label": "india", + "value": "india" + }, + { + "label": "indonesia", + "value": "indonesia" + }, + { + "label": "ireland", + "value": "ireland" + }, + { + "label": "israel", + "value": "israel" + }, + { + "label": "italy", + "value": "italy" + }, + { + "label": "japan", + "value": "japan" + }, + { + "label": "korea", + "value": "korea" + }, + { + "label": "latvia", + "value": "latvia" + }, + { + "label": "lithuania", + "value": "lithuania" + }, + { + "label": "luxembourg", + "value": "luxembourg" + }, + { + "label": "malta", + "value": "malta" + }, + { + "label": "mexico", + "value": "mexico" + }, + { + "label": "netherlands", + "value": "netherlands" + }, + { + "label": "new_zealand", + "value": "new_zealand" + }, + { + "label": "norway", + "value": "norway" + }, + { + "label": "poland", + "value": "poland" + }, + { + "label": "portugal", + "value": "portugal" + }, + { + "label": "romania", + "value": "romania" + }, + { + "label": "russian_federation", + "value": "russian_federation" + }, + { + "label": "slovak_republic", + "value": "slovak_republic" + }, + { + "label": "slovakia", + "value": "slovakia" + }, + { + "label": "slovenia", + "value": "slovenia" + }, + { + "label": "south_africa", + "value": "south_africa" + }, + { + "label": "spain", + "value": "spain" + }, + { + "label": "sweden", + "value": "sweden" + }, + { + "label": "switzerland", + "value": "switzerland" + }, + { + "label": "turkey", + "value": "turkey" + }, + { + "label": "united_kingdom", + "value": "united_kingdom" + }, + { + "label": "united_states", + "value": "united_states" + } + ], + "paramName": "country" + }, + { + "label": "Transform", + "description": "Transformation of the CPI data. Period represents the change since previous. Defaults to change from one year ago (yoy).", + "optional": true, + "value": "yoy", + "type": "text", + "show": true, + "options": [ + { + "label": "index", + "value": "index" + }, + { + "label": "yoy", + "value": "yoy" + }, + { + "label": "period", + "value": "period" + } + ], + "paramName": "transform" + }, + { + "label": "Frequency", + "description": "The frequency of the data.", + "optional": true, + "value": "monthly", + "type": "text", + "show": true, + "options": [ + { + "label": "annual", + "value": "annual" + }, + { + "label": "quarter", + "value": "quarter" + }, + { + "label": "monthly", + "value": "monthly" + } + ], + "paramName": "frequency" + }, + { + "label": "Harmonized", + "description": "If true, returns harmonized data.", + "optional": true, + "value": false, + "type": "boolean", + "show": true, + "paramName": "harmonized" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/cpi", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "country", + "formatterFn": null, + "headerName": "Country", + "description": "Country", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "CPI index value or period change.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_balance_of_payments_fred_obb": { + "name": "Balance Of Payments", + "description": "Balance of Payments Reports.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_balance_of_payments_fred_obb", + "params": [ + { + "label": "Country", + "description": "The country to get data. Enter as a 3-letter ISO country code, default is USA.", + "optional": true, + "value": "united_states", + "type": "text", + "show": true, + "options": [ + { + "label": "argentina", + "value": "argentina" + }, + { + "label": "australia", + "value": "australia" + }, + { + "label": "austria", + "value": "austria" + }, + { + "label": "belgium", + "value": "belgium" + }, + { + "label": "brazil", + "value": "brazil" + }, + { + "label": "canada", + "value": "canada" + }, + { + "label": "chile", + "value": "chile" + }, + { + "label": "china", + "value": "china" + }, + { + "label": "colombia", + "value": "colombia" + }, + { + "label": "costa_rica", + "value": "costa_rica" + }, + { + "label": "czechia", + "value": "czechia" + }, + { + "label": "denmark", + "value": "denmark" + }, + { + "label": "estonia", + "value": "estonia" + }, + { + "label": "finland", + "value": "finland" + }, + { + "label": "france", + "value": "france" + }, + { + "label": "germany", + "value": "germany" + }, + { + "label": "greece", + "value": "greece" + }, + { + "label": "hungary", + "value": "hungary" + }, + { + "label": "iceland", + "value": "iceland" + }, + { + "label": "india", + "value": "india" + }, + { + "label": "indonesia", + "value": "indonesia" + }, + { + "label": "ireland", + "value": "ireland" + }, + { + "label": "israel", + "value": "israel" + }, + { + "label": "italy", + "value": "italy" + }, + { + "label": "japan", + "value": "japan" + }, + { + "label": "korea", + "value": "korea" + }, + { + "label": "latvia", + "value": "latvia" + }, + { + "label": "lithuania", + "value": "lithuania" + }, + { + "label": "luxembourg", + "value": "luxembourg" + }, + { + "label": "mexico", + "value": "mexico" + }, + { + "label": "netherlands", + "value": "netherlands" + }, + { + "label": "new_zealand", + "value": "new_zealand" + }, + { + "label": "norway", + "value": "norway" + }, + { + "label": "poland", + "value": "poland" + }, + { + "label": "portugal", + "value": "portugal" + }, + { + "label": "russia", + "value": "russia" + }, + { + "label": "saudi_arabia", + "value": "saudi_arabia" + }, + { + "label": "slovak_republic", + "value": "slovak_republic" + }, + { + "label": "slovenia", + "value": "slovenia" + }, + { + "label": "south_africa", + "value": "south_africa" + }, + { + "label": "spain", + "value": "spain" + }, + { + "label": "sweden", + "value": "sweden" + }, + { + "label": "switzerland", + "value": "switzerland" + }, + { + "label": "turkey", + "value": "turkey" + }, + { + "label": "united_kingdom", + "value": "united_kingdom" + }, + { + "label": "united_states", + "value": "united_states" + }, + { + "label": "g7", + "value": "g7" + }, + { + "label": "g20", + "value": "g20" + } + ], + "paramName": "country" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/balance_of_payments", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "period", + "formatterFn": null, + "headerName": "Period", + "description": "The date representing the beginning of the reporting period.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "balance_percent_of_gdp", + "formatterFn": "normalizedPercent", + "headerName": "Balance Percent Of Gdp", + "description": "Current Account Balance as Percent of GDP", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "balance_total", + "headerName": "Balance Total", + "description": "Current Account Total Balance (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "balance_total_services", + "headerName": "Balance Total Services", + "description": "Current Account Total Services Balance (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "balance_total_secondary_income", + "headerName": "Balance Total Secondary Income", + "description": "Current Account Total Secondary Income Balance (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "balance_total_goods", + "headerName": "Balance Total Goods", + "description": "Current Account Total Goods Balance (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "balance_total_primary_income", + "headerName": "Balance Total Primary Income", + "description": "Current Account Total Primary Income Balance (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "credits_services_percent_of_goods_and_services", + "formatterFn": "normalizedPercent", + "headerName": "Credits Services Percent Of Goods And Services", + "description": "Current Account Credits Services as Percent of Goods and Services", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "credits_services_percent_of_current_account", + "formatterFn": "normalizedPercent", + "headerName": "Credits Services Percent Of Current Account", + "description": "Current Account Credits Services as Percent of Current Account", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "credits_total_services", + "headerName": "Credits Total Services", + "description": "Current Account Credits Total Services (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "credits_total_goods", + "headerName": "Credits Total Goods", + "description": "Current Account Credits Total Goods (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "credits_total_primary_income", + "headerName": "Credits Total Primary Income", + "description": "Current Account Credits Total Primary Income (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "credits_total_secondary_income", + "headerName": "Credits Total Secondary Income", + "description": "Current Account Credits Total Secondary Income (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "credits_total", + "headerName": "Credits Total", + "description": "Current Account Credits Total (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "debits_services_percent_of_goods_and_services", + "formatterFn": "normalizedPercent", + "headerName": "Debits Services Percent Of Goods And Services", + "description": "Current Account Debits Services as Percent of Goods and Services", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "debits_services_percent_of_current_account", + "formatterFn": "normalizedPercent", + "headerName": "Debits Services Percent Of Current Account", + "description": "Current Account Debits Services as Percent of Current Account", + "cellDataType": "number", + "chartDataType": "series", + "renderFn": "greenRed" + }, + { + "field": "debits_total_services", + "headerName": "Debits Total Services", + "description": "Current Account Debits Total Services (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "debits_total_goods", + "headerName": "Debits Total Goods", + "description": "Current Account Debits Total Goods (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "debits_total_primary_income", + "headerName": "Debits Total Primary Income", + "description": "Current Account Debits Total Primary Income (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "debits_total", + "headerName": "Debits Total", + "description": "Current Account Debits Total (USD)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "debits_total_secondary_income", + "headerName": "Debits Total Secondary Income", + "description": "Current Account Debits Total Secondary Income (USD)", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_fred_search_fred_obb": { + "name": "FRED Search", + "description": "Search for FRED series or economic releases by ID or string.\n\nThis does not return the observation values, only the metadata.\nUse this function to find series IDs for `fred_series()`.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_fred_search_fred_obb", + "params": [ + { + "label": "Query", + "description": "The search word(s).", + "optional": true, + "value": null, + "show": true, + "paramName": "query" + }, + { + "label": "Is Release", + "description": "Is release? If True, other search filter variables are ignored. If no query text or release_id is supplied, this defaults to True.", + "optional": true, + "value": false, + "type": "boolean", + "show": true, + "paramName": "is_release" + }, + { + "label": "Release ID", + "description": "A specific release ID to target.", + "optional": true, + "type": "text", + "show": true, + "paramName": "release_id" + }, + { + "label": "Limit", + "description": "The number of data entries to return. (1-1000)", + "optional": true, + "value": null, + "type": "number", + "show": true, + "paramName": "limit" + }, + { + "label": "Offset", + "description": "Offset the results in conjunction with limit.", + "optional": true, + "value": 0, + "type": "number", + "show": true, + "paramName": "offset" + }, + { + "label": "Filter Variable", + "description": "Filter by an attribute.", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "frequency", + "value": "frequency" + }, + { + "label": "units", + "value": "units" + }, + { + "label": "seasonal_adjustment", + "value": "seasonal_adjustment" + } + ], + "type": "text", + "paramName": "filter_variable" + }, + { + "label": "Filter Value", + "description": "String value to filter the variable by. Used in conjunction with filter_variable.", + "optional": true, + "value": null, + "show": true, + "paramName": "filter_value" + }, + { + "label": "Tag Names", + "description": "A semicolon delimited list of tag names that series match all of. Example: 'japan;imports' Multiple comma separated items allowed.", + "optional": true, + "value": null, + "show": true, + "type": "text", + "multiSelect": true, + "paramName": "tag_names" + }, + { + "label": "Exclude Tag Names", + "description": "A semicolon delimited list of tag names that series match none of. Example: 'imports;services'. Requires that variable tag_names also be set to limit the number of matching series. Multiple comma separated items allowed.", + "optional": true, + "value": null, + "show": true, + "type": "text", + "multiSelect": true, + "paramName": "exclude_tag_names" + }, + { + "label": "Series ID", + "description": "A FRED Series ID to return series group information for. This returns the required information to query for regional data. Not all series that are in FRED have geographical data. Entering a value for series_id will override all other parameters. Multiple series_ids can be separated by commas.", + "optional": true, + "type": "text", + "show": true, + "paramName": "series_id" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/fred_search", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "release_id", + "headerName": "Release Id", + "description": "The release ID for queries.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "series_id", + "pinned": "left", + "formatterFn": null, + "headerName": "Series Id", + "description": "The series ID for the item in the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "name", + "pinned": "left", + "formatterFn": null, + "headerName": "Name", + "description": "The name of the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "title", + "pinned": "left", + "formatterFn": null, + "headerName": "Title", + "description": "The title of the series.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "observation_start", + "formatterFn": null, + "headerName": "Observation Start", + "description": "The date of the first observation in the series.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "observation_end", + "formatterFn": null, + "headerName": "Observation End", + "description": "The date of the last observation in the series.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "frequency", + "formatterFn": null, + "headerName": "Frequency", + "description": "The frequency of the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "frequency_short", + "formatterFn": null, + "headerName": "Frequency Short", + "description": "Short form of the data frequency.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "units", + "formatterFn": null, + "headerName": "Units", + "description": "The units of the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "units_short", + "formatterFn": null, + "headerName": "Units Short", + "description": "Short form of the data units.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "seasonal_adjustment", + "formatterFn": null, + "headerName": "Seasonal Adjustment", + "description": "The seasonal adjustment of the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "seasonal_adjustment_short", + "formatterFn": null, + "headerName": "Seasonal Adjustment Short", + "description": "Short form of the data seasonal adjustment.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "last_updated", + "formatterFn": null, + "headerName": "Last Updated", + "description": "The datetime of the last update to the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "notes", + "formatterFn": null, + "headerName": "Notes", + "description": "Description of the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "press_release", + "formatterFn": null, + "headerName": "Press Release", + "description": "If the release is a press release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "url", + "formatterFn": null, + "headerName": "Url", + "description": "URL to the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "popularity", + "headerName": "Popularity", + "description": "Popularity of the series", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "group_popularity", + "headerName": "Group Popularity", + "description": "Group popularity of the release", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "region_type", + "formatterFn": null, + "headerName": "Region Type", + "description": "The region type of the series.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "series_group", + "headerName": "Series Group", + "description": "The series group ID of the series. This value is used to query for regional data.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_fred_series_fred_obb": { + "name": "FRED Series", + "description": "Get data by series ID from FRED.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_fred_series_fred_obb", + "params": [ + { + "label": "Symbol", + "description": "Symbol to get data for. Multiple comma separated items allowed.", + "optional": false, + "type": "text", + "show": true, + "multiSelect": true, + "paramName": "symbol" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Limit", + "description": "The number of data entries to return.", + "optional": true, + "value": 100000, + "type": "number", + "show": true, + "paramName": "limit" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "a", + "value": "a" + }, + { + "label": "q", + "value": "q" + }, + { + "label": "m", + "value": "m" + }, + { + "label": "w", + "value": "w" + }, + { + "label": "d", + "value": "d" + }, + { + "label": "wef", + "value": "wef" + }, + { + "label": "weth", + "value": "weth" + }, + { + "label": "wew", + "value": "wew" + }, + { + "label": "wetu", + "value": "wetu" + }, + { + "label": "wem", + "value": "wem" + }, + { + "label": "wesu", + "value": "wesu" + }, + { + "label": "wesa", + "value": "wesa" + }, + { + "label": "bwew", + "value": "bwew" + }, + { + "label": "bwem", + "value": "bwem" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period", + "optional": true, + "value": "eop", + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/fred_series", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_fred_series_fred_obb_chart": { + "name": "FRED Series (Chart)", + "description": "Get data by series ID from FRED.", + "category": "Economy", + "searchCategory": "chart", + "widgetId": "economy_fred_series_fred_obb_chart", + "params": [ + { + "label": "Symbol", + "description": "Symbol to get data for. Multiple comma separated items allowed.", + "optional": false, + "type": "text", + "show": true, + "multiSelect": true, + "paramName": "symbol" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Limit", + "description": "The number of data entries to return.", + "optional": true, + "value": 100000, + "type": "number", + "show": true, + "paramName": "limit" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "a", + "value": "a" + }, + { + "label": "q", + "value": "q" + }, + { + "label": "m", + "value": "m" + }, + { + "label": "w", + "value": "w" + }, + { + "label": "d", + "value": "d" + }, + { + "label": "wef", + "value": "wef" + }, + { + "label": "weth", + "value": "weth" + }, + { + "label": "wew", + "value": "wew" + }, + { + "label": "wetu", + "value": "wetu" + }, + { + "label": "wem", + "value": "wem" + }, + { + "label": "wesu", + "value": "wesu" + }, + { + "label": "wesa", + "value": "wesa" + }, + { + "label": "bwew", + "value": "bwew" + }, + { + "label": "bwem", + "value": "bwem" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period", + "optional": true, + "value": "eop", + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + }, + { + "paramName": "chart", + "label": "Chart", + "description": "Returns chart", + "optional": true, + "value": true, + "type": "boolean", + "show": false + } + ], + "endpoint": "api/v1/economy/fred_series", + "gridData": { + "w": 50, + "h": 20 + }, + "data": { + "dataKey": "chart.content", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "FRED" + ], + "defaultViz": "chart" + }, + "economy_fred_release_table_fred_obb": { + "name": "FRED Release Table", + "description": "Get economic release data by ID and/or element from FRED.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_fred_release_table_fred_obb", + "params": [ + { + "label": "Release ID", + "description": "The ID of the release. Use `fred_search` to find releases.", + "optional": false, + "type": "text", + "show": true, + "paramName": "release_id" + }, + { + "label": "Element Id", + "description": "The element ID of a specific table in the release.", + "optional": true, + "value": null, + "show": true, + "paramName": "element_id" + }, + { + "label": "Date", + "description": "A specific date to get data for. Multiple comma separated items allowed.", + "optional": true, + "value": null, + "type": "text", + "show": true, + "multiSelect": true, + "paramName": "date" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/fred_release_table", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "level", + "headerName": "Level", + "description": "The indentation level of the element.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "element_type", + "formatterFn": null, + "headerName": "Element Type", + "description": "The type of the element.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "line", + "headerName": "Line", + "description": "The line number of the element.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "element_id", + "formatterFn": null, + "headerName": "Element Id", + "description": "The element id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "parent_id", + "formatterFn": null, + "headerName": "Parent Id", + "description": "The parent id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "children", + "formatterFn": null, + "headerName": "Children", + "description": "The element_id of each child, as a comma-separated string.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "symbol", + "pinned": "left", + "formatterFn": null, + "headerName": "Symbol", + "description": "Symbol representing the entity requested in the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "name", + "pinned": "left", + "formatterFn": null, + "headerName": "Name", + "description": "The name of the series.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "The reported value of the series.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_fred_regional_fred_obb": { + "name": "FRED Regional", + "description": "Query the Geo Fred API for regional economic data by series group.\n\nThe series group ID is found by using `fred_search` and the `series_id` parameter.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_fred_regional_fred_obb", + "params": [ + { + "label": "Symbol", + "description": "Symbol to get data for.", + "optional": false, + "type": "text", + "show": true, + "paramName": "symbol" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Limit", + "description": "The number of data entries to return.", + "optional": true, + "value": 100000, + "type": "number", + "show": true, + "paramName": "limit" + }, + { + "label": "Is Series Group", + "description": "When True, the symbol provided is for a series_group, else it is for a series ID.", + "optional": true, + "value": false, + "type": "boolean", + "show": true, + "paramName": "is_series_group" + }, + { + "label": "Region Type", + "description": "The type of regional data. Parameter is only valid when `is_series_group` is True.", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "bea", + "value": "bea" + }, + { + "label": "msa", + "value": "msa" + }, + { + "label": "frb", + "value": "frb" + }, + { + "label": "necta", + "value": "necta" + }, + { + "label": "state", + "value": "state" + }, + { + "label": "country", + "value": "country" + }, + { + "label": "county", + "value": "county" + }, + { + "label": "censusregion", + "value": "censusregion" + } + ], + "type": "text", + "paramName": "region_type" + }, + { + "label": "Season", + "description": "The seasonal adjustments to the data. Parameter is only valid when `is_series_group` is True.", + "optional": true, + "value": "nsa", + "type": "text", + "show": true, + "options": [ + { + "label": "sa", + "value": "sa" + }, + { + "label": "nsa", + "value": "nsa" + }, + { + "label": "ssa", + "value": "ssa" + } + ], + "paramName": "season" + }, + { + "label": "Units", + "description": "The units of the data. This should match the units returned from searching by series ID. An incorrect field will not necessarily return an error. Parameter is only valid when `is_series_group` is True.", + "optional": true, + "value": null, + "show": true, + "paramName": "units" + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency.\n \n None = No change\n \n a = Annual\n \n q = Quarterly\n \n m = Monthly\n \n w = Weekly\n \n d = Daily\n \n wef = Weekly, Ending Friday\n \n weth = Weekly, Ending Thursday\n \n wew = Weekly, Ending Wednesday\n \n wetu = Weekly, Ending Tuesday\n \n wem = Weekly, Ending Monday\n \n wesu = Weekly, Ending Sunday\n \n wesa = Weekly, Ending Saturday\n \n bwew = Biweekly, Ending Wednesday\n \n bwem = Biweekly, Ending Monday", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "a", + "value": "a" + }, + { + "label": "q", + "value": "q" + }, + { + "label": "m", + "value": "m" + }, + { + "label": "w", + "value": "w" + }, + { + "label": "d", + "value": "d" + }, + { + "label": "wef", + "value": "wef" + }, + { + "label": "weth", + "value": "weth" + }, + { + "label": "wew", + "value": "wew" + }, + { + "label": "wetu", + "value": "wetu" + }, + { + "label": "wem", + "value": "wem" + }, + { + "label": "wesu", + "value": "wesu" + }, + { + "label": "wesa", + "value": "wesa" + }, + { + "label": "bwew", + "value": "bwew" + }, + { + "label": "bwem", + "value": "bwem" + } + ], + "type": "text", + "paramName": "frequency" + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation.\n This parameter has no affect if the frequency parameter is not set.\n \n avg = Average\n \n sum = Sum\n \n eop = End of Period", + "optional": true, + "value": "eop", + "show": true, + "options": [ + { + "label": "avg", + "value": "avg" + }, + { + "label": "sum", + "value": "sum" + }, + { + "label": "eop", + "value": "eop" + } + ], + "type": "text", + "paramName": "aggregation_method" + }, + { + "label": "Transform", + "description": "Transformation type\n \n None = No transformation\n \n chg = Change\n \n ch1 = Change from Year Ago\n \n pch = Percent Change\n \n pc1 = Percent Change from Year Ago\n \n pca = Compounded Annual Rate of Change\n \n cch = Continuously Compounded Rate of Change\n \n cca = Continuously Compounded Annual Rate of Change\n \n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/fred_regional", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "region", + "formatterFn": null, + "headerName": "Region", + "description": "The name of the region.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "code", + "headerName": "Code", + "description": "The code of the region.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "value", + "headerName": "Value", + "description": "The obersvation value. The units are defined in the search results by series ID.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "series_id", + "pinned": "left", + "formatterFn": null, + "headerName": "Series Id", + "description": "The individual series ID for the region.", + "cellDataType": "text", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_retail_prices_fred_obb": { + "name": "Retail Prices", + "description": "Get retail prices for common items.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_retail_prices_fred_obb", + "params": [ + { + "label": "Item", + "description": "The item or basket of items to query.", + "optional": true, + "value": null, + "show": true, + "paramName": "item" + }, + { + "label": "Country", + "description": "The country to get data.", + "optional": true, + "value": "united_states", + "type": "text", + "show": true, + "paramName": "country" + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "start_date" + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": true, + "value": null, + "type": "date", + "show": true, + "paramName": "end_date" + }, + { + "label": "Region", + "description": "The region to get average price levels for.", + "optional": true, + "value": "all_city", + "type": "text", + "show": true, + "options": [ + { + "label": "all_city", + "value": "all_city" + }, + { + "label": "northeast", + "value": "northeast" + }, + { + "label": "midwest", + "value": "midwest" + }, + { + "label": "south", + "value": "south" + }, + { + "label": "west", + "value": "west" + } + ], + "paramName": "region" + }, + { + "label": "Frequency", + "description": "The frequency of the data.", + "optional": true, + "value": "monthly", + "type": "text", + "show": true, + "options": [ + { + "label": "annual", + "value": "annual" + }, + { + "label": "quarter", + "value": "quarter" + }, + { + "label": "monthly", + "value": "monthly" + } + ], + "paramName": "frequency" + }, + { + "label": "Transform", + "description": "Transformation type\n None = No transformation\n chg = Change\n ch1 = Change from Year Ago\n pch = Percent Change\n pc1 = Percent Change from Year Ago\n pca = Compounded Annual Rate of Change\n cch = Continuously Compounded Rate of Change\n cca = Continuously Compounded Annual Rate of Change\n log = Natural Log", + "optional": true, + "value": null, + "show": true, + "options": [ + { + "label": "chg", + "value": "chg" + }, + { + "label": "ch1", + "value": "ch1" + }, + { + "label": "pch", + "value": "pch" + }, + { + "label": "pc1", + "value": "pc1" + }, + { + "label": "pca", + "value": "pca" + }, + { + "label": "cch", + "value": "cch" + }, + { + "label": "cca", + "value": "cca" + }, + { + "label": "log", + "value": "log" + } + ], + "type": "text", + "paramName": "transform" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/retail_prices", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "symbol", + "pinned": "left", + "formatterFn": null, + "headerName": "Symbol", + "description": "Symbol representing the entity requested in the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "country", + "formatterFn": null, + "headerName": "Country", + "description": "", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "description", + "formatterFn": null, + "headerName": "Description", + "description": "Description of the item.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "Price, or change in price, per unit.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "economy_pce_fred_obb": { + "name": "PCE", + "description": "Get Personal Consumption Expenditures (PCE) reports.", + "category": "Economy", + "searchCategory": "Economy", + "widgetId": "economy_pce_fred_obb", + "params": [ + { + "label": "Date", + "description": "A specific date to get data for. Default is the latest report. Multiple comma separated items allowed.", + "optional": true, + "value": null, + "type": "text", + "show": true, + "multiSelect": true, + "paramName": "date" + }, + { + "label": "Category", + "description": "The category to query.", + "optional": true, + "value": "personal_income", + "type": "text", + "show": true, + "options": [ + { + "label": "personal_income", + "value": "personal_income" + }, + { + "label": "wages_by_industry", + "value": "wages_by_industry" + }, + { + "label": "real_pce_percent_change", + "value": "real_pce_percent_change" + }, + { + "label": "real_pce_quantity_index", + "value": "real_pce_quantity_index" + }, + { + "label": "pce_price_index", + "value": "pce_price_index" + }, + { + "label": "pce_dollars", + "value": "pce_dollars" + }, + { + "label": "real_pce_chained_dollars", + "value": "real_pce_chained_dollars" + }, + { + "label": "pce_price_percent_change", + "value": "pce_price_percent_change" + } + ], + "paramName": "category" + }, + { + "paramName": "provider", + "value": "fred", + "show": false + } + ], + "endpoint": "api/v1/economy/pce", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of the data.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "symbol", + "pinned": "left", + "formatterFn": null, + "headerName": "Symbol", + "description": "Symbol representing the entity requested in the data.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "value", + "headerName": "Value", + "description": "", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "name", + "pinned": "left", + "formatterFn": null, + "headerName": "Name", + "description": "The name of the series.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "element_id", + "formatterFn": null, + "headerName": "Element Id", + "description": "The element id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "parent_id", + "formatterFn": null, + "headerName": "Parent Id", + "description": "The parent id in the parent/child relationship.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "children", + "formatterFn": null, + "headerName": "Children", + "description": "The element_id of each child, as a comma-separated string.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "level", + "headerName": "Level", + "description": "The indentation level of the element.", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "line", + "headerName": "Line", + "description": "The line number of the series in the table.", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "FRED" + ] + }, + "regulators_sec_cik_map_sec_obb": { + "name": "CIK Map", + "description": "Map a ticker symbol to a CIK number.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_cik_map_sec_obb", + "params": [ + { + "label": "Symbol", + "description": "Symbol to get data for.", + "optional": false, + "type": "text", + "show": true, + "paramName": "symbol" + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache for the request, default is True.", + "optional": true, + "value": true, + "type": "boolean", + "show": true, + "paramName": "use_cache" + }, + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/cik_map", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + }, + "regulators_sec_institutions_search_sec_obb": { + "name": "Institutions Search", + "description": "Search SEC-regulated institutions by name and return a list of results with CIK numbers.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_institutions_search_sec_obb", + "params": [ + { + "label": "Query", + "description": "Search query.", + "optional": true, + "value": "", + "type": "text", + "show": true, + "paramName": "query" + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": true, + "value": true, + "type": "boolean", + "show": true, + "paramName": "use_cache" + }, + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/institutions_search", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "institution", + "formatterFn": null, + "headerName": "Institution", + "description": "The name of the institution.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "cik_number", + "headerName": "Cik Number", + "description": "Central Index Key (CIK)", + "cellDataType": "number", + "chartDataType": "series" + } + ] + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + }, + "regulators_sec_schema_files_sec_obb": { + "name": "Schema Files", + "description": "Use tool for navigating the directory of SEC XML schema files by year.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_schema_files_sec_obb", + "params": [ + { + "label": "Query", + "description": "Search query.", + "optional": true, + "value": "", + "type": "text", + "show": true, + "paramName": "query" + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": true, + "value": true, + "type": "boolean", + "show": true, + "paramName": "use_cache" + }, + { + "label": "Url", + "description": "Enter an optional URL path to fetch the next level.", + "optional": true, + "value": null, + "show": true, + "paramName": "url" + }, + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/schema_files", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + }, + "regulators_sec_symbol_map_sec_obb": { + "name": "Symbol Map", + "description": "Map a CIK number to a ticker symbol, leading 0s can be omitted or included.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_symbol_map_sec_obb", + "params": [ + { + "label": "Query", + "description": "Search query.", + "optional": false, + "value": null, + "type": "text", + "show": true, + "paramName": "query" + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache. If True, cache will store for seven days.", + "optional": true, + "value": true, + "type": "boolean", + "show": true, + "paramName": "use_cache" + }, + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/symbol_map", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + }, + "regulators_sec_rss_litigation_sec_obb": { + "name": "RSS Litigation", + "description": "Get the RSS feed that provides links to litigation releases concerning civil lawsuits brought by the Commission in federal court.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_rss_litigation_sec_obb", + "params": [ + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/rss_litigation", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "date", + "pinned": "left", + "formatterFn": null, + "headerName": "Date", + "description": "The date of publication.", + "cellDataType": "date", + "chartDataType": "category" + }, + { + "field": "title", + "pinned": "left", + "formatterFn": null, + "headerName": "Title", + "description": "The title of the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "summary", + "formatterFn": null, + "headerName": "Summary", + "description": "Short summary of the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "id", + "formatterFn": null, + "headerName": "Id", + "description": "The identifier associated with the release.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "link", + "formatterFn": null, + "headerName": "Link", + "description": "URL to the release.", + "cellDataType": "text", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + }, + "regulators_sec_sic_search_sec_obb": { + "name": "SIC Search", + "description": "Search for Industry Titles, Reporting Office, and SIC Codes. An empty query string returns all results.", + "category": "Regulators", + "searchCategory": "Regulators", + "widgetId": "regulators_sec_sic_search_sec_obb", + "params": [ + { + "label": "Query", + "description": "Search query.", + "optional": true, + "value": "", + "type": "text", + "show": true, + "paramName": "query" + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": true, + "value": true, + "type": "boolean", + "show": true, + "paramName": "use_cache" + }, + { + "paramName": "provider", + "value": "sec", + "show": false + } + ], + "endpoint": "api/v1/regulators/sec/sic_search", + "gridData": { + "w": 45, + "h": 15 + }, + "data": { + "dataKey": "results", + "table": { + "showAll": true, + "columnsDefs": [ + { + "field": "sic_code", + "headerName": "Sic Code", + "description": "Sector Industrial Code (SIC)", + "cellDataType": "number", + "chartDataType": "series" + }, + { + "field": "industry_title", + "formatterFn": null, + "headerName": "Industry Title", + "description": "Industry title.", + "cellDataType": "text", + "chartDataType": "category" + }, + { + "field": "office", + "formatterFn": null, + "headerName": "Office", + "description": "Reporting office within the Corporate Finance Office", + "cellDataType": "text", + "chartDataType": "category" + } + ] + } + }, + "source": [ + "SEC" + ], + "subCategory": "SEC" + } +} \ No newline at end of file diff --git a/openbb_platform/extensions/platform_api/tests/test_api.py b/openbb_platform/extensions/platform_api/tests/test_api.py new file mode 100644 index 000000000000..471abfad5a7e --- /dev/null +++ b/openbb_platform/extensions/platform_api/tests/test_api.py @@ -0,0 +1,78 @@ +from unittest.mock import MagicMock, mock_open, patch + +import pytest +from openbb_platform_api.utils.api import ( + check_port, + get_user_settings, + get_widgets_json, + parse_args, +) + + +# Mock environment variables +@pytest.fixture(autouse=True) +def mock_env_vars(monkeypatch): + monkeypatch.setenv("HOME", "/mock/home") + monkeypatch.setenv("USERPROFILE", "/mock/home") + + +@pytest.mark.parametrize("port_input", [6900, "6900", 6901, "6901"]) +def test_check_port(port_input): + with patch("socket.socket") as mock_socket: + mock_sock_instance = MagicMock() + mock_socket.return_value.__enter__.return_value = mock_sock_instance + + # Mock connect_ex to return 0 for port 6900 (indicating it's in use) + mock_sock_instance.connect_ex.side_effect = lambda addr: ( + 0 if addr[1] == 6900 else 1 + ) + + port = check_port("127.0.0.1", port_input) + assert port == 6901 # The next available port should be 6901 + + +def test_get_user_settings_no_login(): + with patch( + "builtins.open", + mock_open( + read_data='{"credentials": {}, "preferences": {}, "defaults": {"commands": {}}}' + ), + ): + settings = get_user_settings( + _login=False, current_user_settings="", user_settings_copy="" + ) + assert settings == { + "credentials": {}, + "preferences": {}, + "defaults": {"commands": {}}, + } + + +def test_get_widgets_json_no_build(): + with patch("builtins.open", mock_open(read_data="{}")), patch( + "os.path.exists", return_value=True + ): + widgets_json = get_widgets_json( + _build=False, _openapi={}, widget_exclude_filter=[] + ) + assert widgets_json == {} + + +def test_parse_args(): + with patch("sys.argv", ["script.py", "--help"]): + with pytest.raises(SystemExit) as e: + parse_args() + assert e.type == SystemExit + assert e.value.code == 0 + + with patch("sys.argv", ["script.py", "--key", "value"]): + args = parse_args() + assert args == {"key": "value"} + + with patch("sys.argv", ["script.py", "--flag"]): + args = parse_args() + assert args == {"flag": True} + + +if __name__ == "__main__": + pytest.main() diff --git a/openbb_platform/extensions/platform_api/tests/test_openapi_utils.py b/openbb_platform/extensions/platform_api/tests/test_openapi_utils.py new file mode 100644 index 000000000000..ff5956a72315 --- /dev/null +++ b/openbb_platform/extensions/platform_api/tests/test_openapi_utils.py @@ -0,0 +1,397 @@ +import json +from pathlib import Path + +import pytest +from openbb_platform_api.utils.openapi import ( + data_schema_to_columns_defs, + get_data_schema_for_widget, + get_query_schema_for_widget, +) + +# pylint: disable=redefined-outer-name + + +# Load the mock OpenAPI JSON +@pytest.fixture(scope="module") +def mock_openapi_json(): + mock_openapi_path = Path(__file__).parent / "mock_openapi.json" + with open(mock_openapi_path) as file: + return json.load(file) + + +@pytest.mark.parametrize( + "path, params_number, query_schema, expected_has_chart", + [ + ( + "/api/v1/economy/balance_of_payments", + 4, + [ + { + "parameter_name": "provider", + "label": "Provider", + "description": "Source of the data.", + "optional": True, + "type": "text", + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "country", + "label": "Country", + "description": "The country to get data. Enter as a 3-letter ISO country code, default is USA.", + "optional": True, + "value": "united_states", + "options": { + "fred": [ + {"label": "argentina", "value": "argentina"}, + {"label": "australia", "value": "australia"}, + {"label": "austria", "value": "austria"}, + {"label": "belgium", "value": "belgium"}, + {"label": "brazil", "value": "brazil"}, + {"label": "canada", "value": "canada"}, + {"label": "chile", "value": "chile"}, + {"label": "china", "value": "china"}, + {"label": "colombia", "value": "colombia"}, + {"label": "costa_rica", "value": "costa_rica"}, + {"label": "czechia", "value": "czechia"}, + {"label": "denmark", "value": "denmark"}, + {"label": "estonia", "value": "estonia"}, + {"label": "finland", "value": "finland"}, + {"label": "france", "value": "france"}, + {"label": "germany", "value": "germany"}, + {"label": "greece", "value": "greece"}, + {"label": "hungary", "value": "hungary"}, + {"label": "iceland", "value": "iceland"}, + {"label": "india", "value": "india"}, + {"label": "indonesia", "value": "indonesia"}, + {"label": "ireland", "value": "ireland"}, + {"label": "israel", "value": "israel"}, + {"label": "italy", "value": "italy"}, + {"label": "japan", "value": "japan"}, + {"label": "korea", "value": "korea"}, + {"label": "latvia", "value": "latvia"}, + {"label": "lithuania", "value": "lithuania"}, + {"label": "luxembourg", "value": "luxembourg"}, + {"label": "mexico", "value": "mexico"}, + {"label": "netherlands", "value": "netherlands"}, + {"label": "new_zealand", "value": "new_zealand"}, + {"label": "norway", "value": "norway"}, + {"label": "poland", "value": "poland"}, + {"label": "portugal", "value": "portugal"}, + {"label": "russia", "value": "russia"}, + {"label": "saudi_arabia", "value": "saudi_arabia"}, + {"label": "slovak_republic", "value": "slovak_republic"}, + {"label": "slovenia", "value": "slovenia"}, + {"label": "south_africa", "value": "south_africa"}, + {"label": "spain", "value": "spain"}, + {"label": "sweden", "value": "sweden"}, + {"label": "switzerland", "value": "switzerland"}, + {"label": "turkey", "value": "turkey"}, + {"label": "united_kingdom", "value": "united_kingdom"}, + {"label": "united_states", "value": "united_states"}, + {"label": "g7", "value": "g7"}, + {"label": "g20", "value": "g20"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "text", + "show": True, + }, + { + "parameter_name": "start_date", + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + { + "parameter_name": "end_date", + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + ], + False, + ), + ( + "/api/v1/economy/fred_series", + 8, + [ + { + "parameter_name": "provider", + "label": "Provider", + "description": "Source of the data.", + "optional": True, + "type": "text", + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "symbol", + "label": "Symbol", + "description": "Symbol to get data for.", + "optional": False, + "type": "text", + "multiple_items_allowed": {"fred": True}, + "show": True, + }, + { + "parameter_name": "start_date", + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + { + "parameter_name": "end_date", + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + { + "parameter_name": "limit", + "label": "Limit", + "description": "The number of data entries to return.", + "optional": True, + "value": 100000, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "number", + "show": True, + }, + { + "parameter_name": "frequency", + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency." + + "\n " + + "\n None = No change" + + "\n " + + "\n a = Annual\n " + + "\n q = Quarterly\n " + + "\n m = Monthly\n " + + "\n w = Weekly\n " + + "\n d = Daily\n " + + "\n wef = Weekly, Ending Friday" + + "\n " + + "\n weth = Weekly, Ending Thursday" + + "\n " + + "\n wew = Weekly, Ending Wednesday" + + "\n " + + "\n wetu = Weekly, Ending Tuesday" + + "\n " + + "\n wem = Weekly, Ending Monday" + + "\n " + + "\n wesu = Weekly, Ending Sunday" + + "\n " + + "\n wesa = Weekly, Ending Saturday" + + "\n " + + "\n bwew = Biweekly, Ending Wednesday" + + "\n " + + "\n bwem = Biweekly, Ending Monday", + "optional": True, + "value": None, + "options": { + "fred": [ + {"label": "a", "value": "a"}, + {"label": "q", "value": "q"}, + {"label": "m", "value": "m"}, + {"label": "w", "value": "w"}, + {"label": "d", "value": "d"}, + {"label": "wef", "value": "wef"}, + {"label": "weth", "value": "weth"}, + {"label": "wew", "value": "wew"}, + {"label": "wetu", "value": "wetu"}, + {"label": "wem", "value": "wem"}, + {"label": "wesu", "value": "wesu"}, + {"label": "wesa", "value": "wesa"}, + {"label": "bwew", "value": "bwew"}, + {"label": "bwem", "value": "bwem"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "aggregation_method", + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation." + + "\n This parameter has no affect if the frequency parameter is not set." + + "\n " + + "\n avg = Average" + + "\n " + + "\n sum = Sum" + + "\n " + + "\n eop = End of Period", + "optional": True, + "value": "eop", + "options": { + "fred": [ + {"label": "avg", "value": "avg"}, + {"label": "sum", "value": "sum"}, + {"label": "eop", "value": "eop"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "transform", + "label": "Transform", + "description": "Transformation type" + + "\n " + + "\n None = No transformation" + + "\n " + + "\n chg = Change" + + "\n " + + "\n ch1 = Change from Year Ago" + + "\n " + + "\n pch = Percent Change" + + "\n " + + "\n pc1 = Percent Change from Year Ago" + + "\n " + + "\n pca = Compounded Annual Rate of Change" + + "\n " + + "\n cch = Continuously Compounded Rate of Change" + + "\n " + + "\n cca = Continuously Compounded Annual Rate of Change" + + "\n " + + "\n log = Natural Log", + "optional": True, + "value": None, + "options": { + "fred": [ + {"label": "chg", "value": "chg"}, + {"label": "ch1", "value": "ch1"}, + {"label": "pch", "value": "pch"}, + {"label": "pc1", "value": "pc1"}, + {"label": "pca", "value": "pca"}, + {"label": "cch", "value": "cch"}, + {"label": "cca", "value": "cca"}, + {"label": "log", "value": "log"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + ], + True, + ), + ( + "/api/v1/regulators/sec/schema_files", + 4, + [ + { + "parameter_name": "provider", + "label": "Provider", + "description": "Source of the data.", + "optional": True, + "type": "text", + "available_providers": ["sec"], + "show": True, + }, + { + "parameter_name": "query", + "label": "Query", + "description": "Search query.", + "optional": True, + "value": "", + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "type": "text", + "show": True, + }, + { + "parameter_name": "use_cache", + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": True, + "value": True, + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "type": "boolean", + "show": True, + }, + { + "parameter_name": "url", + "label": "Url", + "description": "Enter an optional URL path to fetch the next level.", + "optional": True, + "value": None, + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "show": True, + }, + ], + False, + ), + ], +) +def test_get_query_schema_for_widget( + mock_openapi_json, path, params_number, query_schema, expected_has_chart +): + route_params, has_chart = get_query_schema_for_widget(mock_openapi_json, path) + assert len(route_params) == params_number + assert route_params == query_schema + assert has_chart == expected_has_chart + + +@pytest.mark.parametrize( + "openapi_operation_id", + [ + "economy_survey_sloos", + "economy_survey_university_of_michigan", + "economy_balance_of_payments", + ], +) +def test_get_data_schema_for_widget(mock_openapi_json, openapi_operation_id): + schema = get_data_schema_for_widget(mock_openapi_json, openapi_operation_id) + assert schema is not None + + +@pytest.mark.parametrize( + "openapi_operation_id", + [ + "economy_survey_sloos", + "economy_survey_university_of_michigan", + "economy_balance_of_payments", + ], +) +def test_data_schema_to_columns_defs(mock_openapi_json, openapi_operation_id): + column_defs = data_schema_to_columns_defs( + mock_openapi_json, openapi_operation_id, provider="fred" + ) + assert len(column_defs) > 1 # There should be at least two columns + + +if __name__ == "__main__": + pytest.main() diff --git a/openbb_platform/extensions/platform_api/tests/test_widgets_utils.py b/openbb_platform/extensions/platform_api/tests/test_widgets_utils.py new file mode 100644 index 000000000000..cd94845816ae --- /dev/null +++ b/openbb_platform/extensions/platform_api/tests/test_widgets_utils.py @@ -0,0 +1,456 @@ +import json +from pathlib import Path + +import pytest +from openbb_platform_api.utils.widgets import build_json, modify_query_schema + +# pylint: disable=redefined-outer-name + + +# Load the mock OpenAPI JSON +@pytest.fixture(scope="module") +def mock_openapi_json(): + mock_openapi_path = Path(__file__).parent / "mock_openapi.json" + with open(mock_openapi_path) as file: + return json.load(file) + + +# Load the mock widgets JSON +@pytest.fixture(scope="module") +def mock_widgets_json(): + mock_widgets_path = Path(__file__).parent / "mock_widgets.json" + with open(mock_widgets_path) as file: + return json.load(file) + + +@pytest.mark.parametrize( + "query_schema, provider_value, expected_result", + [ + ( + [ + { + "parameter_name": "provider", + "label": "Provider", + "description": "Source of the data.", + "optional": True, + "type": "text", + "available_providers": ["sec"], + "show": True, + }, + { + "parameter_name": "query", + "label": "Query", + "description": "Search query.", + "optional": True, + "value": "", + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "type": "text", + "show": True, + }, + { + "parameter_name": "use_cache", + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": True, + "value": True, + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "type": "boolean", + "show": True, + }, + { + "parameter_name": "url", + "label": "Url", + "description": "Enter an optional URL path to fetch the next level.", + "optional": True, + "value": None, + "options": {"sec": []}, + "multiple_items_allowed": {}, + "available_providers": ["sec"], + "show": True, + }, + ], + "sec", + [ + { + "label": "Query", + "description": "Search query.", + "optional": True, + "value": "", + "type": "text", + "show": True, + "paramName": "query", + }, + { + "label": "Use Cache", + "description": "Whether or not to use cache.", + "optional": True, + "value": True, + "type": "boolean", + "show": True, + "paramName": "use_cache", + }, + { + "label": "Url", + "description": "Enter an optional URL path to fetch the next level.", + "optional": True, + "value": None, + "show": True, + "paramName": "url", + }, + {"paramName": "provider", "value": "sec", "show": False}, + ], + ), + ( + [ + { + "parameter_name": "provider", + "label": "Provider", + "description": "Source of the data.", + "optional": True, + "type": "text", + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "symbol", + "label": "Symbol", + "description": "Symbol to get data for.", + "optional": False, + "type": "text", + "multiple_items_allowed": {"fred": True}, + "show": True, + }, + { + "parameter_name": "start_date", + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + { + "parameter_name": "end_date", + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "date", + "show": True, + }, + { + "parameter_name": "limit", + "label": "Limit", + "description": "The number of data entries to return.", + "optional": True, + "value": 100000, + "options": {"fred": []}, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "type": "number", + "show": True, + }, + { + "parameter_name": "frequency", + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency." + + "\n " + + "\n None = No change" + + "\n " + + "\n a = Annual" + + "\n " + + "\n q = Quarterly" + + "\n " + + "\n m = Monthly" + + "\n " + + "\n w = Weekly" + + "\n " + + "\n d = Daily" + + "\n " + + "\n wef = Weekly, Ending Friday" + + "\n " + + "\n weth = Weekly, Ending Thursday" + + "\n " + + "\n wew = Weekly, Ending Wednesday" + + "\n " + + "\n wetu = Weekly, Ending Tuesday" + + "\n " + + "\n wem = Weekly, Ending Monday" + + "\n " + + "\n wesu = Weekly, Ending Sunday" + + "\n " + + "\n wesa = Weekly, Ending Saturday" + + "\n " + + "\n bwew = Biweekly, Ending Wednesday" + + "\n " + + "\n bwem = Biweekly, Ending Monday", + "optional": True, + "value": None, + "options": { + "fred": [ + {"label": "a", "value": "a"}, + {"label": "q", "value": "q"}, + {"label": "m", "value": "m"}, + {"label": "w", "value": "w"}, + {"label": "d", "value": "d"}, + {"label": "wef", "value": "wef"}, + {"label": "weth", "value": "weth"}, + {"label": "wew", "value": "wew"}, + {"label": "wetu", "value": "wetu"}, + {"label": "wem", "value": "wem"}, + {"label": "wesu", "value": "wesu"}, + {"label": "wesa", "value": "wesa"}, + {"label": "bwew", "value": "bwew"}, + {"label": "bwem", "value": "bwem"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "aggregation_method", + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation." + + "\n This parameter has no affect if the frequency parameter is not set." + + "\n " + + "\n avg = Average" + + "\n " + + "\n sum = Sum" + + "\n " + + "\n eop = End of Period", + "optional": True, + "value": "eop", + "options": { + "fred": [ + {"label": "avg", "value": "avg"}, + {"label": "sum", "value": "sum"}, + {"label": "eop", "value": "eop"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + { + "parameter_name": "transform", + "label": "Transform", + "description": "Transformation type" + + "\n " + + "\n None = No transformation" + + "\n " + + "\n chg = Change" + + "\n " + + "\n ch1 = Change from Year Ago" + + "\n " + + "\n pch = Percent Change" + + "\n " + + "\n pc1 = Percent Change from Year Ago" + + "\n " + + "\n pca = Compounded Annual Rate of Change" + + "\n " + + "\n cch = Continuously Compounded Rate of Change" + + "\n " + + "\n cca = Continuously Compounded Annual Rate of Change" + + "\n " + + "\n log = Natural Log", + "optional": True, + "value": None, + "options": { + "fred": [ + {"label": "chg", "value": "chg"}, + {"label": "ch1", "value": "ch1"}, + {"label": "pch", "value": "pch"}, + {"label": "pc1", "value": "pc1"}, + {"label": "pca", "value": "pca"}, + {"label": "cch", "value": "cch"}, + {"label": "cca", "value": "cca"}, + {"label": "log", "value": "log"}, + ] + }, + "multiple_items_allowed": {}, + "available_providers": ["fred"], + "show": True, + }, + ], + "fred", + [ + { + "label": "Symbol", + "description": "Symbol to get data for. Multiple comma separated items allowed.", + "optional": False, + "type": "text", + "show": True, + "multiSelect": True, + "paramName": "symbol", + }, + { + "label": "Start Date", + "description": "Start date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "type": "date", + "show": True, + "paramName": "start_date", + }, + { + "label": "End Date", + "description": "End date of the data, in YYYY-MM-DD format.", + "optional": True, + "value": None, + "type": "date", + "show": True, + "paramName": "end_date", + }, + { + "label": "Limit", + "description": "The number of data entries to return.", + "optional": True, + "value": 100000, + "type": "number", + "show": True, + "paramName": "limit", + }, + { + "label": "Frequency", + "description": "Frequency aggregation to convert high frequency data to lower frequency." + + "\n " + + "\n None = No change" + + "\n " + + "\n a = Annual" + + "\n " + + "\n q = Quarterly" + + "\n " + + "\n m = Monthly" + + "\n " + + "\n w = Weekly" + + "\n " + + "\n d = Daily" + + "\n " + + "\n wef = Weekly, Ending Friday" + + "\n " + + "\n weth = Weekly, Ending Thursday" + + "\n " + + "\n wew = Weekly, Ending Wednesday" + + "\n " + + "\n wetu = Weekly, Ending Tuesday" + + "\n " + + "\n wem = Weekly, Ending Monday" + + "\n " + + "\n wesu = Weekly, Ending Sunday" + + "\n " + + "\n wesa = Weekly, Ending Saturday" + + "\n " + + "\n bwew = Biweekly, Ending Wednesday" + + "\n " + + "\n bwem = Biweekly, Ending Monday", + "optional": True, + "value": None, + "show": True, + "options": [ + {"label": "a", "value": "a"}, + {"label": "q", "value": "q"}, + {"label": "m", "value": "m"}, + {"label": "w", "value": "w"}, + {"label": "d", "value": "d"}, + {"label": "wef", "value": "wef"}, + {"label": "weth", "value": "weth"}, + {"label": "wew", "value": "wew"}, + {"label": "wetu", "value": "wetu"}, + {"label": "wem", "value": "wem"}, + {"label": "wesu", "value": "wesu"}, + {"label": "wesa", "value": "wesa"}, + {"label": "bwew", "value": "bwew"}, + {"label": "bwem", "value": "bwem"}, + ], + "type": "text", + "paramName": "frequency", + }, + { + "label": "Aggregation Method", + "description": "A key that indicates the aggregation method used for frequency aggregation." + + "\n This parameter has no affect if the frequency parameter is not set." + + "\n " + + "\n avg = Average" + + "\n " + + "\n sum = Sum" + + "\n " + + "\n eop = End of Period", + "optional": True, + "value": "eop", + "show": True, + "options": [ + {"label": "avg", "value": "avg"}, + {"label": "sum", "value": "sum"}, + {"label": "eop", "value": "eop"}, + ], + "type": "text", + "paramName": "aggregation_method", + }, + { + "label": "Transform", + "description": "Transformation type" + + "\n " + + "\n None = No transformation" + + "\n " + + "\n chg = Change" + + "\n " + + "\n ch1 = Change from Year Ago" + + "\n " + + "\n pch = Percent Change" + + "\n " + + "\n pc1 = Percent Change from Year Ago" + + "\n " + + "\n pca = Compounded Annual Rate of Change" + + "\n " + + "\n cch = Continuously Compounded Rate of Change" + + "\n " + + "\n cca = Continuously Compounded Annual Rate of Change" + + "\n " + + "\n log = Natural Log", + "optional": True, + "value": None, + "show": True, + "options": [ + {"label": "chg", "value": "chg"}, + {"label": "ch1", "value": "ch1"}, + {"label": "pch", "value": "pch"}, + {"label": "pc1", "value": "pc1"}, + {"label": "pca", "value": "pca"}, + {"label": "cch", "value": "cch"}, + {"label": "cca", "value": "cca"}, + {"label": "log", "value": "log"}, + ], + "type": "text", + "paramName": "transform", + }, + {"paramName": "provider", "value": "fred", "show": False}, + ], + ), + ], +) +def test_modify_query_schema(query_schema, provider_value, expected_result): + result = modify_query_schema(query_schema, provider_value) + assert result == expected_result + + +def test_build_json(mock_openapi_json, mock_widgets_json): + result = build_json(openapi=mock_openapi_json, widget_exclude_filter=[]) + assert ( + len(result) == len(mock_openapi_json["paths"]) + 1 + ) # +1 for the duplicate path with a chart. + assert result == mock_widgets_json + + +if __name__ == "__main__": + pytest.main() diff --git a/openbb_platform/openbb/assets/reference.json b/openbb_platform/openbb/assets/reference.json index d62b9bf95de7..c7b12614d4e6 100644 --- a/openbb_platform/openbb/assets/reference.json +++ b/openbb_platform/openbb/assets/reference.json @@ -39292,4 +39292,4 @@ "description": "Financial market regulators data." } } -} \ No newline at end of file +}