Custom, easy to integrate shell
Project description
!!!DISCLAIMER!!!
:warning: This tool is experimental ⚠️ : This project currently is in early beta! The tool is extremly unstable, has a lot of unfixed bugs and currently even has no error control. USAGE AT YOU OWN RISK! We are currently working on getting everything properly working.
Console Engine
This is a simple to integrate Shell (Metasploit like)
Usage
You will have to pass a configuaration as Dictionary into the Shell instance. In the configuration you define the commands and their needed arguments.
Example config:
config = {
'keywords': {
'help': 'help_menu',
'exit': 'exit',
'commandone': 'method1',
'commandtwo': 'method2',
},
'methods': {
'help_menu': {
'arguments': None
},
'exit': {
'arguments': None
},
'method1': {
'arguments': {
'flags': {
'i': {
'type': 'IPADDR',
'idx': 'target_ip'
}
}
}
},
'method2': {
'arguments': {
'values': {
'STR': 'text'
}
}
}
},
}
After having made the config implement console engine into your script like in this demo script:
import console-engine
if __name__=='__main__':
shell_ = console-engine.Shell(config, header='>> ')
while True:
inst, count = shell_.prompt()
res = inst[0]
if res['idx'] == 'help_menu':
print("""
command1 - returns given ip
command2 - echos given str
help - diplays this msg
exit - terminates script
""")
elif res['idx'] == 'exit':
exit()
elif res['idx'] == 'method1':
print(res['data']['target_ip'])
elif res['idx'] == 'method2':
print(res['data']['text'])
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
console-engine-0.0.1.tar.gz
(9.3 kB
view hashes)
Built Distribution
Close
Hashes for console_engine-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e2cc8b2887732c1cdcedb2639b37c41524f6f33247759da085121307d1fca974 |
|
MD5 | f4178914bf8e358eae9bdde3d2ff9dee |
|
BLAKE2b-256 | 9b011df2e067707a3e4ad098db7a8b7867626418611b29444eb30eb63a5195b1 |