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).

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.

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.

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

(E_Theory is automatically declared when needed by the ML code in this package. If you need to ensure that it is defined for compiling own ML code, invoke Theory.init.)

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