WIP add groff generator
This commit is contained in:
lash
parent
68a01565c9
commit
d638ad93ae
GPG Key ID:
21D2E7BB88C2A746
|
|
@ -1,3 +1,5 @@
|
|||
- 0.0.21
|
||||
* Log rpc reply before json parse
|
||||
- 0.0.20
|
||||
* Add edit option for some long flag aliases of short flags: -a, -e, -s and -y
|
||||
- 0.0.19
|
||||
|
|
|
|||
|
|
@ -0,0 +1,258 @@
|
|||
# local imports
|
||||
from .base import (
|
||||
Flag,
|
||||
argflag_std_target,
|
||||
)
|
||||
|
||||
|
||||
class DocEntry:
|
||||
|
||||
def __init__(self, *args, argvalue=None):
|
||||
self.flags = args
|
||||
self.v = argvalue
|
||||
self.render = self.get_empty
|
||||
self.groff = None
|
||||
|
||||
|
||||
def __check_line_default(self, m):
|
||||
if self.render == self.get_empty:
|
||||
self.render = m
|
||||
|
||||
|
||||
def get_empty(self):
|
||||
s = ''
|
||||
for flag in self.flags:
|
||||
if len(s) > 0:
|
||||
s += ', '
|
||||
s += flag
|
||||
|
||||
s += '\n\t(undefined)\n'
|
||||
return s
|
||||
|
||||
|
||||
def set_groff(self, v):
|
||||
self.__check_line_default(self.get_groff)
|
||||
self.groff = v
|
||||
|
||||
|
||||
def get_groff(self):
|
||||
s = ''
|
||||
for flag in self.flags:
|
||||
if len(s) > 0:
|
||||
s += ', '
|
||||
s += '\\fB' + flag
|
||||
if self.v != None:
|
||||
s += ' \\fI' + self.v
|
||||
s += '\\fP'
|
||||
|
||||
v = self.groff
|
||||
if v == None:
|
||||
v = self.plain
|
||||
|
||||
s = "\n.TP\n" + s + "\n" + self.groff
|
||||
return s
|
||||
|
||||
|
||||
def __str__(self):
|
||||
return self.render()
|
||||
|
||||
|
||||
class DocGenerator:
|
||||
|
||||
def __init__(self, arg_flags):
|
||||
self.arg_flags = arg_flags
|
||||
self.docs = {}
|
||||
|
||||
|
||||
def __str__(self):
|
||||
s = ''
|
||||
ks = list(self.docs.keys())
|
||||
ks.sort()
|
||||
for k in ks:
|
||||
s += str(self.docs[k]) + "\n"
|
||||
return s
|
||||
|
||||
|
||||
def process(self):
|
||||
if self.arg_flags & Flag.VERBOSE:
|
||||
o = DocEntry('--no-logs')
|
||||
o.set_groff('Turn of logging completely. Negates \\fB-v\\fP and \\fB-vv\\fP')
|
||||
self.docs['nologs'] = o
|
||||
|
||||
o = DocEntry('-v')
|
||||
o.set_groff('Verbose. Show logs for important state changes.')
|
||||
self.docs['v'] = o
|
||||
|
||||
o = DocEntry('-vv')
|
||||
o.set_groff('Very verbose. Show logs with debugging information.')
|
||||
self.docs['vv'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.CONFIG:
|
||||
o = DocEntry('-c', '--config', argvalue='config_dir')
|
||||
o.set_groff('Load configuration files from given directory. All files with an .ini extension will be loaded, of which all must contain valid ini file data.')
|
||||
self.docs['c'] = o
|
||||
|
||||
o = DocEntry('-n', '--namespace', argvalue='namespace')
|
||||
o.set_groff('Load given configuration namespace. Configuration will be loaded from the immediate configuration subdirectory with the same name.')
|
||||
self.docs['n'] = o
|
||||
|
||||
o = DocEntry('--dumpconfig', argvalue='format')
|
||||
o.set_groff('Load given configuration namespace. Configuration will be loaded from the immediate configuration subdirectory with the same name.')
|
||||
self.docs['dumpconfig'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.WAIT:
|
||||
o = DocEntry('-w')
|
||||
o.set_groff('Wait for the last transaction to be confirmed on the network. Will generate an error if the EVM execution fails.')
|
||||
self.docs['w'] = o
|
||||
|
||||
o = DocEntry('-ww')
|
||||
o.set_groff('Wait for \\fIall\\fP transactions sequentially to be confirmed on the network. Will generate an error if EVM execution fails for any of the transactions.')
|
||||
self.docs['ww'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.ENV_PREFIX:
|
||||
o = DocEntry('--env-prefix')
|
||||
o.set_groff('Environment prefix for variables to overwrite configuration. Example: If \\fB--env-prefix\\fP is set to \\fBFOO\\fP then configuration variable \\fBBAR_BAZ\\fP would be set by environment variable \\fBFOO_BAZ_BAR\\fP. Also see \\fBENVIRONMENT\\fP.')
|
||||
self.docs['envprefix'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.PROVIDER:
|
||||
o = DocEntry('-p', '--rpc-provider')
|
||||
o.set_groff('Fully-qualified URL of RPC provider.')
|
||||
self.docs['p'] = o
|
||||
|
||||
o = DocEntry('--rpc-dialect')
|
||||
o.set_groff('RPC backend dialect. If specified it \\fImay\\fP help with encoding and decoding issues.')
|
||||
self.docs['rpcdialect'] = o
|
||||
|
||||
o = DocEntry('--height')
|
||||
o.set_groff('Block height at which to query state for. Does not apply to transactions.')
|
||||
self.docs['height'] = o
|
||||
|
||||
if self.arg_flags & Flag.RPC_AUTH:
|
||||
o = DocEntry('--rpc-auth')
|
||||
o.set_groff('RPC endpoint authentication method, e.g. how to handle a HTTP WWW-Authenticate header.')
|
||||
self.docs['rpcauth'] = o
|
||||
|
||||
o = DocEntry('--rpc-credentials')
|
||||
o.set_groff('RPC endpoint authentication data. Format depends on the authentication method defined in \\fB--rpc-auth\\fP.')
|
||||
self.docs['rpcendpoint'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.CHAIN_SPEC:
|
||||
o = DocEntry('-i', '--chain-spec', argvalue='chain_spec')
|
||||
o.set_groff('Chain specification string, in the format <engine>:<fork>:<chain_id>:<common_name>. Example: "evm:london:1:ethereum".')
|
||||
self.docs['i'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.UNSAFE:
|
||||
o = DocEntry('-u', '--unsafe')
|
||||
o.set_groff('Allow addresses that do not pass checksum.')
|
||||
self.docs['u'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.SEQ:
|
||||
o = DocEntry('--seq')
|
||||
o.set_groff('Use numeric sequencial jsonrpc query ids. Useful for buggy server implementations who expects such.')
|
||||
self.docs['seq'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.KEY_FILE:
|
||||
o = DocEntry('-y', '--key-path', argvalue='path')
|
||||
o.set_groff('Path to signing key.')
|
||||
self.docs['y'] = o
|
||||
|
||||
o = DocEntry('--passphrase-file', argvalue='path')
|
||||
o.set_groff('Path to file containing password to unlock key file')
|
||||
self.docs['passphrasefile'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.SEND:
|
||||
o = DocEntry('-s')
|
||||
o.set_groff('Send to network. If set, network state may change. This means tokens may be spent and so on. Use with care. Only applies to transactions.')
|
||||
self.docs['s'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.RAW:
|
||||
o = DocEntry('--raw')
|
||||
o.set_groff('Produce output most optimized for machines.')
|
||||
self.docs['raw'] = o
|
||||
|
||||
|
||||
if self.arg_flags & (Flag.SIGN | Flag.NONCE):
|
||||
o = DocEntry('--nonce')
|
||||
o.set_groff('Explicitly set nonce to use for transaction.')
|
||||
self.docs['nonce'] = o
|
||||
|
||||
|
||||
if self.arg_flags & (Flag.SIGN | Flag.FEE):
|
||||
o = DocEntry('--fee-price')
|
||||
o.set_groff('Set fee unit price to offer for the transaction. If used with \\fB-s\\fP this may incur actual network token cost.')
|
||||
self.docs['feeprice'] = o
|
||||
|
||||
o = DocEntry('--fee-limit')
|
||||
o.set_groff('Set the limit of execution units for the transaction. If used with \\fB-s\fP this may incur actual network token cost. If \\fB--fee-price\\fP is not explicitly set, the price \\fImay\\fP be retrieved from the network, and multiplied with this value to define the cost.')
|
||||
self.docs['feelimit'] = o
|
||||
|
||||
# TODO: this manipulation should be DRYd
|
||||
if self.arg_flags & argflag_std_target == 0:
|
||||
self.arg_flags |= Flag.WALLET
|
||||
|
||||
|
||||
if self.arg_flags & Flag.EXEC:
|
||||
o = DocEntry('-e', '--executable-address')
|
||||
o.set_groff('Address of an executable code point on the network.')
|
||||
self.docs['e'] = o
|
||||
|
||||
|
||||
if self.arg_flags & Flag.WALLET:
|
||||
o = DocEntry('-a', '--recipient-address')
|
||||
o.set_groff('Network wallet address to operate on. For read calls, this will be the wallet address for which the query is anchored. For transaction calls, it will be the wallet address for which state will be changed.')
|
||||
self.docs['a'] = o
|
||||
|
||||
|
||||
# self.add_argument('--no-logs', dest='no_logs',action='store_true', help='Turn off all logging')
|
||||
# self.add_argument('-v', action='store_true', help='Be verbose')
|
||||
# self.add_argument('-vv', action='store_true', help='Be more verbose')
|
||||
# if arg_flags & Flag.CONFIG:
|
||||
# self.add_argument('-c', '--config', type=str, default=env.get('CONFINI_DIR'), help='Configuration directory')
|
||||
# self.add_argument('-n', '--namespace', type=str, help='Configuration namespace')
|
||||
# self.add_argument('--dumpconfig', type=str, choices=['env', 'ini'], help='Output configuration and quit. Use with --raw to omit values and output schema only.')
|
||||
# if arg_flags & Flag.WAIT:
|
||||
# self.add_argument('-w', action='store_true', help='Wait for the last transaction to be confirmed')
|
||||
# self.add_argument('-ww', action='store_true', help='Wait for every transaction to be confirmed')
|
||||
# if arg_flags & Flag.ENV_PREFIX:
|
||||
# self.add_argument('--env-prefix', default=env.get('CONFINI_ENV_PREFIX'), dest='env_prefix', type=str, help='environment prefix for variables to overwrite configuration')
|
||||
# if arg_flags & Flag.PROVIDER:
|
||||
# self.add_argument('-p', '--rpc-provider', dest='p', type=str, help='RPC HTTP(S) provider url')
|
||||
# self.add_argument('--rpc-dialect', dest='rpc_dialect', type=str, help='RPC HTTP(S) backend dialect')
|
||||
# self.add_argument('--height', default='latest', help='Block height to execute against')
|
||||
# if arg_flags & Flag.RPC_AUTH:
|
||||
# self.add_argument('--rpc-auth', dest='rpc_auth', type=str, help='RPC autentication scheme')
|
||||
# self.add_argument('--rpc-credentials', dest='rpc_credentials', type=str, help='RPC autentication credential values')
|
||||
# if arg_flags & Flag.CHAIN_SPEC:
|
||||
# self.add_argument('-i', '--chain-spec', dest='i', type=str, help='Chain specification string')
|
||||
# if arg_flags & Flag.UNSAFE:
|
||||
# self.add_argument('-u', '--unsafe', dest='u', action='store_true', help='Do not verify address checksums')
|
||||
# if arg_flags & Flag.SEQ:
|
||||
# self.add_argument('--seq', action='store_true', help='Use sequential rpc ids')
|
||||
# if arg_flags & Flag.KEY_FILE:
|
||||
# self.add_argument('-y', self.long_args['-y'], dest='y', type=str, help='Keystore file to use for signing or address')
|
||||
# self.add_argument('--passphrase-file', dest='passphrase_file', type=str, help='File containing passphrase for keystore')
|
||||
# if arg_flags & Flag.SEND:
|
||||
# self.add_argument('-s', self.long_args['-s'], dest='s', action='store_true', help='Send to network')
|
||||
# if arg_flags & Flag.RAW:
|
||||
# self.add_argument('--raw', action='store_true', help='Do not decode output')
|
||||
# if arg_flags & (Flag.SIGN | Flag.NONCE):
|
||||
# self.add_argument('--nonce', type=int, help='override nonce')
|
||||
# if arg_flags & (Flag.SIGN | Flag.FEE):
|
||||
# self.add_argument('--fee-price', dest='fee_price', type=int, help='override fee price')
|
||||
# self.add_argument('--fee-limit', dest='fee_limit', type=int, help='override fee limit')
|
||||
# if arg_flags & argflag_std_target == 0:
|
||||
# arg_flags |= Flag.WALLET
|
||||
# if arg_flags & Flag.EXEC:
|
||||
# self.add_argument('-e', self.long_args['-e'], dest=self.arg_dest['-e'], type=str, help='contract address')
|
||||
# if arg_flags & Flag.WALLET:
|
||||
# self.add_argument('-a', self.long_args['-a'], dest=self.arg_dest['-a'], type=str, help='recipient address')
|
||||
|
|
@ -322,7 +322,8 @@ class JSONRPCHTTPConnection(HTTPConnection):
|
|||
)
|
||||
ho = build_opener(handler)
|
||||
install_opener(ho)
|
||||
|
||||
|
||||
r = None
|
||||
try:
|
||||
r = urlopen(
|
||||
req,
|
||||
|
|
@ -332,8 +333,9 @@ class JSONRPCHTTPConnection(HTTPConnection):
|
|||
except URLError as e:
|
||||
raise RPCException(e)
|
||||
|
||||
result = json.load(r)
|
||||
logg.debug('(HTTP) recv {}'.format(result))
|
||||
resp = r.read()
|
||||
logg.debug('(HTTP) recv {}'.format(resp.decode('utf-8')))
|
||||
result = json.loads(resp)
|
||||
if o['id'] != result['id']:
|
||||
raise ValueError('RPC id mismatch; sent {} received {}'.format(o['id'], result['id']))
|
||||
return jsonrpc_result(result, error_parser)
|
||||
|
|
|
|||
|
|
@ -0,0 +1,6 @@
|
|||
from chainlib.cli.man import DocGenerator
|
||||
|
||||
|
||||
g = DocGenerator(0xffffffff)
|
||||
g.process()
|
||||
print(g)
|
||||
Loading…
Reference in New Issue