Class JoiningRules

Read and store joining rules.  A JoiningRules object corresponds to a
 single joining-rules source, which can be a file or a Db, in
 the form of a ( conn, cur ) pair. If a source is not supplied,
 stdin is read as a file.
If an OK- pattern is found for which there is no OK pattern,
 a ValueError is raised. The list of offending patterns is
 retained in self.missing_ok_patterns.
source specifies where the rules are to be read from. If it is
 a character string, it must be a file name. Otherwise, it represents
 a database and must a sequence whose first two elements are the
 conn and cur for the database. The third element is optional and
 if specified is the database name.

Read a joining-rules table from a DB. Source is a sequence containing a connection object and a cursor object as its first two elements and an optional database name as its third element. Assume that prior to creation of cur, "conn.row_factory = sqlite3.Row" has been called.

Return the sql for creating a smarts-rules table in the named db. This is put into a static method because the information it returns has to be accessed from places where no JoiningRules object exists.

Return the sql for creating a joining-rules table in the named db. This is put into a static method because the information it returns has to be accessed from places where no JoiningRules object exists.

Write the rules to a file, or to stdout if fname is not specified. User-supplied definitions are always written out, but unless use_def_names is True, the SMARTS are written with the defintions expanded.