{"id":13736184,"url":"https://github.com/status-im/nim-rocksdb","last_synced_at":"2025-10-26T15:16:29.689Z","repository":{"id":28717435,"uuid":"119156264","full_name":"status-im/nim-rocksdb","owner":"status-im","description":"Nim wrapper for RocksDB, a persistent key-value store for Flash and RAM Storage.","archived":false,"fork":false,"pushed_at":"2025-02-10T03:12:40.000Z","size":390,"stargazers_count":35,"open_issues_count":2,"forks_count":6,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-02-22T17:43:33.792Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Nim","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/status-im.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHEv2","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-27T10:58:37.000Z","updated_at":"2025-02-17T20:11:06.000Z","dependencies_parsed_at":"2024-07-08T08:12:47.213Z","dependency_job_id":"23914058-7ed4-40c9-9c6f-eec8f7742cf4","html_url":"https://github.com/status-im/nim-rocksdb","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/status-im%2Fnim-rocksdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/status-im%2Fnim-rocksdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/status-im%2Fnim-rocksdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/status-im%2Fnim-rocksdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/status-im","download_url":"https://codeload.github.com/status-im/nim-rocksdb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240371761,"owners_count":19790888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T03:01:17.142Z","updated_at":"2025-10-26T15:16:29.664Z","avatar_url":"https://github.com/status-im.png","language":"Nim","funding_links":[],"categories":["Data"],"sub_categories":["Database"],"readme":"# Nim-RocksDb\n\n![Github action](https://github.com/status-im/nim-rocksdb/workflows/CI/badge.svg)\n[![License: Apache](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n![Stability: experimental](https://img.shields.io/badge/stability-experimental-orange.svg)\n\nA Nim wrapper for [Facebook's RocksDB](https://github.com/facebook/rocksdb), a persistent key-value store for Flash and RAM Storage.\n\n## Current status\n\nNim-RocksDb provides a wrapper for the low-level functions in the librocksdb c\nlibrary.\n\n## Installation\n\nNim-RocksDb requires Nim and the Nimble package manager. For Windows you will\nneed Visual Studio 2015 Update 3 or greater with the English language pack.\n\nTo get started run:\n```\nnimble install rocksdb\n```\n\nThis will download and install the RocksDB libraries for your platform and copy\nthem into the `build/` directory of the project. On Linux and MacOS only static\nlinking to the RocksDb libraries is supported and on Windows only dynamic linking\nis supported.\n\nOn Windows you may want to copy the dll into another location or set your PATH\nto include the `build/` directory so that your application can find the dll on\nstartup.\n\n### Compression libraries\n\nRocksDb supports using a number of compression libraries. This library builds\nand only supports the following compression libraries:\n- lz4\n- zstd\n\nOn Linux and MacOS these libraries are staticly linked into the final binary\nalong with the RocksDb static library. On Windows they are staticly linked into\nthe RocksDb dll.\n\n\n### Static linking\n\nOn Linux and MacOS your Nim program will need to use the C++ linker profile\nbecause RocksDb is a C++ library. For example:\n\n```\n  when defined(macosx):\n    switch(\"clang.linkerexe\", \"clang++\")\n  when defined(linux):\n    switch(\"gcc.linkerexe\", \"g++\")\n```\n\nNote that static linking is currently not supported on windows.\n\n## Usage\n\nSee [simple_example](examples/simple_example.nim)\n\n### Contribution\n\nAny contribution intentionally submitted for inclusion in the work by you shall\nbe dual licensed as above, without any additional terms or conditions.\n\n## Versioning\n\nThe library generally follows the upstream RocksDb version number, adding one\nmore number for tracking changes to the Nim wrapper itself.\n\n## License\n\n### Wrapper License\n\nThis repository is licensed and distributed under either of\n\n* MIT license: [LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT\n\nor\n\n* Apache License, Version 2.0, ([LICENSE-APACHEv2](LICENSE-APACHEv2) or http://www.apache.org/licenses/LICENSE-2.0)\n\nat your option. This file may not be copied, modified, or distributed except\naccording to those terms.\n\n### Dependency License\n\nRocksDB is developed and maintained by Facebook Database Engineering Team.\nIt is built on earlier work on LevelDB by Sanjay Ghemawat (sanjay@google.com)\nand Jeff Dean (jeff@google.com)\n\nRocksDB is dual-licensed under both the [GPLv2](https://github.com/facebook/rocksdb/blob/master/COPYING) and Apache License, Version 2.0, ([LICENSE-APACHEv2](LICENSE-APACHEv2) or http://www.apache.org/licenses/LICENSE-2.0).  You may select, at your option, one of the above-listed licenses.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatus-im%2Fnim-rocksdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstatus-im%2Fnim-rocksdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstatus-im%2Fnim-rocksdb/lists"}