Returns an instance of type Ops. It is guaranteed that for each instance isabelle, exactly one instance of Obs is created (using the ec from the first such invocation). (If you see this doc string in a class different from OperationCollection but no definition of the class Ops, treat this function as if it was private.)

Retrieves a theory located at the path path.

The path is interpreted relative to the Isabelle working directory (Isabelle.Setup.workingDirectory).

If path ends in X.thy, the theory will have the fully qualified name Draft.X.

Unqualified imports of the theory X are searched for in the same directory. Qualified imports must be findable according to the rules specified in apply(String).

The note about thread-safety from apply(String) applies for this function, too.

Retrieves a theory by its name. E.g., Theory("HOL-Analysis.Inner_Product").

name must be the fully qualified name of the theory (with exception of "global theories" which have no qualifier, e.g., Pure, Main, Complex_Main, ...).

For a theory to be found, it needs to be included in the current session image (specified via the logic parameter in Isabelle.Setup), or the directory containing its that theory's session must be configured via registerSessionDirectoriesNow. The same requirements apply to all theories imported by the theory name. (I.e., all theories required to execute name must be either in the session image or registered via registerSessionDirectoriesNow.) ROOT and ROOTS are not taken into account for finding the theories.

Note: This function invokes Thy_Info.use_thy in the Isabelle process. That function is not thread-safe. Therefore separate invocations of apply will not be executed in parallel. (Locking happens on Isabelle side, thus this function returns immediately anyway.) If you want to invoke Thy_Info.use_thy or related functions yourself, please use Theory.mutex to avoid concurrent execution with this function.

Makes sure an Ops instance for the instance isabelle is initialized. This is useful when code needs to be sure that the global initialization inside the Ops class has happened (e.g., declarations of ML types via Isabelle.executeMLCodeNow) even if it does not access any of the fields in the Ops class.

Can safely be called several times with the same isabelle and/or executionContext.

Creates a new theory that imports several other theories. (Equivalent to theory MergedTheoryName import Theory1 Theory2 Theory3 ... begin in Isabelle/Isar.)

A typical use case would be to create a context that inherits from several theories at once, E.g., Context(Theory.mergeTheories(theories=List(theory1, theory2, theory3))). (Or shorter: Context(mergeTheories(theory1, theory2, theory3)).)

A mutex (in the Isabelle process) for synchronizing non-threadsafe theory operations (e.g., Thy_Info.use_thy). This mutex is internally by operations in Theory. Use this mutex to avoid concurrent execution with the functions in Theory.

Should construct an instance of type Ops

Like registerSessionDirectoriesNow but returns a Future. Only once the future completes successfully, the session directories are guaranteed to have been registered.

Registers session directories.

Each Isabelle session (such as HOL, HOL-Library, FOL, ...) has one (or several) associated session directories that contain the theory files. (E.g., the session directory of HOL is .../src/HOL, and thus the theory HOL.List is found in .../src/HOL/List.thy.) The session directories are configured in Isabelle via the ROOT and ROOTS files. Currently, however, scala-isabelle cannot read the ROOT(S) files. Instead, session directories need to be registered with this function.

More specifically:

• When Isabelle loads a theory X.Y, and X.Y is in contained the session image (configured with Isabelle.Setup.logic), then the theory contained in the session image is used. (Conflicting session directory specifications will be ignored.)
• Otherwise, the session directory D for X is looked up, and the file D/Y.thy is read.
• Otherwise Y.thy in the current directory is opened.
• When a theory file is read, resolution of the imports of that theory is done the same way.
• One session can have several session directories, but one session directory must not be shared by several sessions

Representation of theories in ML. (See the general discussion of Context, the same things apply to Theory.)

• ML type: theory
• Representation of theory thy as an exception: E_Theory thy

Available as an implicit value by importing de.unruh.isabelle.pure.Implicits._