Uploaded image for project: 'Bigtop'
  1. Bigtop
  2. BIGTOP-685

provide a way to specify the parameters expected by a test

    Details

    • Type: New Feature
    • Status: Closed
    • Priority: Blocker
    • Resolution: Fixed
    • Affects Version/s: 0.4.0
    • Fix Version/s: 0.5.0
    • Component/s: tests
    • Labels:
      None

      Description

      Many tests take parameters. Parameters may be passed into a test via system properties or environment variables. These parameters can be regarded as part of the test's contract. Over time, with increasing number of tests, it becomes hard to keep track of the set of parameters that may be used by the tests.
      I propose to address this issue at two levels:
      1. Introduce an annotation type for annotating a test class with the list of system properties and environment variables used by it. This allows for the contract to be exposed in the javadoc, as well as to annotation processing tools.
      2. Provide utility functions for automatically obtaining the parameters and their values from the above annotation.

      Not addressed in this proposal: Injecting 2. into the test runner itself (currently we are running tests through JUnit).

        Attachments

        1. TestDummy2.groovy
          2 kB
          Wing Yew Poon
        2. TestDummy1b.java
          2 kB
          Wing Yew Poon
        3. TestDummy1a.java
          2 kB
          Wing Yew Poon
        4. contract.txt
          10 kB
          Wing Yew Poon
        5. BIGTOP-685-2.txt
          13 kB
          Wing Yew Poon

          Issue Links

            Activity

              People

              • Assignee:
                wypoon Wing Yew Poon
                Reporter:
                wypoon Wing Yew Poon
              • Votes:
                0 Vote for this issue
                Watchers:
                4 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: