supported_migration_targets

Julia

supported_migration_targets(source_version::AbstractString)

supported_migration_targets(source_version::AbstractString) -> Vector{String}

The schema versions source_version can be migrated to.

• A version on the additive line 1.0.0 … <current schema version> → [SCHEMA_VERSION] (a no-op marker bump to the current schema).
• Everything else — including EVERY 0.x version, which 1.0.0’s clean break puts out of reach of a marker bump, plus newer-than-current, other majors, and malformed strings — → String[].

Named without the get prefix its TypeScript twin (getSupportedMigrationTargets) carries; the behaviour is identical.

Examples

supported_migration_targets("1.0.0")   # ["1.0.0"]
supported_migration_targets("0.9.0")   # String[]  — the clean break
supported_migration_targets("2.0.0")   # String[]
supported_migration_targets("1.0")     # String[]  — malformed

Source

TypeScript

Exported as getSupportedMigrationTargets and supportedMigrationTargets. Both names refer to the same operation.

getSupportedMigrationTargets

function getSupportedMigrationTargets(sourceVersion: string): string[]

Deprecated. Use supportedMigrationTargets.

Deprecated. Use supportedMigrationTargets . The canonical name is supported_migration_targets, with no get prefix. Kept for one minor per API_SPEC.md §10; removed at the next major.

Source

supportedMigrationTargets

function supportedMigrationTargets(sourceVersion: string): string[]

Get the list of schema versions that a given source version can migrate to.

• any version on the additive line 1.0.0 … <current schema version> → [SCHEMA_VERSION] (a no-op marker bump to the current schema).
• everything else — including EVERY 0.x version, which 1.0.0’s clean break puts out of reach of a marker bump — → [].

Source

Python

supported_migration_targets(from_version: str) -> list[str]

The schema versions from_version can migrate to.

• a version on the additive line 1.0.0 … <current schema version> → [SCHEMA_VERSION] (a no-op marker bump to the current schema);
• everything else — including EVERY 0.x version, which 1.0.0’s clean break puts out of reach of a marker bump — → [].

The canonical name of TypeScript’s getSupportedMigrationTargets: the harmonized API drops the get prefix.

Source

Rust

Exported as get_supported_migration_targets and supported_migration_targets. Both names refer to the same operation.

get_supported_migration_targets

pub fn get_supported_migration_targets(from_version: &str) -> Vec<String>

Deprecated since 0.2.0: renamed to supported_migration_targets (API_SPEC.md phase-6 G-2)

Deprecated alias of supported_migration_targets .

Every binding spells this supported_migration_targets (API_SPEC.md §8). This alias is deprecated and will be removed at the next major (API_SPEC.md §10).

Source · Rust docs

supported_migration_targets

pub fn supported_migration_targets(from_version: &str) -> Vec<String>

The schema versions from_version can be migrated to.

• any version on the additive line 1.0.0 … <current schema version> → [SCHEMA_VERSION] (a no-op marker bump to the current schema);
• everything else — including EVERY 0.x version, which 1.0.0’s clean break puts out of reach of a marker bump, plus newer-than-current, other majors and malformed strings — → an empty vector.

This is the single source of truth for the whole module: can_migrate is membership in this list and migrate refuses whatever it omits.

Source · Rust docs

Example (migrate)

// decay.esm is written at format 1.0.0; the current format is a newer
// 1.x, reached by a version-marker bump with no structural change.
assert_eq!(doc.esm, "1.0.0");
assert_eq!(supported_migration_targets(&doc.esm), [SCHEMA_VERSION]);
assert!(can_migrate(&doc.esm, SCHEMA_VERSION));
let migrated = migrate(&doc, SCHEMA_VERSION)?;
assert_eq!(migrated.esm, SCHEMA_VERSION);

// A 0.x document is out of reach: 1.0.0 was a clean break.
assert!(!can_migrate("0.9.0", SCHEMA_VERSION));

From docs/api/examples/rust/load.rs

Go

func SupportedMigrationTargets(sourceVersion string) []string

SupportedMigrationTargets returns the schema versions sourceVersion can be migrated to.

• any version on the additive line 1.0.0 … <current schema version> → SchemaVersion (a no-op marker bump to the current schema).
• everything else — including EVERY 0.x version, which 1.0.0’s clean break puts out of reach of a marker bump — → an empty slice.

The canonical name drops TypeScript’s get prefix.

Source · Go docs