Metadata-Version: 2.4
Name: astar-devopstool
Version: 0.1
Summary: Python devopstool
Author-email: "A.Star" <astar@snowland.ltd>
Maintainer-email: "A.Star" <astar@snowland.ltd>
License: Apache-2.0
Project-URL: Homepage, https://github.com/astar-club/astar-devopstool-python
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: astartool>=0.0.9
Provides-Extra: ssh
Requires-Dist: paramiko>=2.4.2; extra == "ssh"
Provides-Extra: gitlab
Requires-Dist: python-gitlab>=2.0.0; extra == "gitlab"
Provides-Extra: host
Requires-Dist: psutil; extra == "host"
Provides-Extra: all
Requires-Dist: paramiko>=2.4.2; extra == "all"
Requires-Dist: python-gitlab>=2.0.0; extra == "all"
Requires-Dist: psutil; extra == "all"
Dynamic: license-file

# astar-devopstool

[![version](https://img.shields.io/pypi/v/astar-devopstool.svg)](https://pypi.python.org/pypi/astar-devopstool)
[![gitee](https://gitee.com/snowlandltd/astar-devopstool-python/badge/star.svg)](https://gitee.com/snowlandltd/astar-devopstool-python/stargazers)
[![github](https://img.shields.io/github/stars/astar-club/astar-devopstool-python)](https://img.shields.io/github/stars/astar-club/astar-devopstool-python)
[![download](https://img.shields.io/pypi/dm/astar-devopstool.svg)](https://pypi.org/project/astar-devopstool)
[![wheel](https://img.shields.io/pypi/wheel/astar-devopstool.svg)](https://pypi.python.org/pypi/astar-devopstool)
![licence](https://img.shields.io/pypi/l/astar-devopstool.svg)
![status](https://img.shields.io/pypi/status/astar-devopstool.svg)

一组 Python 运维 / 开发辅助工具，包含 FTP/SFTP 传输、邮件发送、GitLab 提交统计、
主机监控、IP 与代理工具、版本发布通告等模块。

## 安装

项目的非核心功能以**可选依赖（extras）**形式提供，可按需安装，避免引入过重依赖：

```bash
pip install astar-devopstool            # 仅核心功能（基础库 astartool）
pip install "astar-devopstool[ssh]"     # + SFTP / SSH（依赖 paramiko）
pip install "astar-devopstool[gitlab]"  # + GitLab 统计（依赖 python-gitlab）
pip install "astar-devopstool[host]"    # + 主机监控（依赖 psutil）
pip install "astar-devopstool[all]"     # 全部可选功能
```

未安装对应可选依赖时，相关模块仍可导入，但调用具体功能会抛出清晰的
`ImportError` 并提示应安装的 extra。

## 文档

- 中文文档：[doc/README.zh.md](doc/README.zh.md)
- English documentation：[doc/README.en.md](doc/README.en.md)
- API 文档（v0.1）：[doc/api/v0.1/index.md](doc/api/v0.1/index.md)

## 许可证

Apache-2.0

## 参考资料

[1] https://github.com/ASTARCHEN/astartool

[2] https://blog.csdn.net/qq_43057091/article/details/82179301

[3] https://blog.csdn.net/qq_41841569/article/details/83824278

[4] ftp自动下载、自动上传脚本，可以递归目录操作 http://blog.csdn.net/ouyang_peng/article/details/79271113
