Metadata-Version: 2.1
Name: socket-request
Version: 1.1.6
Summary: socket_request is building and parsing HTTP requests with UNIX domain sockets.
Home-page: https://github.com/jinwoo-j/socket_request
Author: Jinwoo Jeong
Author-email: jinwoo@parametacorp.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: halo (>=0.0.31)
Requires-Dist: devtools (>=0.6.1)
Requires-Dist: argparse (>=1.4.0)
Requires-Dist: requests (>=2.20.0)
Requires-Dist: pawnlib (==0.1.37)

# socket_request

socket_request is build and parses HTTP requests with unix domain sockets.

### Installing socket_request

socket_request is available on PyPI:

```
pip3 install socket-request

```
Officially supports Python 3.7+.



### Examples:

```python
import socket_request

docker = socket_request.DockerSock(unix_socket="/var/run/docker.sock")
docker.get_docker_images()

```


```python
import socket_request

control_chain = socket_request.ControlChain(unix_socket="./cli.sock")
control_chain.stop()
control_chain.start()

```

## CLI:
$ control_chain --help
```angular2html

    ╋╋╋╋╋╋╋╋╋┏┓╋╋╋╋╋┏┓╋╋╋╋┏┓
    ╋╋╋╋╋╋╋╋┏┛┗┓╋╋╋╋┃┃╋╋╋╋┃┃
    ┏━━┳━━┳━╋┓┏╋━┳━━┫┃╋┏━━┫┗━┳━━┳┳━┓
    ┃┏━┫┏┓┃┏┓┫┃┃┏┫┏┓┃┃╋┃┏━┫┏┓┃┏┓┣┫┏┓┓
    ┃┗━┫┗┛┃┃┃┃┗┫┃┃┗┛┃┗┓┃┗━┫┃┃┃┏┓┃┃┃┃┃
    ┗━━┻━━┻┛┗┻━┻┛┗━━┻━┛┗━━┻┛┗┻┛┗┻┻┛┗┛

	 version : 1.0.11
	 base_dir: /app/icon2-node


usage: control_chain [-h] [-s unixsocket] [-d] [-t timeout] [-w wait_state]
                     [-r retry] [-ws] [-ap auto_prepare] [-p payload_file]
                     [-f] [-i] [--seedAddress SEEDADDRESS] [-b BASE_DIR]
                     [-pd payload dict]
                    {start,stop,reset,leave,view_chain,view_system_config,join,backup,backup_list,restore,chain_config,system_config,ls,prune}

Command Line Interface for control_chain

positional arguments:
    {start,stop,reset,leave,view_chain,view_system_config,join,backup,backup_list,restore,chain_config,system_config,ls,prune}

optional arguments:
  -h, --help            show this help message and exit
  -s unixsocket, --unixsocket unixsocket
                        unix domain socket path (default:
                        /app/icon2-node/data/cli.socket)
  -d, --debug           debug mode. (default: False)
  -t timeout, --timeout timeout
                        timeout (default: 60)
  -w wait_state, --wait-state wait_state
                        wait_state (default: True)
  -r retry, --retry retry
                        wait_state (default: True)
  -ws, --wait-socket    wait for unix domain socket
  -ap auto_prepare, --auto_prepare auto_prepare
                        auto_prepare (default: True)
  -p payload_file, --payload payload_file
                        payload file
  -f, --forever         retry forever
  -i, --inspect         inspect for view chain
  --seedAddress SEEDADDRESS
                        seed list string
  -b BASE_DIR, --base-dir BASE_DIR
                        base dir for goloop
  -pd payload dict, --payload-dict payload dict
                        payload dict
  -bh BLOCKHEIGHT, --blockheight BLOCKHEIGHT
    BlockHeight for pruning
  -rn RESTORE_NAME, --restore-name RESTORE_NAME
    Restore filename for restore 
```


## ConnectSock
- ConnectSock class
- request(self, method="GET", url=None, headers={}, payload={}, files={}, return_dict=False) method

## ControlChain
Parent class is ConnectSock class
- ControlChain class
- start() method
- stop() method
- reset() method
- leave() method
- backup() method
- backup_list() method
- restore(name="name") method
- join(seed_list=["127.0.0.1:7100"], role=3) method
- view_chain(detail=False, inspect=False) method
- chain_config(payload={"key": "autoStart", "value": "true"}) method
- view_system_config() method
- system_config(payload={"key": "rpcIncludeDebug", "value": "true"}) method


## DockerSock
Parent class is ConnectSock class
- DockerSock class
