Metadata-Version: 2.1
Name: fyle-django-allauth
Version: 0.1.2
Summary: Fyle OAuth2 provider for Django, lets you associate Fyle accounts with your User accounts.
Home-page: https://github.com/fylein/fyle-django-allauth
Author: akshay_codemonk
Author-email: akshay@codemonk.in
License: BSD License
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Description-Content-Type: text/markdown
Requires-Dist: Django (>=1.11)
Requires-Dist: django-allauth

# fyle-django-allauth

Fyle OAuth 2.0 provider for django-allauth, lets you associate Fyle accounts with your User accounts.


## Dependencies
Install  [django-allauth](https://django-allauth.readthedocs.io/en/latest/installation.html) and configure it.



## Quick start

1. Install fyle-django-allauth

    ```
    pip install fyle-django-allauth
    ```

2. Include 'fyle_allauth' in the INSTALLED_APPS section of settings.py :
    ```
    INSTALLED_APPS = (
    ...
    'django.contrib.sites',

    'allauth',
    'allauth.account',
    'allauth.socialaccount',
    'fyle_allauth'  # new 
    ```

3. Fyle App registration (get your client_id and client_secret here)
    1. Login to [Fyle](https://app.fyle.in)
    2. Goto settings and click on Developers
    3. Click on create new app, enter the details and select type as OAuth 2.0
    4. For Redirect URI enter 
        1. 'http://localhost:8000/accounts/fyle/login/callback/' for development
        2. 'https://your_domain/accounts/fyle/login/callback/' for production
    5. Note down the client_secret and client_id

4. Open django-admin and create a new record under Social Applications
    Select Fyle as provider and enter the above noted client_secret and client_id.

    Final step is to add our site to the Chosen sites on the bottom.

5. Visit http://localhost:8000/accounts/fyle/login to login using your Fyle account.

6. If using a custom user model then add the below lines to settings.py
    ```
    # For custom user model that has email as the user identifying field
    ACCOUNT_USER_MODEL_USERNAME_FIELD = None
    ACCOUNT_USERNAME_REQUIRED = False
    ACCOUNT_EMAIL_REQUIRED = True
    ACCOUNT_AUTHENTICATION_METHOD = 'email'

    # Disable verification mail [optional]
    ACCOUNT_EMAIL_VERIFICATION = 'none'  
    ``` 

7. If you are using a different application then update your base URL by adding the below line to settings.py
    ```
    FYLE_BASE_URL = 'https://app.fyle.in'
    ```


For more info on customisation refer the django-allauth [documentation](https://django-allauth.readthedocs.io/en/latest/advanced.html#custom-user-models)

