You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cassandra.apache.org by mc...@apache.org on 2018/05/16 08:37:01 UTC
[2/2] cassandra-dtest git commit: Remove doxygen and references to it.
Remove doxygen and references to it.
Project: http://git-wip-us.apache.org/repos/asf/cassandra-dtest/repo
Commit: http://git-wip-us.apache.org/repos/asf/cassandra-dtest/commit/0fd9a55b
Tree: http://git-wip-us.apache.org/repos/asf/cassandra-dtest/tree/0fd9a55b
Diff: http://git-wip-us.apache.org/repos/asf/cassandra-dtest/diff/0fd9a55b
Branch: refs/heads/master
Commit: 0fd9a55b964bee4218d5d617895be9fa34a49985
Parents: adb0d4c
Author: Mick Semb Wever <mc...@apache.org>
Authored: Wed May 16 07:44:30 2018 +1000
Committer: Mick Semb Wever <mc...@apache.org>
Committed: Wed May 16 07:44:30 2018 +1000
----------------------------------------------------------------------
CONTRIBUTING.md | 27 +-
doxygen/Doxyfile_python | 2336 --------------------------------------
doxygen/doxypy-0.4.2.tar.gz | Bin 4455 -> 0 bytes
3 files changed, 3 insertions(+), 2360 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cassandra-dtest/blob/0fd9a55b/CONTRIBUTING.md
----------------------------------------------------------------------
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6131160..5c9e72a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -24,9 +24,9 @@ connect to C*.
All version objects being passed from CCM are now LooseVersion objects, instead of strings. Those can still be safely compared to strings, so there is no need to do `version < LooseVersion('3.10')`.
-## Doxygen Docstrings
+## Documentation
-We are now colocating our test plans directly with the source code. We have decided to do so in a manner compatible with Doxygen, to turn the test plans into easily navigated HTML. Please view the following list of tags, as well as an example test. While this full list of tags is available for use, there is no need to use every tag for a given test. The **description** and **since** fields should be included, but most others should only be used when **appropriate**. The test plan will live in a comment block below the test method declaration.
+Please view the following list of tags, as well as an example test. While this full list of tags is available for use, there is no need to use every tag for a given test. The **description** and **jira_ticket** fields should be included, but most others should only be used when **appropriate**. The test plan will live in a comment block below the test method declaration.
Input | Description
@@ -37,7 +37,6 @@ Description | Brief description of the test
@return | Description of expected return value (Usually used for helper methods)
@expected_errors | What exceptions this test is expected to throw on normal behavior (should be caught and expected in the test)
@throws | What exceptions this test would throw upon failure (if expecting a specific regression)
-@since | I am unsure what we will use this for. Do not use until we have reached a decision.
@jira_ticket | Associated JIRA ticket identifier, including the project name (e.g. `CASSANDRA-42`, not `42`).
@expected_result | Brief summary of what the expected results of this test are
@test_assumptions | Test requirements (auth, hints disabled , etc)
@@ -48,32 +47,13 @@ Description | Brief description of the test
```python
def test_example(self):
"""
-Demonstrates the expected syntax for a test plan. Parsed by Doxygen.
+Demonstrates the expected syntax for a test plan.
@jira_ticket CASSANDRA-0000
-@since 2.0.15, 2.1.5
@note Test should not be implemented, it is an example.
"""
pass
```
-To run doxygen to generate HTML from these test plans, you will need to do the following:
-
-* Unzip **doxygen/doxypy-0.4.2.tar.gz** and install it
-```
- cd doxygen/
- tar xvf doxypy-0.4.2.tar.gz
- cd doxypy-0.4.2
- sudo python setup.py install
-```
-* Install **doxygen**, via your system's package manager
-* Edit the **INPUT** and **OUTPUT_DIRECTORY** fields in **doxygen/Doxyfile_python**. They must be absolute paths. **INPUT** should point to **cassandra-dtest/**.
-* Run doxygen
-```
- doxygen doxygen/Doxyfile_python
-```
-
-Feel free to submit test plans without the implemented tests. If you are submitting a new test, we would appreciate if it were annotated in this manner. If that is not possible, we will add the markup to your pull request.
-
## Modules
In some cases, we organize our test files by putting them in directories. If you do so, please export a module from that directory by placing an `__init__.py` file in the directory with the test files. This makes the modules visible to our test infrastructure scripts that divide tests into buckets for CI.
@@ -82,7 +62,6 @@ In some cases, we organize our test files by putting them in directories. If you
- When possible, you should use the assert functions from [`tools/assertions.py`](https://github.com/apache/cassandra-dtest/blob/master/tools/assertions.py).
- When none of these are applicable, use python's built in [unittest assertions](https://docs.python.org/2/library/unittest.html#assert-methods).
-- Naked assert statements should never be used, e.g. `assert True`
## Byteman Files
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cassandra.apache.org
For additional commands, e-mail: commits-help@cassandra.apache.org