Kitura-Compression

Kitura compression middleware

Build Status - Master Mac OS X Linux Apache 2

Summary

Kitura compression middleware for compressing body data sent back to the client. Supports deflate and gzip compression methods. Uses zlib.

Table of Contents

Swift version

The latest version of Kitura-Compression requires Swift 3.0. You can download this version of the Swift binaries by following this link. Compatibility with other Swift versions is not guaranteed.

API

In order to use compression middleware, create an instance of Compression, and connect it to the desired path:

import KituraCompression

router.all(middleware: Compression())

You can configure Compression with optional arguments: swift public init (threshold: Int = 1024, chunkSize: Int = 16384, compressionLevel: CompressionLevel = CompressionLevel.defaultCompression, compressionStrategy: CompressionStrategy = CompressionStrategy.defaultStrategy, memoryLevel: Int32 = 8) Where: - threshold is the byte threshold for the response body size before compression is considered for the response, defaults to 1024.

  • chunkSize is the size of internal output slab buffer in bytes, defaults to 16384

  • compressionLevel is the level of zlib compression to apply. The supported values are:
    .noCompression, .bestSpeed, .bestCompression, .defaultCompression

  • compressionStrategy is used to tune the compression algorithm. Here are its possible values:
    .defaultStrategy, .filtered, .huffmanOnly, .rle, .fixed

  • memoryLevel specifies how much memory should be allocated for the internal compression state. The default value is 8.

For more information on compression parameters, see zlib manual.

License

This library is licensed under Apache 2.0. Full license text is available in LICENSE.