Clone this repo:
  1. 88e4636 Bump actions/checkout from 4.1.5 to 4.1.6 in the github-actions group (#87) by dependabot[bot] · 2 weeks ago master
  2. 1a6f2df Bump actions/checkout from 4.1.4 to 4.1.5 in the github-actions group (#86) by dependabot[bot] · 6 weeks ago
  3. f2f8a8b blast_repo fixes (#85) by Devon Carew · 6 weeks ago
  4. e6df05a Bump actions/checkout from 4.1.2 to 4.1.4 (#84) by dependabot[bot] · 7 weeks ago
  5. 2d1d69a Bump dart-lang/setup-dart from 1.6.2 to 1.6.4 (#83) by dependabot[bot] · 7 weeks ago

Dart CI pub package package publisher

The pool package exposes a Pool class which makes it easy to manage a limited pool of resources.

The easiest way to use a pool is by calling withResource. This runs a callback and returns its result, but only once there aren't too many other callbacks currently running.

// Create a Pool that will only allocate 10 resources at once. After 30 seconds
// of inactivity with all resources checked out, the pool will throw an error.
final pool = new Pool(10, timeout: new Duration(seconds: 30));

Future<String> readFile(String path) {
  // Since the call to [File.readAsString] is within [withResource], no more
  // than ten files will be open at once.
  return pool.withResource(() => new File(path).readAsString());
}

For more fine-grained control, the user can also explicitly request generic PoolResource objects that can later be released back into the pool. This is what withResource does under the covers: requests a resource, then releases it once the callback completes.

Pool ensures that only a limited number of resources are allocated at once. It‘s the caller’s responsibility to ensure that the corresponding physical resource is only consumed when a PoolResource is allocated.

class PooledFile implements RandomAccessFile {
  final RandomAccessFile _file;
  final PoolResource _resource;

  static Future<PooledFile> open(String path) {
    return pool.request().then((resource) {
      return new File(path).open().then((file) {
        return new PooledFile._(file, resource);
      });
    });
  }

  PooledFile(this._file, this._resource);

  // ...

  Future<RandomAccessFile> close() {
    return _file.close.then((_) {
      _resource.release();
      return this;
    });
  }
}