Metadata-Version: 2.4
Name: cdpd
Version: 0.1.2
Summary: IPython cell magic tool: %%cd for code formatting and %%pd for AI output analysis and insights
Author-email: Nguyen <skyland1620@gmail.com>
License: MIT
Keywords: ipython,jupyter,gemini,pep8,cdpd,data-analysis,ai
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai==1.1.1
Requires-Dist: httpx>=0.24.0
Requires-Dist: ipython>=7.0.0
Dynamic: license-file

# cdpd

Thư viện IPython / Jupyter Cell Magic hỗ trợ lập trình và phân tích dữ liệu với Google Gemini:
1. **`%%pd`**: Đọc output/kết quả từ cell trước đó và **ghi thẳng kết quả nhận xét vào trong cell** (không in output).
2. **`%%cd`**: Chuẩn hóa code trong cell theo chuẩn PEP 8, **giữ nguyên toàn bộ comment** và **ghi thẳng vào cell** (không in output).

## 🚀 Cài đặt

```bash
pip install cdpd
```

## ⚙️ Cấu hình

Bạn có thể cấu hình nhanh bằng một trong các cách sau:

### Cách 1: Dùng hàm `cdpd.set()` (Khuyến nghị)
```python
import cdpd

# Chỉ cần set key:
cdpd.set("YOUR_GEMINI_API_KEY")

# Hoặc set cả key lẫn model cùng lúc:
cdpd.set("YOUR_GEMINI_API_KEY", "gemini-3.1-flash-lite")
```

### Cách 2: Gán biến trực tiếp
```python
import cdpd

cdpd.api_key = "YOUR_GEMINI_API_KEY"
cdpd.model = "gemini-3.1-flash-lite"
```

### Cách 3: Dùng Line Magic `%cdpd` trực tiếp trong Notebook
```python
import cdpd

%cdpd YOUR_GEMINI_API_KEY
```

---

## 📖 Hướng dẫn sử dụng

### 1. Phân tích & Nhận xét số liệu (`%%pd`)

Sau khi chạy 1 cell sinh ra số liệu, biểu đồ hoặc DataFrame:

```python
# [Cell 1 - Code tính toán]
df.describe()
```

Mở cell mới ngay bên dưới để yêu cầu nhận xét:

```python
# [Cell 2]
%%pd
Nhận xét về độ lệch chuẩn và các giá trị bất thường của bảng số liệu trên.
```

> 💡 **Kết quả:** Khi chạy, nội dung cell sẽ được **thay thế trực tiếp bằng câu trả lời của AI**, không in ra phần output. Bạn có thể bấm phím tắt `M` để chuyển cell này thành Cell Markdown nếu muốn!

---

### 2. Chuẩn hóa & Format code (`%%cd`)

Thêm `%%cd` ở đầu cell cần format:

```python
%%cd
# Comment này sẽ được giữ nguyên 100%
def tinh_tong( a,b ):
    x=a+b;return x
```

> 💡 **Kết quả:** Code sẽ được viết lại chuẩn PEP 8 ngay trong cell, comment được giữ nguyên vẹn và không sinh ra output thừa.

---

## 📄 License

MIT License. See [LICENSE](LICENSE) for details.
