sqliteschema 0.9.5

A Python library to dump table schema of a SQLite database file.

sqliteschema

Table of Contents

• sqliteschema

• Summary

• Installation

• Usage

  • Extract SQLite Schema

  • Dump SQLite Schema as Table Text

  • Dump Schema as Text

• Dependencies

  • Test dependencies

Summary

A Python library to dump table schema of a SQLite database file.

Installation

pip install sqliteschema

Usage

Full example can be found at examples/get_table_schema.py

Extract SQLite Schema

Sample Code:

for verbosity_level in range(2):
    print("----- get_table_schema method: verbosity_level={} -----".format(
        verbosity_level))
    extractor = sqliteschema.SqliteSchemaExtractor(
        sqlite_db_path, verbosity_level=verbosity_level,
        output_format="table")
    for table_name in extractor.get_table_name_list():
        print("{:s} {}".format(
            table_name,
            extractor.get_table_schema(table_name)))
    print()

Output:

----- get_table_schema method: verbosity_level=0 -----
sampletable0 ['attr_a', 'attr_b']
sampletable1 ['foo', 'bar', 'hoge']
constraints ['primarykey_id', 'notnull_value', 'unique_value']

----- get_table_schema method: verbosity_level=1 -----
sampletable0 OrderedDict([('attr_a', 'INTEGER'), ('attr_b', 'INTEGER')])
sampletable1 OrderedDict([('foo', 'INTEGER'), ('bar', 'REAL'), ('hoge', 'TEXT')])
constraints OrderedDict([('primarykey_id', 'INTEGER'), ('notnull_value', 'REAL'), ('unique_value', 'INTEGER')])

Dump SQLite Schema as Table Text

Sample Code:

for verbosity_level in range(2):
    print("----- dump schema table: verbosity_level={} -----".format(
        verbosity_level))
    extractor = sqliteschema.SqliteSchemaExtractor(
        sqlite_db_path, verbosity_level=verbosity_level,
        output_format="table")
    print(extractor.dumps())

Output:

----- dump schema table: verbosity_level=0 -----
.. table:: sampletable0

    +--------------+---------+
    |Attribute name|Data type|
    +==============+=========+
    |attr_a        |INTEGER  |
    +--------------+---------+
    |attr_b        |INTEGER  |
    +--------------+---------+

.. table:: sampletable1

    +--------------+---------+
    |Attribute name|Data type|
    +==============+=========+
    |foo           |INTEGER  |
    +--------------+---------+
    |bar           |REAL     |
    +--------------+---------+
    |hoge          |TEXT     |
    +--------------+---------+

.. table:: constraints

    +--------------+---------+
    |Attribute name|Data type|
    +==============+=========+
    |primarykey_id |INTEGER  |
    +--------------+---------+
    |notnull_value |REAL     |
    +--------------+---------+
    |unique_value  |INTEGER  |
    +--------------+---------+


----- dump schema table: verbosity_level=1 -----
.. table:: sampletable0 (2 records)

    +--------------+---------+-----------+--------+------+-----+
    |Attribute name|Data type|Primary key|Not NULL|Unique|Index|
    +==============+=========+===========+========+======+=====+
    |attr_a        |INTEGER  |           |        |      |     |
    +--------------+---------+-----------+--------+------+-----+
    |attr_b        |INTEGER  |           |        |      |     |
    +--------------+---------+-----------+--------+------+-----+

.. table:: sampletable1 (2 records)

    +--------------+---------+-----------+--------+------+-----+
    |Attribute name|Data type|Primary key|Not NULL|Unique|Index|
    +==============+=========+===========+========+======+=====+
    |foo           |INTEGER  |           |        |      |X    |
    +--------------+---------+-----------+--------+------+-----+
    |bar           |REAL     |           |        |      |     |
    +--------------+---------+-----------+--------+------+-----+
    |hoge          |TEXT     |           |        |      |X    |
    +--------------+---------+-----------+--------+------+-----+

.. table:: constraints (0 records)

    +--------------+---------+-----------+--------+------+-----+
    |Attribute name|Data type|Primary key|Not NULL|Unique|Index|
    +==============+=========+===========+========+======+=====+
    |primarykey_id |INTEGER  |X          |        |      |     |
    +--------------+---------+-----------+--------+------+-----+
    |notnull_value |REAL     |           |X       |      |     |
    +--------------+---------+-----------+--------+------+-----+
    |unique_value  |INTEGER  |           |        |X     |     |
    +--------------+---------+-----------+--------+------+-----+

Dump Schema as Text

Sample Code:

for verbosity_level in range(6):
    print("----- dump schema text: verbosity_level={} -----".format(
        verbosity_level))
    extractor = sqliteschema.SqliteSchemaExtractor(
        sqlite_db_path, verbosity_level=verbosity_level,
        output_format="text")
    print(extractor.dumps())

Output:

----- dump schema text: verbosity_level=0 -----
sampletable0
sampletable1
constraints

----- dump schema text: verbosity_level=1 -----
sampletable0 (attr_a, attr_b)
sampletable1 (foo, bar, hoge)
constraints (primarykey_id, notnull_value, unique_value)

----- dump schema text: verbosity_level=2 -----
sampletable0 (attr_a INTEGER, attr_b INTEGER)
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)
constraints (primarykey_id INTEGER, notnull_value REAL, unique_value INTEGER)

----- dump schema text: verbosity_level=3 -----
sampletable0 (attr_a INTEGER, attr_b INTEGER)
sampletable1 (foo INTEGER, bar REAL, hoge TEXT)
constraints (primarykey_id INTEGER PRIMARY KEY, notnull_value REAL NOT NULL, unique_value INTEGER UNIQUE)

----- dump schema text: verbosity_level=4 -----
sampletable0 (
    attr_a INTEGER,
    attr_b INTEGER
)

sampletable1 (
    foo INTEGER,
    bar REAL,
    hoge TEXT
)

constraints (
    primarykey_id INTEGER PRIMARY KEY,
    notnull_value REAL NOT NULL,
    unique_value INTEGER UNIQUE
)


----- dump schema text: verbosity_level=5 -----
sampletable0 (
    attr_a INTEGER,
    attr_b INTEGER
)

sampletable1 (
    foo INTEGER,
    bar REAL,
    hoge TEXT
)
CREATE INDEX sampletable1_foo_index ON sampletable1('foo')
CREATE INDEX sampletable1_hoge_index ON sampletable1('hoge')

constraints (
    primarykey_id INTEGER PRIMARY KEY,
    notnull_value REAL NOT NULL,
    unique_value INTEGER UNIQUE
)

Dependencies

Python 2.7+ or 3.4+

• logbook

• pytablewriter

• SimpleSQLite

• six

• typepy

Test dependencies

• pytest

• pytest-runner

• tox