Merge pull request #2 from httpland/beta

Beta

Author: TomokiMiyauci

CHANGELOG.md

@@ -1,3 +1,14 @@
+# [1.1.0-beta.1](https://github.com/httpland/http-utils/compare/1.0.0...1.1.0-beta.1) (2023-04-29)
+
+
+### Features
+
+* **quoted_string:** add `isQdtext` function ([dfcd316](https://github.com/httpland/http-utils/commit/dfcd3167b159f5515aed07adf97fa2a48239ce48))
+* **quoted_string:** add `isQuotedString` function ([ca5dee2](https://github.com/httpland/http-utils/commit/ca5dee2bdd585e5731c40980e3074e0ffd50a0fd))
+* **quoted_string:** add `isQuotedString` function ([3c2f5a9](https://github.com/httpland/http-utils/commit/3c2f5a9b5dda5d6042f7db51620054991f824bd6))
+* **token:** add http token utilities ([c11449f](https://github.com/httpland/http-utils/commit/c11449f772bd8e15abf51bb1ef68ff2e595ccb88))
+* **token:** improve type inference ([a2b87b9](https://github.com/httpland/http-utils/commit/a2b87b9a4759121204c65878cd152265b2c9769b))
+
 # 1.0.0 (2023-04-02)
 
 

README.md

@@ -542,6 +542,104 @@ assert(response.headers.get(header), value);
 assert(init !== response);
 ```
 
+## Tokens
+
+Compliant with
+[RFC 9110, 5.6.2. Tokens](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.2).
+
+### isTchar
+
+Whether the input is
+[tchar](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.2-2) or not.
+
+```ts
+import { isTchar } from "https://deno.land/x/http_utils@$VERSION/token.ts";
+import {
+  assert,
+  assertFalse,
+} from "https://deno.land/std@$VERSION/testing/asserts.ts";
+
+assert(isTchar("!"));
+assert(isTchar("a"));
+assert(isTchar("Z"));
+assertFalse(isTchar(""));
+```
+
+### isToken
+
+Whether the input is
+[token](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.2-2) or not.
+
+```ts
+import { isToken } from "https://deno.land/x/http_utils@$VERSION/token.ts";
+import {
+  assert,
+  assertFalse,
+} from "https://deno.land/std@$VERSION/testing/asserts.ts";
+
+assert(isToken("token"));
+assert(isToken("*!~"));
+assertFalse(isToken(""));
+```
+
+## Quoted Strings
+
+Compliant with
+[RFC 9110, 5.6.4. Quoted Strings](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4).
+
+### isQdtext
+
+Whether the input is
+[qdtext](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-2) or not.
+
+```ts
+import { isQdtext } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+import {
+  assert,
+  assertFalse,
+} from "https://deno.land/std@$VERSION/testing/asserts.ts";
+
+assert(isQdtext("\t"));
+assert(isQdtext("\xFF"));
+assertFalse(isQdtext(`"`));
+```
+
+### isQuotedPair
+
+Whether the input is
+[quoted-pair](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-4) or
+not.
+
+```ts
+import { isQuotedPair } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+import {
+  assert,
+  assertFalse,
+} from "https://deno.land/std@$VERSION/testing/asserts.ts";
+
+assert(isQuotedPair("\\\t"));
+assert(isQuotedPair("\\\xFF"));
+assertFalse(isQuotedPair("\\"));
+```
+
+### isQuotedString
+
+Whether the input is
+[quoted-string](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-2).
+
+```ts
+import { isQuotedString } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+import {
+  assert,
+  assertFalse,
+} from "https://deno.land/std@$VERSION/testing/asserts.ts";
+
+assert(isQuotedString(`""`));
+assert(isQuotedString(`"qdtext"`));
+assert(isQuotedString(`"quoted-pair"`));
+assertFalse(isQuotedString(""));
+```
+
 ## License
 
 Copyright © 2023-present [httpland](https://github.com/httpland).

_tools/publish_npm.ts

@@ -16,11 +16,12 @@ if (import.meta.main) {
   const tag = isPrerelease?.[0] ?? "latest";
 
   const pkg = makeOptions(version);
-  const result = await Deno.run({
-    cmd: ["npm", "publish", pkg.outDir, "--tag", String(tag)],
-    stdout: "piped",
-  })
-    .output();
+  const command = new Deno.Command("npm", {
+    args: ["publish", pkg.outDir, "--tag", String(tag)],
+  });
+  const result = await command.output();
 
-  console.log(new TextDecoder().decode(result));
+  if (!result.success) {
+    console.error(new TextDecoder().decode(result.stderr));
+  }
 }

deno.json

@@ -4,18 +4,12 @@
     "build:npm": "deno run -A _tools/build_npm.ts"
   },
   "fmt": {
-    "files": {
-      "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
-    }
+    "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
   },
   "lint": {
-    "files": {
-      "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
-    }
+    "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
   },
   "test": {
-    "files": {
-      "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
-    }
+    "exclude": ["CHANGELOG.md", "CODE_OF_CONDUCT.md"]
   }
 }

quoted_string.ts

@@ -0,0 +1,93 @@
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+/**
+ * ```abnf
+ * obs-text = %x80-FF
+ * qdtext   = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text
+ * ```
+ */
+const reQdtext = /^[\t \x21\x23-\x5B\x5D-\x7E\x80-\xFF]$/;
+
+/** Whether the input is [qdtext](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-2) or not.
+ *
+ * @example
+ * ```ts
+ * import { isQdtext } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+ * import {
+ *   assert,
+ *   assertFalse,
+ * } from "https://deno.land/std@$VERSION/testing/asserts.ts";
+ *
+ * assert(isQdtext("\t"));
+ * assert(isQdtext("\xFF"));
+ * assertFalse(isQdtext(`"`));
+ * ```
+ */
+export function isQdtext(input: string): boolean {
+  return reQdtext.test(input);
+}
+
+/**
+ * ```abnf
+ * obs-text = %x80-FF
+ * quoted-pair = "\" ( HTAB / SP / VCHAR / obs-text )
+ * ```
+ */
+const reQuotedPair = /^\\[\t \x21-\x7E\x80-\xFF]$/;
+
+/** [Quoted pair](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-4). */
+export type QuotedPair = `\\${string}`;
+
+/** Whether the input is [quoted-pair](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-4) or not.
+ *
+ * @example
+ * ```ts
+ * import { isQuotedPair } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+ * import {
+ *   assert,
+ *   assertFalse,
+ * } from "https://deno.land/std@$VERSION/testing/asserts.ts";
+ *
+ * assert(isQuotedPair("\\\t"));
+ * assert(isQuotedPair("\\\xFF"));
+ * assertFalse(isQuotedPair("\\"));
+ * ```
+ */
+export function isQuotedPair(input: string): input is QuotedPair {
+  return reQuotedPair.test(input);
+}
+
+/** [quoted-string](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-2). */
+export type QuotedString = `"${string}"`;
+
+/**
+ * ```abnf
+ * quoted-string  = DQUOTE *( qdtext / quoted-pair ) DQUOTE
+ * qdtext         = HTAB / SP / %x21 / %x23-5B / %x5D-7E / obs-text
+ * quoted-pair    = "\" ( HTAB / SP / VCHAR / obs-text )
+ * obs-text       = %x80-FF
+ * ```
+ */
+const reQuotedString =
+  /^"(?:[\t \x21\x23-\x5B\x5D-\x7E\x80-\xFF]|\\[\t \x21-\x7E\x80-\xFF])*?"$/;
+
+/** Whether the input is [quoted-string](https://www.rfc-editor.org/rfc/rfc9110.html#section-5.6.4-2).
+ *
+ * @example
+ * ```ts
+ * import { isQuotedString } from "https://deno.land/x/http_utils@$VERSION/quoted_string.ts";
+ * import {
+ *   assert,
+ *   assertFalse,
+ * } from "https://deno.land/std@$VERSION/testing/asserts.ts";
+ *
+ * assert(isQuotedString(`""`));
+ * assert(isQuotedString(`"qdtext"`));
+ * assert(isQuotedString(`"quoted-pair"`));
+ * assertFalse(isQuotedString(""));
+ * ```
+ */
+export function isQuotedString(input: string): input is QuotedString {
+  return reQuotedString.test(input);
+}