sparc.client package

Subpackages

• sparc.client.services package
  • Submodules
    • sparc.client.services.o2sparc module
      • O2SparcService
      • O2SparcSolver
    • sparc.client.services.pennsieve module
      • PennsieveService
    • sparc.client.services.metadata module
      • MetadataService
    • Module contents

Submodules

sparc.client.client module

class sparc.client.client.SparcClient(config_file: str = 'config.ini', connect: bool = True)

Bases: object

The main class of the sparc.client library.

This class is used to connect existing modules located in <projectbase>/services folder

Parameters:

config_filestr

The location of the file in INI format that is used to extract configuration variables. The config file needs to define a [global] section with the name of the default profile (in square brackets as well) which holds environmental variables used by the modules. Refer to configparser for further details.

connectbool (True)

Calls connect() method of each of the modules. By default during initialization all modules are initialized and ready to be used, unless connect is set to False.

Attributes:

module_nameslist

Stores the list of modules that are automatically loaded from the <projectbase>/services directory.

configConfigParser

Config used for sparc.client

Methods:

add_module(path, config, connect):

Adds and optionally connects to a module in a given path with configuration variables defined in config.

connect():

Connects all the modules by calling their connect() functions.

get_config():

Returns config used by sparc.client

add_module(paths: str | list[str], config: dict | SectionProxy | None = None, connect: bool = True) → None

Adds and optionally connects to a module in a given path with configuration variables defined in config.

Parameters:

pathsstr or list[str]

a path to the module

configdict or configparser.SectionProxy

a dictionary (or Section of the config file parsed by ConfigParser) with the configuration variables

connectbool

determines if the module should auto-connect

connect() → bool

Connects each of the modules loaded into self.module_names

get_config() → ConfigParser

Returns config for sparc.client

Module contents

class sparc.client.SparcClient(config_file: str = 'config.ini', connect: bool = True)

Bases: object

The main class of the sparc.client library.

This class is used to connect existing modules located in <projectbase>/services folder

Parameters:

config_filestr

The location of the file in INI format that is used to extract configuration variables. The config file needs to define a [global] section with the name of the default profile (in square brackets as well) which holds environmental variables used by the modules. Refer to configparser for further details.

connectbool (True)

Calls connect() method of each of the modules. By default during initialization all modules are initialized and ready to be used, unless connect is set to False.

Attributes:

module_nameslist

Stores the list of modules that are automatically loaded from the <projectbase>/services directory.

configConfigParser

Config used for sparc.client

Methods:

add_module(path, config, connect):

Adds and optionally connects to a module in a given path with configuration variables defined in config.

connect():

Connects all the modules by calling their connect() functions.

get_config():

Returns config used by sparc.client

add_module(paths: str | list[str], config: dict | SectionProxy | None = None, connect: bool = True) → None

Adds and optionally connects to a module in a given path with configuration variables defined in config.

Parameters:

pathsstr or list[str]

a path to the module

configdict or configparser.SectionProxy

a dictionary (or Section of the config file parsed by ConfigParser) with the configuration variables

connectbool

determines if the module should auto-connect

connect() → bool

Connects each of the modules loaded into self.module_names

get_config() → ConfigParser

Returns config for sparc.client