Page MenuHomePhabricator
Differential D4012 Diff 11123 doc/functional-tests.md

Changeset View

Standalone View

View Options

doc/functional-tests.md

Show First 20 Lines • Show All 256 Lines • ▼ Show 20 Lines
#### Using the P2P interface #### Using the P2P interface
- `messages.py` contains all the definitions for objects that pass - `messages.py` contains all the definitions for objects that pass
over the network (`CBlock`, `CTransaction`, etc, along with the network-level over the network (`CBlock`, `CTransaction`, etc, along with the network-level
wrappers for them, `msg_block`, `msg_tx`, etc). wrappers for them, `msg_block`, `msg_tx`, etc).
- P2P tests have two threads. One thread handles all network communication - P2P tests have two threads. One thread handles all network communication
with the bitcoind(s) being tested (using python's asyncore package); the other with the bitcoind(s) being tested in a callback-based event loop; the other
implements the test logic. implements the test logic.
- `P2PConnection` is the class used to connect to a bitcoind. `P2PInterface` - `P2PConnection` is the class used to connect to a bitcoind. `P2PInterface`
contains the higher level logic for processing P2P payloads and connecting to contains the higher level logic for processing P2P payloads and connecting to
the Bitcoin Core node application logic. For custom behaviour, subclass the the Bitcoin Core node application logic. For custom behaviour, subclass the
P2PInterface object and override the callback methods. P2PInterface object and override the callback methods.
- Call `network_thread_start()` after all `P2PInterface` objects are created to
start the networking thread. (Continue with the test logic in your existing
thread.)
- Can be used to write tests where specific P2P protocol behavior is tested. - Can be used to write tests where specific P2P protocol behavior is tested.
Examples tests are `p2p_unrequested_blocks.py`, `p2p_compactblocks.py`. Examples tests are `p2p_unrequested_blocks.py`, `p2p_compactblocks.py`.
### test-framework modules ### test-framework modules
#### [test_framework/authproxy.py](test_framework/authproxy.py) #### [test_framework/authproxy.py](test_framework/authproxy.py)
Taken from the [python-bitcoinrpc repository](https://github.com/jgarzik/python-bitcoinrpc). Taken from the [python-bitcoinrpc repository](https://github.com/jgarzik/python-bitcoinrpc).
Show All 26 Lines