Closing the Gap between Unit Test Code and Documentation

Karsten Stocker; Hironori Washizaki; Yoshiaki Fukazawa

doi:10.1109/ICSTW.2017.56

Closing the Gap between Unit Test Code and Documentation

Karsten Stocker, Hironori Washizaki, Yoshiaki Fukazawa

Research output: Chapter in Book/Report/Conference proceeding › Conference contribution

3 Citations (Scopus)

Abstract

Test Driven Development as well as the documentation of tests and their architecture are today an important pillar of software quality assurance. The change of requirements during the implementation phase entails a need to change tests as well as the test documentation of the software. Since unit tests are specified in the implementation language, an interdisciplinary readable documentation must be maintained, which is structurally easier to comprehend and also make the test transparent for persons who are not involved into code writing. This leads to additional effort, costs and possibly inconsistencies between the test and its documentation. This gap in the workflow could be closed by Tanni - a domain specific language, which allows the specification of test cases in the form of interdisciplinary readable tables without requiring programming skills. Based on them executable test code for the respective unit test framework is generated. This merges specification and documentation of unit test cases to one step of work. By this the mentioned additional effort, costs and imminent inconsistencies can be reduced. The Language Workbench Meta Programming System from JetBrains serves as a technological base and is enabler for further positive effects which possibly could be gained by using the described language.

Original language	English
Title of host publication	Proceedings - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017
Publisher	Institute of Electrical and Electronics Engineers Inc.
Pages	304-308
Number of pages	5
ISBN (Electronic)	9781509066766
DOIs	https://doi.org/10.1109/ICSTW.2017.56
Publication status	Published - 2017 Apr 13
Event	10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017 - Tokyo, Japan Duration: 2017 Mar 13 → 2017 Mar 17

Other

Other	10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017
Country/Territory	Japan
City	Tokyo
Period	17/3/13 → 17/3/17

Keywords

Documentation
Domain-specific Language
Java
Meta Programming System
Test Case Specification
Test Code Generation
Unit Test

ASJC Scopus subject areas

Software
Safety, Risk, Reliability and Quality

Access to Document

10.1109/ICSTW.2017.56

Cite this

Closing the Gap between Unit Test Code and Documentation. / Stocker, Karsten; Washizaki, Hironori ; Fukazawa, Yoshiaki.

Proceedings - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017. Institute of Electrical and Electronics Engineers Inc., 2017. p. 304-308 7899073.

Research output: Chapter in Book/Report/Conference proceeding › Conference contribution

Stocker, K, Washizaki, H & Fukazawa, Y 2017, Closing the Gap between Unit Test Code and Documentation. in Proceedings - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017., 7899073, Institute of Electrical and Electronics Engineers Inc., pp. 304-308, 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017, Tokyo, Japan, 17/3/13. https://doi.org/10.1109/ICSTW.2017.56

@inproceedings{5988951308a546bb84d136ddfaf2f2b5,

title = "Closing the Gap between Unit Test Code and Documentation",

abstract = "Test Driven Development as well as the documentation of tests and their architecture are today an important pillar of software quality assurance. The change of requirements during the implementation phase entails a need to change tests as well as the test documentation of the software. Since unit tests are specified in the implementation language, an interdisciplinary readable documentation must be maintained, which is structurally easier to comprehend and also make the test transparent for persons who are not involved into code writing. This leads to additional effort, costs and possibly inconsistencies between the test and its documentation. This gap in the workflow could be closed by Tanni - a domain specific language, which allows the specification of test cases in the form of interdisciplinary readable tables without requiring programming skills. Based on them executable test code for the respective unit test framework is generated. This merges specification and documentation of unit test cases to one step of work. By this the mentioned additional effort, costs and imminent inconsistencies can be reduced. The Language Workbench Meta Programming System from JetBrains serves as a technological base and is enabler for further positive effects which possibly could be gained by using the described language.",

keywords = "Documentation, Domain-specific Language, Java, Meta Programming System, Test Case Specification, Test Code Generation, Unit Test",

author = "Karsten Stocker and Hironori Washizaki and Yoshiaki Fukazawa",

year = "2017",

month = apr,

day = "13",

doi = "10.1109/ICSTW.2017.56",

language = "English",

pages = "304--308",

booktitle = "Proceedings - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017",

publisher = "Institute of Electrical and Electronics Engineers Inc.",

address = "United States",

note = "10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017 ; Conference date: 13-03-2017 Through 17-03-2017",

}

TY - GEN

T1 - Closing the Gap between Unit Test Code and Documentation

AU - Stocker, Karsten

AU - Washizaki, Hironori

AU - Fukazawa, Yoshiaki

PY - 2017/4/13

Y1 - 2017/4/13

N2 - Test Driven Development as well as the documentation of tests and their architecture are today an important pillar of software quality assurance. The change of requirements during the implementation phase entails a need to change tests as well as the test documentation of the software. Since unit tests are specified in the implementation language, an interdisciplinary readable documentation must be maintained, which is structurally easier to comprehend and also make the test transparent for persons who are not involved into code writing. This leads to additional effort, costs and possibly inconsistencies between the test and its documentation. This gap in the workflow could be closed by Tanni - a domain specific language, which allows the specification of test cases in the form of interdisciplinary readable tables without requiring programming skills. Based on them executable test code for the respective unit test framework is generated. This merges specification and documentation of unit test cases to one step of work. By this the mentioned additional effort, costs and imminent inconsistencies can be reduced. The Language Workbench Meta Programming System from JetBrains serves as a technological base and is enabler for further positive effects which possibly could be gained by using the described language.

AB - Test Driven Development as well as the documentation of tests and their architecture are today an important pillar of software quality assurance. The change of requirements during the implementation phase entails a need to change tests as well as the test documentation of the software. Since unit tests are specified in the implementation language, an interdisciplinary readable documentation must be maintained, which is structurally easier to comprehend and also make the test transparent for persons who are not involved into code writing. This leads to additional effort, costs and possibly inconsistencies between the test and its documentation. This gap in the workflow could be closed by Tanni - a domain specific language, which allows the specification of test cases in the form of interdisciplinary readable tables without requiring programming skills. Based on them executable test code for the respective unit test framework is generated. This merges specification and documentation of unit test cases to one step of work. By this the mentioned additional effort, costs and imminent inconsistencies can be reduced. The Language Workbench Meta Programming System from JetBrains serves as a technological base and is enabler for further positive effects which possibly could be gained by using the described language.

KW - Documentation

KW - Domain-specific Language

KW - Java

KW - Meta Programming System

KW - Test Case Specification

KW - Test Code Generation

KW - Unit Test

UR - http://www.scopus.com/inward/record.url?scp=85018400924&partnerID=8YFLogxK

UR - http://www.scopus.com/inward/citedby.url?scp=85018400924&partnerID=8YFLogxK

U2 - 10.1109/ICSTW.2017.56

DO - 10.1109/ICSTW.2017.56

M3 - Conference contribution

AN - SCOPUS:85018400924

SP - 304

EP - 308

BT - Proceedings - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017

PB - Institute of Electrical and Electronics Engineers Inc.

T2 - 10th IEEE International Conference on Software Testing, Verification and Validation Workshops, ICSTW 2017

Y2 - 13 March 2017 through 17 March 2017

ER -

Closing the Gap between Unit Test Code and Documentation

Abstract

Other

Keywords

ASJC Scopus subject areas

Access to Document

Other files and links

Fingerprint

Cite this