semvec/pypi-packages huggingface dataset:
mistral-image-gen 0.1.0
A Python library for generating images using Mistral AI API
Requires Python: >=3.6

# Mistral Image Generator

مكتبة Python لتوليد الصور باستخدام Mistral AI API.

## التثبيت

```bash
pip install mistral-image-gen
```

## الاستخدام الأساسي

```python
from mistral_image_gen import MistralImageGenerator

# إنشاء نسخة من المولد
generator = MistralImageGenerator()

# توليد صورة واحدة
image_path = generator.generate_image("سيارة رياضية حمراء جميلة")
print(f"تم حفظ الصورة في: {image_path}")

# توليد عدة صور دفعة واحدة
prompts = [
    "قطة صغيرة تلعب بكرة",
    "غروب الشمس على الشاطئ",
    "حديقة مليئة بالزهور"
]
image_paths = generator.batch_generate(prompts, prefix="my_images_")
print(f"تم إنشاء {len(image_paths)} صور")
```

## المميزات

- توليد صور من وصف نصي
- دعم توليد صور متعددة دفعة واحدة
- إمكانية تخصيص مجلد حفظ الصور
- معالجة الأخطاء وإعادة المحاولة تلقائياً
- تنسيق أسماء الملفات تلقائياً

## المساهمة

نرحب بمساهماتكم! يرجى إرسال pull requests أو فتح issues على GitHub.

## الترخيص

هذا المشروع مرخص تحت MIT License.
md-ref-checker 0.2.3
A tool for checking references in Markdown files
Requires Python: >=3.8
Keywords: checker, markdown, obsidian, reference

# Markdown Reference Checker

一个用于检查 Markdown 文件中引用完整性的工具，特别适用于 Obsidian 风格的 wiki 链接。

## 特性

- 支持两种引用语法：
  - `[[file]]` - 创建到文件的链接
  - `![[file]]` - 嵌入并渲染文件内容
- 支持引用任意类型文件（无扩展名时默认为 .md）
- 支持引用别名 (`[[file|alias]]` 或 `![[file|alias]]`)
- 支持标题引用 (`[[file#heading]]`)
- 支持标准 Markdown 图片语法 (`![alt](image)`)
- 检测未使用的图片
- 检测单向链接（A引用B但B没有引用A）
- 支持 `.gitignore` 和自定义忽略规则
- 详细的错误报告（包含行号和列号）
- 生成引用统计信息

## 安装

### 使用 pip 安装

```bash
pip install md-ref-checker
```

### 从源码安装

```bash
# 克隆仓库
git clone https://github.com/chess99/md-ref-checker.git
cd md-ref-checker

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或
venv\Scripts\activate  # Windows

# 安装开发依赖
pip install -e ".[dev]"
```

## 使用方法

### 命令行工具

```bash
# 检查当前目录
md-ref-checker

# 检查指定目录
md-ref-checker -d /path/to/docs

# 显示详细信息
md-ref-checker -v 2

# 忽略特定文件
md-ref-checker -i "*.tmp" -i "draft/*"

# 删除未使用的图片
md-ref-checker -r

# 显示调试信息
md-ref-checker -D

# 严格图片引用模式
md-ref-checker --strict-image-refs
```

### 命令行选项

- `-d, --dir`: 要检查的目录路径（默认为当前目录）
- `-v, --verbosity`: 输出详细程度（0-2）
  - 0: 只显示无效引用和未使用的图片
  - 1: 显示无效引用、未使用的图片和单向链接
  - 2: 显示所有引用统计信息
- `-n, --no-color`: 禁用彩色输出
- `-i, --ignore`: 添加要忽略的文件模式（可多次使用）
- `-r, --delete-unused-images`: 删除未被引用的图片文件
- `-D, --debug`: 显示调试信息
- `--strict-image-refs`: 严格图片引用模式（只将 ![[]] 和 ![] 视为图片引用）

### Python API

```python
from md_ref_checker import ReferenceChecker

# 创建检查器
checker = ReferenceChecker("docs")

# 启用严格图片引用模式（只将 ![[]] 和 ![] 视为图片引用）
checker = ReferenceChecker("docs", strict_image_refs=True)

# 添加忽略规则
checker.fs.ignore_patterns.extend(["*.tmp", "draft/*"])

# 检查整个目录
result = checker.check_directory()

# 检查单个文件
result = checker.check_file("docs/note.md")

# 处理结果
if result.invalid_refs:
    print("发现无效引用:")
    for ref in result.invalid_refs:
        print(f"{ref.source_file}:{ref.line_number} - {ref.target}")

if result.unused_images:
    print("未使用的图片:")
    for image in result.unused_images:
        print(image)

if result.unidirectional_links:
    print("单向链接:")
    for source, target in result.unidirectional_links:
        print(f"{source} -> {target}")
```

## 开发

项目使用 `pre-commit` 钩子和 `make` 命令来简化开发流程。

#### 初始化开发环境

```bash
# 安装所有依赖并设置 pre-commit 钩子
make install
```

#### 常用命令

```bash
# 格式化代码
make format

# 运行所有代码检查
make lint

# 运行测试
make test

# 清理临时文件和缓存
make clean
```

#### 运行测试

```bash
# 运行所有测试
pytest

# 运行特定测试
pytest tests/test_models.py

# 显示测试覆盖率
pytest --cov=md_ref_checker
```

#### 代码质量工具

项目使用以下工具保证代码质量：

- Black: 代码格式化
- Ruff: 代码检查和导入排序
- MyPy: 类型检查
- pre-commit: Git 提交前自动运行检查

所有这些检查都会在提交代码时自动运行。你也可以手动运行它们：

```bash
# 手动运行 pre-commit 检查
pre-commit run --all-files

# 单独运行格式化
black src tests

# 单独运行代码检查
ruff check src tests

# 单独运行类型检查
mypy src tests
```

## 贡献

欢迎贡献！请参考以下步骤：

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
hi-gcp-utils 1.0.1
GCP Utilities for BigQuery
Requires Python: >=3.6

# GCP Utils

A Python package for interacting with Google BigQuery, providing easy-to-use utilities for data operations.

## Installation

```bash
pip install hi-gcp-utils
```

## Usage

```python
from gcp_utils import BigQueryClient

# Initialize the client
client = BigQueryClient(
    project_id="your-project-id",
    dataset_id="your-dataset-id"
)

# Set your credentials
client.set_key_file("path/to/your/credentials.json")

# Example: Query data
df = client.sql2df("SELECT * FROM your_table LIMIT 10")
```

## Features

- Easy BigQuery table operations
- DataFrame integration with pandas
- Secure credential management
- Table schema modifications
- Data transfer utilities

## Requirements

- Python >= 3.6
- google-cloud-bigquery
- google-cloud-storage
- pandas
- pandas-gbq
- pyarrow

## License

This project is licensed under the MIT License.