Skip to main content
Documentation Status https://github.com/MacHu-GWU/acore_db_app-project/actions/workflows/main.yml/badge.svg https://codecov.io/gh/MacHu-GWU/acore_db_app-project/branch/main/graph/badge.svg https://img.shields.io/pypi/v/acore-db-app.svg https://img.shields.io/pypi/l/acore-db-app.svg https://img.shields.io/pypi/pyversions/acore-db-app.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/Acore_Doc--None.svg?style=social&logo=readthedocs
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_db_app Documentation

https://acore-server.readthedocs.io/en/latest/_static/acore_server-logo.png

AzerothCore 魔兽世界服务器后端有一个数据库. 基于数据库我们可以开发出很多有创造力的 App. 这里有两个痛点:

  1. 出于安全考虑, 我们只能允许位于 AWS EC2 上的游戏服务器能跟数据库网络直连. 在本地的 App 开发过程连接到数据库, 以及让最终的 App 连接到数据库都是一个挑战.

  2. 当基于数据库的 App 开发完毕后, 这个 App 以什么形式给最终用户使用? Web App? 桌面 GUI? 网络安全又如何保障?

该项目是一个针对这个需求的完整解决方案, 它包含两个组件 CLI 和 SDK.

  1. CLI 是在 AWS EC2 游戏服务器上安装的一个命令行工具. 把常用的数据库 App 功能以及输入输出用 CLI 包装好供外部用户调用. 这些 CLI 命令的输入通常是和对应 Python 函数一致的参数, 而输出通常是将数据序列化成 JSON 然后打印到 stdout.

  2. SDK 则是可以在任何地方运行的一系列 API. 这些 API 会用 SSM Run Command 远程调用位于 EC2 上的 CLI, 然后将 stdout 中的数据解析并返回.

简而言之, CLI 是服务端的 App, SDK 是客户端的 App. 并且 SDK 是基于 CLI 的封装. 两者结合就能实现任何有权限的开发者都能从任何地方安全地运行数据库 App 的功能, 而无需位于数据库所在的 VPC 中.

AzerothCore Database Schema Reference:

在 EC2 上安装完 acore_db_app CLI 之后, 你可以用下面的命令测试:

/home/ubuntu/git_repos/acore_db_app-project/.venv/bin/acdb hello

Get latest N quests for a character:

/home/ubuntu/git_repos/acore_db_app-project/.venv/bin/acdb quest get-latest-n-quest --char ${character}

Install

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

$ pip install acore-db-app

To upgrade to latest version:

$ pip install --upgrade acore-db-app

Metadata

Release files for acore-db-app 0.2.4

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-db-app 0.2.4
File Size Uploaded
acore_db_app-0.2.4.tar.gz 36.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for acore-db-app 0.2.4
File Interpreter ABI Platform
acore_db_app-0.2.4-py3-none-any.whl Python 3 none any Details

Total release size: 76.1 kB

Release files / acore_db_app-0.2.4.tar.gz

Download URL acore_db_app-0.2.4.tar.gz
Size 36.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b66f3f024543f5241d2b1acc6a3d3b04e68ab8921a6374938a18e22ac9b89cb2
BLAKE2b-256 checksum
How to use checksums
36470eb30e887c9b77448171af21da9a5dc176c29fecbfd5583c227b7ada8d8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.0 CPython/3.11.8

Release files / acore_db_app-0.2.4-py3-none-any.whl

Download URL acore_db_app-0.2.4-py3-none-any.whl
Size 39.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
97d89b617e1aa70d2b1923442785612bff62ade2b3edb57b860d509dca4806d3
BLAKE2b-256 checksum
How to use checksums
c17689296a79db8edeabad1861fba79ad18c23126c7a75e102470b6180d65ee3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.0 CPython/3.11.8

Release history Release notifications | RSS feed

This release

0.2.4 This release

2 release files

0.2.3

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