// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license. // Interfaces 100% copied from Go. // Documentation liberally lifted from them too. // Thank you! We love Go! export const EOF: unique symbol = Symbol("EOF"); export type EOF = typeof EOF; const DEFAULT_BUFFER_SIZE = 32 * 1024; // Seek whence values. // https://golang.org/pkg/io/#pkg-constants export enum SeekMode { SEEK_START = 0, SEEK_CURRENT = 1, SEEK_END = 2, } // Reader is the interface that wraps the basic read() method. // https://golang.org/pkg/io/#Reader export interface Reader { read(p: Uint8Array): Promise; } export interface SyncReader { readSync(p: Uint8Array): number | EOF; } // Writer is the interface that wraps the basic write() method. // https://golang.org/pkg/io/#Writer export interface Writer { write(p: Uint8Array): Promise; } export interface SyncWriter { writeSync(p: Uint8Array): number; } // https://golang.org/pkg/io/#Closer export interface Closer { // The behavior of Close after the first call is undefined. Specific // implementations may document their own behavior. close(): void; } // https://golang.org/pkg/io/#Seeker export interface Seeker { seek(offset: number, whence: SeekMode): Promise; } export interface SyncSeeker { seekSync(offset: number, whence: SeekMode): number; } // https://golang.org/pkg/io/#ReadCloser export interface ReadCloser extends Reader, Closer {} // https://golang.org/pkg/io/#WriteCloser export interface WriteCloser extends Writer, Closer {} // https://golang.org/pkg/io/#ReadSeeker export interface ReadSeeker extends Reader, Seeker {} // https://golang.org/pkg/io/#WriteSeeker export interface WriteSeeker extends Writer, Seeker {} // https://golang.org/pkg/io/#ReadWriteCloser export interface ReadWriteCloser extends Reader, Writer, Closer {} // https://golang.org/pkg/io/#ReadWriteSeeker export interface ReadWriteSeeker extends Reader, Writer, Seeker {} export async function copy( src: Reader, dst: Writer, options?: { bufSize?: number; } ): Promise { let n = 0; const bufSize = options?.bufSize ?? DEFAULT_BUFFER_SIZE; const b = new Uint8Array(bufSize); let gotEOF = false; while (gotEOF === false) { const result = await src.read(b); if (result === EOF) { gotEOF = true; } else { n += await dst.write(b.subarray(0, result)); } } return n; } export async function* iter( r: Reader, options?: { bufSize?: number; } ): AsyncIterableIterator { const bufSize = options?.bufSize ?? DEFAULT_BUFFER_SIZE; const b = new Uint8Array(bufSize); while (true) { const result = await r.read(b); if (result === EOF) { break; } yield b.subarray(0, result); } } export function* iterSync( r: SyncReader, options?: { bufSize?: number; } ): IterableIterator { const bufSize = options?.bufSize ?? DEFAULT_BUFFER_SIZE; const b = new Uint8Array(bufSize); while (true) { const result = r.readSync(b); if (result === EOF) { break; } yield b.subarray(0, result); } }