Skip to main content

基于交互模式的现代化测试自动化框架,支持多种测试场景

Project description

DF Test Framework

简单、强大、可扩展的现代化 Python 测试自动化框架

PyPI version Python License


核心特性

  • HTTP 客户端 - 同步/异步,拦截器链,自动重试
  • GraphQL/gRPC 客户端 - 完整协议支持
  • 数据库访问 - SQLAlchemy 2.0,Repository + UnitOfWork 模式
  • 消息队列 - Kafka/RabbitMQ/RocketMQ 统一接口
  • 存储客户端 - LocalFile/S3/阿里云 OSS
  • 可观测性 - OpenTelemetry 追踪 + Prometheus 监控
  • 测试工具 - Fixtures、数据构建器、Mock 工具、Allure 集成

安装

# 基础安装
pip install df-test-framework

# 可选依赖
pip install df-test-framework[ui]           # UI 测试(Playwright)
pip install df-test-framework[mq]           # 消息队列
pip install df-test-framework[observability] # 可观测性
pip install df-test-framework[storage]      # 存储客户端
pip install df-test-framework[all]          # 所有功能

快速开始

脚手架创建项目

df-test init my-test-project
cd my-test-project
cp .env.example .env
pytest -v

手动使用

from df_test_framework import Bootstrap, FrameworkSettings
from pydantic import Field

class DemoSettings(FrameworkSettings):
    api_base_url: str = Field(default="https://api.example.com")

runtime = (
    Bootstrap()
    .with_settings(DemoSettings)
    .build()
    .run()
)

http = runtime.http_client()
response = http.get("/users/1")
assert response.status_code == 200

异步高性能模式

import asyncio
from df_test_framework import AsyncHttpClient

async def test_concurrent():
    async with AsyncHttpClient("https://api.example.com") as client:
        tasks = [client.get(f"/users/{i}") for i in range(100)]
        responses = await asyncio.gather(*tasks)
        assert len(responses) == 100

asyncio.run(test_concurrent())

架构

Layer 4 ─ extensions/        # Pluggy 扩展系统
Layer 3 ─ testing/           # Fixtures、数据构建、插件
Layer 2 ─ infrastructure/    # Bootstrap、配置、日志、Runtime
Layer 1 ─ clients/…          # HTTP、数据库、消息、存储
Layer 0 ─ common/            # 异常与基础类型

文档

完整文档请访问 GitHub 仓库


许可证

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

df_test_framework-3.35.5.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

df_test_framework-3.35.5-py3-none-any.whl (546.3 kB view details)

Uploaded Python 3

File details

Details for the file df_test_framework-3.35.5.tar.gz.

File metadata

  • Download URL: df_test_framework-3.35.5.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for df_test_framework-3.35.5.tar.gz
Algorithm Hash digest
SHA256 5c169023abe7fc7a87b9b5870e888750a846e56266969c05371a1a0a94e14474
MD5 a910af08bdd302668ce758a0136d7bcf
BLAKE2b-256 1a170b76c5c4f7a389ff553daa9adaa3e352eba81cc9212dfc491e8d382a57ba

See more details on using hashes here.

File details

Details for the file df_test_framework-3.35.5-py3-none-any.whl.

File metadata

File hashes

Hashes for df_test_framework-3.35.5-py3-none-any.whl
Algorithm Hash digest
SHA256 5ef8be37b1fcb66c7b13e20a5b5c67e8af5d0d69ddaee4524413921889743934
MD5 6885327ba4d4b29daaa084571a4aafd8
BLAKE2b-256 85345e117e43bd936655bc2747a64260a5354ce7332b242c27591fd1c8ca9ea9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page