Apache
/
hbase
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

HBASE-20346 Update how to run shell tests in ref guide

This commit is contained in:
Mike Drob 2018-04-04 14:23:56 -07:00
parent 8adf1bb2b4
commit f27819a9ae
1 changed files with 12 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
src/main/asciidoc/_chapters/developer.adoc
View File

@ -906,13 +906,21 @@ For any other module, for example `hbase-common`, the tests must be strict unit
==== Testing the HBase Shell ==== Testing the HBase Shell
The HBase shell and its tests are predominantly written in jruby. The HBase shell and its tests are predominantly written in jruby.
In order to make these tests run as a part of the standard build, there is a single JUnit test, `TestShell`, that takes care of loading the jruby implemented tests and running them.
In order to make these tests run as a part of the standard build, there are a few JUnit test classes that take care of loading the jruby implemented tests and running them.
The tests were split into separate classes to accomodate class level timeouts (see <<hbase.unittests>> for specifics).
You can run all of these tests from the top level with: You can run all of these tests from the top level with:
[source,bourne] [source,bourne]
----
mvn clean test -Dtest=Test*Shell
---- ----
mvn clean test -Dtest=TestShell If you have previously done a `mvn install`, then you can instruct maven to run only the tests in the hbase-shell module with:
[source,bourne]
----
mvn clean test -pl hbase-shell
---- ----
Alternatively, you may limit the shell tests that run using the system variable `shell.test`. Alternatively, you may limit the shell tests that run using the system variable `shell.test`.
@ -921,8 +929,7 @@ For example, the tests that cover the shell commands for altering tables are con
[source,bourne] [source,bourne]
---- ----
mvn clean test -pl hbase-shell -Dshell.test=/AdminAlterTableTest/
mvn clean test -Dtest=TestShell -Dshell.test=/AdminAlterTableTest/
---- ----
You may also use a link:http://docs.ruby-doc.com/docs/ProgrammingRuby/html/language.html#UJ[Ruby Regular Expression You may also use a link:http://docs.ruby-doc.com/docs/ProgrammingRuby/html/language.html#UJ[Ruby Regular Expression
@ -932,14 +939,13 @@ You can run all of the HBase admin related tests, including both the normal admi
[source,bourne] [source,bourne]
---- ----
mvn clean test -Dtest=TestShell -Dshell.test=/.*Admin.*Test/ mvn clean test -pl hbase-shell -Dshell.test=/.*Admin.*Test/
---- ----
In the event of a test failure, you can see details by examining the XML version of the surefire report results In the event of a test failure, you can see details by examining the XML version of the surefire report results
[source,bourne] [source,bourne]
---- ----
vim hbase-shell/target/surefire-reports/TEST-org.apache.hadoop.hbase.client.TestShell.xml vim hbase-shell/target/surefire-reports/TEST-org.apache.hadoop.hbase.client.TestShell.xml
---- ----