Metadata-Version: 2.0
Name: dbf-light
Version: 0.3.0
Summary: Light and easy DBF reader
Home-page: https://github.com/idlesign/dbf_light
Author: Igor `idle sign` Starikov
Author-email: idlesign@yandex.ru
License: BSD 3-Clause License
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: BSD License
Provides-Extra: cli
Provides-Extra: cli
Requires-Dist: click; extra == 'cli'

dbf_light
=========
https://github.com/idlesign/dbf_light

|release| |lic| |ci| |coverage| |health|

.. |release| image:: https://img.shields.io/pypi/v/dbf_light.svg
    :target: https://pypi.python.org/pypi/dbf_light

.. |lic| image:: https://img.shields.io/pypi/l/dbf_light.svg
    :target: https://pypi.python.org/pypi/dbf_light

.. |ci| image:: https://img.shields.io/travis/idlesign/dbf_light/master.svg
    :target: https://travis-ci.org/idlesign/dbf_light

.. |coverage| image:: https://img.shields.io/coveralls/idlesign/dbf_light/master.svg
    :target: https://coveralls.io/r/idlesign/dbf_light

.. |health| image:: https://landscape.io/github/idlesign/dbf_light/master/landscape.svg?style=flat
    :target: https://landscape.io/github/idlesign/dbf_light/master


Description
-----------

*Light and easy DBF reader*

No fancy stuff, just DBF reading for most common format versions.

* Python 2.7, 3.4+;
* Uses `namedtuple` for row representation and iterative row reading to minimize memory usage;
* Works fine with cyrillic (supports KLADR and CBRF databases);
* Reads .dbf from zip files.


API
---

.. code-block:: python

    from dbf_light import Dbf


    with Dbf.open('some.dbf') as dbf:

        for field in dbf.field:
            print('Field: %s' % field)

        print('Rows (%s):' % dbf.prolog.records_count)

        for row in dbf:
            print(row)

    # Read `some.dbf` from zip (ignoring filename case):
    with Dbf.open_zip('some.dbf', 'here/myarch.zip', case_sensitive=False) as dbf:
        ...


CLI
---

Requires `click` package (can be installed with: `pip install dbf_light[cli]`).

.. code-block:: bash

    $ dbf_light describe myfile.dbf
    $ dbf_light show myfile.dbf


