semvec/pypi-packages huggingface dataset:
tingpy 0.1.0
A developer-friendly wrapper for Firebase Cloud Messaging with QR code pairing
License: MIT
Requires Python: >=3.6

# tingpy

A developer-friendly wrapper for Firebase Cloud Messaging (FCM) that simplifies push notifications and handles mobile app pairing via QR code.

## Features

- **Notification Sender**: Send push notifications to mobile apps using Firebase Cloud Messaging.
- **Mobile Pairing**: Generate QR codes in the terminal for easy connection of mobile apps to Firebase projects.

## Installation

```bash
pip install tingpy
```

## Dependencies

- firebase-admin
- segno

## Usage

```python
import tingpy

# 1. Setup (Sending)
bot = tingpy.Client("my-secret.json")

# 2. Pairing (Only needed once)
# This prints a giant QR code in the terminal
tingpy.pair_device("google-services.json")

# 3. Usage
bot.send(
    topic="general",
    title="Trade Executed",
    body="Bought NIFTY 21500 CE @ 120"
)
```

## API Reference

### TingClient

- `__init__(config_path)`: Initialize with path to Firebase service account JSON.
- `send(topic, title, body, color=None)`: Send a notification to the specified topic.

### pair_device(json_path)

Parses the google-services.json file and prints a QR code containing the necessary pairing information.

## Testing

Run unit tests:

```bash
python -m unittest tests/test_pairing.py
```

## License

MIT
finstock 0.1.0
中国期货股票数据获取库 - 通过API获取K线数据并转换为pandas DataFrame
License: MIT
Requires Python: >=3.10
Keywords: china, data, futures, kline, pandas, stocks, trading

# FinStock - 中国期货股票数据获取库

[![PyPI version](https://badge.fury.io/py/finstock.svg)](https://badge.fury.io/py/finstock)
[![Python versions](https://img.shields.io/pypi/pyversions/finstock.svg)](https://pypi.org/project/finstock/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

FinStock 是一个专为中国期货和股票市场设计的Python数据获取库，通过简单的API调用即可获取K线数据并自动转换为pandas DataFrame格式。

## 特性

- 简单易用：一行代码获取K线数据
- Pandas集成：自动转换为DataFrame格式
- 完整数据：支持OHLCV、持仓量、成交额等完整字段
- 多时间框架：支持分钟、小时、日线、周线、月线
- 多交易所：支持上期所、大商所、郑商所、中金所、能源中心
- 类型安全：使用Pydantic进行数据验证

## 安装

```bash
pip install finstock
```

## 快速开始

```python
from finstock import FinStockClient

# 创建客户端
client = FinStockClient("http://localhost:8000")

# 获取K线数据
kline_data = client.get_kline("CU2401.SHFE", "1d")

# 转换为DataFrame
df = kline_data.to_dataframe()
print(df.head())
```

## 支持的数据

### 时间间隔
- 1m, 5m, 15m, 1h, 1d, 1w, 1M

### 交易所
- SHFE: 上海期货交易所
- DCE: 大连商品交易所
- CZCE: 郑州商品交易所
- CFFEX: 中国金融期货交易所
- INE: 上海国际能源交易中心

## API参考

### FinStockClient

#### get_kline(symbol, interval, start_datetime=None, end_datetime=None)
获取K线数据

**参数:**
- symbol: 期货合约代码，如 "CU2401.SHFE"
- interval: 时间间隔，如 "1d"
- start_datetime: 开始时间，可选
- end_datetime: 结束时间，可选

**返回:** KLineData对象

#### get_kline_dataframe(symbol, interval, start_datetime=None, end_datetime=None)
直接获取K线数据的DataFrame格式

#### health_check()
检查API服务状态

## 开发

```bash
# 克隆仓库
git clone https://github.com/finstock/finstock.git
cd finstock

# 安装开发依赖
uv sync --dev

# 运行测试
uv run pytest

# 代码格式化
uv run black .
uv run ruff check .

# 类型检查
uv run mypy finstock/
```

## 许可证

MIT License - 查看 [LICENSE](LICENSE) 文件了解详情。

## 支持

- 邮箱: contact@finstock.com
- 问题反馈: [GitHub Issues](https://github.com/finstock/finstock/issues)
- 文档: [在线文档](https://finstock.readthedocs.io)

---

免责声明: 本库仅用于学习和研究目的。使用时请遵守相关法律法规和交易所规定。投资有风险，入市需谨慎。