Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/robertfmurdock/jsmints

Last synced: 6 days ago
JSON representation

Host: GitHub
URL: https://github.com/robertfmurdock/jsmints
Owner: robertfmurdock
License: mit
Created: 2022-01-20T01:40:04.000Z (almost 3 years ago)
Default Branch: master
Last Pushed: 2024-10-30T15:25:12.000Z (9 days ago)
Last Synced: 2024-10-30T16:28:26.330Z (9 days ago)
Language: Kotlin
Size: 6.59 MB
Stars: 9
Watchers: 3
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-kotlin-multiplatform - jsmints - A suite of libraries and gradle plugins for working with Kotlin JS, with a focus on testing and version updating. (Libraries / Test)

README

# jsmints ![Build](https://github.com/robertfmurdock/jsmints/actions/workflows/main.yml/badge.svg?branch=master) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.zegreatrob.jsmints/jsmints-bom/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.zegreatrob/jsmints)

[![Gradle Lib Updates](https://github.com/robertfmurdock/jsmints/actions/workflows/gradle-update.yml/badge.svg?branch=master)](https://github.com/robertfmurdock/jsmints/actions/workflows/gradle-update.yml)
[![Gradle Wrapper Update](https://github.com/robertfmurdock/jsmints/actions/workflows/update-gradle-wrapper.yml/badge.svg?branch=master)](https://github.com/robertfmurdock/jsmints/actions/workflows/update-gradle-wrapper.yml)

![Latest Release](https://img.shields.io/github/v/release/robertfmurdock/jsmints)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/robertfmurdock/jsmints)

Jsmints is a suite of libraries and gradle plugins for working with Kotlin JS, with a focus on testing and version updating.

Included:

### react-testing-library

A kotlin wrapper for [react testing library](https://testing-library.com/docs/react-testing-library/intro/). Coroutine sugar included to help avoid common errors, like forgetting to "await" a returned promise.

Most functions are available from the "TestingLibraryReact" singleton object. Import and play.

import com.zegreatrob.wrapper.testinglibrary.react.TestingLibraryReact

- [examples](libraries/react-testing-library/src/jsTest/kotlin/com/zegreatrob/wrapper/testinglibrary/react/ByLabelTextTest.kt)

### user-event-testing-library

A kotlin wrapper for [user event](https://testing-library.com/docs/user-event/intro). Similar to react-testing-library, coroutine sugar included to help avoid common errors, like forgetting to "await" a returned promise.

### wdio

Kotlin wrapper + convenience functions for the wdio js project, to allow node js kotlin code to operate a web browser via wdio. This allows for writing webdriver tests with Kotlin Test.

### wdio-testing-library

Kotlin wrapper + convenience functions for [wdio testing library](https://testing-library.com/docs/webdriverio-testing-library/intro/).

### WDIO Gradle Plugin

This is a one-stop-shop for setting up WDIO for your kotlin project.

Intended to be usable without configuration, but allow the full flexibility of the tool, it comes bundled with defaults that can be changed, including use of the ["nice html reporter"](https://github.com/rpii/wdio-html-reporter), screenshot capture, and chrome operation.

### Jspackage Gradle Plugin

A gradle plugin that allows you use a package.json file to define your Javascript dependencies.

### NCU Gradle Plugin

A gradle plugin that will automatically include [npm-check-updates](https://github.com/raineorshine/npm-check-updates) and tasks that take advantage of it.

Requires use of the Jspackage plugin.

### React Data Loader

A Kotlin-based react component for handling simple data-loading state. For people who want extremely simple and clear data-loading behavior, and find other React solutions too *quirky*.

### [minreact](minreact/README.md)

Sugar for React functional components that allows them to use Kotlin data classes as props. This helps avoid the 'forgotten mandatory prop' issue that can happen when using the base Kotlin DSL.

If you choose to use this library, please share feedback! The API is strange and could use some love regarding what's good and what stinks.

### minenzyme

A wrapper for the enzyme library. I am not actively supporting this module any more. In future versions it may be removed from the suite.

## Installation

All of these are either regular libraries, or gradle plugins.

They're listed at https://mvnrepository.com/artifact/com.zegreatrob.jsmints

Simply find the library related to the feature you want, and then follow the instructions for you build process on its mvn repository page.

Sorry for the abbreviated instructions, but I wanted to get something here to help anyone who might get stuck!