Class RawLocalRustCompiler

Runs the build script in the current envionment.

Hierarchy (view full)

LocalRustCompiler
- RawLocalRustCompiler

Index

Constructors

constructor

new RawLocalRustCompiler(options?): RawLocalRustCompiler
Parameters
- Optional options: Partial<LocalRustCompiler>
Returns RawLocalRustCompiler
Inherited from LocalRustCompiler.constructor
- Defined in compile/compile.ts:131

Properties

`Optional` buildGid

buildGid?: number = ...

Owner gid that is set on build artifacts.

`Optional` buildUid

buildUid?: number = ...

Owner uid that is set on build artifacts.

caching

caching: boolean = !this.config.getFlag('FADROMA_REBUILD', ()=>false)

Whether to enable caching and reuse contracts from artifacts directory.

config

config: Config

`Readonly` id

id: string = 'local'

Unique identifier of this compiler implementation.

log

log: Core.Console

noFetch

noFetch: boolean = ...

Whether to skip any git fetch calls in the build script.

outputDir

outputDir: Directory = ...

Name of directory where build artifacts are collected.

quiet

quiet: boolean = ...

Whether the build log should be printed only on error, or always

revision

revision: string = Program.HEAD

Default Git reference from which to build sources.

runtime

runtime: string = ...

Node.js runtime that runs the build subprocess. Defaults to the same one that is running this script.

`Optional` script

script?: string = ...

The build script.

toolchain

toolchain: string = ...

Version of Rust toolchain to use.

verbose

verbose: boolean = ...

Whether the build process should print more detail to the console.

Methods

build

build(contract): Promise<CompiledCode>
Compile a single contract.
Parameters
- contract: string | Partial<RustSourceCode>
Returns Promise<CompiledCode>
Inherited from LocalRustCompiler.build
- Defined in compile/compile.ts:150

`Protected` buildBatch

buildBatch(batch, options?): Promise<Record<number, CompiledCode>>
Parameters
- batch: CompileBatch
- options: {
  buildScript?: string | Path;
  outputDir?: string;
  } = {}
  - Optional buildScript?: string | Path
  - Optional outputDir?: string
Returns Promise<Record<number, CompiledCode>>
Overrides LocalRustCompiler.buildBatch
- Defined in compile/compile.ts:301

buildMany

buildMany(contracts): Promise<CompiledCode[]>
This implementation groups the passed source by workspace and ref, in order to launch one build container per workspace/ref combination and have it build all the crates from that combination in sequence, reusing the container's internal intermediate build cache.
Parameters
- contracts: (string | Partial<RustSourceCode>)[]
Returns Promise<CompiledCode[]>
Inherited from LocalRustCompiler.buildMany
- Defined in compile/compile.ts:158

`Protected` collectBatches

collectBatches(contracts): CompileBatches
Parameters
- contracts: Partial<RustSourceCode>[]
Returns CompileBatches
Inherited from LocalRustCompiler.collectBatches
- Defined in compile/compile.ts:182

`Protected` logStart

logStart(sourcePath, sourceRef, tasks): void
Parameters
- sourcePath: string
- sourceRef: string
- tasks: Set<CompileTask>
Returns void
Inherited from LocalRustCompiler.logStart
- Defined in compile/compile.ts:286

`Protected` populateBatchResults

populateBatchResults(__namedParameters): Promise<Record<number, CompiledCode>>
Parameters
- __namedParameters: {
      outputDir: string;
      sourceRef: string;
      tasks: Set<CompileTask>;
  }
  - outputDir: string
  - sourceRef: string
  - tasks: Set<CompileTask>
Returns Promise<Record<number, CompiledCode>>
Inherited from LocalRustCompiler.populateBatchResults
- Defined in compile/compile.ts:248

`Protected` resolveSource

resolveSource(source): Partial<RustSourceCode>
Parameters
- source: string | Partial<RustSourceCode>
Returns Partial<RustSourceCode>
a fully populated RustSourceCode from the original.
Inherited from LocalRustCompiler.resolveSource
- Defined in compile/compile.ts:139

`Protected` spawn

spawn(...args): ChildProcess
Overridable for testing.
Parameters
- Rest ...args: [command: string, args: readonly string[], options: SpawnOptions]
Returns ChildProcess
- Defined in compile/compile.ts:346

`Protected` tryGetCached

tryGetCached(outputDir, __namedParameters): CompiledCode
Check if codePath exists in local artifacts cache directory. If it does, don't rebuild it but return it from there.
Parameters
- outputDir: string
- __namedParameters: Partial<RustSourceCode>
Returns CompiledCode
Inherited from LocalRustCompiler.tryGetCached
- Defined in compile/compile.ts:230

Class RawLocalRustCompiler

Hierarchy (view full)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Optional options: Partial<LocalRustCompiler>

Returns RawLocalRustCompiler

Properties

Optional buildGid

Optional buildUid

caching

config

Readonly id

log

noFetch

outputDir

quiet

revision

runtime

Optional script

toolchain

verbose

Methods

build

Parameters

contract: string | Partial<RustSourceCode>

Returns Promise<CompiledCode>

Protected buildBatch

Parameters

batch: CompileBatch

options: { buildScript?: string | Path; outputDir?: string; } = {}

Optional buildScript?: string | Path

Optional outputDir?: string

Returns Promise<Record<number, CompiledCode>>

buildMany

Parameters

contracts: (string | Partial<RustSourceCode>)[]

Returns Promise<CompiledCode[]>

Protected collectBatches

Parameters

contracts: Partial<RustSourceCode>[]

Returns CompileBatches

Protected logStart

Parameters

sourcePath: string

sourceRef: string

tasks: Set<CompileTask>

Returns void

Protected populateBatchResults

Parameters

__namedParameters: { outputDir: string; sourceRef: string; tasks: Set<CompileTask>; }

outputDir: string

sourceRef: string

tasks: Set<CompileTask>

Returns Promise<Record<number, CompiledCode>>

Protected resolveSource

Parameters

source: string | Partial<RustSourceCode>

Returns Partial<RustSourceCode>

Protected spawn

Parameters

Rest ...args: [command: string, args: readonly string[], options: SpawnOptions]

Returns ChildProcess

Protected tryGetCached

Parameters

outputDir: string

__namedParameters: Partial<RustSourceCode>

Returns CompiledCode

Settings

Member Visibility

Theme

On This Page

`Optional` options: Partial<LocalRustCompiler>

`Optional` buildGid

`Optional` buildUid

`Readonly` id

`Optional` script

`Protected` buildBatch

options: {
buildScript?: string | Path;
outputDir?: string;
} = {}

`Optional` buildScript?: string | Path

`Optional` outputDir?: string

`Protected` collectBatches

`Protected` logStart

`Protected` populateBatchResults

__namedParameters: {
outputDir: string;
sourceRef: string;
tasks: Set<CompileTask>;
}

`Protected` resolveSource

`Protected` spawn

`Rest` ...args: [command: string, args: readonly string[], options: SpawnOptions]

`Protected` tryGetCached