Metadata-Version: 2.4
Name: cdpd
Version: 0.1.0
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.0.0
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`**: Tự động đọc output/kết quả từ cell trước đó và in nhận xét ngắn gọn, đủ ý dưới dạng văn bản để bạn dễ dàng copy dán vào các cell Markdown báo cáo.
2. **`%%cd`**: Tự động định dạng, tối ưu và chuẩn hóa code trong cell theo chuẩn PEP 8.

## 🚀 Cài đặt

```bash
pip install cdpd
```

## ⚙️ Cấu hình (Cực kỳ ngắn gọn)

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"  # (tùy chọn)
```

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

%cdpd YOUR_GEMINI_API_KEY
```

### Cách 4: Qua biến môi trường
```bash
export GEMINI_API_KEY="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 code mới ngay bên dưới để hỏi 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ả:** Gemini sẽ in nhận xét dạng text thuần. Bạn chỉ cần bôi đen, copy và dán vào cell Markdown để làm báo cáo/thuyết minh.

---

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

Thêm `%%cd` ở dòng đầu của cell code cần format:

```python
%%cd
def tinh_tong( a,b ):
    x=a+b;return x
```

---

## 📄 License

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