k8s.io/kubernetes@v1.29.3/test/conformance/doc.go (about)

     1  /*
     2  Copyright 2019 The Kubernetes Authors.
     3  
     4  Licensed under the Apache License, Version 2.0 (the "License");
     5  you may not use this file except in compliance with the License.
     6  You may obtain a copy of the License at
     7  
     8      http://www.apache.org/licenses/LICENSE-2.0
     9  
    10  Unless required by applicable law or agreed to in writing, software
    11  distributed under the License is distributed on an "AS IS" BASIS,
    12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  See the License for the specific language governing permissions and
    14  limitations under the License.
    15  */
    16  
    17  /*
    18  This stand-alone package is utilized for dynamically generating/maintaining a list of
    19  conformance tests. It utilizes a two step approach:
    20    - The test binary is built
    21    - The test binary is run in dry mode with a custom ginkgo reporter dumping out
    22      types.SpecSummary objects which contain full test names and file/code information.
    23    - The SpecSummary information is parsed to get file/line info on Conformance tests and
    24      then we use a simplified AST parser to grab the comments above the test.
    25  
    26  Due to the complicated nature of how tests can be declared/wrapped in various contexts,
    27  this approach is much simpler to maintain than a pure-AST parser and allows us to easily
    28  capture the full test names/locations of the tests using the pre-existing ginkgo logic.
    29  */
    30  package main