Metadata-Version: 2.1
Name: sqlalchemy-ds-manager
Version: 0.0.1
Summary: SqlAlchemy DS Manager: A simple datasource manager for SqlAlchemy using json file and cache manager for your sql statement
Project-URL: Homepage, https://github.com/jnguyen0220/sqlalchemy_ds_manager
Project-URL: Bug Tracker, https://github.com/jnguyen0220/sqlalchemy_ds_manager/issues
Author-email: Jonny Nguyen <jonny_nguyen@outlook.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Requires-Dist: oracledb
Requires-Dist: pymssql
Requires-Dist: sqlalchemy
Description-Content-Type: text/markdown

# SqlAlchemy DS Manager: A simple datasource manager for SqlAlchemy using json file and cache manager for your sql statement
## PyPi
pip install sqlalchemy-ds-manager

## Configs
* [datasource.json](https://github.com/jnguyen0220/sqlalchemy_ds_manager/blob/main/src/sqlalchemy_ds_manager/datasource.json)
```
[
  {
    "provider": "ORACLE",
    "source": [
      {
        "name": "golang",
        "server": "server_name",
        "port": 1000,
        "service_name": "service_name"
      }
    ]
  },
  {
    "provider": "SQLSERVER",
    "source": [
      {
        "name": "rust",
        "server": "server_name",
        "database": "database_name"
      }
    ]
  }
]
```
## Usage
### without cache
* [exemple.py](https://github.com/jnguyen0220/sqlalchemy_ds_manager/blob/main/src/sqlalchemy_ds_manager/example.py)
```
from sqlalchemy_ds_manager.datasource.manager import DatasourceManager
from sqlalchemy_ds_manager.provider.oracle import OracleProvider
from sqlalchemy_ds_manager.provider.sql_server import SqlServerProvider
from sqlalchemy import text
import pandas as pd
from os import path

def main():
    currentDir = path.dirname(__file__)
    filename = path.join(currentDir, 'datasource.json')

    sql = "Select * from table_name"

    dm = DatasourceManager(filename, providers=dict(
        ORACLE=OracleProvider,
        SQLSERVER=SqlServerProvider
    ))

    datasource = dict(
        golang = dm.get(source_name="golang", uid="go_uid", pwd="go_pwd"),
        rust = dm.get(source_name="rust", uid="rust_uid", pwd="rust_pwd")
    )
    
    with datasource.get('golang').new().connect() as conn:
        df = pd.read_sql(text(sql), conn)
    
if __name__ == "__main__":
    main()
```
### with cache
* [exemple_with_cache.py](https://github.com/jnguyen0220/sqlalchemy_ds_manager/blob/main/src/sqlalchemy_ds_manager/example_with_cache.py)
```
from sqlalchemy_ds_manager.datasource.manager import DatasourceManager
from sqlalchemy_ds_manager.provider.oracle import OracleProvider
from sqlalchemy_ds_manager.provider.sql_server import SqlServerProvider
from sqlalchemy_ds_manager.cache.file import FileCache
from sqlalchemy import text
import pandas as pd
import time
from os import path

currentDir = path.dirname(__file__)
filename = path.join(currentDir, 'datasource.json')
folder = path.join(currentDir, 'cache_files')

dm = DatasourceManager(filename, providers=dict(
    ORACLE=OracleProvider,
    SQLSERVER=SqlServerProvider
))

datasource = dict(
    golang = dm.get(source_name="golang", uid="go_uid", pwd="go_pwd"),
    rust = dm.get(source_name="rust", uid="rust_uid", pwd="rust_pwd")
)

def main():
    sql = "Select * from table_name"
    fc = FileCache(folder)
    df = getSql(sql, "golang", fc)
    
def getSql(sql, source_name: str, fc):
    exist = fc.find(sql)
    if exist == None:
        with datasource.get(source_name).new().connect() as conn: 
            start = time.time()
            df = pd.read_sql(text(sql), conn)
            duration = round(time.time() - start, 2) 
            filename = fc.add(sql, duration)
            df.to_pickle(filename)
            return df
    else:
        return pd.read_pickle(exist)

if __name__ == "__main__":
    main()
```