goscript 0.1.0 → 0.1.2

package/gs/testing/testing.ts

@@ -0,0 +1,399 @@
+import { mkdirSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import * as context from '@goscript/context/index.js'
+
+export type TestFunc = (t: T) => void | Promise<void>
+export type TB = T | B | F
+
+export type TestCase = {
+  name: string
+  fn: TestFunc
+}
+
+export type RunOptions = {
+  verbose?: boolean
+  count?: number
+  short?: boolean
+}
+
+export type RunResult = {
+  ok: boolean
+  failed: number
+  skipped: number
+}
+
+class TestControl extends Error {
+  public readonly kind: 'fatal' | 'skip'
+
+  constructor(kind: 'fatal' | 'skip', message: string) {
+    super(message)
+    this.kind = kind
+  }
+}
+
+let shortMode = false
+
+export class T {
+  private readonly testName: string
+  private failed = false
+  private skipped = false
+  private logs: string[] = []
+  private cleanups: (() => void | Promise<void>)[] = []
+  private tempDirs: string[] = []
+
+  constructor(name: string) {
+    this.testName = name
+  }
+
+  public Name(): string {
+    return this.testName
+  }
+
+  public Fail(): void {
+    this.failed = true
+  }
+
+  public FailNow(): never {
+    this.failed = true
+    throw new TestControl('fatal', 'test failed')
+  }
+
+  public Failed(): boolean {
+    return this.failed
+  }
+
+  public Error(...args: unknown[]): void {
+    this.Log(...args)
+    this.Fail()
+  }
+
+  public Errorf(format: string, ...args: unknown[]): void {
+    this.Log(formatMessage(format, args))
+    this.Fail()
+  }
+
+  public Fatal(...args: unknown[]): never {
+    this.Log(...args)
+    this.FailNow()
+  }
+
+  public Fatalf(format: string, ...args: unknown[]): never {
+    this.Log(formatMessage(format, args))
+    this.FailNow()
+  }
+
+  public Log(...args: unknown[]): void {
+    this.logs.push(args.map(formatValue).join(' '))
+  }
+
+  public Logf(format: string, ...args: unknown[]): void {
+    this.logs.push(formatMessage(format, args))
+  }
+
+  public Skip(...args: unknown[]): never {
+    this.Log(...args)
+    this.SkipNow()
+  }
+
+  public Skipf(format: string, ...args: unknown[]): never {
+    this.Log(formatMessage(format, args))
+    this.SkipNow()
+  }
+
+  public SkipNow(): never {
+    this.skipped = true
+    throw new TestControl('skip', 'test skipped')
+  }
+
+  public Skipped(): boolean {
+    return this.skipped
+  }
+
+  public Helper(): void {}
+
+  public Cleanup(fn: (() => void | Promise<void>) | null): void {
+    this.cleanups.push(() => {
+      if (fn == null) {
+        throw new Error('testing: nil cleanup function')
+      }
+      return fn()
+    })
+  }
+
+  public async Run(name: string, fn: TestFunc): Promise<boolean> {
+    const child = new T(this.testName + '/' + name)
+    try {
+      await fn(child)
+    } catch (err) {
+      if (err instanceof TestControl && err.kind === 'skip') {
+        // A skipped subtest is still a successful Run result.
+      } else {
+        child.Fail()
+        if (!(err instanceof TestControl)) {
+          child.Log(formatValue(err))
+        }
+      }
+    }
+    try {
+      await child.runCleanups()
+    } catch (err) {
+      child.Fail()
+      if (!(err instanceof TestControl)) {
+        child.Log(formatValue(err))
+      }
+    }
+    if (child.Failed()) {
+      this.Fail()
+      child.flushLogs()
+      return false
+    }
+    return true
+  }
+
+  public TempDir(): string {
+    const path = join(
+      tmpdir(),
+      'goscript-test-' +
+        this.testName.replace(/[^A-Za-z0-9_.-]/g, '_') +
+        '-' +
+        String(this.tempDirs.length),
+    )
+    mkdirSync(path, { recursive: true })
+    this.tempDirs.push(path)
+    return path
+  }
+
+  public Parallel(): void {
+  }
+
+  public Setenv(key: string, value: string): void {
+    const proc = (globalThis as any).process as
+      | { env?: Record<string, string | undefined> }
+      | undefined
+    const env = proc?.env
+    if (env === undefined) {
+      return
+    }
+    const oldValue = env[key]
+    env[key] = value
+    this.Cleanup(() => {
+      if (oldValue === undefined) {
+        delete env[key]
+        return
+      }
+      env[key] = oldValue
+    })
+  }
+
+  public Chdir(dir: string): void {
+    const proc = (globalThis as any).process as
+      | { cwd?: () => string; chdir?: (dir: string) => void }
+      | undefined
+    if (proc?.cwd === undefined || proc.chdir === undefined) {
+      return
+    }
+    const oldDir = proc.cwd()
+    proc.chdir(dir)
+    this.Cleanup(() => {
+      proc.chdir!(oldDir)
+    })
+  }
+
+  public ArtifactDir(): string {
+    return this.TempDir()
+  }
+
+  public Attr(_key: string, _value: string): void {}
+
+  public Context(): context.Context {
+    return context.Background()
+  }
+
+  public Output(): null {
+    return null
+  }
+
+  public private(): void {}
+
+  public async runCleanups(): Promise<void> {
+    for (let i = this.cleanups.length - 1; i >= 0; i--) {
+      await this.cleanups[i]()
+    }
+  }
+
+  public flushLogs(): void {
+    for (const line of this.logs) {
+      console.log('    ' + line)
+    }
+  }
+}
+
+export class B extends T {
+  public N = 1
+
+  constructor(name = 'Benchmark') {
+    super(name)
+  }
+
+  public async Run(
+    name: string,
+    fn: (b: B) => void | Promise<void>,
+  ): Promise<boolean> {
+    const child = new B(this.Name() + '/' + name)
+    child.N = this.N
+    try {
+      await fn(child)
+    } catch (err) {
+      child.Error(err)
+    }
+    if (child.Failed()) {
+      this.Fail()
+      return false
+    }
+    return true
+  }
+
+  public StartTimer(): void {}
+
+  public StopTimer(): void {}
+
+  public ResetTimer(): void {}
+
+  public ReportAllocs(): void {}
+
+  public SetBytes(_bytes: number): void {}
+
+  public ReportMetric(_n: number, _unit: string): void {}
+
+  public RunParallel(_fn: (pb: PB) => void): void {}
+
+  public Loop(): boolean {
+    if (this.N > 0) {
+      this.N--
+      return true
+    }
+    return false
+  }
+}
+
+export class F extends T {
+  constructor(name = 'Fuzz') {
+    super(name)
+  }
+
+  public Add(..._args: unknown[]): void {}
+
+  public Fuzz(_fn: unknown): void {}
+}
+
+export class PB {
+  private remaining = 1
+
+  public Next(): boolean {
+    if (this.remaining > 0) {
+      this.remaining--
+      return true
+    }
+    return false
+  }
+}
+
+export function Short(): boolean {
+  return shortMode
+}
+
+export async function runTests(
+  packagePath: string,
+  tests: TestCase[],
+  options: RunOptions = {},
+): Promise<RunResult> {
+  const previousShortMode = shortMode
+  shortMode = options.short ?? false
+  const count = options.count ?? 1
+  let failed = 0
+  let skipped = 0
+  try {
+    for (let run = 0; run < count; run++) {
+      for (const test of tests) {
+        if (options.verbose) {
+          console.log('=== RUN   ' + test.name)
+        }
+        const t = new T(test.name)
+        const start = Date.now()
+        try {
+          await test.fn(t)
+        } catch (err) {
+          if (err instanceof TestControl && err.kind === 'skip') {
+            skipped++
+          } else {
+            t.Fail()
+            if (!(err instanceof TestControl)) {
+              t.Log(formatValue(err))
+            }
+          }
+        } finally {
+          await t.runCleanups()
+        }
+        const elapsed = ((Date.now() - start) / 1000).toFixed(2)
+        if (t.Skipped()) {
+          if (options.verbose) {
+            t.flushLogs()
+          }
+          console.log('--- SKIP: ' + test.name + ' (' + elapsed + 's)')
+          continue
+        }
+        if (t.Failed()) {
+          failed++
+          t.flushLogs()
+          console.log('--- FAIL: ' + test.name + ' (' + elapsed + 's)')
+          continue
+        }
+        if (options.verbose) {
+          t.flushLogs()
+          console.log('--- PASS: ' + test.name + ' (' + elapsed + 's)')
+        }
+      }
+    }
+    if (failed === 0) {
+      if (options.verbose) {
+        console.log('PASS')
+      }
+      return { ok: true, failed, skipped }
+    }
+    console.log('FAIL\t' + packagePath)
+    return { ok: false, failed, skipped }
+  } finally {
+    shortMode = previousShortMode
+  }
+}
+
+function formatMessage(format: string, args: unknown[]): string {
+  let index = 0
+  return format.replace(/%#v|%\+v|%q|%[vds]/g, (verb) => {
+    const value = args[index++]
+    if (verb === '%q') {
+      return JSON.stringify(String(value))
+    }
+    return formatValue(value)
+  })
+}
+
+function formatValue(value: unknown): string {
+  if (value instanceof Error) {
+    return value.message
+  }
+  if (
+    value !== null &&
+    typeof value === 'object' &&
+    'Error' in value &&
+    typeof value.Error === 'function'
+  ) {
+    return String(value.Error())
+  }
+  if (value === null) {
+    return '<nil>'
+  }
+  return String(value)
+}

