nikel-core

command
Version: v0.0.0-...-5f1a4ed Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2021 License: MIT Imports: 1 Imported by: 0

README

Nikel Core

This README provides a high-level overview of Nikel-Core.

Benchmarks

Benchmark code: GitHub Gist

Date: 07/25/2020

Commit ID: d20962

AMD Ryzen 7 3800X on localhost with standard output disabled

Cache Concurrent Users Hatch Rate Throughput
In-Memory 10000 100 users/s 2474.4 reqs/s
LevelDB (SSD) 10000 100 users/s 2382.5 reqs/s
BadgerDB (SSD) 10000 100 users/s 2372.5 reqs/s
None 10000 100 users/s 1639.6 reqs/s

Note that benchmark results don't reflect real world performance so take the results with a grain of salt.

Web Framework

Nikel-Core is powered by Gin, a performant and featureful web framework.

Database

All data is stored in memory through variables for low latency and fast querying. (with thread-safe access via immutability and read-only access)

Querying

The querying system is based on Gojsonq. It maps the REST API interface to Gojsonq query calls.

Using guregu/Null, the queried data is passed through a struct that formats the data in the proper JSON structure.

Caching

Data is cached via a Gin cache middleware backed by GoLevelDB. (nikel-cache)

The cache can be optionally backed by memory or BadgerDB.

CORS

Nikel-Core by default allows all origins so that the API is accessible to everyone.

Gzip

Nikel-Core gzips all responses for smaller payload sizes.

Rate Limits

Rate limits are handled in memory via ulule/limiter.

Process Flow

Request -> Ratelimit* -> Cache* -> Cors* -> Gzip* -> Route handler -> Query engine -> Response

*Optional

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
t or T : Toggle theme light dark auto
y or Y : Canonical URL