Skip to main content
Documentation Status https://github.com/MacHu-GWU/acore_soap-project/actions/workflows/main.yml/badge.svg https://codecov.io/gh/MacHu-GWU/acore_soap-project/branch/main/graph/badge.svg https://img.shields.io/pypi/v/acore-soap.svg https://img.shields.io/pypi/l/acore-soap.svg https://img.shields.io/pypi/pyversions/acore-soap.svg https://img.shields.io/badge/Release_History!--None.svg?style=social https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
https://img.shields.io/badge/Link-Document-blue.svg https://img.shields.io/badge/Link-API-blue.svg https://img.shields.io/badge/Link-Install-blue.svg https://img.shields.io/badge/Link-GitHub-blue.svg https://img.shields.io/badge/Link-Submit_Issue-blue.svg https://img.shields.io/badge/Link-Request_Feature-blue.svg https://img.shields.io/badge/Link-Download-blue.svg

Welcome to acore_soap Documentation

https://acore-soap.readthedocs.io/en/latest/_static/acore_soap-logo.png

azerothcore 魔兽世界服务器 自带一个类似于 Terminal 的交互式 Console. GM 可以在里面输入命令来创建账号, 修改密码, 封禁账号等, 例如 .account create $account $password. 你如果用 GM 账号登录游戏客户端, 你也可以在游戏内聊天框输入 GM 命令, 本质是一样的.

如果你希望像操作 Rest API 一样的远程执行命令, 以上两种方法就不太实用了. 一种你需要 SSH 到服务器上才能接触到 console, 一种你需要登录游戏客户端, 而客户端是没有我们需要的变成接口的. 而这种需求对于服务器维护者来说又是实实在在的. 例如服务器可能有一个官网, 让会员用户可以在网站上点击购买物品后, 游戏服务器就自动运行一条 GM 命令将物品发送到用户游戏角色的邮箱. 在这个例子里 GM 命令的发起端是 Web 服务器, 而运维的时候 GM 命令的发起端可以是任何东西, 例如 VM, Container, Lambda Function 等. 所以我们就需要一套机制能仅让有权限的人或机器远程执行 GM 命令. 这个需求对于长期的正式运营非常重要.

我创造了一整套工具用于实现这个需求. 其中这个 acore_soap 项目是这一整套工具的基石. 在应用层, 它提供了一套 Pythonic 的 API 用参数化的方式发送 GM 命令, 并将返回的信息解析成机器友好的 Python 对象. 在底层, 它提供了一套 SOAPRequest 和 SOAPResponse 的抽象, 实现了发送 command 和获取 response message 的核心逻辑. 你可以用这个基石来构建更高级的应用, 例如一个 Web 服务器, 一个 Discord Bot 等等.

Install

acore_soap is released on PyPI, so all you need is to:

$ pip install acore-soap

To upgrade to latest version:

$ pip install --upgrade acore-soap

Metadata

Release files for acore-soap 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for acore-soap 0.2.1
File Size Uploaded
acore_soap-0.2.1.tar.gz 18.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for acore-soap 0.2.1
File Interpreter ABI Platform
acore_soap-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 34.8 kB

Release files / acore_soap-0.2.1.tar.gz

Download URL acore_soap-0.2.1.tar.gz
Size 18.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2438157c725cd7124ac12a485d33d3002e004b48ecbebe317ac2e8c21f21ec90
BLAKE2b-256 checksum
How to use checksums
59a5d8fd164bebfd3386ee1e019167a1dbe069a881262b454c34775d90b9ae53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.10.10

Release files / acore_soap-0.2.1-py3-none-any.whl

Download URL acore_soap-0.2.1-py3-none-any.whl
Size 16.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2a745717d14f644eb4e5d9df45fcac4dd5e008db1a41214cecfeebb50410c17d
BLAKE2b-256 checksum
How to use checksums
a6dc6368fe84922ce66b34172d1697fdab9328bcb12d99c35f7279e2a5e5c964
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.10.10

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page