• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号
登陆 注册

takari/takari-plugin-testing-project: Maven Plugin Testing Framework

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称（OpenSource Name）：

takari/takari-plugin-testing-project

开源软件地址(OpenSource Url)：

https://github.com/takari/takari-plugin-testing-project

开源编程语言(OpenSource Language)：

Java 100.0%

开源软件介绍(OpenSource Introduction)：

Takari Maven Plugin Testing Framework

Small, cohesive, one-stop library for developing unit and integration tests for Maven plugins. Provides alternative to, and arguably supersedes, maven-plugin-testing-harness and maven-verifier.

Features and benefits

  • Convenient junit4-based API
  • Convenient junit5-based API
  • Flexible unit test mojo configuration API simplifies test project setup and maintenance
  • Collocate main and test code in the same build module
  • No need to install or deploy plugins to run tests
  • Run plugins integration tests against multiple Maven versions
  • Integration with takari-lifecycle and incrementalbuild library
  • Fully supported by Maven Development Tools m2e extension
  • [2.1.0+] full support for all maven versions 3.0 to 3.6.2
  • [3.0.0+] full support for all maven versions 3.6.3+, requires Java11+

Unit testing

pom.xml

<packaging>takari-maven-plugin</packaging>

<dependency>
  <groupId>io.takari.maven.plugins</groupId>
  <artifactId>takari-plugin-testing</artifactId>
  <version>2.8.0</version>
  <scope>test</scope>
</dependency>

<!-- required if not already present in main dependencies -->
<dependency>
  <groupId>org.apache.maven</groupId>
  <artifactId>maven-core</artifactId>
  <version>${mavenVersion}</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>org.apache.maven</groupId>
  <artifactId>maven-compat</artifactId>
  <version>${mavenVersion}</version>
  <scope>test</scope>
</dependency>

JUnit 4 test code

public class PluginUnitTest {
  @Rule
  public final TestResources resources = new TestResources();

  @Rule
  public final TestMavenRuntime maven = new TestMavenRuntime();

  @Test
  public void test() throws Exception {
    File basedir = resources.getBasedir("testproject");
    maven.executeMojo(basedir, "mymojo", newParameter("name", "value");
    assertFilesPresent(basedir, "target/output.txt");
  }
}

JUnit 5 test code

class PluginUnitTest {
  @RegisterExtension
  final TestResources5 resources = new TestResources5();

  @RegisterExtension
  final TestMavenRuntime5 maven = new TestMavenRuntime5();

  @Test
  void test() throws Exception {
    File basedir = resources.getBasedir("testproject");
    maven.executeMojo(basedir, "mymojo", newParameter("name", "value");
    assertFilesPresent(basedir, "target/output.txt");
  }
}

Integration testing

pom.xml

<packaging>takari-maven-plugin</packaging>
    
<dependency>
  <groupId>io.takari.maven.plugins</groupId>
  <artifactId>takari-plugin-testing</artifactId>
  <version>3.0.0</version>
  <scope>test</scope>
</dependency>
<dependency>
  <groupId>io.takari.maven.plugins</groupId>
  <artifactId>takari-plugin-integration-testing</artifactId>
  <version>3.0.0</version>
  <type>pom</type>
  <scope>test</scope>
</dependency>

JUnit 4 test

@RunWith(MavenJUnitTestRunner.class)
@MavenVersions({"3.2.3", "3.2.5"})
public class PluginIntegrationTest {
  @Rule
  public final TestResources resources = new TestResources();

  public final MavenRuntime maven;

  public PluginIntegrationTest(MavenRuntimeBuilder mavenBuilder) {
    this.maven = mavenBuilder.withCliOptions("-B", "-U").build();
  }

  @Test
  public void test() throws Exception {
    File basedir = resources.getBasedir("basic");
    maven.forProject(basedir)
      .withCliOption("-Dproperty=value")
      .withCliOption("-X")
      .execute("deploy")
      .assertErrorFreeLog()
      .assertLogText("some build message");
  }
}

JUnit 5 test

@MavenVersions({"3.2.3", "3.2.5"})
class PluginIntegrationTest {
  @RegisterExtension
  final TestResources5 resources = new TestResources5();

  private final MavenRuntime maven;

  PluginIntegrationTest(MavenRuntimeBuilder mavenBuilder) {
    this.maven = mavenBuilder.withCliOptions("-B", "-U").build();
  }

  @MavenPluginTest
  void test() throws Exception {
    File basedir = resources.getBasedir("basic");
    maven.forProject(basedir)
      .withCliOption("-Dproperty=value")
      .withCliOption("-X")
      .execute("deploy")
      .assertErrorFreeLog()
      .assertLogText("some build message");
  }
}

Note that test pom.xml can use ${it-project.version} to reference the version of the takari-maven-plugin or takari-maven-component project being build (i.e. the project which defines the test). For example,

<build>
  <plugins>
    <plugin>
      <groupId>example.groupId</groupId>
      <artifactId>example-plugin</artifactId>
      <version>${it-project.version}</version>
      <executions>...</executions>
    </plugin>
...

Hudson users beware

Hudson Maven 3 does not use -s/--settings standard maven command option to enable "managed" settings.xml files in maven builds. Because of this, test JVMs launched by Maven builds are not able to use the settings.xml files will fail with artifact resolution errors. To workaround, use filesystem-based settings xml files and pass them using -s/--settings options.

鲜花
握手
雷人
路过
鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
More+
上一篇：
apache/maven-skins: Mirror of Apache Maven skins发布时间：2022-08-17
下一篇：
jenkinsci/lib-jenkins-maven-embedder: Jenkins hudson-maven-embedder library发布时间：2022-08-17
热门推荐
More+
热门话题
More+
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服（服务时间 9:00～18:00）

在线QQ客服
地址：深圳市南山区西丽大学城创智工业园
电邮：jeky_zhao#qq.com
移动电话：139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap