BizLogic

Some nanoswap business logic

• Installation
• Documentation
  • Build docs locally
• Tests
  • Before running tests:
    • Regenerate pb2.py files
    • Ipfs setup
    • Run the ipfs daemon
• IPFS troubleshooting

Installation

pip install bizlogic

Documentation

https://bizlogic.readthedocs.io/

Build docs locally

mkdocs serve

Tests

To only run tests: pytest --cov=bizlogic --log-cli-level=debug
To only run lints: flake8 bizlogic --docstring-convention google --ignore=D100,D104 --exclude=loan_pb2.py,vouch_pb2.py,loan_application_pb2.py To run all checks: nox

Before running tests:

Regenerate pb2.py files

protoc --python_out=bizlogic/protoc --proto_path=protobuf protobuf/*.proto

Ipfs setup

https://docs.ipfs.tech/install/

Run the ipfs daemon

ipfs daemon --api /ip4/0.0.0.0/tcp/5001

Check the status of your node at:

• http://localhost:5001/webui
• https://webui.ipfs.io/#/status

IPFS troubleshooting

Set the log level, send the logs to a file, and search the file for relevant messages

export IPFS_LOGGING=<debug|info|error>
ipfs daemon --debug 2>&1 | tee ipfs.log
cat ipfs.log | grep test_directory

If you find something important, you can show the first few lines around that message

grep -C 10 '2023-04-13T17:31:49.712-0400' ipfs.log

Here is an example of an error message in these logs:

2023-04-13T17:31:49.712-0400	DEBUG	cmds/http	http/handler.go:90	incoming API request: /files/mkdir?arg=test_directory
2023-04-13T17:31:49.712-0400	DEBUG	cmds	go-ipfs-cmds@v0.8.2/command.go:161	error occured in call, closing with error: paths must start with a leading slash