Metadata-Version: 1.2
Name: django-yugabytedb
Version: 4.0.0.post0
Summary: Django backend for YugabyteDB
Home-page: https://www.yugabyte.com/
Author: Yugabyte
Author-email: hbhanawat@yugabyte.com
Maintainer: Sfurti Sarah
Maintainer-email: ssarah@yugabyte.com
License: Apache
Project-URL: Documentation, https://docs.yugabyte.com/
Project-URL: Code, https://github.com/yugabyte/yb-django
Description: Prerequisites
        -------------
        
        * GCC
        * Python 3.8 and above 
        * Psycopg2-binary
        * Django 3.2 or above
        
        Need for Django Backend for YugabyteDB
        ---------------------------------------
        
        YugabyteDB needs a separate backend for Django. This is because of mainly 2 reasons.
        
        * Django tries to create Inet data types as primary keys in Django test suites. Since this is not supported, we map Inet types to varchar(15) and varchar(39) in the YB backend.  
        * We also need it to support type change from int to BigInt and numeric(m,n) to double precision. This is required  for Django DB migrations. For now, the YB backend ignores these type changes.
          
        Installing from Pypi
        ---------------------
        
        Install the django-yugabytedb package with the command:
        
        .. code-block:: console
        
            $ pip install django-yugabytedb
        
        
        Installing in Python Virtual Environment From Source
        ---------------------------------------------------------
        
        The django-yugabytedb package can also be installed from source:
        
        .. code-block:: console
        
            $ git clone https://github.com/yugabyte/yb-django.git
        
            $ python -m pip install -r <repo_path>/yb-django/requirements.txt
        
            $ python -m pip install -e <repo_path>/yb-django/
        
        Check if it is installed correctly:
        
        .. code-block:: console
        
            $ pip list —local
        
        Use the backend with your Application
        -------------------------------------
        
        Update the ``DATABASES`` setting in your Django project's settings to point to YB server using Django YB backend:
        
        .. code-block:: python
        
            DATABASES = {
                'default': {
                    'ENGINE': 'django_yugabytedb',
                    'NAME': 'yugabyte',
                    'HOST': 'localhost',
                    'PORT': 5433,
                    'USER': 'yugabyte'
                }
            }
        
        Known bugs and issues
        -----------------------
        
        * The creation of indexes in YugabyteDB is a little slow.
        * Since Inet is mapped to varchar in the backend, comparison between data in the inet column wth Inet type will fail.
        * For YugabyteDB verions earlier than 2.9, the savepoint feature is not supported.
        * Dropping of Primary keys are not supported
        * Alter table Add column Unique is not yet supported.
        * Backfilling of existing rows when new column is added with default value is not yet implemented in yugabytedb.
        * Type change from int to BigInt and numeric(m,n) to double precision is not yet supported.
        * ALTER INDEX not supported yet.
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.0
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
