tech.resource — techascent/tech.resource 2.0

*resource-context* clj

*resource-debug-double-free* clj

ignore clj

(ignore item)

Ignore specifically this resource.

ignore-resources clj

(ignore-resources pred)

Ignore these resources for which pred returns true and do not track them. They will not be released unless added again with track

make-resource clj

(make-resource release-fn!)

Make a releaser out of an arbitrary closure

PResource clj protocol

release-resource clj

(release-resource item)

release clj

(release item)

Release this resource and remove it from tracking. Exceptions propagate to callers.

release-current-resources clj

(release-current-resources)

(release-current-resources pred)

Release all resources matching either a predicate or all resources currently tracked. Returns any exceptions that happened during release but continues to attempt to release anything else in the resource list.

release-resource-seq clj

(release-resource-seq res-ctx & {:keys [pred] :or {pred identity}})

Release a resource context returned from return-resource-context.

return-resource-seq clj macro

(return-resource-seq & body)

Run code and return both the return value and the resources the code created. Returns: {:return-value retval :resource-seq resources}

safe-create clj

(safe-create resource-atom create-fn)

Create a resource and assign it to an atom. Allows threadsafe implementation of singelton type resources. Implementations need to take care that in the case of conflict their resource may be destroyed when the atom has not been set yet so their release-resource implementation needs to use compare-and-set! instead of reset! in order to clear the atom

track clj

(track item)

Begin tracking this resource. Resource be released when current resource context ends

with-bound-resource-seq clj macro

(with-bound-resource-seq resource-seq & body)

Run code and return both the return value and the (updated,appended) resources created. Returns: {:return-value retval :resource-seq resources}

with-resource-context clj macro

(with-resource-context & body)

Begin a new resource context. Any resources added while this context is open will be released when the context ends.