molfoundry.ruleGML#

molfoundry.ruleGML(f, name=None, invert=False, add=True)#

Build a Rule from a GML file.

When called from a script pulled in via include(), a relative f resolves relative to that script (see prefixFilename()); wrap it in a CWDPath to resolve relative to the working directory instead.

Parameters:
  • f (str | CWDPath) – The GML file path to parse.

  • name (str | None) – Human-readable name for the resulting rule, or None to leave it unnamed.

  • invert (bool) – When True, invert the rule after loading.

  • add (bool) – When True (the default), also register the rule in the global inputRules collection.

Returns:

The parsed rule.

Return type:

Rule