financial-dataset-loader


Namefinancial-dataset-loader JSON
Version 0.2.3 PyPI version JSON
download
home_pagehttps://github.com/nailen1/financial_dataset_loader.git
SummaryA Python module for loading financial datasets from various sources
upload_time2025-02-19 05:39:45
maintainerNone
docs_urlNone
authorJune Young Park
requires_python>=3.11
licenseNone
keywords financial data loader dataset aws s3
VCS
bugtrack_url
requirements shining_pebbles aws-s3-controller string_date_controller
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # Financial Dataset Loader

A Python module for efficiently loading financial datasets from various sources including local storage and AWS S3. Designed for streamlined data management in quantitative finance applications.

## Features

- Multiple data source support:
  - AWS S3 storage (`dataset_loader_s3`)
  - Local filesystem (`dataset_loader_local`)
- Flexible data source configuration and path management
- Standardized file name formatting
- Configurable dataset loading parameters

## Project Structure

```
financial_dataset_loader/
├── data_source.py          # Data source configuration
├── dataset_loader_config.py # Loader configurations
├── dataset_loader_local.py  # Local filesystem loader
├── dataset_loader_s3.py     # AWS S3 loader
├── file_name_formatter.py   # File naming utilities
└── path_director.py         # Path management
```

## Installation

```bash
pip install financial-dataset-loader
```

## Usage

### Loading Financial Data

```python
from financial_dataset_loader import dataset_loader_s3

# Load menu snapshot data
df = dataset_loader_s3.load_menu2205_snapshot(date_ref='2025-02-12')

# Load specific fund data
df = dataset_loader_s3.load_menu2205(fund_code='000123', date_ref='2025-02-12')

# Load market data
df = dataset_loader_s3.load_market(market_name='KOSPI', date_ref='2025-02-12')

# Load index data
df = dataset_loader_s3.load_index(ticker_bbg_index='KOSPI Index')

# Load currency data
df = dataset_loader_s3.load_currency(ticker_bbg_currency='USDKRW Curncy')
```

### Available Loading Functions

- `load_menu2160(fund_code)`: Load timeseries data for menu 2160
- `load_menu2160_snapshot(date_ref)`: Load snapshot data for menu 2160
- `load_menu2205(fund_code, date_ref)`: Load fund-specific data for menu 2205
- `load_menu2205_snapshot(date_ref)`: Load snapshot data for menu 2205
- `load_menu8186_snapshot(date_ref)`: Load snapshot data for menu 8186
- `load_menu4165(fund_code, date_ref)`: Load period data for menu 4165
- `load_menu4165_snapshot(fund_code, date_ref)`: Load snapshot data for menu 4165
- `load_index(ticker_bbg_index)`: Load Bloomberg index data
- `load_currency(ticker_bbg_currency)`: Load Bloomberg currency data
- `load_market(market_name, date_ref)`: Load market data

## Requirements

- Python >= 3.11
- aws-s3-controller (for S3 functionality)
- string-date-controller (for date conversion functionality)
- shining_pebbles (for pseudo database functionality)

## License

MIT License

## Author

**June Young Park**  
AI Management Development Team Lead & Quant Strategist at LIFE Asset Management

LIFE Asset Management is a hedge fund management firm that integrates value investing and engagement strategies with quantitative approaches and financial technology, headquartered in Seoul, South Korea.

### Contact

