1
0
mirror of synced 2024-12-15 07:41:15 +01:00
bemaniutils/bemani/client/base.py

425 lines
16 KiB
Python

import time
from typing import Optional, Dict, List, Tuple, Any
from typing_extensions import Final
from bemani.client.common import random_hex_string
from bemani.client.protocol import ClientProtocol
from bemani.protocol import Node
class BaseClient:
"""
The base client that all client emulators subclass from. This includes
a lot of functionality to create cards, exchange packets, verify responses
and verify some basic packets that are always expected to work.
"""
CARD_OK: Final[int] = 0
CARD_NEW: Final[int] = 112
CARD_BAD_PIN: Final[int] = 116
CARD_NOT_ALLOWED: Final[int] = 110
CORRECT_PASSWORD: Final[str] = '1234'
WRONG_PASSWORD: Final[str] = '4321'
def __init__(self, proto: ClientProtocol, pcbid: str, config: Dict[str, Any]) -> None:
self.__proto = proto
self.pcbid = pcbid
self.config = config
def random_card(self) -> str:
return "E004" + random_hex_string(12, caps=True)
def call_node(self) -> Node:
call = Node.void('call')
call.set_attribute('model', self.config['model'])
call.set_attribute('srcid', self.pcbid)
call.set_attribute('tag', random_hex_string(8))
return call
def exchange(self, path: str, tree: Node) -> Node:
module = tree.children[0].name
method = tree.children[0].attribute('method')
return self.__proto.exchange(
f'{path}?model={self.config["model"]}&module={module}&method={method}',
tree,
)
def __assert_path(self, root: Node, path: str) -> bool:
parts = path.split('/')
children = [root]
node: Optional[Node] = None
for part in parts:
if part[0] == '@':
# Verify attribute, should be last part in chain so
# assume its the first node
if node is None:
return False
if part[1:] not in node.attributes:
return False
else:
return True
else:
# Verify node name, might be last in chain
found = False
for child in children:
if child.name == part:
# This is a valid node, set to children and keep going
children = child.children
node = child
found = True
break
if not found:
# Didn't find a noce named this
return False
# Traversed whole chain
return True
def assert_path(self, root: Node, path: str) -> None:
"""
Given a root node and a path string such as a/b/node or a/b/@attr,
validate that the root node has decendents that match the path.
As a convenience, you can check an attribute on a node with @attr
format, where <attr> is the string name of the attribute.
"""
if not self.__assert_path(root, path):
raise Exception(f'Path \'{path}\' not found in root node:\n{root}')
def verify_services_get(self, expected_services: List[str]=[], include_net: bool = False) -> None:
call = self.call_node()
# Construct node
services = Node.void('services')
call.add_child(services)
services.set_attribute('method', 'get')
if self.config['avs'] is not None:
# Some older games don't include this info
info = Node.void('info')
services.add_child(info)
info.add_child(Node.string('AVS2', self.config['avs']))
if include_net:
net = Node.void('net')
services.add_child(net)
iface = Node.void('if')
net.add_child(iface)
iface.add_child(Node.u8('id', 0))
iface.add_child(Node.bool('valid', True))
iface.add_child(Node.u8('type', 1))
iface.add_child(Node.u8_array('mac', [1, 2, 3, 4, 5, 6]))
iface.add_child(Node.ipv4('addr', '10.0.0.100'))
iface.add_child(Node.ipv4('bcast', '10.0.0.255'))
iface.add_child(Node.ipv4('netmask', '255.255.255.0'))
iface.add_child(Node.ipv4('gateway', '10.0.0.1'))
iface.add_child(Node.ipv4('dhcp', '10.0.0.1'))
# Swap with server
resp = self.exchange('core/services', call)
# Verify that response is correct
self.assert_path(resp, "response/services")
items = resp.child('services').children
returned_services = []
for item in items:
# Make sure it is an item with a url component
self.assert_path(item, 'item/@url')
# Get list of services provided
returned_services.append(item.attribute('name'))
for service in expected_services:
if service not in returned_services:
raise Exception(f'Service \'{service}\' expected but not returned')
def verify_pcbtracker_alive(self, ecflag: int = 1) -> bool:
call = self.call_node()
# Construct node
pcbtracker = Node.void('pcbtracker')
call.add_child(pcbtracker)
pcbtracker.set_attribute('accountid', self.pcbid)
pcbtracker.set_attribute('ecflag', str(ecflag))
pcbtracker.set_attribute('hardid', '01000027584F6D3A')
pcbtracker.set_attribute('method', 'alive')
pcbtracker.set_attribute('softid', '00010203040506070809')
# Swap with server
resp = self.exchange('core/pcbtracker', call)
# Verify that response is correct
self.assert_path(resp, "response/pcbtracker/@ecenable")
# Print out setting
enable = int(resp.child('pcbtracker').attribute('ecenable'))
if enable != 0:
return True
return False
def verify_message_get(self) -> None:
call = self.call_node()
# Construct node
message = Node.void('message')
call.add_child(message)
message.set_attribute('method', 'get')
# Swap with server
resp = self.exchange('core/message', call)
# Verify that response is correct
self.assert_path(resp, "response/message/@status")
def verify_dlstatus_progress(self) -> None:
call = self.call_node()
# Construct node
dlstatus = Node.void('dlstatus')
call.add_child(dlstatus)
dlstatus.set_attribute('method', 'progress')
dlstatus.add_child(Node.s32('progress', 0))
# Swap with server
resp = self.exchange('core/dlstatus', call)
# Verify that response is correct
self.assert_path(resp, "response/dlstatus/@status")
def verify_package_list(self) -> None:
call = self.call_node()
# Construct node
package = Node.void('package')
call.add_child(package)
package.set_attribute('method', 'list')
package.set_attribute('pkgtype', 'all')
# Swap with server
resp = self.exchange('core/package', call)
# Verify that response is correct
self.assert_path(resp, "response/package")
def verify_facility_get(self, encoding: str='SHIFT_JIS') -> str:
call = self.call_node()
# Construct node
facility = Node.void('facility')
call.add_child(facility)
facility.set_attribute('encoding', encoding)
facility.set_attribute('method', 'get')
# Swap with server
resp = self.exchange('core/facility', call)
# Verify that response is correct
self.assert_path(resp, "response/facility/location/id")
self.assert_path(resp, "response/facility/line")
self.assert_path(resp, "response/facility/portfw")
self.assert_path(resp, "response/facility/public")
self.assert_path(resp, "response/facility/share")
return resp.child_value('facility/location/id')
def verify_pcbevent_put(self) -> None:
call = self.call_node()
# Construct node
pcbevent = Node.void('pcbevent')
call.add_child(pcbevent)
pcbevent.set_attribute('method', 'put')
pcbevent.add_child(Node.time('time', int(time.time())))
pcbevent.add_child(Node.u32('seq', 0))
item = Node.void('item')
pcbevent.add_child(item)
item.add_child(Node.string('name', 'boot'))
item.add_child(Node.s32('value', 1))
item.add_child(Node.time('time', int(time.time())))
# Swap with server
resp = self.exchange('core/pcbevent', call)
# Verify that response is correct
self.assert_path(resp, "response/pcbevent")
def verify_cardmng_inquire(self, card_id: str, msg_type: str, paseli_enabled: bool) -> Optional[str]:
call = self.call_node()
# Construct node
cardmng = Node.void('cardmng')
call.add_child(cardmng)
cardmng.set_attribute('cardid', card_id)
cardmng.set_attribute('cardtype', '1')
cardmng.set_attribute('method', 'inquire')
cardmng.set_attribute('update', '0')
if msg_type == 'new' and 'old_profile_model' in self.config:
cardmng.set_attribute('model', self.config['old_profile_model'])
# Swap with server
resp = self.exchange('core/cardmng', call)
if msg_type == 'unregistered':
# Verify that response is correct
self.assert_path(resp, "response/cardmng/@status")
# Verify that we weren't found
status = int(resp.child('cardmng').attribute('status'))
if status != self.CARD_NEW:
raise Exception(f'Card \'{card_id}\' returned invalid status \'{status}\'')
# Nothing to return
return None
elif msg_type == 'new':
# Verify that response is correct
self.assert_path(resp, "response/cardmng/@refid")
self.assert_path(resp, "response/cardmng/@binded")
self.assert_path(resp, "response/cardmng/@newflag")
self.assert_path(resp, "response/cardmng/@ecflag")
binded = int(resp.child('cardmng').attribute('binded'))
newflag = int(resp.child('cardmng').attribute('newflag'))
ecflag = int(resp.child('cardmng').attribute('ecflag'))
if binded != 0:
raise Exception(f'Card \'{card_id}\' returned invalid binded value \'{binded}\'')
if newflag != 1:
raise Exception(f'Card \'{card_id}\' returned invalid newflag value \'{newflag}\'')
if ecflag != (1 if paseli_enabled else 0):
raise Exception(f'Card \'{card_id}\' returned invalid ecflag value \'{newflag}\'')
# Return the refid
return resp.child('cardmng').attribute('refid')
elif msg_type == 'query':
# Verify that response is correct
self.assert_path(resp, "response/cardmng/@refid")
self.assert_path(resp, "response/cardmng/@binded")
self.assert_path(resp, "response/cardmng/@newflag")
self.assert_path(resp, "response/cardmng/@ecflag")
binded = int(resp.child('cardmng').attribute('binded'))
newflag = int(resp.child('cardmng').attribute('newflag'))
ecflag = int(resp.child('cardmng').attribute('ecflag'))
if binded != 1:
raise Exception(f'Card \'{card_id}\' returned invalid binded value \'{binded}\'')
if newflag != 0:
raise Exception(f'Card \'{card_id}\' returned invalid newflag value \'{newflag}\'')
if ecflag != (1 if paseli_enabled else 0):
raise Exception(f'Card \'{card_id}\' returned invalid ecflag value \'{newflag}\'')
# Return the refid
return resp.child('cardmng').attribute('refid')
else:
raise Exception(f'Unrecognized message type \'{msg_type}\'')
def verify_cardmng_getrefid(self, card_id: str) -> str:
call = self.call_node()
# Construct node
cardmng = Node.void('cardmng')
call.add_child(cardmng)
cardmng.set_attribute('cardid', card_id)
cardmng.set_attribute('cardtype', '1')
cardmng.set_attribute('method', 'getrefid')
cardmng.set_attribute('newflag', '0')
cardmng.set_attribute('passwd', self.CORRECT_PASSWORD)
# Swap with server
resp = self.exchange('core/cardmng', call)
# Verify that response is correct
self.assert_path(resp, "response/cardmng/@refid")
return resp.child('cardmng').attribute('refid')
def verify_cardmng_authpass(self, ref_id: str, correct: bool) -> None:
call = self.call_node()
# Construct node
cardmng = Node.void('cardmng')
call.add_child(cardmng)
cardmng.set_attribute('method', 'authpass')
cardmng.set_attribute('pass', self.CORRECT_PASSWORD if correct else self.CORRECT_PASSWORD[::-1])
cardmng.set_attribute('refid', ref_id)
# Swap with server
resp = self.exchange('core/cardmng', call)
# Verify that response is correct
self.assert_path(resp, "response/cardmng/@status")
status = int(resp.child('cardmng').attribute('status'))
if status != (self.CARD_OK if correct else self.CARD_BAD_PIN):
raise Exception(f'Ref ID \'{ref_id}\' returned invalid status \'{status}\'')
def verify_eacoin_checkin(self, card_id: str) -> Tuple[str, int]:
call = self.call_node()
# Construct node
eacoin = Node.void('eacoin')
call.add_child(eacoin)
eacoin.set_attribute('method', 'checkin')
eacoin.add_child(Node.string('cardtype', '1'))
eacoin.add_child(Node.string('cardid', card_id))
eacoin.add_child(Node.string('passwd', self.CORRECT_PASSWORD))
eacoin.add_child(Node.string('ectype', '1'))
# Swap with server
resp = self.exchange('core/eacoin', call)
# Verify that response is correct
self.assert_path(resp, "response/eacoin/sessid")
self.assert_path(resp, "response/eacoin/balance")
return (resp.child('eacoin').child_value('sessid'), resp.child('eacoin').child_value('balance'))
def verify_eacoin_consume(self, sessid: str, balance: int, amount: int) -> None:
call = self.call_node()
# Construct node
eacoin = Node.void('eacoin')
call.add_child(eacoin)
eacoin.set_attribute('method', 'consume')
eacoin.add_child(Node.string('sessid', sessid))
eacoin.add_child(Node.s16('sequence', 0))
eacoin.add_child(Node.s32('payment', amount))
eacoin.add_child(Node.s32('service', 0))
eacoin.add_child(Node.string('itemtype', '0'))
eacoin.add_child(Node.string('detail', '/eacoin/start_pt1'))
# Swap with server
resp = self.exchange('core/eacoin', call)
# Verify that response is correct
self.assert_path(resp, "response/eacoin/balance")
newbalance = resp.child('eacoin').child_value('balance')
if balance - amount != newbalance:
raise Exception(f"Expected to get back balance {balance - amount} but got {newbalance}")
def verify_eacoin_checkout(self, session: str) -> None:
call = self.call_node()
# Construct node
eacoin = Node.void('eacoin')
call.add_child(eacoin)
eacoin.set_attribute('method', 'checkout')
eacoin.add_child(Node.string('sessid', session))
# Swap with server
resp = self.exchange('core/eacoin', call)
# Verify that response is correct
self.assert_path(resp, "response/eacoin/@status")
def verify(self, cardid: Optional[str]) -> None:
raise Exception('Override in subclass!')