Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
65 lines (51 loc) · 2.71 KB

CONTRIBUTING.md

File metadata and controls

65 lines (51 loc) · 2.71 KB
Raw

How to contribute ?

Contributions of any kind a ❤️ accepted

  • Adding new frameworks
  • Fix some frameworks
  • Update dependencies
  • Discuss best practices

Running the benchmarks

Only needed to run benchmarks locally (./run.sh) — CI builds each framework and checks its routes, but never benchmarks, so none of this is required to open a pull request.

  • Docker, to build and run each framework
  • Ruby + bundle install, for the rake tasks that generate the per-framework .Dockerfile/.Makefile
  • zrk >= 2.4.0, the load generator the collect targets shell out to. brew install zoxy-io/tap/zrk, or grab a static binary from the releases. It must be on PATH. The harness runs it in --closed mode (added in 2.2.0) and is validated on 2.4.x; run.sh enforces the minimum.

Adding a framework

Define bootstrap as a YAML list of shell commands. Dockerfile generation concatenates commands from the root config, the language config (for example, javascript/config.yaml), then the framework config (for example, javascript/nextjs/config.yaml). Within each file, commands run in this order: top-level bootstrap, language bootstrap, selected language engine bootstrap, framework bootstrap, then inline framework engine bootstrap. Command order and repeated commands are preserved, so language dependency installation runs before framework build commands.

Define environment as YAML key/value pairs:

environment:
  NODE_ENV: production
  NEXT_TELEMETRY_DISABLED: 1

Environment mappings merge from the root config, then the language config, then the framework config. Within each file, the order is top-level environment, language environment, selected language engine environment, framework environment, then inline framework engine environment. Later values override duplicate keys; variables for other engines are excluded. Each resulting pair renders as one ENV KEY=value instruction in the Dockerfile.

  • All frameworks SHOULD follow this rules :
HTTP Route Status code Response body
GET / 200 Empty
GET /user/:id 200 id given as param
POST /user 200 Empty

  • All framework SHOULD contain a Dockerfile

  • All framework SHOULD be referenced in :

    • Makefile, a target group for the language, and a target for the framework
    • neph.yaml, a target group for the language, and a target for the framework
    • benchmarker.cr, a hash for language containing all frameworks an repository information