#> gradle check

#> git clone https://github.com/stchar/pipeline-sharedlib-testharness.git

.
├── jobs                              # Template pipeline scripts to load the lib
│   │                                 # are used by unit tests
│   └── template
|       |
│       └── template.groovy
├── src
│   └── org
│       └── hcm
│           └── libjenkins
│               └── *.groovy         # Examples of Library class
├── test
│   ├── integration
│   │   └── groovy
│   │       └── *.groovy             # Integration tests
│   └── unit
│       └── groovy
│           └── *.groovy             # JenkinsPipelineUnit tests
└── vars
    └── *.groovy                     # Jenkins pipeline shared library vars objects

// file: jobs/template/gitlab.groovy

@Library('jenkins-commons')
import org.hcm.libjenkins.Gitlab

gitlab_lib = new Gitlab(this)

gl_stages = ['hello']

gitlabBuild(gl_stages) {
  gitlab_stage(gl_stages,'hello','master',10) {
    echo "Hello World!"
  }
}

return this

// file: test/unit/groovy/TestJenkinsCommonLib.groovy

...

class TestJenkinsCommonLib extends BasePipelineTest {

  String sharedLibs = ''

  @Override
  @Before
  void setUp() throws Exception {
      scriptRoots += 'jobs'
      super.setUp()
      def library = library().name('jenkins-commons')
                       .defaultVersion("master")
                       .allowOverride(true)
                       .implicit(true)
                       .targetPath('build/libs')
                       .retriever(localSource('build/libs'))
                       .build()
      helper.registerSharedLibrary(library)
  }

 
}

// file:  test/unit/groovy/TestJenkinsCommonLib.groovy

 ...

  @Test
  void should_execute_without_errors() throws Exception {
    def script = runScript("template/pipeline/template.groovy")
    //printCallStack()
  }

  @Test
  void verify_is_upstream() throws Exception {
    def script = runScript("template/pipeline/template.groovy")
    assertEquals('Verify is_upstream ', false, script.gitlab_lib.is_upstream('feature'))
    assertEquals('Verify is_upstream ', true, script.gitlab_lib.is_upstream('master'))
    assertEquals('Verify is_upstream ', true, script.gitlab_lib.is_upstream('rel-1.2.3'))
    //printCallStack()
  }

// file:  test/integration/groovy/TestReleaseMail.groovy
 
class TestReleaseMail {  
  @Rule
  public JenkinsRule rule = new JenkinsRule() {
    @Override
    public void before() throws Throwable {
      super.before()
      Mailbox.clearAll()
    }

    @Override
    public void after() throws Exception {
      super.after()
      Mailbox.clearAll()
    }
  }
...
}

// file:  test/integration/groovy/TestReleaseMail.groovy
 
class TestReleaseMail {  
  ...
  @Test
  void "verify release mail"() {

    WorkflowJob workflowJob = rule.createProject(WorkflowJob, 'test-release-mail')
    def script = new File('jobs/release/mail/basic.groovy')
    workflowJob.definition = new CpsFlowDefinition(script.text, true)

    WorkflowRun result = rule.buildAndAssertSuccess(workflowJob)
    
    rule.assertLogContains('Sending email to: jhon.doe@example.com', result)

    assertEquals(1, Mailbox.get("jhon.doe@example.com").getNewMessageCount());
    
    Message message = Mailbox.get("jhon.doe@example.com").get(0);
    MimeMultipart part = (MimeMultipart) message.getContent();
    
    assertTrue("Verify message body", 
       part.getBodyPart(0).getInputStream().text.contains("Release Artifacts"))


  }
  ...
}