Remove ensure and assume functions

Uses must replace `ensure` or `assume` functions to corresponding
specific functions like `ensureString` or `assumeNumber`, etc.

Author: lambdalisue

README.md

@@ -94,7 +94,6 @@ if (isLike({ foo: "", bar: 0 }, e)) {
 The `unknownutil` provides the following ensure functions which will raise
 `EnsureError` when a given `x` is not expected type.
 
-- `ensure<T>(x: unknown, pred: Predicate<T>, message?: string): assert x is T`
 - `ensureString(x: unknown): assert x is string`
 - `ensureNumber(x: unknown): assert x is number`
 - `ensureBoolean(x: unknown): assert x is boolean`
@@ -151,7 +150,6 @@ ensureLike({ foo: "", bar: 0 }, b); // Now 'b' is '{foo: string, bar: number}'
 The `unknownutil` provides the following assume functions which returns a given
 `x` as is or raise `EnsureError` when that is not expected type.
 
-- `assume<T>(x: unknown, pred: Predicate<T>, message?: string): T`
 - `assumeString(x: unknown): string`
 - `assumeNumber(x: unknown): number`
 - `assumeBoolean(x: unknown): boolean`

assume.ts

@@ -1,6 +1,5 @@
 import { Predicate } from "./is.ts";
 import {
-  ensure,
   ensureArray,
   ensureBoolean,
   ensureFunction,
@@ -13,18 +12,6 @@ import {
   ensureUndefined,
 } from "./ensure.ts";
 
-/**
- * Return `x` as-is if `x` is expected type or raise an `EnsureError` when it's not.
- */
-export function assume<T>(
-  x: unknown,
-  pred: Predicate<T>,
-  message = "The value is not expected type",
-): T {
-  ensure(x, pred, message);
-  return x;
-}
-
 /**
  * Return `x` as-is if `x` is string or raise an `EnsureError` when it's not.
  */

assume_test.ts

@@ -1,6 +1,5 @@
 import { assertEquals, assertThrows } from "./deps_test.ts";
 import {
-  assume,
   assumeArray,
   assumeBoolean,
   assumeFunction,
@@ -14,15 +13,6 @@ import {
 } from "./assume.ts";
 import { isBoolean, isNumber, isString } from "./is.ts";
 
-Deno.test("assume returns the value when pred return true", () => {
-  assertEquals(assume("a", isString), "a");
-  assertEquals(assume(0, isNumber), 0);
-});
-Deno.test("assume throws error when pred return false", () => {
-  assertThrows(() => assume("a", isNumber));
-  assertThrows(() => assume(0, isString));
-});
-
 Deno.test("assumeString returns the value when the value is string", () => {
   assertEquals(assumeString("Hello"), "Hello");
 });

ensure.ts

@@ -24,10 +24,7 @@ export class EnsureError extends Error {
   }
 }
 
-/**
- * Ensure if `x` is expected type by raising an `EnsureError` when it's not.
- */
-export function ensure<T>(
+function ensure<T>(
   x: unknown,
   pred: Predicate<T>,
   message = "The value is not expected type",

ensure_test.ts

@@ -1,6 +1,5 @@
 import { assertThrows } from "./deps_test.ts";
 import {
-  ensure,
   ensureArray,
   ensureBoolean,
   ensureFunction,
@@ -14,15 +13,6 @@ import {
 } from "./ensure.ts";
 import { isBoolean, isNumber, isString } from "./is.ts";
 
-Deno.test("ensure does nothing when pred return true", () => {
-  ensure("a", isString);
-  ensure(0, isNumber);
-});
-Deno.test("ensure throws error when pred return false", () => {
-  assertThrows(() => ensure("a", isNumber));
-  assertThrows(() => ensure(0, isString));
-});
-
 Deno.test("ensureString does nothing on string", () => {
   ensureString("Hello");
 });