mancha 0.3.0 → 0.3.1

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/entities/readme.md

@@ -1,122 +0,0 @@
-# entities [![NPM version](https://img.shields.io/npm/v/entities.svg)](https://npmjs.org/package/entities) [![Downloads](https://img.shields.io/npm/dm/entities.svg)](https://npmjs.org/package/entities) [![Node.js CI](https://github.com/fb55/entities/actions/workflows/nodejs-test.yml/badge.svg)](https://github.com/fb55/entities/actions/workflows/nodejs-test.yml)
-
-Encode & decode HTML & XML entities with ease & speed.
-
-## Features
-
--   😇 Tried and true: `entities` is used by many popular libraries; eg.
-    [`htmlparser2`](https://github.com/fb55/htmlparser2), the official
-    [AWS SDK](https://github.com/aws/aws-sdk-js-v3) and
-    [`commonmark`](https://github.com/commonmark/commonmark.js) use it to
-    process HTML entities.
--   ⚡️ Fast: `entities` is the fastest library for decoding HTML entities (as
-    of April 2022); see [performance](#performance).
--   🎛 Configurable: Get an output tailored for your needs. You are fine with
-    UTF8? That'll save you some bytes. Prefer to only have ASCII characters? We
-    can do that as well!
-
-## How to…
-
-### …install `entities`
-
-    npm install entities
-
-### …use `entities`
-
-```javascript
-const entities = require("entities");
-
-// Encoding
-entities.escapeUTF8("& ü"); // "& ü"
-entities.encodeXML("& ü"); // "& ü"
-entities.encodeHTML("& ü"); // "& ü"
-
-// Decoding
-entities.decodeXML("asdf & ÿ ü '"); // "asdf & ÿ ü '"
-entities.decodeHTML("asdf & ÿ ü '"); // "asdf & ÿ ü '"
-```
-
-## Performance
-
-This is how `entities` compares to other libraries on a very basic benchmark
-(see `scripts/benchmark.ts`, for 10,000,000 iterations; **lower is better**):
-
-| Library        | Version | `decode` perf | `encode` perf | `escape` perf |
-| -------------- | ------- | ------------- | ------------- | ------------- |
-| entities       | `3.0.1` | 1.418s        | 6.786s        | 2.196s        |
-| html-entities  | `2.3.2` | 2.530s        | 6.829s        | 2.415s        |
-| he             | `1.2.0` | 5.800s        | 24.237s       | 3.624s        |
-| parse-entities | `3.0.0` | 9.660s        | N/A           | N/A           |
-
----
-
-## FAQ
-
-> What methods should I actually use to encode my documents?
-
-If your target supports UTF-8, the `escapeUTF8` method is going to be your best
-choice. Otherwise, use either `encodeHTML` or `encodeXML` based on whether
-you're dealing with an HTML or an XML document.
-
-You can have a look at the options for the `encode` and `decode` methods to see
-everything you can configure.
-
-> When should I use strict decoding?
-
-When strict decoding, entities not terminated with a semicolon will be ignored.
-This is helpful for decoding entities in legacy environments.
-
-> Why should I use `entities` instead of alternative modules?
-
-As of April 2022, `entities` is a bit faster than other modules. Still, this is
-not a very differentiated space and other modules can catch up.
-
-**More importantly**, you might already have `entities` in your dependency graph
-(as a dependency of eg. `cheerio`, or `htmlparser2`), and including it directly
-might not even increase your bundle size. The same is true for other entity
-libraries, so have a look through your `node_modules` directory!
-
-> Does `entities` support tree shaking?
-
-Yes! `entities` ships as both a CommonJS and a ES module. Note that for best
-results, you should not use the `encode` and `decode` functions, as they wrap
-around a number of other functions, all of which will remain in the bundle.
-Instead, use the functions that you need directly.
-
----
-
-## Acknowledgements
-
-This library wouldn't be possible without the work of these individuals. Thanks
-to
-
--   [@mathiasbynens](https://github.com/mathiasbynens) for his explanations
-    about character encodings, and his library `he`, which was one of the
-    inspirations for `entities`
--   [@inikulin](https://github.com/inikulin) for his work on optimized tries for
-    decoding HTML entities for the `parse5` project
--   [@mdevils](https://github.com/mdevils) for taking on the challenge of
-    producing a quick entity library with his `html-entities` library.
-    `entities` would be quite a bit slower if there wasn't any competition.
-    Right now `entities` is on top, but we'll see how long that lasts!
-
----
-
-License: BSD-2-Clause
-
-## Security contact information
-
-To report a security vulnerability, please use the
-[Tidelift security contact](https://tidelift.com/security). Tidelift will
-coordinate the fix and disclosure.
-
-## `entities` for enterprise
-
-Available as part of the Tidelift Subscription
-
-The maintainers of `entities` and thousands of other packages are working with
-Tidelift to deliver commercial support and maintenance for the open source
-dependencies you use to build your applications. Save time, reduce risk, and
-improve code health, while paying the maintainers of the exact dependencies you
-use.
-[Learn more.](https://tidelift.com/subscription/pkg/npm-entities?utm_source=npm-entities&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/dist/index.js

@@ -1,22 +0,0 @@
-const { dirname, resolve } = require('path');
-const { readdir, stat } = require('fs');
-const { promisify } = require('util');
-
-const toStats = promisify(stat);
-const toRead = promisify(readdir);
-
-module.exports = async function (start, callback) {
-	let dir = resolve('.', start);
-	let tmp, stats = await toStats(dir);
-
-	if (!stats.isDirectory()) {
-		dir = dirname(dir);
-	}
-
-	while (true) {
-		tmp = await callback(dir, await toRead(dir));
-		if (tmp) return resolve(dir, tmp);
-		dir = dirname(tmp = dir);
-		if (tmp === dir) break;
-	}
-}

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/dist/index.mjs

@@ -1,22 +0,0 @@
-import { dirname, resolve } from 'path';
-import { readdir, stat } from 'fs';
-import { promisify } from 'util';
-
-const toStats = promisify(stat);
-const toRead = promisify(readdir);
-
-export default async function (start, callback) {
-	let dir = resolve('.', start);
-	let tmp, stats = await toStats(dir);
-
-	if (!stats.isDirectory()) {
-		dir = dirname(dir);
-	}
-
-	while (true) {
-		tmp = await callback(dir, await toRead(dir));
-		if (tmp) return resolve(dir, tmp);
-		dir = dirname(tmp = dir);
-		if (tmp === dir) break;
-	}
-}

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/index.d.ts

@@ -1,3 +0,0 @@
-type Promisable<T> = T | Promise<T>;
-export type Callback = (directory: string, files: string[]) => Promisable<string | false | void>;
-export default function (directory: string, callback: Callback): Promise<string | void>;

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/license

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.com)
-
-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.

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/package.json

@@ -1,61 +0,0 @@
-{
-  "name": "escalade",
-  "version": "3.1.1",
-  "repository": "lukeed/escalade",
-  "description": "A tiny (183B to 210B) and fast utility to ascend parent directories",
-  "module": "dist/index.mjs",
-  "main": "dist/index.js",
-  "types": "index.d.ts",
-  "license": "MIT",
-  "author": {
-    "name": "Luke Edwards",
-    "email": "luke.edwards05@gmail.com",
-    "url": "https://lukeed.com"
-  },
-  "exports": {
-    ".": [
-      {
-        "import": "./dist/index.mjs",
-        "require": "./dist/index.js"
-      },
-      "./dist/index.js"
-    ],
-    "./sync": [
-      {
-        "import": "./sync/index.mjs",
-        "require": "./sync/index.js"
-      },
-      "./sync/index.js"
-    ]
-  },
-  "files": [
-    "*.d.ts",
-    "dist",
-    "sync"
-  ],
-  "modes": {
-    "sync": "src/sync.js",
-    "default": "src/async.js"
-  },
-  "engines": {
-    "node": ">=6"
-  },
-  "scripts": {
-    "build": "bundt",
-    "pretest": "npm run build",
-    "test": "uvu -r esm test -i fixtures"
-  },
-  "keywords": [
-    "find",
-    "parent",
-    "parents",
-    "directory",
-    "search",
-    "walk"
-  ],
-  "devDependencies": {
-    "bundt": "1.1.1",
-    "esm": "3.2.25",
-    "uvu": "0.3.3"
-  }
-}

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/readme.md

@@ -1,211 +0,0 @@
-# escalade [![CI](https://github.com/lukeed/escalade/workflows/CI/badge.svg)](https://github.com/lukeed/escalade/actions) [![codecov](https://badgen.now.sh/codecov/c/github/lukeed/escalade)](https://codecov.io/gh/lukeed/escalade)
-
-> A tiny (183B to 210B) and [fast](#benchmarks) utility to ascend parent directories
-
-With [escalade](https://en.wikipedia.org/wiki/Escalade), you can scale parent directories until you've found what you're looking for.<br>Given an input file or directory, `escalade` will continue executing your callback function until either:
-
-1) the callback returns a truthy value
-2) `escalade` has reached the system root directory (eg, `/`)
-
-> **Important:**<br>Please note that `escalade` only deals with direct ancestry – it will not dive into parents' sibling directories.
-
----
-
-**Notice:** As of v3.1.0, `escalade` now includes [Deno support](http://deno.land/x/escalade)! Please see [Deno Usage](#deno) below.
-
----
-
-## Install
-
-```
-$ npm install --save escalade
-```
-
-
-## Modes
-
-There are two "versions" of `escalade` available:
-
-#### "async"
-> **Node.js:** >= 8.x<br>
-> **Size (gzip):** 210 bytes<br>
-> **Availability:** [CommonJS](https://unpkg.com/escalade/dist/index.js), [ES Module](https://unpkg.com/escalade/dist/index.mjs)
-
-This is the primary/default mode. It makes use of `async`/`await` and [`util.promisify`](https://nodejs.org/api/util.html#util_util_promisify_original).
-
-#### "sync"
-> **Node.js:** >= 6.x<br>
-> **Size (gzip):** 183 bytes<br>
-> **Availability:** [CommonJS](https://unpkg.com/escalade/sync/index.js), [ES Module](https://unpkg.com/escalade/sync/index.mjs)
-
-This is the opt-in mode, ideal for scenarios where `async` usage cannot be supported.
-
-
-## Usage
-
-***Example Structure***
-
-```
-/Users/lukeed
-  └── oss
-    ├── license
-    └── escalade
-      ├── package.json
-      └── test
-        └── fixtures
-          ├── index.js
-          └── foobar
-            └── demo.js
-```
-
-***Example Usage***
-
-```js
-//~> demo.js
-import { join } from 'path';
-import escalade from 'escalade';
-
-const input = join(__dirname, 'demo.js');
-// or: const input = __dirname;
-
-const pkg = await escalade(input, (dir, names) => {
-  console.log('~> dir:', dir);
-  console.log('~> names:', names);
-  console.log('---');
-
-  if (names.includes('package.json')) {
-    // will be resolved into absolute
-    return 'package.json';
-  }
-});
-
-//~> dir: /Users/lukeed/oss/escalade/test/fixtures/foobar
-//~> names: ['demo.js']
-//---
-//~> dir: /Users/lukeed/oss/escalade/test/fixtures
-//~> names: ['index.js', 'foobar']
-//---
-//~> dir: /Users/lukeed/oss/escalade/test
-//~> names: ['fixtures']
-//---
-//~> dir: /Users/lukeed/oss/escalade
-//~> names: ['package.json', 'test']
-//---
-
-console.log(pkg);
-//=> /Users/lukeed/oss/escalade/package.json
-
-// Now search for "missing123.txt"
-// (Assume it doesn't exist anywhere!)
-const missing = await escalade(input, (dir, names) => {
-  console.log('~> dir:', dir);
-  return names.includes('missing123.txt') && 'missing123.txt';
-});
-
-//~> dir: /Users/lukeed/oss/escalade/test/fixtures/foobar
-//~> dir: /Users/lukeed/oss/escalade/test/fixtures
-//~> dir: /Users/lukeed/oss/escalade/test
-//~> dir: /Users/lukeed/oss/escalade
-//~> dir: /Users/lukeed/oss
-//~> dir: /Users/lukeed
-//~> dir: /Users
-//~> dir: /
-
-console.log(missing);
-//=> undefined
-```
-
-> **Note:** To run the above example with "sync" mode, import from `escalade/sync` and remove the `await` keyword.
-
-
-## API
-
-### escalade(input, callback)
-Returns: `string|void` or `Promise<string|void>`
-
-When your `callback` locates a file, `escalade` will resolve/return with an absolute path.<br>
-If your `callback` was never satisfied, then `escalade` will resolve/return with nothing (undefined).
-
-> **Important:**<br>The `sync` and `async` versions share the same API.<br>The **only** difference is that `sync` is not Promise-based.
-
-#### input
-Type: `string`
-
-The path from which to start ascending.
-
-This may be a file or a directory path.<br>However, when `input` is a file, `escalade` will begin with its parent directory.
-
-> **Important:** Unless given an absolute path, `input` will be resolved from `process.cwd()` location.
-
-#### callback
-Type: `Function`
-
-The callback to execute for each ancestry level. It always is given two arguments:
-
-1) `dir` - an absolute path of the current parent directory
-2) `names` - a list (`string[]`) of contents _relative to_ the `dir` parent
-
-> **Note:** The `names` list can contain names of files _and_ directories.
-
-When your callback returns a _falsey_ value, then `escalade` will continue with `dir`'s parent directory, re-invoking your callback with new argument values.
-
-When your callback returns a string, then `escalade` stops iteration immediately.<br>
-If the string is an absolute path, then it's left as is. Otherwise, the string is resolved into an absolute path _from_ the `dir` that housed the satisfying condition.
-
-> **Important:** Your `callback` can be a `Promise/AsyncFunction` when using the "async" version of `escalade`.
-
-## Benchmarks
-
-> Running on Node.js v10.13.0
-
-```
-# Load Time
-  find-up         3.891ms
-  escalade        0.485ms
-  escalade/sync   0.309ms
-
-# Levels: 6 (target = "foo.txt"):
-  find-up          x 24,856 ops/sec ±6.46% (55 runs sampled)
-  escalade         x 73,084 ops/sec ±4.23% (73 runs sampled)
-  find-up.sync     x  3,663 ops/sec ±1.12% (83 runs sampled)
-  escalade/sync    x  9,360 ops/sec ±0.62% (88 runs sampled)
-
-# Levels: 12 (target = "package.json"):
-  find-up          x 29,300 ops/sec ±10.68% (70 runs sampled)
-  escalade         x 73,685 ops/sec ± 5.66% (66 runs sampled)
-  find-up.sync     x  1,707 ops/sec ± 0.58% (91 runs sampled)
-  escalade/sync    x  4,667 ops/sec ± 0.68% (94 runs sampled)
-
-# Levels: 18 (target = "missing123.txt"):
-  find-up          x 21,818 ops/sec ±17.37% (14 runs sampled)
-  escalade         x 67,101 ops/sec ±21.60% (20 runs sampled)
-  find-up.sync     x  1,037 ops/sec ± 2.86% (88 runs sampled)
-  escalade/sync    x  1,248 ops/sec ± 0.50% (93 runs sampled)
-```
-
-## Deno
-
-As of v3.1.0, `escalade` is available on the Deno registry.
-
-Please note that the [API](#api) is identical and that there are still [two modes](#modes) from which to choose:
-
-```ts
-// Choose "async" mode
-import escalade from 'https://deno.land/escalade/async.ts';
-
-// Choose "sync" mode
-import escalade from 'https://deno.land/escalade/sync.ts';
-```
-
-> **Important:** The `allow-read` permission is required!
-
-
-## Related
-
-- [premove](https://github.com/lukeed/premove) - A tiny (247B) utility to remove items recursively
-- [totalist](https://github.com/lukeed/totalist) - A tiny (195B to 224B) utility to recursively list all (total) files in a directory
-- [mk-dirs](https://github.com/lukeed/mk-dirs) - A tiny (420B) utility to make a directory and its parents, recursively
-
-## License
-
-MIT © [Luke Edwards](https://lukeed.com)

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/sync/index.d.ts

@@ -1,2 +0,0 @@
-export type Callback = (directory: string, files: string[]) => string | false | void;
-export default function (directory: string, callback: Callback): string | void;

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/sync/index.js

@@ -1,18 +0,0 @@
-const { dirname, resolve } = require('path');
-const { readdirSync, statSync } = require('fs');
-
-module.exports = function (start, callback) {
-	let dir = resolve('.', start);
-	let tmp, stats = statSync(dir);
-
-	if (!stats.isDirectory()) {
-		dir = dirname(dir);
-	}
-
-	while (true) {
-		tmp = callback(dir, readdirSync(dir));
-		if (tmp) return resolve(dir, tmp);
-		dir = dirname(tmp = dir);
-		if (tmp === dir) break;
-	}
-}

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/escalade/sync/index.mjs

@@ -1,18 +0,0 @@
-import { dirname, resolve } from 'path';
-import { readdirSync, statSync } from 'fs';
-
-export default function (start, callback) {
-	let dir = resolve('.', start);
-	let tmp, stats = statSync(dir);
-
-	if (!stats.isDirectory()) {
-		dir = dirname(dir);
-	}
-
-	while (true) {
-		tmp = callback(dir, readdirSync(dir));
-		if (tmp) return resolve(dir, tmp);
-		dir = dirname(tmp = dir);
-		if (tmp === dir) break;
-	}
-}

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/follow-redirects/LICENSE

@@ -1,18 +0,0 @@
-Copyright 2014–present Olivier Lalonde <olalonde@gmail.com>, James Talmage <james@talmage.io>, Ruben Verborgh
-
-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.

package/examples/compiled/node_modules/mancha/examples/compiled/node_modules/follow-redirects/README.md

@@ -1,155 +0,0 @@
-## Follow Redirects
-
-Drop-in replacement for Node's `http` and `https` modules that automatically follows redirects.
-
-[![npm version](https://img.shields.io/npm/v/follow-redirects.svg)](https://www.npmjs.com/package/follow-redirects)
-[![Build Status](https://github.com/follow-redirects/follow-redirects/workflows/CI/badge.svg)](https://github.com/follow-redirects/follow-redirects/actions)
-[![Coverage Status](https://coveralls.io/repos/follow-redirects/follow-redirects/badge.svg?branch=master)](https://coveralls.io/r/follow-redirects/follow-redirects?branch=master)
-[![npm downloads](https://img.shields.io/npm/dm/follow-redirects.svg)](https://www.npmjs.com/package/follow-redirects)
-[![Sponsor on GitHub](https://img.shields.io/static/v1?label=Sponsor&message=%F0%9F%92%96&logo=GitHub)](https://github.com/sponsors/RubenVerborgh)
-
-`follow-redirects` provides [request](https://nodejs.org/api/http.html#http_http_request_options_callback) and [get](https://nodejs.org/api/http.html#http_http_get_options_callback)
- methods that behave identically to those found on the native [http](https://nodejs.org/api/http.html#http_http_request_options_callback) and [https](https://nodejs.org/api/https.html#https_https_request_options_callback)
- modules, with the exception that they will seamlessly follow redirects.
-
-```javascript
-const { http, https } = require('follow-redirects');
-
-http.get('http://bit.ly/900913', response => {
-  response.on('data', chunk => {
-    console.log(chunk);
-  });
-}).on('error', err => {
-  console.error(err);
-});
-```
-
-You can inspect the final redirected URL through the `responseUrl` property on the `response`.
-If no redirection happened, `responseUrl` is the original request URL.
-
-```javascript
-const request = https.request({
-  host: 'bitly.com',
-  path: '/UHfDGO',
-}, response => {
-  console.log(response.responseUrl);
-  // 'http://duckduckgo.com/robots.txt'
-});
-request.end();
-```
-
-## Options
-### Global options
-Global options are set directly on the `follow-redirects` module:
-
-```javascript
-const followRedirects = require('follow-redirects');
-followRedirects.maxRedirects = 10;
-followRedirects.maxBodyLength = 20 * 1024 * 1024; // 20 MB
-```
-
-The following global options are supported:
-
-- `maxRedirects` (default: `21`) – sets the maximum number of allowed redirects; if exceeded, an error will be emitted.
-
-- `maxBodyLength` (default: 10MB) – sets the maximum size of the request body; if exceeded, an error will be emitted.
-
-### Per-request options
-Per-request options are set by passing an `options` object:
-
-```javascript
-const url = require('url');
-const { http, https } = require('follow-redirects');
-
-const options = url.parse('http://bit.ly/900913');
-options.maxRedirects = 10;
-options.beforeRedirect = (options, response, request) => {
-  // Use this to adjust the request options upon redirecting,
-  // to inspect the latest response headers,
-  // or to cancel the request by throwing an error
-
-  // response.headers = the redirect response headers
-  // response.statusCode = the redirect response code (eg. 301, 307, etc.)
-
-  // request.url = the requested URL that resulted in a redirect
-  // request.headers = the headers in the request that resulted in a redirect
-  // request.method = the method of the request that resulted in a redirect
-  if (options.hostname === "example.com") {
-    options.auth = "user:password";
-  }
-};
-http.request(options);
-```
-
-In addition to the [standard HTTP](https://nodejs.org/api/http.html#http_http_request_options_callback) and [HTTPS options](https://nodejs.org/api/https.html#https_https_request_options_callback),
-the following per-request options are supported:
-- `followRedirects` (default: `true`) – whether redirects should be followed.
-
-- `maxRedirects` (default: `21`) – sets the maximum number of allowed redirects; if exceeded, an error will be emitted.
-
-- `maxBodyLength` (default: 10MB) – sets the maximum size of the request body; if exceeded, an error will be emitted.
-
-- `beforeRedirect` (default: `undefined`) – optionally change the request `options` on redirects, or abort the request by throwing an error.
-
-- `agents` (default: `undefined`) – sets the `agent` option per protocol, since HTTP and HTTPS use different agents. Example value: `{ http: new http.Agent(), https: new https.Agent() }`
-
-- `trackRedirects` (default: `false`) – whether to store the redirected response details into the `redirects` array on the response object.
-
-
-### Advanced usage
-By default, `follow-redirects` will use the Node.js default implementations
-of [`http`](https://nodejs.org/api/http.html)
-and [`https`](https://nodejs.org/api/https.html).
-To enable features such as caching and/or intermediate request tracking,
-you might instead want to wrap `follow-redirects` around custom protocol implementations:
-
-```javascript
-const { http, https } = require('follow-redirects').wrap({
-  http: require('your-custom-http'),
-  https: require('your-custom-https'),
-});
-```
-
-Such custom protocols only need an implementation of the `request` method.
-
-## Browser Usage
-
-Due to the way the browser works,
-the `http` and `https` browser equivalents perform redirects by default.
-
-By requiring `follow-redirects` this way:
-```javascript
-const http = require('follow-redirects/http');
-const https = require('follow-redirects/https');
-```
-you can easily tell webpack and friends to replace
-`follow-redirect` by the built-in versions:
-
-```json
-{
-  "follow-redirects/http"  : "http",
-  "follow-redirects/https" : "https"
-}
-```
-
-## Contributing
-
-Pull Requests are always welcome. Please [file an issue](https://github.com/follow-redirects/follow-redirects/issues)
- detailing your proposal before you invest your valuable time. Additional features and bug fixes should be accompanied
- by tests. You can run the test suite locally with a simple `npm test` command.
-
-## Debug Logging
-
-`follow-redirects` uses the excellent [debug](https://www.npmjs.com/package/debug) for logging. To turn on logging
- set the environment variable `DEBUG=follow-redirects` for debug output from just this module. When running the test
- suite it is sometimes advantageous to set `DEBUG=*` to see output from the express server as well.
-
-## Authors
-
-- [Ruben Verborgh](https://ruben.verborgh.org/)
-- [Olivier Lalonde](mailto:olalonde@gmail.com)
-- [James Talmage](mailto:james@talmage.io)
-
-## License
-
-[MIT License](https://github.com/follow-redirects/follow-redirects/blob/master/LICENSE)