echotools

通用基础设施 SDK：配置中心、日志、事件总线、调用链、任务调度、 插件框架、协议系统、自适应选择器，完全项目无关，兼容 Python 3.8–3.14。

安装

# 核心（仅 typing-extensions）
pip install echotools

# 完整功能
pip install echotools[all]

可选依赖

Extra 用途
toml TOML 配置读写
watch watchdog 文件监视
http aiohttp Web 层
socks SOCKS 代理
ssh SSH 终端
terminal Windows ConPTY
all 全部可选依赖
dev pytest, ruff, mypy

PyPI 重装（uninstall-no-record-file）

本地 pip install -e . 或中断的 wheel 安装可能留下无 RECORD 的元数据，导致 pip install --upgrade echotools 报 Cannot uninstall echotools None。

# 在仓库根目录
powershell -File scripts/reinstall_from_pypi.ps1 -Version 2.3.81

或手动：删除 src/echotools.egg-info 与 site-packages 里仅有 direct_url.json 的 echotools-*.dist-info，再执行 pip install --force-reinstall --no-cache-dir echotools==2.3.81。

快速开始

from echotools import EchoTools

et = EchoTools(service_name="myapp")
et.logger.configure(level="INFO", color=True)
cfg = et.config
cfg.load("config.toml")

with et.tracer.trace("request") as trace:
    with et.tracer.span(trace, "db") as span:
        span.set_tag("query", "select 1")

await et.shutdown()

能力总览

模块 说明
ConfigCenter 点路径配置 + 热重载 + 类型绑定
LoggerManager 调用链注入 + 颜色 + 轮转
EventBus 同步/异步事件
Tracer 轻量调用链
TaskDispatcher 单发/竞速 + 贝叶斯自适应选择
PluginRegistry 自动发现 + 热重载
get_protocol XML/antml/original/bracket/nous 等 LLM 工具协议
ProxyManager HTTP/HTTPS/SOCKS
AutoUpdater git 自动更新
FileWatcher 轮询文件监视

开发

pip install -e ".[dev,all]"
make lint
make test
make cov

模块指南见 docs/modules.md，API 参考见 docs/api.md。

许可证

MIT

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.4.11)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nightpoem from gravatar.com nightpoem

Credits

Author: nichengfuben

License

MIT

Requires

Python >=3.8

Provides Extra

toml watch http socks ssh terminal console all dev

Classifiers

Report project as malware

Download files

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

Source Distribution

echotools-2.3.84.tar.gz (338.8 kB view details)

Uploaded Source

Built Distribution

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

echotools-2.3.84-py3-none-any.whl (434.0 kB view details)

Uploaded Python 3

File details

Details for the file echotools-2.3.84.tar.gz.

File metadata

  • Download URL: echotools-2.3.84.tar.gz
  • Upload date:
  • Size: 338.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for echotools-2.3.84.tar.gz
Algorithm Hash digest
SHA256 0f74325d90d921e6760fe3d240e21e088f50ec580dd8e59698bc9ec7628f481a
MD5 fb3896907d016f77c4c24fce46282a81
BLAKE2b-256 5f9fc766fa1e7398c86e34822ea3c566dfc2b83bb9e9d16940e329d0972ae3e0

See more details on using hashes here.

File details

Details for the file echotools-2.3.84-py3-none-any.whl.

File metadata

  • Download URL: echotools-2.3.84-py3-none-any.whl
  • Upload date:
  • Size: 434.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for echotools-2.3.84-py3-none-any.whl
Algorithm Hash digest
SHA256 647c64ff4802a8c2ff21427704c141467c506eac7e30b3f498c4d4cb500b9db6
MD5 2a88c53c97141d2a9ba71dedde0a2ee9
BLAKE2b-256 a575bc1d1a551020a2410baefc38c642e3e330007692f625ff975363542c6552

See more details on using hashes here.

Release history Release notifications | RSS feed

2.4.11

2 files

2.4.10

2 files

2.4.9

2 files

2.4.8

2 files

2.4.7

2 files

2.4.6

2 files

2.4.5

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.104

2 files

2.3.103

2 files

2.3.100

2 files

2.3.99

2 files

2.3.98

2 files

2.3.97

2 files

2.3.96

2 files

2.3.94

2 files

2.3.93

2 files

2.3.91

2 files

2.3.90

2 files

2.3.89

2 files

2.3.88

2 files

2.3.87

2 files

2.3.86

2 files

2.3.85

2 files

This release

2.3.84 This release

2 files

2.3.83

2 files

2.3.82

2 files

2.3.81

2 files

2.3.80

2 files

2.3.78

2 files

2.3.74

2 files

2.3.73

2 files

2.3.71

2 files

2.3.70

2 files

2.3.67

2 files

2.3.66

2 files

2.3.64

2 files

2.3.62

2 files

2.3.61

2 files

2.3.60

2 files

2.3.56

2 files

2.3.55

2 files

2.3.53

2 files

2.3.52

2 files

2.3.51

2 files

2.3.50

2 files

2.3.49

2 files

2.3.48

2 files

2.3.47

2 files

2.3.46

2 files

2.3.45

2 files

2.3.44

2 files

2.3.43

2 files

2.3.42

2 files

2.3.40

2 files

2.3.39

2 files

2.3.38

2 files

2.3.31

2 files

2.3.30

2 files

2.3.29

2 files

2.3.25

2 files

2.3.23

2 files

2.3.22

2 files

2.3.21

2 files

2.3.19

2 files

2.3.16

2 files

2.3.15

2 files

2.3.14

2 files

2.3.13

2 files

2.3.12

2 files

2.3.11

2 files

2.3.10

2 files

2.3.8

2 files

2.3.7

2 files

2.3.6

2 files

2.3.5

2 files

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.1.0

2 files

2.0.0

2 files

1.0.36

2 files

1.0.35

2 files

1.0.33

2 files

1.0.32

2 files

1.0.31

2 files

1.0.30

2 files

1.0.29

1 file

1.0.28

1 file

1.0.27

2 files

1.0.26

2 files

1.0.25

2 files

1.0.24

2 files

1.0.23

2 files

1.0.22

2 files

1.0.21

2 files

1.0.20

2 files

1.0.19

1 file

1.0.18

1 file

1.0.17

2 files

1.0.16

2 files

1.0.15

2 files

1.0.14

2 files

1.0.13

2 files

1.0.12

2 files

1.0.11

2 files

1.0.10

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

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