https://github.com/visionary-code-works/stockanalysisprogram
A Python-based toolkit for fetching and visualizing financial data and metrics for stocks.
https://github.com/visionary-code-works/stockanalysisprogram
finance finance-application financial-analysis python stock stock-market
Last synced: about 1 month ago
JSON representation
A Python-based toolkit for fetching and visualizing financial data and metrics for stocks.
- Host: GitHub
- URL: https://github.com/visionary-code-works/stockanalysisprogram
- Owner: Visionary-Code-Works
- License: mit
- Created: 2023-12-19T12:08:20.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-03T03:41:15.000Z (2 months ago)
- Last Synced: 2026-05-03T05:16:19.892Z (2 months ago)
- Topics: finance, finance-application, financial-analysis, python, stock, stock-market
- Language: Jupyter Notebook
- Homepage:
- Size: 782 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Stock Analysis Program
[](https://github.com/Visionary-Code-Works/StockAnalysisProgram/actions/workflows/python_publish.yml)
## Overview
The Stock Analysis Program is a Python-based toolkit designed to fetch and visualize financial data and metrics for stocks. It is ideal for financial analysts, traders, and anyone interested in stock market analysis. The program offers functionalities such as retrieving historical stock data, computing moving averages, analyzing revenue growth, and plotting financial metrics.
## Features
- **Data Fetching**: Retrieve historical data, financial summaries, and key metrics for stocks.
- **Data Visualization**: Visualize stock prices, financial metrics, and revenue growth.
- **Comparative Analysis**: Compare performance of different stocks and stock indices.
- **Customizability**: Modular design allows for easy customization and extension.
## Installation
Install the package from PyPI:
```bash
pip install stock-analysis-program
```
The package also installs a small command-line menu:
```bash
stock-analysis
```
## Usage
The program consists of multiple Python classes categorized into Fetchers and Plotters.
### Fetchers
- `StockDataFetcher`
- `StockSummaryFetcher`
- `FinancialMetricsFetcher`
- `RevenueGrowthFetcher`
### Plotters
- `StockPricePlotter`
- `FinancialMetricsPlotter`
- `RevenueGrowthPlotter`
- `StockVolatilityPlotter`
- `StockExchangePerformancePlotter`
- `CurrentPricesTickerDisplay`
### Example
```python
from stock_analysis_program import StockPricePlotter
# Plotting stock prices for Apple and Microsoft
price_plotter = StockPricePlotter(['AAPL', 'MSFT'])
price_plotter.plot_closing_prices('2021-01-01', '2021-12-31')
```
Plotter methods return Matplotlib figure and axes objects for notebook,
testing, or dashboard usage:
```python
figures = price_plotter.plot_closing_prices(
'2021-01-01',
'2021-12-31',
show=False,
)
```
## Documentation
For detailed documentation on each component, please refer to the `docs` directory.
- [Workflow](./docs/Workflow.md)
- [Plotter](./docs/Plotter.md)
- [Fetcher](./docs/Fetcher.md)
- [Documentation](./docs/documentation.md)
## Contributing
Contributions to enhance the program are welcome. Please fork the repository and submit a pull request with your changes.
## License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.