# 安装 Fli
pip install flights

# 通过 pipx 安装（推荐 CLI 用户）
pipx install flights

# 运行 MCP 服务器（STDIO 模式）
fli-mcp

# 运行 MCP 服务器（HTTP 模式，可网络访问）
fli-mcp-http
# 服务地址：http://127.0.0.1:8000/mcp/

{
  "mcpServers": {
    "fli": {
      "command": "fli-mcp",
      "args": []
    }
  }
}

# pip 安装
pip install flights

# pipx 安装（推荐用于 CLI）
pipx install flights

# 验证安装
fli --help

# 基础搜索
fli flights JFK LHR 2026-10-25

# 高级筛选
fli flights JFK LHR 2026-10-25 \
  --time 6-20 \           # 出发时间窗口（6点-20点）
  --airlines BA KL \      # 指定航空公司
  --class BUSINESS \       # 舱位等级
  --stops NON_STOP \      # 只看直飞
  --sort DURATION         # 按时长排序

# 基础日期搜索
fli dates JFK LHR

# 高级日期搜索
fli dates JFK LHR \
  --from 2026-01-01 \   # 开始日期
  --to 2026-02-01 \     # 结束日期
  --monday --friday       # 只看特定星期几

from datetime import datetime, timedelta
from fli.models import (
    Airport, PassengerInfo, SeatType, MaxStops, SortBy,
    FlightSearchFilters, FlightSegment
)
from fli.search import SearchFlights

# 创建搜索筛选器
filters = FlightSearchFilters(
    passenger_info=PassengerInfo(adults=1),
    flight_segments=[
        FlightSegment(
            departure_airport=[[Airport.JFK, 0]],
            arrival_airport=[[Airport.LAX, 0]],
            travel_date=(datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d"),
        )
    ],
    seat_type=SeatType.ECONOMY,
    stops=MaxStops.NON_STOP,
    sort_by=SortBy.CHEAPEST,
)

# 执行搜索
search = SearchFlights()
flights = search.search(filters)

# 处理结果
for flight in flights:
    print(f"💰 价格: ${flight.price}")
    print(f"⏱️ 时长: {flight.duration} 分钟")
    print(f"✈️ 经停: {flight.stops}")
    for leg in flight.legs:
        print(f"\n🛫 航班: {leg.airline.value} {leg.flight_number}")
        print(f"📍 出发: {leg.departure_airport.value} at {leg.departure_datetime}")
        print(f"📍 到达: {leg.arrival_airport.value} at {leg.arrival_datetime}")

from fli.models import FlightSegment

# 添加返程航段
filters = FlightSearchFilters(
    passenger_info=PassengerInfo(adults=2),  # 2位乘客
    flight_segments=[
        FlightSegment(
            departure_airport=[[Airport.JFK, 0]],
            arrival_airport=[[Airport.LHR, 0]],
            travel_date="2026-10-25",
        ),
        FlightSegment(
            departure_airport=[[Airport.LHR, 0]],
            arrival_airport=[[Airport.JFK, 0]],
            travel_date="2026-11-05",
        )
    ],
    seat_type=SeatType.BUSINESS,
    stops=MaxStops.NON_STOP,
    sort_by=SortBy.CHEAPEST,
)

from fli.search import SearchDates

# 创建日期搜索
date_search = SearchDates()

# 搜索最便宜日期
results = date_search.search(
    origin=Airport.JFK,
    destination=Airport.LAX,
    start_date="2026-01-01",
    end_date="2026-02-01",
    is_round_trip=True,
    trip_duration=7,
    cabin_class=SeatType.ECONOMY,
)

# 处理结果
for result in results:
    print(f"📅 日期: {result.date}")
    print(f"💰 价格: ${result.price}")

# 使用 uv 运行（推荐）
uv run python examples/basic_one_way_search.py
uv run python examples/round_trip_search.py
uv run python examples/date_range_search.py

# 安装依赖后直接运行
pip install pydantic curl_cffi httpx
python examples/basic_one_way_search.py

# 构建镜像
docker build -t fli-dev -f .devcontainer/Dockerfile .

# 运行 MCP 服务器
docker run --rm fli-dev fli-mcp

# 运行 HTTP MCP 服务器
docker run --rm -p 8000:8000 fli-dev fli-mcp-http

# 启动 HTTP 服务器
fli-mcp-http
# 服务地址：http://127.0.0.1:8000/mcp/

# Docker Compose
docker-compose up -d

# Railway 自动检测配置
railway login
railway init
railway up

# Nixpacks 支持可选 MCP 依赖
nixpacks build -p pip .

# 克隆仓库
git clone https://github.com/punitarani/fli.git
cd fli

# 使用 uv 安装所有依赖
uv sync --all-extras

# 运行测试
uv run pytest

# 代码检查
uv run ruff check .
uv run ruff format .

# 构建文档
uv run mkdocs serve

# 安装所有依赖
make install-all

# 运行测试
make test

# 代码检查
make lint

# 格式化代码
make format

# 运行 CI
make ci

# Docker 中运行 CI
make ci-docker

# 安装 act
brew install act

# 运行 CI（lint + tests on Python 3.10-3.13）
make ci

# Docker 中运行（无需本地安装 act）
make ci-docker

# 直接运行
fli-mcp

# 或使用 uv
uv run fli-mcp

# 或使用 make
make mcp

# 启动 HTTP 服务器
fli-mcp-http

# Docker 中运行
docker run --rm -p 8000:8000 fli-dev fli-mcp-http

from fli.models import Airport

# 常用机场
Airport.JFK  # 纽约肯尼迪
Airport.LAX  # 洛杉矶
Airport.LHR  # 伦敦希思罗
Airport.CDG  # 巴黎戴高乐
Airport.NRT  # 东京成田

from fli.models import SeatType

SeatType.ECONOMY       # 经济舱
SeatType.PREMIUM_ECONOMY  # 超级经济舱
SeatType.BUSINESS     # 商务舱
SeatType.FIRST        # 头等舱

from fli.models import MaxStops

MaxStops.ANY        # 任意经停
MaxStops.NON_STOP   # 直飞
MaxStops.ONE_STOP   # 一程经停
MaxStops.TWO_PLUS_STOPS  # 两程或以上

from fli.search import SearchFlights
from fli.exceptions import RateLimitError, APIError

try:
    search = SearchFlights(max_retries=3)
    flights = search.search(filters)
except RateLimitError:
    print("请求过于频繁，请稍后重试")
except APIError as e:
    print(f"API 错误: {e}")

from fli.models import Airport

# 无效机场代码会自动抛出异常
try:
    invalid_search = FlightSegment(
        departure_airport=[["XXX", 0]],  # 无效代码
        arrival_airport=[[Airport.LAX, 0]],
        travel_date="2026-10-25",
    )
except ValueError as e:
    print(f"验证错误: {e}")