alef 0.110.4

Opinionated polyglot binding generator for Rust libraries
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

typedef _ComponentLoadNative = Int32 Function(Pointer<Utf8> component);
typedef _ComponentLoadDart = int Function(Pointer<Utf8> component);
typedef _ComponentStringNative = Pointer<Utf8> Function(Pointer<Utf8> component);
typedef _ComponentStringDart = Pointer<Utf8> Function(Pointer<Utf8> component);

void _ensureComponentPlatform() {
  if (Platform.isAndroid || Platform.isIOS) {
    throw UnsupportedError(
      'Downloadable native components are unsupported on mobile targets; bundle the feature profile into the application instead.',
    );
  }
}

String _takeComponentString(Pointer<Utf8> pointer) {
  if (pointer == nullptr) {
    _checkError();
    throw StateError('Native component operation returned no result');
  }
  try {
    return pointer.toDartString();
  } finally {
    _freeString(pointer.cast<Char>());
  }
}

/// Ensure a signed native component is downloaded, verified, and loaded.
void componentLoad(String component) {
  _ensureComponentPlatform();
  final nativeComponent = component.toNativeUtf8();
  try {
    final operation = _lib.lookupFunction<_ComponentLoadNative, _ComponentLoadDart>(
      '{{ prefix }}_component_load',
    );
    if (operation(nativeComponent) != 0) _checkError();
  } finally {
    calloc.free(nativeComponent);
  }
}

/// Prefetch one component, or every configured component when [component] is null.
List<String> componentPrefetch([String? component]) {
  _ensureComponentPlatform();
  final nativeComponent = component?.toNativeUtf8();
  try {
    final operation = _lib.lookupFunction<_ComponentStringNative, _ComponentStringDart>(
      '{{ prefix }}_component_prefetch',
    );
    final json = _takeComponentString(operation(nativeComponent ?? nullptr));
    return (jsonDecode(json) as List<dynamic>).cast<String>();
  } finally {
    if (nativeComponent != null) calloc.free(nativeComponent);
  }
}

/// Return `missing`, `cached:<path>`, or `loaded:<path>` for a component.
String componentStatus(String component) => _componentStringCall(
      component,
      '{{ prefix }}_component_status',
    );

/// Return the verified content-addressed cache path for a component.
String componentCachePath(String component) => _componentStringCall(
      component,
      '{{ prefix }}_component_cache_path',
    );

String _componentStringCall(String component, String symbol) {
  _ensureComponentPlatform();
  final nativeComponent = component.toNativeUtf8();
  try {
    final operation = _lib.lookupFunction<_ComponentStringNative, _ComponentStringDart>(symbol);
    return _takeComponentString(operation(nativeComponent));
  } finally {
    calloc.free(nativeComponent);
  }
}