Re-level non-docs content to top of repo and rename content→docs

_code-samples/paths/py/paths.py

@@ -0,0 +1,50 @@
+"""Example of how to find the best path to trade with"""
+from xrpl.clients import JsonRpcClient
+from xrpl.models.amounts import IssuedCurrencyAmount
+from xrpl.models.currencies.xrp import XRP
+from xrpl.models.requests import RipplePathFind
+from xrpl.models.transactions import Payment
+from xrpl.transaction import autofill_and_sign
+from xrpl.wallet import generate_faucet_wallet
+
+# References
+# - https://xrpl.org/paths.html#paths
+# - https://xrpl.org/ripple_path_find.html#ripple_path_find
+
+# Create a client to connect to the test network
+client = JsonRpcClient("https://s.altnet.rippletest.net:51234")
+
+# Creating wallet to send money from
+wallet = generate_faucet_wallet(client, debug=True)
+
+# Create account and amount variables for later transaction
+destination_account = "rKT4JX4cCof6LcDYRz8o3rGRu7qxzZ2Zwj"
+destination_amount = IssuedCurrencyAmount(
+    value="0.001",
+    currency="USD",
+    issuer="rVnYNK9yuxBz4uP8zC8LEFokM2nqH3poc",
+)
+
+# Create a RipplePathFind request and have the client call it
+path_request = RipplePathFind(
+    source_account=wallet.address,
+    source_currencies=[XRP()],
+    destination_account=destination_account,
+    destination_amount=destination_amount,
+)
+path_response = client.request(path_request)
+print(path_response)
+
+# Extract out paths from the RipplePathFind response
+paths = path_response.result["alternatives"][0]["paths_computed"]
+print(paths)
+
+# # Create a Payment to send money from wallet to destination_account using path
+payment_tx = Payment(
+    account=wallet.address,
+    amount=destination_amount,
+    destination=destination_account,
+    paths=paths,
+)
+
+print("signed: ", autofill_and_sign(payment_tx, client, wallet))