Metadata-Version: 2.4
Name: pypitravel
Version: 1.0.2
Summary: 圆周旅迹行程规划导出与可视化工具
Requires-Python: >=3.12
Requires-Dist: fastapi
Requires-Dist: httpx
Requires-Dist: uvicorn
Description-Content-Type: text/markdown

# PyPitravel

[![PyPI version](https://img.shields.io/pypi/v/pypitravel.svg)](https://pypi.org/project/pypitravel/)
[![Python version](https://img.shields.io/badge/python-3.12+-yellow.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-Apache_2.0-green.svg)](LICENSE)

PyPitravel 是一个用于解析旅行规划平台《圆周旅迹》数据、提供行程规划导出与可视化的工具。

## 项目由来
由于“圆周旅迹”仅提供 iOS 客户端，导致在电脑端进行复杂的行程规划与整理非常不便。本项目旨在通过解析其 API 数据，在电脑端实现行程的可视化导出与整理。

## 核心功能

*   **智能解析**: 自动从旅行行程链接中提取行程 ID。
*   **API 代理**: 安全地获取旅行规划平台数据，绕过 CORS 跨域拦截。
*   **本地部署**: 提供轻量级的本地 Web 服务。
*   **可视化分析**: 支持交互式地图轨迹绘制与行程数据分析（开发中）。
*   **便携运行**: 基于 Nuitka 打包，用户无需安装 Python 环境即可使用。

## 快速上手

### 安装
使用 pip 安装：
```bash
pip install pypitravel
```

### 启动
安装完成后，在终端直接运行：
```bash
pypitravel
```
随后打开浏览器访问 `http://127.0.0.1:8000` 即可使用。

## 从源码安装 (开发者)
如果你需要进行二次开发或修改源码：
1. 环境要求：Python >= 3.12，安装 [uv](https://github.com/astral-sh/uv)。
2. 克隆项目并安装依赖：
   ```bash
   uv sync
   ```
3. 运行项目：
   ```bash
   uv run pypitravel
   ```

## 应用预览

![应用截图](https://raw.githubusercontent.com/crthu/pypitravel/master/img/demo.png)

## 技术栈
*   **后端**: FastAPI, httpx
*   **前端**: HTML, JavaScript (Leaflet.js 规划中)
*   **打包**: Nuitka
*   **依赖管理**: uv

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 开源。

## 免责声明

PyPitravel 仅供个人学习与研究使用。所调用的 Pitravel 服务为商业软件，其 API 和数据归原平台所有。
*   本项目不承担任何因使用本项目而导致的平台服务条款违反责任。
*   严禁将本项目用于任何商业用途或大规模自动化抓取。
*   使用时请遵守目标平台的相关服务条款与隐私政策。
