Metadata-Version: 2.1
Name: gulf
Version: 0.1.0
Summary: 
Author: fangyang_gpu
Author-email: fangyang.jing@hotmail.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: akshare (>=1.11.28,<2.0.0)
Requires-Dist: dolphindb (>=1.30.22.2,<2.0.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Description-Content-Type: text/markdown

gulf
========================
<div align="center">
<img src="https://github.com/FangyangJz/gulf/assets/19723117/2d2a06b7-e4f5-429a-b87a-1b850070d033?raw=true" width="50%">
</div>

[简体中文](README_CN.md)

## Description

**`gulf`** is an open-source integrated finance data source and database application on top of [DolphinDB](https://www.dolphindb.com/) and [akshare](https://github.com/akfamily/akshare).

### Installation

You can install the latest stable version from pip using:
```
pip install gulf
```
If you plan to develop gulf yourself, or want to be on the cutting edge, you can use an editable install:
```bash
git clone https://github.com/FangyangJz/gulf.git
pip install -e .
```

### About development environment

Use `poetry` as dependency management and `conda` as virtual environment management.

* In `PyCharm` settings, `poetry` venv creation may meet error, because the OS system is not native English. So `conda` was used as the virtual environment management, and author used `python` 3.9 version.

* If you follow the official `poetry` manual and create a redundant venv, just delete it. Check the following locations (note hidden paths):

    > C:\Users\fangy\AppData\Local\pypoetry\Cache\virtualenvs


* If the virtual environment is not automatically activated, manually switch:
    ```
    conda activate your_venv_name
    ```
    After activate the virtual environment, `poetry update/init/install/add` command is executed on the shell. [Stack overflow link](https://stackoverflow.com/questions/70851048/does-it-make-sense-to-use-conda-poetry)

