From bacc4ad8f52738979f602ba98648794b178036d0 Mon Sep 17 00:00:00 2001 From: holgerd77 Date: Wed, 6 Sep 2017 15:24:42 +0200 Subject: Remove outdated testeth information and link to C++ docs --- docs/index.rst | 2 +- docs/using-testeth.rst | 65 ++++---------------------------------------------- 2 files changed, 5 insertions(+), 62 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index 323902751..0cf2d2297 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -14,13 +14,13 @@ Ethereum Tests :maxdepth: 2 :caption: Contents: - using-testeth.rst test_types/blockchain_tests.rst test_types/state_tests.rst test_types/rlp_tests.rst test_types/difficulty_tests.rst test_types/transaction_tests.rst test_types/vm_tests.rst + using-testeth.rst contribute.rst diff --git a/docs/using-testeth.rst b/docs/using-testeth.rst index 390225d7f..b725b8746 100644 --- a/docs/using-testeth.rst +++ b/docs/using-testeth.rst @@ -1,68 +1,11 @@ -Using Testeth +Test Creation ============= -Ethereum cpp-client testeth tool for creation and execution of ethereum tests. +Instructions on how to create tests and how to use the cpp-client ``testeth`` tool +can be found in the c++ documentation +`test generation chapter `_. -To run tests you should open folder (see also `Installing and building `_ -in ``cpp-ethereum`` docs) - ``/build/libethereum/test`` -and execute a command ``./testeth`` This will run all test cases automatically. -To run a specific test case you could use parameter ``-t`` in the command line option: - ``./testeth -t /`` - -Or just the test suite: - - ``./testeth -t `` - -You could also use ``--filltests`` option to rerun test creation from .json files which are located at ``../cpp-ethereum/test/.json`` - - ``./testeth -t / --filltests`` - -By default using ``--filltests`` option ``testeth`` recreate tests to the ``ETHEREUM_TEST_PATH`` folder. You might want to set this variable globally on your system like: - -| ``nano /etc/environment`` -| ``ETHEREUM_TEST_PATH="/home/user/ethereum/tests"`` -| - -Filler files are test templates which are used to fill initial parameters defined at test specification :ref:`ethereum_tests` and then create a complete test ``.json`` file. You might find filler files very useful when creating your own tests. - -The ``--checkstate`` option adds a BOOST error if the post state of filled test differs from its ``expected`` section. - -To specify a concrete test in a TEST_CASE file for filling/running procedure use ``--singletest`` option: - - ``./testeth -t / --singletest `` - -If you want to debug (note: testeth should be build with VMTRACE=1) a single test within a result test ``.json`` file, you might use the following command: - -| ``./testeth --log_level=test_suite --run_test=/ --singletest .json`` -| `` --vmtrace --verbosity 12`` -| or -| ``./testeth -t / --singletest --vmtrace --verbosity 12`` -| - -Some tests may use excessive resources when running, so by default they are disabled. Such tests require specific flag to be set in order to be executed. Like ``--performance``, ``--inputLimits``, ``--memory``, ``--quadratic``. You may also enable all of the tests by setting ``--all`` flag. Be careful. Enabled memory tests may stress your system to use 4GB of RAM and more. - -That's it for test execution. To read more about command line options you may run ``testeth`` with ``--help`` option. - -Now let's see what test cases are available. - -Test Cases ----------- - -Almost each test case has its filler file available at ``/webthree-umbrella/libethereum/test`` - -TEST_SUITE = BlockTests -TEST_CASES = blValidBlockTest blInvalidTransactionRLP blTransactionTest blInvalidHeaderTest userDefinedFile - -TEST_SUITE = TransactionTests -TEST_CASES = ttTransactionTest ttWrongRLPTransaction tt10mbDataField userDefinedFile - -TEST_SUITE = StateTests -TEST_CASES = stExample stSystemOperationsTest stPreCompiledContracts stLogTests stRecursiveCreate stTransactionTest stInitCodeTest stSpecialTest stRefundTest stBlockHashTest stQuadraticComplexityTest stSolidityTest stMemoryTest stCreateTest userDefinedFileState - -TEST_SUITE = VMTests -TEST_CASES = vm_tests vmArithmeticTest vmBitwiseLogicOperationTest vmSha3Test vmEnvironmentalInfoTest vmBlockInfoTest vmIOandFlowOperationsTest vmPushDupSwapTest vmLogTest vmSystemOperationsTest vmPerformanceTest vmInputLimitsTest1 vmInputLimitsTest2 vmRandom userDefinedFile -- cgit