Reorganize the python-examples module

- Use requirements.txt to install dependencies to local venv.
- Use setup.py to build/install example packages to local venv.
- Adjust reference-doc-builder to new Python pkg imports.

.gitignore

@@ -33,10 +33,12 @@ java-examples/src/main/proto/*
 proto-downloader/*.iml
 proto-downloader/*.proto
 python-examples/*.iml
-python-examples/bisq/api/__pycache__/
+python-examples/myvenv
-python-examples/bisq/api/*.py
+python-examples/python_examples/__pycache__
-python-examples/bots/__pycache__
+python-examples/python_examples/bisqapi/__pycache__
-python-examples/bots/events/__pycache__
+python-examples/python_examples/bisqapi/*.py
+python-examples/python_examples/bots/__pycache__
+python-examples/python_examples/bots/bisq_events/__pycache__
 python-examples/proto/*
 reference-doc-builder/*.iml
 reference-doc-builder/build

python-examples/README.md

@@ -0,0 +1,4 @@
+# Bisq API Python Examples
+
+The `run-setup.sh` script in this directory can be used to install Python dependencies and build the examples packages.
+

python-examples/generate-python-protos.sh

@@ -14,7 +14,7 @@
 export PROTO_PATH="proto"
 
 # The destination directory for the generated Python code (he protoc compiler output).
-export PYTHON_PROTO_OUT_PATH="bisq/api"
+export PYTHON_PROTO_OUT_PATH="python_examples/bisqapi"
 
 python3 -m grpc_tools.protoc \
   --proto_path=$PROTO_PATH \
@@ -24,5 +24,5 @@ protoc --proto_path=$PROTO_PATH --python_out=$PYTHON_PROTO_OUT_PATH $PROTO_PATH/
 
 # Hack the internal import statements in the generated python to prepend the `bisq.api` package name.
 # See why Google will not fix this:  https://github.com/protocolbuffers/protobuf/issues/1491
-sed -i 's/import pb_pb2 as pb__pb2/import bisq.api.pb_pb2 as pb__pb2/g' $PYTHON_PROTO_OUT_PATH/grpc_pb2.py
+sed -i 's/import pb_pb2 as pb__pb2/import python_examples.bisqapi.pb_pb2 as pb__pb2/g' $PYTHON_PROTO_OUT_PATH/grpc_pb2.py
-sed -i 's/import grpc_pb2 as grpc__pb2/import bisq.api.grpc_pb2 as grpc__pb2/g' $PYTHON_PROTO_OUT_PATH/grpc_pb2_grpc.py
+sed -i 's/import grpc_pb2 as grpc__pb2/import python_examples.bisqapi.grpc_pb2 as grpc__pb2/g' $PYTHON_PROTO_OUT_PATH/grpc_pb2_grpc.py

python-examples/python_examples/bisqapi/README.md

@@ -1,2 +1,3 @@
 The api directory contains the Bisq gRPC API's generated Python files used by the examples.
 
+The protoc generated files in this directory are not versioned in this project.

python-examples/python_examples/bots/best_priced_offer_bot.ini

@@ -7,7 +7,7 @@ direction = SELL
 
 [offers]
 # List of comma separated offer ids to be synced.
-offer_ids = piape-ef84138d-8204-4b6e-995c-49d3dd1ef37a-184
+offer_ids = dlyunuk-d5e15df0-9a35-4409-bdce-c760b42162ae-184
 
 [safeguards]
 # This should prevent the synchronization with offers that are out of bounds.

python-examples/python_examples/bots/bisq_client.py

@@ -5,8 +5,8 @@ from decimal import *
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 from logger import log
 
 # For more channel options, please see https://grpc.io/grpc/core/group__grpc__arg__keys.html

python-examples/python_examples/bots/bisq_events/trade_event.py

@@ -1,5 +1,5 @@
 # From https://expobrain.net/2010/07/31/simple-event-dispatcher-in-python
-from event import Event
+from python_examples.bots.bisq_events.event import Event
 
 
 class TradeEvent(Event):

python-examples/python_examples/bots/bisq_events/trade_event_listener.py

@@ -1,5 +1,6 @@
 # From https://expobrain.net/2010/07/31/simple-event-dispatcher-in-python
-from bots.logger import log
+from python_examples.bots.logger import log
+
 from trade_event import TradeEvent
 
 

python-examples/python_examples/bots/path_config.py

@@ -2,4 +2,4 @@ import os
 import sys
 
 DIR_PATH = os.path.dirname(os.path.abspath(__file__))
-sys.path.append(os.path.join(DIR_PATH, 'events'))
+sys.path.append(os.path.join(DIR_PATH, 'bisq_events'))

python-examples/python_examples/bots/protocol_step.py

@@ -1,6 +1,6 @@
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
 from logger import log
 
 WAIT_FOR_TRADE_DEPOSIT_CONFIRMATION = 'WAIT_FOR_TRADE_DEPOSIT_CONFIRMATION'

python-examples/python_examples/bots/run-main.py

@@ -1,6 +1,4 @@
-import best_priced_offer_bot
 import bisqswap_mm_bot
 
 # best_priced_offer_bot.main('localhost', 9998, 'xyz')
-
 bisqswap_mm_bot.main('localhost', 9998, 'xyz')

python-examples/python_examples/bots/sepa_mm_bot.py

@@ -3,9 +3,9 @@ import threading
 import time
 
 from bisq_client import BisqClient
-from events.trade_event import TradeEvent
-from events.trade_event_data import TradeEventData
 from protocol_step import *
+from python_examples.bots.bisq_events.trade_event import TradeEvent
+from python_examples.bots.bisq_events.trade_event_data import TradeEventData
 
 
 # noinspection PyInitNewSignature

python-examples/python_examples/bots/sepa_mm_bot_ui.py

@@ -4,17 +4,16 @@ from decimal import *
 from pathlib import Path
 from tkinter import *
 
-import path_config
 import sepa_mm_bot
-from events.event_dispatcher import EventDispatcher
-from events.trade_event import TradeEvent
 from logger import log
+from python_examples.bots.bisq_events.event_dispatcher import EventDispatcher
+from python_examples.bots.bisq_events.trade_event import TradeEvent
 
 config = configparser.ConfigParser()
 config.read('sepa_mm_bot.ini')
 
 OUTPUT_PATH = Path(__file__).parent
-ASSETS_PATH = OUTPUT_PATH / Path('./assets')
+ASSETS_PATH = OUTPUT_PATH / Path('assets')
 WINDOW_WIDTH = 970
 WINDOW_HEIGHT = 575
 

python-examples/python_examples/rpccalls/cancel_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/close_trade.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/confirm_payment_received.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/confirm_payment_started.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/create_bsq_swap_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/create_crypto_currency_payment_account.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/create_offer.py

@@ -4,8 +4,8 @@ from builtins import print
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/create_payment_account.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/edit_offer.py

@@ -4,8 +4,8 @@ from builtins import print
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 EDITED_USD_OFFER_ID = '44736-16df6819-d98b-4f13-87dd-50087c464fac-184'
 

python-examples/python_examples/rpccalls/fail_trade.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_address_balance.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_balances.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_bsq_swap_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_bsq_swap_offers.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_crypto_currency_payment_methods.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_funding_addresses.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_market_price.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_my_bsq_swap_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_my_bsq_swap_offers.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_my_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_my_offers.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_offer_category.py

@@ -3,8 +3,8 @@ from builtins import print
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_offers.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_payment_account_form.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_payment_accounts.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_payment_methods.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_trade.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_trades.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_transaction.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_tx_fee_rate.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_unused_bsq_address.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/get_version.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/lock_wallet.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/remove_wallet_password.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/send_bsq.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/send_btc.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/set_tx_fee_rate_preference.py

@@ -3,8 +3,8 @@ from builtins import print
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/set_wallet_password.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/stop.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/take_offer.py

@@ -3,8 +3,8 @@ from builtins import print
 
 import grpc
 
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/unfail_trade.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/unlock_wallet.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/unset_tx_fee_rate_preference.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/verify_bsq_sent_to_address.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/python_examples/rpccalls/withdraw_funds.py

@@ -3,8 +3,8 @@ from builtins import print
 import grpc
 
 # from getpass import getpass
-import bisq.api.grpc_pb2 as bisq_messages
+import python_examples.bisqapi.grpc_pb2 as bisq_messages
-import bisq.api.grpc_pb2_grpc as bisq_service
+import python_examples.bisqapi.grpc_pb2_grpc as bisq_service
 
 
 def main():

python-examples/requirements.txt

@@ -0,0 +1,3 @@
+grpcio==1.44.0
+grpcio-tools==1.44.0
+mypy-protobuf==3.2.0

python-examples/run-setup.sh

@@ -0,0 +1,20 @@
+#! /bin/bash
+
+# This script must be run from this directory.
+
+# Install python3-venv if necessary.
+# sudo apt install python3-venv
+
+# Install Python setuptools if necessary.
+# pip install setuptools
+
+# Set up Python environment in python-examples directory.
+rm -rf myvenv
+python -m venv myvenv
+source ./myvenv/bin/activate
+
+# Install Python example dependencies.
+pip install -r requirements.txt
+
+# Install API example packages in myvenv.
+pip install .

python-examples/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='python-examples',
+    version='0.0.1',
+    description='Bisq Python Examples',
+    url='https://bisq-network.github.io/slate/#python-examples',
+    license='GNU AFFERO GENERAL PUBLIC LICENSE Version 3',
+    setup_requires=['wheel'],
+    # packages=find_packages(include=['rpccalls', 'bots', 'bots.*']),
+    packages=find_packages(),
+    # package_data={'bots': ['bots/assets/*.png']},
+    install_requires=['grpcio', 'grpcio-tools', 'mypy-protobuf', 'python-examples'],
+    classifiers=[
+        'Operating System :: POSIX :: Linux :: MacOS',
+        'Programming Language :: Python :: 3.8.10',
+    ],
+)

reference-doc-builder/src/main/java/bisq/apidoc/markdown/CodeExamples.java

@@ -39,7 +39,7 @@ public class CodeExamples {
     // TODO  Is hard-coding paths to example source files OK?
     private static final String CLI_EXAMPLES_DIR = "cli-examples";
     private static final String JAVA_EXAMPLES_DIR = "java-examples/src/main/java/rpccalls";
-    private static final String PYTHON_EXAMPLES_DIR = "python-examples/rpccalls";
+    private static final String PYTHON_EXAMPLES_DIR = "python-examples/python_examples/rpccalls";
 
     private static final String START_SHELL_MD = "```shell";
     private static final String START_JAVA_MD = "```java";