Package com.arc_e_tect.gradle.apionly.transcriberj.core

Class GenerationReport

java.lang.Object
com.arc_e_tect.gradle.apionly.transcriberj.core.GenerationReport
public final class GenerationReport extends Object
What a generation run could not do in full, and what the specification could do about it: the end-of-run report D14 asks for.

  • Constructor Details

    • GenerationReport

      public GenerationReport()
      Creates an empty report.

  • Method Details

    • noValidValue

      public List<GenerationReport.NoValidValue> noValidValue()
      Every generated method that throws because no valid value could be generated for it.
      Returns:
      the entries, in the order they were written

    • unsupportedParameters

      public List<GenerationReport.UnsupportedParameter> unsupportedParameters()
      Every parameter no valid value is generated for yet.
      Returns:
      the entries, in contract order

    • degraded

      public List<GenerationReport.Degraded> degraded()
      Every degraded method.
      Returns:
      the entries, in the order they were written

    • recommendations

      public List<GenerationReport.Recommendation> recommendations()
      Every recommendation.
      Returns:
      the entries, in the order they were made

    • undecided

      public List<Finding> undecided()
      Every construct no generation rule has been decided for.
      Returns:
      the findings, in contract order

    • warnings

      public List<String> warnings()
      Everything about the contract's design worth a second look.
      Returns:
      the warnings, in the order they were found

    • note

      public void note(String note)
      Records something worth saying about this generation that is not a problem.
      Parameters:
      note - the note

    • notes

      public List<String> notes()
      What this generation had to say about itself.
      Returns:
      the notes, in the order they were made

    • render

      public String render(String contract, String version)
      The report as text, for a file and a build log.
      Parameters:
      contract - the contract's name
      version - the contract's version
      Returns:
      the text

    • renderValidValues

      public String renderValidValues(String contract, String version)
      Every generated valid value, by class and location, as JSON: members sorted by name, no insignificant whitespace, and a final newline, so the same contract gives the same bytes.
      Parameters:
      contract - the contract's name
      version - the contract's version
      Returns:
      the JSON text