Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/goncalossilva/kotlinx-murmurhash
Kotlin Multiplatform (KMP) library for hashing using MurmurHash
https://github.com/goncalossilva/kotlinx-murmurhash
hash kotlin-multiplatform murmurhash murmurhash3
Last synced: 6 days ago
JSON representation
Kotlin Multiplatform (KMP) library for hashing using MurmurHash
- Host: GitHub
- URL: https://github.com/goncalossilva/kotlinx-murmurhash
- Owner: goncalossilva
- License: mit
- Created: 2021-12-07T01:10:27.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-23T18:08:16.000Z (16 days ago)
- Last Synced: 2024-10-24T02:53:23.788Z (15 days ago)
- Topics: hash, kotlin-multiplatform, murmurhash, murmurhash3
- Language: Kotlin
- Homepage:
- Size: 3.61 MB
- Stars: 36
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-kotlin-multiplatform - kotlinx-murmurhash - Multiplatform library for MurmurHash, a non-cryptographic hash function for general hash-based lookup focused on simplicity and performance. (Libraries / Utility)
- kmp-awesome - murmurhash - library for hashing using MurmurHash (Libraries / 🔑 Crypto)
README
# kotlinx-murmurhash
[![badge-version]](https://search.maven.org/search?q=g:com.goncalossilva%20a:murmurhash*)
![badge-jvm][badge-jvm]
![badge-js][badge-js]
![badge-nodejs][badge-nodejs]
![badge-android][badge-android]
![badge-ios][badge-ios]
![badge-watchos][badge-watchos]
![badge-tvos][badge-tvos]
![badge-macos][badge-macos]
![badge-windows][badge-windows]
![badge-linux][badge-linux]
Kotlin Multiplatform (KMP) library for [MurmurHash](https://en.wikipedia.org/wiki/MurmurHash), a non-cryptographic hash function for general hash-based lookup focused on simplicity and performance.
## Usage
Add the dependency in `build.gradle.kts`:
```kotlin
kotlin {
sourceSets {
val commonMain by getting {
dependencies {
implementation("com.goncalossilva:murmurhash:")
}
}
}
}
```
Use the provided `MurmurHash*` classes and `hash*` hashing functions.
## Example
```kotlin
MurmurHash3().hash32x86(string.encodeToByteArray())
```
## Contributing
Pull requests are welcome! See [MurmurHash3Test](src/commonTest/kotlin/MurmurHash3Test.kt) for an example of how to leverage hashes computed by the canonical C++ implementation for testing.
Feel free to contribute earlier versions, such as MurmurHash2 and MurmurHash1.
## Acknowledgements
Testing using a wordlist and pre-computed hashes of the canonical C++ implementation is inspired by [@sangupta](https://github.com/sangupta)'s [murmur](https://github.com/sangupta/murmur) Java implementation.
## License
Released under the [MIT License](https://opensource.org/licenses/MIT).
[badge-version]: https://img.shields.io/maven-central/v/com.goncalossilva/murmurhash?style=flat
[badge-ios]: https://img.shields.io/badge/platform-ios-CDCDCD.svg?style=flat
[badge-js]: https://img.shields.io/badge/platform-js-F8DB5D.svg?style=flat
[badge-nodejs]: https://img.shields.io/badge/platform-nodejs-68a063.svg?style=flat
[badge-jvm]: https://img.shields.io/badge/platform-jvm-DB413D.svg?style=flat
[badge-android]: https://img.shields.io/badge/platform-android-6EDB8D.svg?style=flat
[badge-linux]: https://img.shields.io/badge/platform-linux-2D3F6C.svg?style=flat
[badge-windows]: https://img.shields.io/badge/platform-windows-4D76CD.svg?style=flat
[badge-macos]: https://img.shields.io/badge/platform-macos-111111.svg?style=flat
[badge-watchos]: https://img.shields.io/badge/platform-watchos-C0C0C0.svg?style=flat
[badge-tvos]: https://img.shields.io/badge/platform-tvos-808080.svg?style=flat
[badge-wasm]: httpss://img.shields.io/badge/platform-wasm-624FE8.svg?style=flat