silx.resources: Project resources access

Access project’s data and documentation files.

All access to data and documentation files MUST be made through the functions of this modules to ensure access across different distribution schemes:

• Installing from source or from wheel

• Installing package as a zip (through the use of pkg_resources)

• Linux packaging willing to install data files (and doc files) in alternative folders. In this case, this file must be patched.

• Frozen fat binary application using silx (frozen with cx_Freeze or py2app). This needs special care for the resource files in the setup:

  • With cx_Freeze, add silx/resources to include_files:

    import silx.resources
    silx_include_files = (os.path.dirname(silx.resources.__file__),
                          os.path.join('silx', 'resources'))
    setup(...
          options={'build_exe': {'include_files': [silx_include_files]}}
          )
    

  • With py2app, add silx in the packages list of the py2app options:

    setup(...
          options={'py2app': {'packages': ['silx']}}
          )
    

register_resource_directory(name, package_name, forced_path=None)

Register another resource directory to the available list.

By default only the directory “silx” is available.

New in version 0.6.

Parameters

• name (str) – Name of the resource directory. It is used on the resource name to specify the resource directory to use. The resource “silx:foo.png” will use the “silx” resource directory.

• package_name (str) – Python name of the package containing resources. For example “silx.resources”.

• forced_path (str) – Path containing the resources. If specified pkg_resources nor package_name will be used For example “silx.resources”.

Raises

ValueError – If the resource directory name already exists.

list_dir(resource)

List the content of a resource directory.

Result are not prefixed by the resource name.

The resource name can be prefixed by the name of a resource directory. For example “silx:foo.png” identify the resource “foo.png” from the resource directory “silx”. See also register_resource_directory().

Parameters

resource (str) – Name of the resource directory to list

Returns

list of name contained in the directory

Return type

List

is_dir(resource)

True is the resource is a resource directory.

The resource name can be prefixed by the name of a resource directory. For example “silx:foo.png” identify the resource “foo.png” from the resource directory “silx”. See also register_resource_directory().

Parameters

resource (str) – Name of the resource

Return type

bool

exists(resource)

True is the resource exists.

Parameters

resource (str) – Name of the resource

Return type

bool

resource_filename(resource)

Return filename corresponding to resource.

The existence of the resource is not checked.

The resource name can be prefixed by the name of a resource directory. For example “silx:foo.png” identify the resource “foo.png” from the resource directory “silx”. See also register_resource_directory().

Parameters

resource (str) – Resource path relative to resource directory using ‘/’ path separator. It can be either a file or a directory.

Raises

ValueError – If the resource name uses an unregistred resource directory name

Returns

Absolute resource path in the file system

Return type

str