Initializes a new runnable container for the given directory.

parent is the parent runnable container. You don't normally need to specify it. Prefer to call #child on the parent instead.

transparent specifies whether the container is transparent, see #transparent?.

Returns the absolute path of the directory of this container.

Introduces a filter for the constituent runnables of this container. filter should decide whether to accept (true) or reject (false) a runnable.

warn specifies whether the RunnableIgnored signal should be sent if filter rejects a runnable.

Inserts runnable after all other runnables in this container.

Inserts the entire array of runnables after all other runnables in this container.

Returns whether this container's filters allow it to contain the given runnable.

Builds and returns a child of this container.

Optionally, the directory of the child can be provided. Otherwise, the directory of this container will be used.

Additionally, you can specify whether the child should be transparent (see #transparent?).

Creates a RunnableDir, RunnableScript, or RunnableSharedObject depending on what datum points to and on its extension.

ancestor is set as the ancestor of the created runnable.

Returns nil if datum does not exist, or if there is no appropriate classification.

If datum is a capability, creates and returns an appropriate RunnableCapability object. Otherwise, tries to convert datum to an absolute, normalized path, and then passes the path to the other #classify?(datum : Path, ancestor : Ancestor?).

Returns nil if nothing succeeded, deeming datum unclassifiable.

Returns an array with contained runnables. If none, returns an array with self.

Yields constituent runnables.

Recursively yields file and directory paths in this container.

Recursively yields file and directory paths in this container.

Yields all paths matching selector in lexicographic order. The paths are initially taken from the directory of this container. See Disk#glob for details.

Returns whether this container is empty, i.e., holds has no constituent runnables.

Returns the RunnableEnvironment assigned to this container.

Recursively replaces each runnable in this container with its #constituents. Most notably, rewrites transparent containers to their constituents.

Returns whether env is this container's environment.

Returns whether this container includes the given runnable.

Returns a set of all paths (file, directory, etc. paths) in this container, including those in nested containers.

Inserts runnable before all other runnables in this container.

Calls fn with each nonterminal and the container it's from, recurses into nested RunnableContainers.

Calls fn with each nonterminal and the container it's from, recurses into nested RunnableContainers.

Replaces all non-terminal (see Runnable::Terminal) runnables with the result of fn. Recurses into nested containers.

Replaces all non-terminal (see Runnable::Terminal) runnables with the result of fn. Recurses into nested containers.

Accepts only those runnable in this container and in all nested containers for which fn returns true.

Runnables for which fn returned false are mutably deleted.

Accepts only those runnable in this container and in all nested containers for which fn returns true.

Runnables for which fn returned false are mutably deleted.

Replaces pattern runnable with the replacement runnable in this container only (i.e., does not recurse).

Replaces pattern runnable with multiple replacement runnables in this container only (i.e. does not recurse). Their order will be the same as that in replacement.

Runnables from replacement that this container cannot contain are left out.

Communicates with this container's environment permission server in order to determine whether the use dependency should be allowed to self.

Rewrites this container until there is no point in doing so. That is, until R (current) and R' (rewritten) are equal: R = R'.

Quite obviously this method is susceptible to cyclic expansion when the length of the cycle is higher than, well, zero (e.g. R -> R' -> R -> ...). So please don't do that nor cause that!

Further specializes this runnable. Appends the specialized runnable to (or interacts in some other way with) container. The latter is assumed to be incomplete (or partially complete, which is really the same thing).

root is the runnable root object. It is mainly used for flags and thorough rewriting.

Builds and returns a ResolutionSet with resolutions from this container and all nested containers.

You must call this after #flatten!. Otherwise, the resulting ResolutionSet will be underpopulated with dependencies due to transparent containers standing in the way.

deps is a set of dependencies that all resolutions in the resulting set should have, regardless of nesting. Beware that it is mutated.

Returns whether this container is transparent.

Transparent containers get "merged" with their parent during flattening, for example. At the same time opaque continers remain still and unbreakable. The #constituents of a transparent container are plainly visible & accessible; those of an opaque one are not.

Transparent containers are transparent to filter inheritance. This means that transparent containers can inherit filters of their parent containers. Opaque containers are opaque to filter inheritance. Therefore, transparent containers won't inherit filters of containers above an opaque container, and opaque containers themselves won't inherit anything from parent container(s).