Metadata-Version: 2.1
Name: tdtypes
Version: 0.2.3
Summary: Database Types for Teradata
Home-page: https://bitbucket.org/padhia/tdtypes
Author: Paresh Adhia
License: MIT
Keywords: teradata
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Database
Classifier: Topic :: Software Development
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Requires-Dist: lazy
Provides-Extra: pyodbc
Requires-Dist: pyodbc; extra == 'pyodbc'
Provides-Extra: teradata
Requires-Dist: teradata; extra == 'teradata'

tdtypes
=======

.. image:: https://img.shields.io/pypi/v/tdtypes.svg
     :target: https://pypi.python.org/pypi/tdtypes
     :alt: PyPi
.. image:: https://img.shields.io/badge/License-MIT-blue.svg
     :target: https://opensource.org/licenses/MIT
     :alt: MIT License
.. image:: https://img.shields.io/pypi/pyversions/tdtypes.svg
     :alt: Python3.4+

`tdtypes <https://bitbucket.org/padhia/tdtypes>`_ is a Python library built atop `DB API <https://www.python.org/dev/peps/pep-0249/>`_ compliant library that provides abstraction layer for Teradata Database objects and utilities.

*NOTES:*

- This library was originally developed as a personal project. It is being made available as an open-source project in the hope that someone else might find it useful. This library does not come with any expressed or implied warranty.
- This library is not endorsed by `Teradata Inc <http://www.teradata.com/>`_.

Requirements
------------

The latest version of the *Python3* series is recommended. *Python2* series is no longer supported.

**tdtypes** can work with either `teradata <https://pypi.python.org/pypi/teradata/>`_ (preferred) or `pyodbc <https://github.com/mkleehammer/pyodbc>`_. Either of these packages must be installed.

Installation
------------

Use Python's ``pip`` utility to install ``tdtypes``.

::

  $ python -m pip install -U tdtypes[teradata]

or

::

  $ python -m pip install -U tdtypes[pyodbc]


Configuration and Customization
-------------------------------

No configuration is required except setting up the needed ODBC connections.

**tdtypes** provides an easy way to accept a valid ODBC connection string from the command line. If more flexibility is needed, for example, to use Teradata REST interface instead of ODBC, or automatically retrieve database connection information, create **tdconn_site.py** module and place it in your ``PYTHONPATH``. The module must define two functions ``dbconn_args()`` and ``dbconnect()``. Have a look at the default definitions of these functions in *tdconn_default.py* module to get an idea about the parameters and return values.

Support
-------

If you encounter an issue, report it using `issue tracker <https://bitbucket.org/padhia/tdtypes/issues?status=new&status=open>`_. I'll try to provide a fix as soon as I can. If you already have a fix, send me a pull request.

Contributions
-------------

Feel free to fork this repository and enhance it in a way you see fit. If you think your changes will benefit more people, send me a pull request.


