A simple Redis client in tune with Functional Programming principles in JavaScript for Deno.
Functional Redis is optimized to write elegant and powerful point-free functions. This example uses the Ramda library - for simplification - but you should be able to use any library that implements the Fantasy-land specifications.
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import File from "https://deno.land/x/functional_io@v1.1.0/library/File.js";
import { writeFile } from "https://deno.land/x/functional_io@v1.1.0/library/fs.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
import {
createRedisSession,
pipeRedisCommand
} from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
const copyHogeToFuga = createRedisSession(
compose(
chain(
compose(
writeFile({}),
concat(File.fromPath(`${Deno.cwd()}/hoge`))
)
),
pipeRedisCommand(
[
RedisRequest.set({}, "hoge", "piyo"),
RedisRequest.get("hoge"),
RedisRequest.set({}, "fuga")
]
)
)
);
const container = await copyHogeToFuga({ port: 6379 }).run();
safeExtract("Failed to execute the request.", container);
The RedisRequest
represents a Redis request.
It has three attributes: the first is the Redis command, the second is a typed array named "raw", the last is an
array of arguments.
The RedisRequest
type is mostly interoperable with RedisResponse
, Resource
,
File
, (HTTP) Request
and (HTTP) Response
.
The RedisRequest
type implements the following algebras:
- Group
- Comonad
- Monad
import RedisRequest from "https://deno.land/x/functional-redis@v0.1.1/library/RedisRequest.js";
const redisRequest = RedisRequest("GET", new Uint8Array([]), [ "hoge" ]);
assert(RedisRequest.is(redisRequest));
A Symbol named rawPlaceholder
may be used as a placeholder for the buffer.
In the following example, the request will resolve to: SET hoge piyo
.
import { encodeText } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import RedisRequest from "https://deno.land/x/functional-redis@v0.1.1/library/RedisRequest.js";
import { $$rawPlaceholder } from "https://deno.land/x/functional-redis@v0.1.0/library/Symbol.js";
const redisRequest = RedisRequest("SET", encodeText("piyo"), [ "hoge", $$rawPlaceholder ]);
assert(RedisRequest.is(redisRequest));
The placeholder can be used multiple times if the buffer has multiple values separated by CLRF (\r\n
).
import { encodeText } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import RedisRequest from "https://deno.land/x/functional-redis@v0.1.1/library/RedisRequest.js";
import { $$rawPlaceholder } from "https://deno.land/x/functional-redis@v0.1.0/library/Symbol.js";
const redisRequest = RedisRequest(
"MSET",
encodeText("piyo\r\nfuga\r\n"),
[ "hoge", $$rawPlaceholder, "hogefuga", $$rawPlaceholder ]
);
assert(RedisRequest.is(redisRequest));
The RedisRequest
namespace comes with methods for convenience to create an instance of RedisRequest
with various
commands. The methods are curried.
String → Uint8Array → (String|Symbol)[] → RedisRequest
This curried function takes a string for the name of the Redis command, a (optionally empty) Uint8Array
and, an
array for the arguments. The return value is an instance of RedisRequest
.
RedisRequest.append
📕
String → (String|Uint8Array) → RedisRequest
const redisRequest = RedisRequest.append("hoge", "piyo");
RedisRequest.bitcount
📕
String → [ Number, Number ] → RedisRequest
const redisRequest = RedisRequest.bitcount("hoge", [ 0, 1 ]);
RedisRequest.bitfield
📕
String → String[] → RedisRequest
const redisRequest = RedisRequest.bitfield("hoge", [ "GET", "i8", 100 ]);
RedisRequest.bitop
📕
String → String → String[] → RedisRequest
const redisRequest = RedisRequest.bitop("AND", "hoge", [ "piyo", "fuga" ]);
RedisRequest.bitpos
📕
String → [ Number, Number ] → RedisRequest
const redisRequest = RedisRequest.bitpos("hoge", [ 0, 1 ]);
RedisRequest.decr
📕
String → RedisRequest
const redisRequest = RedisRequest.decr("hoge");
RedisRequest.decrby
📕
String → Number → RedisRequest
const redisRequest = RedisRequest.decrby("hoge", 3);
RedisRequest.get
📕
String → RedisRequest
const redisRequest = RedisRequest.get("hoge");
RedisRequest.getbit
📕
String → Number → RedisRequest
const redisRequest = RedisRequest.getbit("hoge", 3);
RedisRequest.getrange
📕
String → [ Number, Number ] → RedisRequest
const redisRequest = RedisRequest.getrange("hoge", [ 0, 1 ]);
RedisRequest.getset
📕
String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.getset("hoge", "piyo");
const redisRequestB = RedisRequest.getset("hoge", encodeText("piyo"));
RedisRequest.incr
📕
String → RedisRequest
const redisRequest = RedisRequest.incr("hoge");
RedisRequest.incrby
📕
String → Number → RedisRequest
const redisRequest = RedisRequest.incrby("hoge", 3);
RedisRequest.incrbyfloat
📕
String → Number → RedisRequest
const redisRequest = RedisRequest.incrbyfloat("hoge", 0.1);
RedisRequest.mget
📕
(String, ...) → RedisRequest
, or String[] → RedisRequest
const redisRequestA = RedisRequest.mget("hoge", "piyo");
const redisRequestB = RedisRequest.mget([ "hoge", "piyo" ]);
RedisRequest.mset
📕
(String, ...) → RedisRequest
, or (String|Symbol)[] → Uint8Array → RedisRequest
const redisRequestA = RedisRequest.mset("hoge", "piyo", "hogefuga", "fuga");
const redisRequestB = RedisRequest.mset(
[ "hoge", $$rawPlaceholder, "hogefuga", $$rawPlaceholder ],
encodeText("piyo\r\nfuga\r\n")
);
RedisRequest.msetnx
📕
(String, ...) → RedisRequest
, or (String|Symbol)[] → Uint8Array → RedisRequest
const redisRequestA = RedisRequest.msetnx("hoge", "piyo", "hogefuga", "fuga");
const redisRequestB = RedisRequest.msetnx(
[ "hoge", $$rawPlaceholder, "hogefuga", $$rawPlaceholder ],
encodeText("piyo\r\nfuga\r\n")
);
RedisRequest.psetex
📕
Number → String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.psetex(1000, "hoge", "piyo");
const redisRequestB = RedisRequest.psetex(1000, "hoge", encodeText("piyo"));
RedisRequest.set
📕
Object → String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.set({}, "hoge", "piyo");
const redisRequestB = RedisRequest.set({}, "hoge", encodeText("piyo"));
const redisRequestC = RedisRequest.set({ EX: 2000 }, "hoge", encodeText("piyo"));
const redisRequestD = RedisRequest.set({ KEEPTTL: true }, "hoge", encodeText("piyo"));
RedisRequest.setbit
📕
String → Number → Number → RedisRequest
const redisRequest = RedisRequest.setbit("hoge", 7, 1);
RedisRequest.setex
📕
Number → String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.setex(10, "hoge", "piyo");
const redisRequestB = RedisRequest.setex(10, "hoge", encodeText("piyo"));
RedisRequest.setnx
📕
String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.setnx("hoge", "piyo");
const redisRequestB = RedisRequest.setnx("hoge", encodeText("piyo"));
RedisRequest.setrange
📕
String → Number → (String|Uint8Array) → RedisRequest
const redisRequest = RedisRequest.setrange("hoge", 2, "FU");
RedisRequest.stralgo
📕
(String, ...) → RedisRequest
const redisRequest = RedisRequest.strlen("LCS", "KEYS, "hoge", "piyo");
RedisRequest.strlen
📕
String → RedisRequest
const redisRequest = RedisRequest.strlen("hoge");
RedisRequest.copy
📕
Object → String → String → RedisRequest
const redisRequestA = RedisRequest.copy({}, "hoge", "fuga");
const redisRequestB = RedisRequest.copy({ REPLACE: true }, "hoge", "fuga");
const redisRequestC = RedisRequest.copy({ DB: 2 }, "hoge", "fuga");
RedisRequest.del
📕
(String, ...) → RedisRequest
, or String[] → RedisRequest
const redisRequestA = RedisRequest.del("hoge", "fuga");
const redisRequestB = RedisRequest.del([ "hoge", "fuga" ]);
RedisRequest.dump
📕
String → RedisRequest
const redisRequest = RedisRequest.dump("hoge");
RedisRequest.exists
📕
(String, ...) → RedisRequest
, or String[] → RedisRequest
const redisRequestA = RedisRequest.exists("hoge", "fuga");
const redisRequestB = RedisRequest.exists([ "hoge", "fuga" ]);
RedisRequest.expire
📕
Number → String → RedisRequest
const redisRequest = RedisRequest.expire(10, "hoge");
RedisRequest.expireat
📕
Date|Number → String → RedisRequest
const redisRequestA = RedisRequest.expireat(new Date(), "hoge");
const redisRequestB = RedisRequest.expireat(Date.now(), "hoge");
RedisRequest.keys
📕
String → RedisRequest
const redisRequest = RedisRequest.keys("*ge");
RedisRequest.migrate
📕
Object → String|String[] → RedisRequest
const redisRequestA = RedisRequest.migrate({ host: "127.0.0.1", port: 6379, db: 3, timeout: 5000 }, "hoge");
const redisRequestB = RedisRequest.migrate(
{ host: "127.0.0.1", port: 6379, db: 3, timeout: 5000 },
[ "hoge", "fuga" ]
);
const redisRequestC = RedisRequest.migrate(
{ host: "127.0.0.1", port: 6379, db: 3, timeout: 5000, REPLACE: true },
"hoge"
);
const redisRequestD = RedisRequest.migrate(
{ host: "127.0.0.1", port: 6379, db: 3, timeout: 5000, password },
"hoge"
);
const redisRequestE = RedisRequest.migrate(
{ host: "127.0.0.1", port: 6379, db: 3, timeout: 5000, username, password },
"hoge"
);
RedisRequest.move
📕
Number → String → RedisRequest
const redisRequest = RedisRequest.move(3, "hoge");
RedisRequest.object
📕
String → String|String[] → RedisRequest
const redisRequestA = RedisRequest.object("ENCODING", "hoge");
const redisRequestB = RedisRequest.object("ENCODING", [ "hoge" ]);
RedisRequest.persist
📕
String → RedisRequest
const redisRequest = RedisRequest.persist("hoge");
RedisRequest.pexpireat
📕
Date|Number → String → RedisRequest
const redisRequestA = RedisRequest.pexpireat(new Date(), "hoge");
const redisRequestB = RedisRequest.pexpireat(Date.now(), "hoge");
RedisRequest.pexpire
📕
Number → String → RedisRequest
const redisRequest = RedisRequest.pexpire(5000, "hoge");
RedisRequest.ptll
📕
String → RedisRequest
const redisRequest = RedisRequest.pttl("hoge");
RedisRequest.randomkey
📕
String → RedisRequest
const redisRequest = RedisRequest.randomkey("hoge");
RedisRequest.rename
📕
String → String → RedisRequest
const redisRequest = RedisRequest.rename("hoge", "hogefuga");
RedisRequest.renamenx
📕
String → String → RedisRequest
const redisRequest = RedisRequest.renamenx("hoge", "hogefuga");
RedisRequest.restore
📕
Object → String → String|Uint8Array → RedisRequest
const redisRequestA = RedisRequest.restore(
{ ttl: 10 },
"hoge",
String.raw`\u0000\xC0\n\t\u0000\xBEm\u0006\x89Z(\u0000\n`
);
const redisRequestB = RedisRequest.restore(
{ ttl: 10 },
"hoge",
encodeText(String.raw`\u0000\xC0\n\t\u0000\xBEm\u0006\x89Z(\u0000\n`)
);
const redisRequestC = RedisRequest.restore(
{ ttl: 10, REPLACE: true },
"hoge",
String.raw`\u0000\xC0\n\t\u0000\xBEm\u0006\x89Z(\u0000\n`
);
const redisRequestD = RedisRequest.restore(
{ ttl: 10, IDLETIME: 1 },
"hoge",
String.raw`\u0000\xC0\n\t\u0000\xBEm\u0006\x89Z(\u0000\n`
);
RedisRequest.scan
📕
Object → Number → RedisRequest
const redisRequestA = RedisRequest.scan({}, 0);
const redisRequestB = RedisRequest.scan({ MATCH: "*yo", COUNT: 1000 }, 0);
RedisRequest.sort
📕
Object → String → RedisRequest
const redisRequestA = RedisRequest.sort({}, "hoge");
const redisRequestB = RedisRequest.sort({ BY: "fuga" }, "hoge");
const redisRequestC = RedisRequest.sort({ LIMIT: 10 }, "hoge");
const redisRequestD = RedisRequest.sort({ ASC: true }, "hoge");
const redisRequestE = RedisRequest.sort({ DESC: true, ALPHA: true }, "hoge");
const redisRequestF = RedisRequest.sort({ STORE: "fuga" }, "hoge");
const redisRequestG = RedisRequest.sort({ GET: [ "*" ], ALPHA: true }, "hoge");
const redisRequestH = RedisRequest.sort({ LIMIT: 10, GET: [ "*", "#" ], ALPHA: true }, "hoge");
RedisRequest.touch
📕
String|String[] → RedisRequest
const redisRequestA = RedisRequest.touch("hoge");
const redisRequestB = RedisRequest.touch([ "hoge", "fuga" ]);
RedisRequest.ttl
📕
String → RedisRequest
const redisRequest = RedisRequest.ttl("hoge");
RedisRequest.type
📕
String → RedisRequest
const redisRequest = RedisRequest.type("hoge");
RedisRequest.unlink
📕
String|String[] → RedisRequest
const redisRequestA = RedisRequest.unlink("hoge");
const redisRequestB = RedisRequest.unlink([ "hoge", "fuga" ]);
RedisRequest.wait
📕
Number → Number → RedisRequest
const redisRequest = RedisRequest.wait(1,10);
RedisRequest.hdel
📕
String → String|String[] → RedisRequest
const redisRequestA = RedisRequest.hdel("hoge", "piyo");
const redisRequestB = RedisRequest.hdel("hoge", [ "piyo", "fuga" ]);
RedisRequest.hexists
📕
String → String → RedisRequest
const redisRequest = RedisRequest.hexists("hoge", "piyo");
RedisRequest.hget
📕
String → String → RedisRequest
const redisRequest = RedisRequest.hget("hoge", "piyo");
RedisRequest.hgetall
📕
String → RedisRequest
const redisRequest = RedisRequest.hgetall("hoge");
RedisRequest.hincrby
📕
String → Number → String → RedisRequest
const redisRequest = RedisRequest.hincrby("hoge", 3, "piyo");
RedisRequest.hincrbyfloat
📕
String → Number → String → RedisRequest
const redisRequestA = RedisRequest.hincrbyfloat("hoge", 0.1, "piyo");
const redisRequestB = RedisRequest.hincrbyfloat("hoge", -5, "piyo");
const redisRequestC = RedisRequest.hincrbyfloat("hoge", 5.0e3, "piyo");
RedisRequest.hkeys
📕
String → RedisRequest
const redisRequest = RedisRequest.hkeys("hoge");
RedisRequest.hlen
📕
String → RedisRequest
const redisRequest = RedisRequest.hlen("hoge");
RedisRequest.hmget
📕
String → String|String[] → RedisRequest
const redisRequestA = RedisRequest.hmget("hoge", "piyo");
const redisRequestB = RedisRequest.hmget("hoge", [ "piyo", "fuga" ]);
RedisRequest.hmset
📕
String → String → String|Uint8Array → RedisRequest
or, String → String[] → Uint8Array → RedisRequest
const redisRequestA = RedisRequest.hmset("hoge", "piyo", "fuga");
const redisRequestB = RedisRequest.hmset("hoge", "piyo", encodeText("fuga"));
const redisRequestC = RedisRequest.hmset(
"hoge",
[ "piyo", $$rawPlaceholder, "fuga", $$rawPlaceholder ],
encodeText("hogepiyo\r\nhogefuga\r\n")
);
RedisRequest.hscan
📕
Object → String → Number → RedisRequest
const redisRequestA = RedisRequest.hscan({}, "hoge", 0);
const redisRequestB = RedisRequest.hscan({ MATCH: "*yo", COUNT: 1000 }, "hoge", 0);
RedisRequest.hset
📕
String → String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.hset("hoge", "piyo", "fuga");
const redisRequestB = RedisRequest.hset("hoge", "piyo", encodeText("fuga"));
RedisRequest.hsetnx
📕
String → String → (String|Uint8Array) → RedisRequest
const redisRequestA = RedisRequest.hsetnx("hoge", "piyo", "fuga");
const redisRequestB = RedisRequest.hsetnx("hoge", "piyo", encodeText("fuga"));
RedisRequest.hstrlen
📕
String → String → RedisRequest
const redisRequest = RedisRequest.hstrlen("hoge", "piyo");
RedisRequest.hvals
📕
String → RedisRequest
const redisRequest = RedisRequest.hvals("hoge");
RedisRequest.flushall
📕
() → RedisRequest
const redisRequest = RedisRequest.flushall();
The RedisResponse
represents a Redis response.
It has only one argument, a typed array named "raw".
The RedisResponse
type is mostly interoperable with RedisRequest
, Resource
,
File
, (HTTP) Request
and (HTTP) Response
.
The RedisResponse
type implements the following algebras:
- Alternative
- Group
- Comonad
- Monad
import RedisResponse from "https://deno.land/x/functional-redis@v0.1.1/library/RedisResponse.js";
const redisResponse = RedisResponse.Success(new Uint8Array([]));
assert(RedisResponse.is(redisResponse));
Uint8Array → RedisResponse.Success
Uint8Array → RedisResponse.Failure
The client module provides various utility functions to interact with a Redis server.
RedisResponse → *
This functions takes a RedisResponse
and, returns the most appropriate JavaScript primitive.
For example, string command's response would return a string and,
hash command's response would return an array...
RedisResponse → Buffer
This functions takes a RedisResponse
and, returns a Buffer
which can be interoperated cleanly with RedisRequest
,
Resource
,
File
and,
(HTTP) Request
.
Object → Task Resource
This function takes an object for the connection options and, return a
Task
of a Resource
.
import { connectRedisClient } from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
const container = await connectRedisClient({ port: 6379 }).run();
const redisResource = safeExtract("Failed to connect the client.", container);
Resource → Task Resource
This function takes a Resource and, return a
Task
of a Resource
.
import { disconnectRedisClient } from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
await disconnectRedisClient(redisResource).run();
RedisRequest → Resource → Task RedisResponse
This curried function accepts a RedisRequest
and a Resource
that represents a connection to the Redis server
and, returns a Task
of a RedisResponse
.
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import { executeRedisCommand } from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
import RedisResponse from "https://deno.land/x/functional_redis@v0.3.0/library/RedisResponse.js";
const container = await executeRedisCommand(
RedisRequest.set({}, "hoge", "piyo"),
redisResource
).run();
const redisResponse = safeExtract("Failed to execute the command..", container);
assert(RedisResponse.is(redisResponse));
RedisRequest[] → Resource → Task RedisResponse[]
This curried function accepts an array of RedisRequest
and, a Resource
that represents a connection to the Redis
server. The function returns a Task
of an array of
RedisResponse
.
Do not confuse this function with pipeRedisCommand
; the term "pipeline" refers to the
ability of a Redis server to parse multiple request at a time.
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import { executeRedisCommandPipeline } from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
import RedisResponse from "https://deno.land/x/functional_redis@v0.3.0/library/RedisResponse.js";
const container = await executeRedisCommandPipeline(
[
RedisRequest.set({}, "hoge", "piyo"),
RedisRequest.get("hoge")
],
redisResource
).run();
const redisResponseList = safeExtract("Failed to execute the command..", container);
assert(redisResponseList.every(RedisResponse.is));
(Resource → Task *) → Object → Task Resource
This function takes an unary function that accepts a Resource
that represents a connection to the Redis server and,
Return a Task
.
This functions will sequentially connect to the Redis server, execute the unary function and, finally disconnect.
const setHoge = createRedisSession(executeRedisCommand(RedisRequest.set({}, "hoge", "piyo")));
const container = await setHoge({ port: 6379 }).run();
safeExtract("Failed to read the response.", container);
The function resolves to a Task
of the Resource
; if you need to access the RedisResponse
, the unary function
should compose with the handler.
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import File from "https://deno.land/x/functional_io@v1.1.0/library/File.js";
import { writeFile } from "https://deno.land/x/functional_io@v1.1.0/library/fs.js";
import {
createRedisSession,
executeRedisCommand
} from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
const writeHogeToFile = createRedisSession(
compose(
chain(
compose(
writeFile({}),
concat(File.fromPath(`${Deno.cwd()}/hoge`)),
parseRedisResponse
)
),
executeRedisCommand(RedisRequest.get("hoge"))
)
);
const containerB = await writeHogeToFile({ port: 6379 }).run();
safeExtract("Failed to read the response.", containerB);
Object → RedisRequest → Task RedisResponse
This curried function accepts an object for the options of the connection and, a RedisRequest
. The return value is
a Task
of a RedisResponse
.
This is a convenience function that composes createRedisSession
and executeRedisCommand
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import { executeRedisCommandWithSession } from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
const container = await executeRedisCommandWithSession(
{ port: 6379 },
RedisRequest("SET", new Uint8Array([]), [ "hoge", "piyo" ])
).run();
safeExtract("Failed to read the response.", container);
(RedisRequest|(* → RedisRequest))[] → Resource → Task RedisResponse
This curried function accepts an array of RedisRequest
or a function that would return a RedisRequest
and, a
Resource
that represents a connection to the Redis server. The return value is a
Task
of the RedisResponse
of the last RedisRequest
.
This function will execute all Redis requests sequentially and optionally pipe the previous response into the next request.
import { safeExtract } from "https://deno.land/x/functional@v1.3.2/library/utilities.js";
import {
createRedisSession,
pipeRedisCommand
} from "https://deno.land/x/functional_redis@v0.3.0/library/client.js";
import RedisRequest from "https://deno.land/x/functional_redis@v0.3.0/library/RedisRequest.js";
const copyHogeToFuga = createRedisSession(
compose(
pipeRedisCommand(
[
RedisRequest.set({}, "hoge", "piyo"),
RedisRequest.get("hoge"),
RedisRequest.set({}, "fuga")
]
)
)
);
const container = await copyHogeToFuga({ port: 6379 }).run();
safeExtract("Failed to read the response.", container);
This example works because RedisRequest.set
is a curried function that requires 3 arguments and, returns a
RedisRequest
.
We appreciate your help! Please, read the guidelines.
MIT License
Copyright © 2020 - Sebastien Filion
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.