@effect-ts/system
Version:
Effect-TS is a zero dependency set of libraries to write highly productive, purely functional TypeScript at scale.
53 lines (51 loc) • 2.15 kB
JavaScript
// ets_tracing: off
import { bracketExit_ } from "./bracketExit.mjs";
/**
* When this effect represents acquisition of a resource (for example,
* opening a file, launching a thread, etc.), `bracket` can be used to ensure
* the acquisition is not interrupted and the resource is always released.
*
* The function does two things:
*
* 1. Ensures this effect, which acquires the resource, will not be
* interrupted. Of course, acquisition may fail for internal reasons (an
* uncaught exception).
* 2. Ensures the `release` effect will not be interrupted, and will be
* executed so long as this effect successfully acquires the resource.
*
* In between acquisition and release of the resource, the `use` effect is
* executed.
*
* If the `release` effect fails, then the entire effect will fail even
* if the `use` effect succeeds. If this fail-fast behavior is not desired,
* errors produced by the `release` effect can be caught and ignored.
*
* @ets_data_first bracket_
*/
export function bracket(use, release, __trace) {
return acquire => bracket_(acquire, use, release, __trace);
}
/**
* When this effect represents acquisition of a resource (for example,
* opening a file, launching a thread, etc.), `bracket` can be used to ensure
* the acquisition is not interrupted and the resource is always released.
*
* The function does two things:
*
* 1. Ensures this effect, which acquires the resource, will not be
* interrupted. Of course, acquisition may fail for internal reasons (an
* uncaught exception).
* 2. Ensures the `release` effect will not be interrupted, and will be
* executed so long as this effect successfully acquires the resource.
*
* In between acquisition and release of the resource, the `use` effect is
* executed.
*
* If the `release` effect fails, then the entire effect will fail even
* if the `use` effect succeeds. If this fail-fast behavior is not desired,
* errors produced by the `release` effect can be caught and ignored.
*/
export function bracket_(acquire, use, release, __trace) {
return bracketExit_(acquire, use, release, __trace);
}
//# sourceMappingURL=bracket.mjs.map