feat: initial release of 🍊 tangerine

Author: titanism

.commitlintrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional']
+};

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.eslintignore

@@ -0,0 +1 @@
+!.*.js

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+on:
+  - push
+  - pull_request
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+        node_version:
+          - 16
+          - 18
+    name: Node ${{ matrix.node_version }} on ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup node
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node_version }}
+      - name: Install dependencies
+        run: npm install
+      - name: Run tests
+        run: npm run test
+      - name: Run benchmarks
+        run: npm run benchmarks

.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+*.log
+.idea
+node_modules
+coverage
+.nyc_output
+locales/
+package-lock.json
+yarn.lock
+
+Thumbs.db
+tmp/
+temp/
+*.lcov
+.env

.lintstagedrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  "*.md": filenames => filenames.map(filename => `remark ${filename} -qfo`),
+  'package.json': 'fixpack',
+  '*.js': 'xo --fix'
+};

.npmrc

@@ -0,0 +1 @@
+package-lock=false

.prettierrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+  singleQuote: true,
+  bracketSpacing: true,
+  trailingComma: 'none'
+};

.remarkrc.js

@@ -0,0 +1,3 @@
+module.exports = {
+  plugins: ['preset-github']
+};

.xo-config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  prettier: true,
+  space: true,
+  extends: ['xo-lass']
+};

CNAME

@@ -0,0 +1 @@
+tangeri.ne

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Forward Email (https://forwardemail.net)
+
+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.

README.md

@@ -0,0 +1,3 @@
+module.exports = {
+  files: ['test/*.js', 'test/**/*.js']
+};

ava.config.js

@@ -0,0 +1,201 @@
+const http = require('node:http');
+const process = require('node:process');
+
+const Benchmark = require('benchmark');
+const axios = require('axios');
+const fetch = require('node-fetch');
+const fetchMock = require('fetch-mock');
+const got = require('got');
+const nock = require('nock');
+const phin = require('phin');
+const request = require('request');
+const superagent = require('superagent');
+const undici = require('undici');
+
+const PROTOCOL = process.env.BENCHMARK_PROTOCOL || 'http';
+const HOST = process.env.BENCHMARK_HOST || 'test';
+const PORT = process.env.BENCHMARK_PORT
+  ? Number.parseInt(process.env.BENCHMARK_PORT, 10)
+  : 80;
+const PATH = process.env.BENCHMARK_PATH || '/test';
+const URL = `${PROTOCOL}://${HOST}:${PORT}${PATH}`;
+
+const suite = new Benchmark.Suite();
+
+axios.defaults.baseURL = `http://${HOST}`;
+
+if (HOST === 'test') {
+  const mockAgent = new undici.MockAgent();
+
+  mockAgent
+    .get(axios.defaults.baseURL)
+    .intercept({ path: PATH })
+    .reply(200, 'ok');
+
+  undici.setGlobalDispatcher(mockAgent);
+
+  nock(axios.defaults.baseURL)
+    .persist()
+    .post(PATH)
+    .reply(200, 'ok')
+    .get(PATH)
+    .reply(200, 'ok');
+
+  fetchMock.mock(URL, 200);
+}
+
+suite.add('http.request POST request', {
+  defer: true,
+  fn(defer) {
+    const req = http.request(
+      { host: HOST, port: PORT, path: PATH, method: 'POST' },
+      (res) => {
+        res.resume().on('end', () => defer.resolve());
+      }
+    );
+    req.write('');
+    req.end();
+  }
+});
+
+suite.add('http.request GET request', {
+  defer: true,
+  fn(defer) {
+    http
+      .request({ path: PATH, host: HOST, port: PORT }, (res) => {
+        res.resume().on('end', () => defer.resolve());
+      })
+      .end();
+  }
+});
+
+suite.add('undici GET request', {
+  defer: true,
+  fn(defer) {
+    undici
+      .request(URL)
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('undici POST request', {
+  defer: true,
+  fn(defer) {
+    undici
+      .request(URL, { method: 'POST' })
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('axios GET request', {
+  defer: true,
+  fn(defer) {
+    axios
+      .get(PATH)
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('axios POST request', {
+  defer: true,
+  fn(defer) {
+    axios
+      .post(PATH)
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('got GET request', {
+  defer: true,
+  fn(defer) {
+    got
+      .get(URL, { throwHttpErrors: false, retry: 0 })
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('got POST request', {
+  defer: true,
+  fn(defer) {
+    got
+      .post(URL, { throwHttpErrors: false })
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('fetch GET request', {
+  defer: true,
+  fn(defer) {
+    fetch(URL).then(() => defer.resolve());
+  }
+});
+
+suite.add('fetch POST request', {
+  defer: true,
+  fn(defer) {
+    fetch(URL, { method: 'POST' })
+      .then(() => defer.resolve())
+      .catch(() => defer.resolve());
+  }
+});
+
+suite.add('request GET request', {
+  defer: true,
+  fn(defer) {
+    request(URL, () => defer.resolve());
+  }
+});
+
+suite.add('request POST request', {
+  defer: true,
+  fn(defer) {
+    request.post({ url: URL }, () => defer.resolve());
+  }
+});
+
+suite.add('superagent GET request', {
+  defer: true,
+  fn(defer) {
+    superagent.get(URL).end(() => defer.resolve());
+  }
+});
+
+suite.add('superagent POST request', {
+  defer: true,
+  fn(defer) {
+    superagent
+      .post(URL)
+      .send()
+      .end(() => defer.resolve());
+  }
+});
+
+suite.add('phin GET request', {
+  defer: true,
+  fn(defer) {
+    phin(URL).then(() => defer.resolve());
+  }
+});
+
+suite.add('phin POST request', {
+  defer: true,
+  fn(defer) {
+    phin({ url: URL, method: 'POST' }).then(() => defer.resolve());
+  }
+});
+
+suite.on('complete', function () {
+  console.log('Fastest is ' + this.filter('fastest').map('name'));
+});
+
+suite.on('cycle', function (event) {
+  console.log(String(event.target));
+});
+
+suite.run();