Skip to content

Commit

Permalink
Added a useful reference to the README (#356)
Browse files Browse the repository at this point in the history
* Added a useful reference to the README template
* Line breaks
* Generated the updated README
  • Loading branch information
neboskreb authored Sep 13, 2024
1 parent f2c7058 commit fb7c6ed
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 0 deletions.
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -239,6 +239,36 @@ At this time, Google hasn't shared any immediate plans to bring first-party supp
- [Add support for JUnit 5 (issuetracker.google.com)](https://issuetracker.google.com/issues/127100532)
- [JUnit 5 support (github.com/android/android-test)](https://github.com/android/android-test/issues/224)

## Support for @Rules

Since JUnit 5 has replaced the `@Rule` mechanism with Extensions, the following artifacts help bridge the gap until Android officially transitions to JUnit 5.

### InstantExecutorExtension

Replaces `InstantTaskExecutorRule` in JUnit 5.

<details>
<summary>Kotlin</summary>

```kotlin
dependencies {
testImplementation("io.github.neboskreb:instant-task-executor-extension:1.0.0")
}
```
</details>

<details>
<summary>Groovy</summary>

```groovy
dependencies {
testImplementation 'io.github.neboskreb:instant-task-executor-extension:1.0.0'
}
```
</details>

For more details see [instant-task-executor-extension](https://github.com/neboskreb/instant-task-executor-extension) on GitHub.

## Building Locally

This repository contains multiple modules, divided into two sub-projects. The repository's root directory contains build logic shared across the sub-projects, which in turn use symlinks to connect to the common build scripts in their parent folder.
Expand Down
30 changes: 30 additions & 0 deletions README.md.template
Original file line number Diff line number Diff line change
Expand Up @@ -234,6 +234,36 @@ At this time, Google hasn't shared any immediate plans to bring first-party supp
- [Add support for JUnit 5 (issuetracker.google.com)](https://issuetracker.google.com/issues/127100532)
- [JUnit 5 support (github.com/android/android-test)](https://github.com/android/android-test/issues/224)

## Support for @Rules

Since JUnit 5 has replaced the `@Rule` mechanism with Extensions, the following artifacts help bridge the gap until Android officially transitions to JUnit 5.

### InstantExecutorExtension

Replaces `InstantTaskExecutorRule` in JUnit 5.

<details>
<summary>Kotlin</summary>

```kotlin
dependencies {
testImplementation("${libs.instantTaskExecutorExtension}")
}
```
</details>

<details>
<summary>Groovy</summary>

```groovy
dependencies {
testImplementation '${libs.instantTaskExecutorExtension}'
}
```
</details>

For more details see [instant-task-executor-extension](https://github.com/neboskreb/instant-task-executor-extension) on GitHub.

## Building Locally

This repository contains multiple modules, divided into two sub-projects. The repository's root directory contains build logic shared across the sub-projects, which in turn use symlinks to connect to the common build scripts in their parent folder.
Expand Down
4 changes: 4 additions & 0 deletions build-logic/src/main/kotlin/Dependencies.kt
Original file line number Diff line number Diff line change
Expand Up @@ -84,4 +84,8 @@ object libs {
const val composeUiTest = "androidx.compose.ui:ui-test"
const val composeUiTestJUnit4 = "androidx.compose.ui:ui-test-junit4"
const val composeUiTestManifest = "androidx.compose.ui:ui-test-manifest"

// Documentation
// For the latest version refer to GitHub repo neboskreb/instant-task-executor-extension
const val instantTaskExecutorExtension = "io.github.neboskreb:instant-task-executor-extension:1.0.0"
}

0 comments on commit fb7c6ed

Please sign in to comment.