AssetResource class abstract

An abstract representation of a resource that wraps either:

• Raw textual content (e.g., JSON, YAML, Dart code, properties).
• An Asset object.

This abstraction allows working uniformly with both inline content and file-based assets. The actual implementation is provided by the private class _AssetResource.

Example: Creating from raw content

final resource = AssetResource('{ "name": "example" }');
print(resource.source); // prints the JSON string

Example: Creating from an Asset

final asset = FileAsset('/path/to/config.yaml');
final resource = AssetResource(asset);
print(resource.source); // prints the FileAsset instance

Extension Strategies

Developers can plug in custom extension strategies to determine the file extension dynamically:

AssetResource.registerExtensionStrategy((source) {
  if (source is String && source.endsWith('.conf')) {
    return 'conf';
  }
  return null;
});

Content Detectors

Similarly, content detectors decide whether a String is inline content or a path:

AssetResource.registerContentDetector((source) {
  if (source is String && source.contains('{')) return true;
  return false;
});