package/gs/time/meta.json

@@ -1,6 +1,6 @@
 {
   "dependencies": [],
-  "asyncMethods": {
+  "asyncFunctions": {
     "Sleep": true
   }
-} 
+}

package/gs/time/time.test.ts

@@ -0,0 +1,110 @@
+import { describe, expect, it } from 'vitest'
+
+import * as $ from '@goscript/builtin/index.js'
+
+import {
+  Duration_Abs,
+  Duration_Hours,
+  Duration_Microseconds,
+  Duration_Milliseconds,
+  Duration_Minutes,
+  Duration_Nanoseconds,
+  Duration_Round,
+  Duration_Seconds,
+  Duration_String,
+  Duration_Truncate,
+  FixedZone,
+  January,
+  Microsecond,
+  Millisecond,
+  Minute,
+  NewTicker,
+  NewTimer,
+  RFC3339Nano,
+  Second,
+  Date,
+  May,
+  RFC3339,
+  Time,
+  UTC,
+} from './time.js'
+
+describe('time.Duration_String', () => {
+  it('formats common durations', () => {
+    expect(Duration_String(0)).toBe('0s')
+    expect(Duration_String(1500 * Millisecond)).toBe('1.5s')
+    expect(Duration_String(-1500 * Millisecond)).toBe('-1.5s')
+    expect(Duration_String(2 * Second)).toBe('2s')
+    expect(Duration_String(9 * Millisecond)).toBe('9ms')
+    expect(Duration_String(1500 * Microsecond)).toBe('1.5ms')
+    expect(Duration_String(1500)).toBe('1.5\u00b5s')
+    expect(Duration_String(12)).toBe('12ns')
+  })
+})
+
+describe('time.Duration methods', () => {
+  it('converts to integer and fractional units', () => {
+    expect(Duration_Nanoseconds(1500 * Microsecond)).toBe(1500000)
+    expect(Duration_Microseconds(1500 * Microsecond)).toBe(1500)
+    expect(Duration_Milliseconds(1500 * Microsecond)).toBe(1)
+    expect(Duration_Seconds(1500 * Millisecond)).toBe(1.5)
+    expect(Duration_Minutes(90 * Second)).toBe(1.5)
+    expect(Duration_Hours(90 * Minute)).toBe(1.5)
+  })
+
+  it('rounds and truncates with Go duration semantics', () => {
+    expect(Duration_Truncate(1500 * Millisecond, Second)).toBe(Second)
+    expect(Duration_Truncate(-1500 * Millisecond, Second)).toBe(-Second)
+    expect(Duration_Round(1500 * Millisecond, Second)).toBe(2 * Second)
+    expect(Duration_Round(-1500 * Millisecond, Second)).toBe(-2 * Second)
+    expect(Duration_Round(1500 * Millisecond, 0)).toBe(1500 * Millisecond)
+  })
+
+  it('returns absolute values', () => {
+    expect(Duration_Abs(2 * Second)).toBe(2 * Second)
+    expect(Duration_Abs(-2 * Second)).toBe(2 * Second)
+  })
+})
+
+describe('time constants and timers', () => {
+  it('exports RFC3339Nano', () => {
+    expect(RFC3339Nano).toBe('2006-01-02T15:04:05.999999999Z07:00')
+  })
+
+  it('exports month constants directly', () => {
+    expect(January).toBe(1)
+  })
+
+  it('delivers NewTimer values on C', async () => {
+    const timer = NewTimer(0)
+    const value = await timer.C.receive()
+
+    expect(value.Unix()).toBeGreaterThan(0)
+  })
+
+  it('delivers NewTicker values on C', async () => {
+    const ticker = NewTicker(0)
+    const value = await ticker.C.receive()
+    ticker.Stop()
+
+    expect(value.Unix()).toBeGreaterThan(0)
+  })
+})
+
+describe('time.Time.In', () => {
+  it('returns the same instant in another fixed location', () => {
+    const utc = Date(2025, May, 15, 1, 10, 42, 0, UTC)
+    const pdt = FixedZone('PDT', -7 * 60 * 60)
+
+    expect(utc.In(pdt).Format(RFC3339)).toBe('2025-05-14T18:10:42-07:00')
+    expect(utc.In($.varRef(pdt)).Format(RFC3339)).toBe(
+      '2025-05-14T18:10:42-07:00',
+    )
+  })
+
+  it('panics for nil locations', () => {
+    expect(() => new Time().In(null)).toThrow(
+      'time: missing Location in call to Time.In',
+    )
+  })
+})