Metadata-Version: 1.1
Name: django-firebird
Version: 1.11
Summary: Firebird backend for Django web framework
Home-page: https://github.com/maxirobaina/django-firebird
Author: Maximiliano Robaina
Author-email: maxirobaina@gmail.com
License: BSD
Description: ===============
        django-firebird
        ===============
        
        .. image:: https://img.shields.io/pypi/v/django-firebird.svg
            :target: https://pypi.python.org/pypi/django-firebird
        
        .. image:: https://caniusepython3.com/project/django-firebird.svg
            :target: https://caniusepython3.com/project/django-firebird
        
        
        Firebird SQL backend for django
        -------------------------------
        
        **Repo Note**:
        The ``master`` branch is an *in development* version of django-firebird. This may be substantially different from the latest
        `release of django-firebird`_
        
        .. _release of django-firebird: https://github.com/maxirobaina/django-firebird/releases
        
        
        This version of django-firebird is working with *fbd* [1], therefore it will work only with firebird 2.x and later.
        The stable version corresponds with django 1.11 and live into ``stable/1.11.x`` branch.
        The current master branch of this repository is being developed under django 2.x. For previous Django stable version check
        the branch list of this repository.
        *fbd* is the official stable python-firebird driver, also it has support for python 3.
        
        
        [1] http://pypi.python.org/pypi/fdb/
        
        
        Requirements
        ------------
          * Python 2.7+ or Python 3.x
          * Django 1.11.x
          * fdb (http://pypi.python.org/pypi/fdb/)
        
        Instalation
        -----------
        
        **Using pip**
        
            pip install django-firebird
        
        **From repository**
        
            git clone git://github.com/maxirobaina/django-firebird.git
        
            cd django-firebird
        
            sudo python setup.py install
        
        **Manual Instalation**
        
        Instructions for Ubuntu/Debian
        I assume you have installed django from source with python setup.py install
        
        
            cd /usr/local/lib/python2.7/dist-packages
        
            sudo git clone git://github.com/maxirobaina/django-firebird.git
        
            sudo ln -s django-firebird/firebird firebird
        
            cd /usr/local/lib/python2.7/dist-packages/django/db/backends
        
            sudo ln -s /usr/local/lib/python2.7/dist-packages/django-firebird/firebird
        
        Configuration
        -------------
        
        Modify your setting.py ::
        
            DATABASES = {
                'default': {
                    'ENGINE' : 'firebird',
                    'NAME' : '/var/lib/firebird/2.5/data/django_firebird.fdb', # Path to database or db alias
                    'USER' : 'SYSDBA',           # Your db user
                    'PASSWORD' : '*****',    # db user password
                    'HOST' : '127.0.0.1',        # Your host machine
                    'PORT' : '3050',             # If is empty, use default 3050
                    #'OPTIONS' : {'charset':'ISO8859_1'}
                }
            }
        
        Known bugs and issues
        ---------------------
        
        * Some database migrations doesn't work by default. Sometimes is better make intermediate migrations for solve problems.
        * Some Query Expressions doesn't work by default. We need to make some workaround, ie: Use Cast().
        * Combined duration expressions need more research. No all combination of expressions works.
        
        
        Contributing
        ------------
        
        Code and issues is in GitHub:
        
            https://github.com/maxirobaina/django-firebird
        
        We also have a mailing list:
        
            http://groups.google.com/group/django-firebird-dev
        
        
        Legacy driver
        -------------
        
        Why the change from kinterbasdb to fdb?
        
        If you want to know more about the differences between *fdb* and *kinterbasdb* you can look at:
        
        http://thread.gmane.org/gmane.comp.db.firebird.python/185/focus=187
        
        http://pythonhosted.org//fdb/differences-from-kdb.html
        
        If you still use *kinterbasdb*, the original google code repository has an updated django-firebird 1.4.x LTS version.
        
        https://github.com/mariuz/django-firebird-1.4
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
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.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Database
Classifier: Topic :: Internet :: WWW/HTTP
