ball_resolver #

Module resolver for the Ball programming language.

ball_resolver fetches, verifies, and caches Ball modules from a variety of sources -- HTTP URLs, local files, git repositories, inline literals, and language-specific package registries. All downloads are content-addressable and verified with SHA-256 integrity hashes.

Install #

dart pub add ball_resolver

Quick start #

import 'package:ball_resolver/ball_resolver.dart';

Future<void> main() async {
  final resolver = ModuleResolver();

  // Resolve an import declared inside a Ball program.
  final module = await resolver.resolve(someModuleImport);

  print('Resolved ${module.name} with ${module.functions.length} functions');
}

Supported sources #

Features #

• Integrity verification: every resolved module is hashed and compared against the import's declared SHA-256.
• Content-addressable cache: identical modules are stored once, keyed by their integrity hash.
• Registry adapters: pluggable adapters for pub, npm, and a generic RegistryBridge that handles nuget, cargo, pypi, and maven.
• Recursive resolution: resolver.resolveAll(program) inlines every transitive import into a self-contained Program.

API at a glance #

Links #

• Website: https://ball-lang.dev
• Repository: https://github.com/ball-lang/ball
• Issue tracker: https://github.com/ball-lang/ball/issues

License #

MIT