Source code for pbxplore.demo

"""
Demonstration files --- :mod:`pbxplore.demo`
============================================

PBxplore bundles a set of demonstration files. This module ease the access to
these files.

The path to the demonstration files is stored in :const:`DEMO_DATA_PATH`. This
constant can be accessed as :const:`pbxplore.demo.DEMO_DATA_PATH`, or as
:const:`pbxplore.DEMO_DATA_PATH`.

A list of the available demonstration files is available with the
:func:`list_demo_files` function. The same list with absolute path instead of
file names is provided by :func:`list_demo_files_absolute`.

.. autofunction:: pbxplore.demo.list_demo_files

.. autofunction:: pbxplore.demo.list_demo_files_absolute
"""

import os

DEMO_DATA_PATH=os.path.abspath(os.path.dirname(__file__))


[docs]def list_demo_files(): """ List the names of the bundled demo files File names starting with _ or . are not listed. This allows to omit __init__.py, and hiden files. """ return [demo_file for demo_file in os.listdir(DEMO_DATA_PATH) if not demo_file[0] in '_.']
[docs]def list_demo_files_absolute(): """ List the absolute path to the bundled demo files File names starting with _ or . are not listed. This allows to omit __init__.py, and hiden files. """ return [os.path.join(DEMO_DATA_PATH, demo_file) for demo_file in list_demo_files()]