Generate realistic-looking fake data for development, testing and anonymization across many domains (names, addresses, internet, banking, books, games), extensible via extra fakers, CLI and BOM.
[!IMPORTANT] Are you considering supporting the project by donating to me? Please DO NOT!!!
Please visit the above banner link and make a small donation to help the people in Ukraine. A small donation goes a long way. 💙💛
<img src=./logo/name.png alt="kotlin-faker"/>
Generate realistically-looking fake data for Kotlin, Android, Java and JVM
Use kotlin-faker during development and testing to ensure your application data looks as if it was real, just like this really fake logo, but not quite so.<img src=./logo/kotlin_faker.png height="144" alt="fake-logo"/>
Kotlin-faker is a kotlin port of a popular ruby faker gem.
kotlin-faker: the ultimate fake data generation library for development and testing
Kotlin-faker is a comprehensive data-generation library for the JVM. It is most suitable for development, testing, and data anonymization purposes, and can be used with Kotlin, Java, Android, Scala, and other JVM-based projects. Kotlin-faker provides realistic-looking, fake data generation capabilities in various domains like names 📇, addresses 🏡, internet 🌐, banking 💸, books 📖, games 🎮, and many more.
In fact, kotlin-faker is so good at generating fake data, it almost fooled us into thinking it was real! 😱 From names that sound like they belong to secret agents 🕴️, to addresses where superheroes 🦸 might live.
⚠️ P.S. All names, addresses, bank accounts, and other data generated by this library - even those based on real strings - are entirely fictional. 🦹 All produced data is fake and generated... poorly 💩 The data is completely made up, but the problems that it tries to solve are real 👽 We take no responsibility for any existential crises caused by the eerily convincing fake data. Use with caution! ⚠️
Full documentation, including installation instructions, for kotlin-faker is available at serpro69.github.io/kotlin-faker/.
[!WARNING] kotlin-faker 2.0 is coming, which, apart from new features, also means breaking changes.
More details on currently added breaking changes and migration can be found in #220
Latest releases are always available on maven central.
dependencies {
implementation 'io.github.serpro69:kotlin-faker:$version'
}
<dependencies>
<dependency>
<groupId>io.github.serpro69</groupId>
<artifactId>kotlin-faker</artifactId>
<version>${version}</version>
Snapshots are also available using the following repository: https://central.sonatype.com/repository/maven-snapshots/
With gradle
repositories {
maven {
url = 'https://central.sonatype.com/repository/maven-snapshots/'
}
}
With maven
<repositories>
<repository>
<id>sonatype-snapshot</id>
<name>Sonatype Snapshot</name>
<url>https://central.sonatype.com/repository/maven-snapshots/</>
Kotlin-faker provides a Bill-of-Materials that simplifies dependency management.
See bom/README.md for more details.
Extra fakers covering a wide range of domains are available as separate dependencies. See faker submodules in this repo for more details about each faker.
Faker provides extensions for some third-party testing libraries. See extension submodules in this repo for more details about each extension.
val faker = faker { }
faker.name.firstName() // => Ana
faker.address.city() // => New York
Command line application can be used for a quick lookup of faker functions. See faker-bot README for installation and usage details.
To run unit and integration tests: ./gradlew clean test
To deploy to OSS Sonatype repo:
~/.gradle/gradle.properties
Versions need to be bumped manually through a tag with the next release version that has to follow the semver rules, and the tag has to be pushed to origin.
Creating the tag can be either done manually with git tag or by using gradlew tag task.
To create a new pre-release version (new release candidate)
the following can be used: ./gradlew clean tag -Prelease -PnewPreRelease -PbumpComponent={comp}, where comp can be
one of the following values: major, minor, or patch.
To bump an existing pre-release to the next version (next release candidate for the same release version)
the following can be used: ./gradlew clean tag -Prelease -PpreRelease.
To promote a pre-release to a release version the following can be used:
./gradlew clean tag -Prelease -PpromoteToRelease,
To create a new release version the following can be used:
./gradlew clean tag -Prelease -PbumpComponent={comp}, where comp can be one of the following values: major
, minor, or patch.
Alternatively to the above targets from Makefile can be used for the same purposes.
The CONTRIBUTING guidelines should help in getting you started on how to contribute to this project.
Many thanks to these awesome tools that help us in creating open-source software:
This code is free to use under the terms of the MIT license. See LICENSE.
signing.keyId=<key_id>signing.password=<key_passphrase>signing.secretKeyRingFile=/home/user/.gnupg/secring.gpgsonatypeUsername=<oss_user_token>sonatypePassword=<oss_password_token>stagingProfileId=<oss_staging_profile_id>publishFakerCorePublicationToSonatypeRepository will publish the artifacts to either staging release repo or to snapshots repo, depending on the current versionSurfaced from shared tags and platforms — no rankings paid for.