Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vacxe/konveyor
Random data class generator
https://github.com/vacxe/konveyor
generative-testing kotlin mock reflection testing testing-tools unit-testing
Last synced: 5 days ago
JSON representation
Random data class generator
- Host: GitHub
- URL: https://github.com/vacxe/konveyor
- Owner: Vacxe
- License: apache-2.0
- Created: 2018-08-15T04:30:06.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-07-24T00:30:46.000Z (3 months ago)
- Last Synced: 2024-10-10T12:06:01.367Z (26 days ago)
- Topics: generative-testing, kotlin, mock, reflection, testing, testing-tools, unit-testing
- Language: Kotlin
- Homepage:
- Size: 779 KB
- Stars: 58
- Watchers: 4
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Konveyor
Konveyor is a library for generating Data classes with random values.
## Motivation
From time to time, when you implement a test, you need an instance of object. Creating an instance manually takes a lot of time and it might be boring. It's even worse if object contains nested objects. It makes your test a bit littered.
## How to use Konveyor
For example, you have some class like this
```kotlin
data class PrimitiveDataClass(val int: Int,
val double: Double,
val byte: Byte,
val short: Short,
val long: Long,
val float: Float,
val boolean: Boolean,
val char: Char,
val string: String,
val charSequence: CharSequence)
```
Just call this:
```kotlin
val primitiveDataClass: PrimitiveDataClass = randomBuild()
```
And all fields are automatically filled up:
```
PrimitiveDataClass(int=-160837378, double=0.2543439936127936, byte=125, short=7553, long=8930811805778341874, float=0.9110602, boolean=false, char=2, string=String_212195448, charSequence=String_1391234678)
```
All ```boolean``` will be ```false``` by default
Also, all fields with setter functions should be initialized manualy. Library can help you only with initialization for constructors variables.
### Special cases
Konveyor generates for you every class which has primitives in base. But sometimes, we have to create classes with interfaces and with some irregular cases. We can resolve this issue by using `ObjectResolver`:
```kotlin
val resolver = ObjectResolver()
resolver(MyInterface::class.java, { MyInterfaceImpl() })
val nestedInterfaceDataClass: NestedInterfaceDataClass = randomBuild(resolver = resolver)
```
### Compatibility with Java
Of course, you can use Konveyor with Java:
```java
PrimitiveDataClass primitiveDataClass = KonveyorKt.randomBuild(PrimitiveDataClass.class);
```
### Download
Maven:
```xml
io.github.vacxe
konveyor
latest version
pom
```
Gradle:
```groovy
dependencies {
implementation 'io.github.vacxe:konveyor:'
}
```
```kotlin
dependencies {
implementation("io.github.vacxe:konveyor:")
}
```
##### Enjoy your build with Konveyor!