- Email: juneyoungpaak@gmail.com
- Location: TWO IFC, Yeouido, Seoul

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/nailen1/financial_dataset_loader.git",
    "name": "financial-dataset-loader",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "financial data loader dataset aws s3",
    "author": "June Young Park",
    "author_email": "juneyoungpaak@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/49/d1/cf77962e1556a3c5ea5dcd4b0f80751b790c1f4f93250a62ccfa1c847f47/financial_dataset_loader-0.2.3.tar.gz",
    "platform": null,
    "description": "# Financial Dataset Loader\n\nA Python module for efficiently loading financial datasets from various sources including local storage and AWS S3. Designed for streamlined data management in quantitative finance applications.\n\n## Features\n\n- Multiple data source support:\n  - AWS S3 storage (`dataset_loader_s3`)\n  - Local filesystem (`dataset_loader_local`)\n- Flexible data source configuration and path management\n- Standardized file name formatting\n- Configurable dataset loading parameters\n\n## Project Structure\n\n```\nfinancial_dataset_loader/\n\u251c\u2500\u2500 data_source.py          # Data source configuration\n\u251c\u2500\u2500 dataset_loader_config.py # Loader configurations\n\u251c\u2500\u2500 dataset_loader_local.py  # Local filesystem loader\n\u251c\u2500\u2500 dataset_loader_s3.py     # AWS S3 loader\n\u251c\u2500\u2500 file_name_formatter.py   # File naming utilities\n\u2514\u2500\u2500 path_director.py         # Path management\n```\n\n## Installation\n\n```bash\npip install financial-dataset-loader\n```\n\n## Usage\n\n### Loading Financial Data\n\n```python\nfrom financial_dataset_loader import dataset_loader_s3\n\n# Load menu snapshot data\ndf = dataset_loader_s3.load_menu2205_snapshot(date_ref='2025-02-12')\n\n# Load specific fund data\ndf = dataset_loader_s3.load_menu2205(fund_code='000123', date_ref='2025-02-12')\n\n# Load market data\ndf = dataset_loader_s3.load_market(market_name='KOSPI', date_ref='2025-02-12')\n\n# Load index data\ndf = dataset_loader_s3.load_index(ticker_bbg_index='KOSPI Index')\n\n# Load currency data\ndf = dataset_loader_s3.load_currency(ticker_bbg_currency='USDKRW Curncy')\n```\n\n### Available Loading Functions\n\n- `load_menu2160(fund_code)`: Load timeseries data for menu 2160\n- `load_menu2160_snapshot(date_ref)`: Load snapshot data for menu 2160\n- `load_menu2205(fund_code, date_ref)`: Load fund-specific data for menu 2205\n- `load_menu2205_snapshot(date_ref)`: Load snapshot data for menu 2205\n- `load_menu8186_snapshot(date_ref)`: Load snapshot data for menu 8186\n- `load_menu4165(fund_code, date_ref)`: Load period data for menu 4165\n- `load_menu4165_snapshot(fund_code, date_ref)`: Load snapshot data for menu 4165\n- `load_index(ticker_bbg_index)`: Load Bloomberg index data\n- `load_currency(ticker_bbg_currency)`: Load Bloomberg currency data\n- `load_market(market_name, date_ref)`: Load market data\n\n## Requirements\n\n- Python >= 3.11\n- aws-s3-controller (for S3 functionality)\n- string-date-controller (for date conversion functionality)\n- shining_pebbles (for pseudo database functionality)\n\n## License\n\nMIT License\n\n## Author\n\n**June Young Park**  \nAI Management Development Team Lead & Quant Strategist at LIFE Asset Management\n\nLIFE Asset Management is a hedge fund management firm that integrates value investing and engagement strategies with quantitative approaches and financial technology, headquartered in Seoul, South Korea.\n\n### Contact\n\n- Email: juneyoungpaak@gmail.com\n- Location: TWO IFC, Yeouido, Seoul\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A Python module for loading financial datasets from various sources",
    "version": "0.2.3",
    "project_urls": {
        "Homepage": "https://github.com/nailen1/financial_dataset_loader.git"
    },
    "split_keywords": [
        "financial",
        "data",
        "loader",
        "dataset",
        "aws",
        "s3"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0463df507a8870e7f00f59caa891d24565d0a814b4b6231278be1e5487f71611",
                "md5": "dbad18ffc212c027c9e9aaa78ac9076b",
                "sha256": "e336dc289ce772e6a81a9e8fe4cdb07df0d4ae09d92b11e296625455078201cf"
            },
            "downloads": -1,
            "filename": "financial_dataset_loader-0.2.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dbad18ffc212c027c9e9aaa78ac9076b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 6515,
            "upload_time": "2025-02-19T05:39:44",
            "upload_time_iso_8601": "2025-02-19T05:39:44.062292Z",
            "url": "https://files.pythonhosted.org/packages/04/63/df507a8870e7f00f59caa891d24565d0a814b4b6231278be1e5487f71611/financial_dataset_loader-0.2.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "49d1cf77962e1556a3c5ea5dcd4b0f80751b790c1f4f93250a62ccfa1c847f47",
                "md5": "d4d739d50b2e5d610dd7368a28de28e6",
                "sha256": "dca441c83fe6fbdb2e3caa29b3ecec07e133c7fd63395134272bd50811e29f65"
            },
            "downloads": -1,
            "filename": "financial_dataset_loader-0.2.3.tar.gz",
            "has_sig": false,
            "md5_digest": "d4d739d50b2e5d610dd7368a28de28e6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 5595,
            "upload_time": "2025-02-19T05:39:45",
            "upload_time_iso_8601": "2025-02-19T05:39:45.930447Z",
            "url": "https://files.pythonhosted.org/packages/49/d1/cf77962e1556a3c5ea5dcd4b0f80751b790c1f4f93250a62ccfa1c847f47/financial_dataset_loader-0.2.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-19 05:39:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "nailen1",
    "github_project": "financial_dataset_loader",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "shining_pebbles",
            "specs": []
        },
        {
            "name": "aws-s3-controller",
            "specs": []
        },
        {
            "name": "string_date_controller",
            "specs": []
        }
    ],
    "lcname": "financial-dataset-loader"
}
June Young Park
Elapsed time: 0.42500s