aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/index.rst2
-rw-r--r--docs/using-testeth.rst65
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 <https://github.com/ethereum/cpp-ethereum/blob/develop/doc/generating_tests.rst>`_.
-To run tests you should open folder (see also `Installing and building <http://www.ethdocs.org/en/latest/ethereum-clients/cpp-ethereum/index.html#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 <TEST_SUITE>/<TEST_CASE>``
-
-Or just the test suite:
-
- ``./testeth -t <TEST_SUITE>``
-
-You could also use ``--filltests`` option to rerun test creation from .json files which are located at ``../cpp-ethereum/test/<TEST_FILLER>.json``
-
- ``./testeth -t <TEST_SUITE>/<TEST_CASE> --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 <TEST_SUITE>/<TEST_CASE> --singletest <TEST_NAME>``
-
-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=<TEST_SUITE>/<TEST_CASE> --singletest <TEST_FILE>.json``
-| ``<TEST_NAME> --vmtrace --verbosity 12``
-| or
-| ``./testeth -t <TEST_SUITE>/<TEST_CASE> --singletest <TEST_NAME> --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