TY - GEN

T1 - Generating a Formalized REST API Definition Language for a Dynamic Framework Without Annotations Using Static Analysis Tools

AU - Usova, Daria S.

N1 - Many thanks to the Ktor team for the help with this work. Opportunity to research this task has been given by Leonid Stashevsky, the team lead in Ktor. Also, this work would not be possible without Vadim Brilyantov assistance, who has been sharing knowledge about IntelliJ platform and Ktor plugin. Also many thanks for the help to Bistrov Alexander, my supervisor at Novosibirsk State University. Публикация для корректировки.

PY - 2023

Y1 - 2023

N2 - Documentation plays an important role in the process of software development. It is a document that refers to the information necessary for the software development, maintenance and support. Application program interface or API documentation intended for developers who want to use documented software in their product. It gives a formal description of the program input and output. It is most popular for server-client applications. For the successful execution of the request, the client needs to know the server's API, which often changes. It is difficult for server developers to write documentation for each change, moreover the client is not required to investigate the server source code, besides that it is not always available. Such a situation illustrates that automatic API documentation generation is necessary. Two popular approaches of automatic documentation generation are static and dynamic code analysis. First method analyzes some code representation, for example syntax tree, without actually executing it. The main flaw of such an approach is that they usually use only information from classes, method signatures and annotations. It is not acceptable for libraries which place important information in the method's body. By contrast, dynamic methods require running an application for analysis to make some test requests. The complexity of test generation which will cover all possible code behavior is a fundamental problem for this approach. In this paper, we introduce an approach of automatic API documentation generation based on a syntax tree analysis of server code written on framework KTOR.

AB - Documentation plays an important role in the process of software development. It is a document that refers to the information necessary for the software development, maintenance and support. Application program interface or API documentation intended for developers who want to use documented software in their product. It gives a formal description of the program input and output. It is most popular for server-client applications. For the successful execution of the request, the client needs to know the server's API, which often changes. It is difficult for server developers to write documentation for each change, moreover the client is not required to investigate the server source code, besides that it is not always available. Such a situation illustrates that automatic API documentation generation is necessary. Two popular approaches of automatic documentation generation are static and dynamic code analysis. First method analyzes some code representation, for example syntax tree, without actually executing it. The main flaw of such an approach is that they usually use only information from classes, method signatures and annotations. It is not acceptable for libraries which place important information in the method's body. By contrast, dynamic methods require running an application for analysis to make some test requests. The complexity of test generation which will cover all possible code behavior is a fundamental problem for this approach. In this paper, we introduce an approach of automatic API documentation generation based on a syntax tree analysis of server code written on framework KTOR.

UR - https://www.scopus.com/record/display.uri?eid=2-s2.0-85172008631&origin=inward&txGid=d214c4b0ee54acb7599322720cdeebee

UR - https://www.mendeley.com/catalogue/921f460a-acf0-3317-80a4-45021c5b89b4/

U2 - 10.1109/edm58354.2023.10225100

DO - 10.1109/edm58354.2023.10225100

M3 - Conference contribution

SN - 9798350336870

SP - 1710

EP - 1714

BT - 24th IEEE International Conference of Young Professionals in Electron Devices and Materials, EDM 2023; Novosibirsk; Russian Federation; 29 June 2023 до 3 July 2023

PB - Institute of Electrical and Electronics Engineers (IEEE)

ER -