@verdigris/adonis-compression
v1.0.0
Published
AdonisJs middleware provider that wraps compression module
Downloads
83
Readme
AdonisJs Compression 🗜
This repo contains a provider for a middleware that compresses HTTP responses with GZip.
Intended use case — read me first
This middleware was originally created to compress verbose JSONAPI responses. If you are considering this middleware for compressing static assets in production, please consider using nginx or lighttpd instead. These servers are vastly superior to Node.js in performance for serving static assets.
Setup
Install the provider from npm:
adonis install @verdigris/adonis-compression
Next make sure to read the INSTRUCTIONS.md file.
Node/OS Target
This repo/branch is intended to run on all major OS platforms and targets
Node.js >= 8.0
Development
Please read CONTRIBUTING.md to learn about the contribution guidelines before contributing to this codebase.
Run the following command to see list of available npm scripts:
npm run
Tests & linting
- Unlike majority of AdonisJs codebase, this repository follows official
corporate Verdigris Technologies ECMAScript 6 styleguide. Run
npm run lint
command to check if there are any linting errors. - Make sure you write tests for all changes/bug fixes.
- Also you can write regression tests, which shows that something is
failing but doesn't breaks the build. Which is actually a nice way to show
that something fails. Regression tests are written using
test.failing()
method. - Make sure all tests are passing on CircleCI.
General practices
Most of the ES6 language features are officially supported on Node.js v8. Please make use of the ES6 language features. For example:
- Use Spread syntax over
arguments
keyword in functions. - Never use
bind
orcall
. After calling these methods, AdonisJs cannot guarantee the scope of any methods. - Make sure to write proper docblock.
License
This software is distributed AS IS WITHOUT WARRANTY under Simplified BSD license.
Verdigris Technologies Inc. assumes NO RESPONSIBILITY OR LIABILITY UNDER ANY CIRCUMSTANCES for usage of this software. See the LICENSE.md file for detailed legal information.
Copyright © 2019 Verdigris Technologies Inc. All rights reserved.