Standard library¶

The unobin standard library provides resources and actions for common tasks such as operating on files, generating identifiers, running processes, and making HTTP requests.

The current development version requires Unobin library API 1.0.

factory: {
  description: 'Writes an app config file.'

  inputs: {
    config-path: { type: string }
    app-name:    { type: string }
  }

  imports: { std: 'github.com/cloudboss/unobin-library-std' }

  resources: {
    config: std.fs-file {
      path: input.config-path
      content: @core.to-json({ app: input.app-name })
      create-directory: true
    }
  }

  outputs: {
    config-sha256: { value: resource.config.sha256 }
  }
}

Add the library to the dependency project before compiling the factory:

unobin deps get github.com/cloudboss/unobin-library-std@v0.2.1

Create a zip archive from a directory:

resources: {
  package: std.archive-zipfile {
    path: './build/app.zip'
    source-dir: './app'
    create-directory: true
    excludes: ['**/.git/**']
  }
}

Generate an identifier that remains stable until the resource is replaced:

resources: {
  suffix: std.random-id {
    byte-length: 8
    prefix: 'web-'
  }
}

outputs: {
  name: { value: resource.suffix.hex }
}

Changing byte-length, prefix, or any value in keepers replaces the resource and generates a new identifier.

Configuration¶

The standard library has no library configuration.

Reference¶

The generated reference lists every resource and action kind, its inputs, outputs, defaults, and sensitive fields.