معرفی شرکت ها
django-xero-0.0.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Xero integration for Django
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-xero-0.0.3 |
| نام | django-xero |
| نسخه کتابخانه | 0.0.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Giacomo Lacava |
| ایمیل نویسنده | giac@autoepm.com |
| آدرس صفحه اصلی | https://github.com/toyg/django-xero |
| آدرس اینترنتی | https://pypi.org/project/django-xero/ |
| مجوز | Apache Software License v.2 |
# Django-Xero
[Xero](https://xero.com) integration for Django.
## Features
This package allows users to authenticate to Xero via a Public App that you have
registered on the [Xero Developer Portal](https://developer.xero.com).
Whenever you want to trigger authentication with Xero, just redirect to the view
`xero_auth_start` (either directly or via `resolve('xero-auth-start')` and this package
will do the rest.
The view also accepts an optional `next`parameter to control where the user will land
on successful authentication; otherwise it will redirect to `/`.
Xero sessions last for 30 minutes, but if you want to end them earlier, POST to
the view `xero_logout` (again with an optional `next`).
There is also a `@xero_required` decorator for views, which will automatically
check if an active Xero session is present. If not, it will redirect to an interstitial page
asking the user to do the authentication dance. You can control that page by creating a
custom template `xero/interstitial.html` (make sure it has a link to `xero-auth-start` somewhere).
Once authorized, in your view you will get a `.xerouser` attribute which you can use to do stuff like:
```python
from djxero.decorators import xero_required
@login_required
@xero_required
def my_view(request):
client = request.user.xerouser.client
contacts = client.contacts.all()
...
```
That client is a preconfigured `xero.Xero` object from [pyxero](https://github.com/freakboy3742/pyxero).
Some details will be exposed in `User` instances under `.xerouser`, but the Xero mechanisms
are such that it's all pretty meaningless - there is currently no way to know anything about the user
from the xero session alone. For that reason, note that
***you must have some other registration mechanism to create a regular Django
user first*** (e.g. regular login page with some other auth system); this package only extends
that `User` instance to attach a temporary Xero session.
If your User model has the same email or firstname/lastname as recorded in Xero,
you can try to guess its details with `request.user.xerouser.guess_user()` and then manually save the ID
in `request.user.xerouser.xero_id`, but the heuristic is very basic and may or may not work.
## Supported Platforms
* Python 3.7 (should work on 3.5/3.6 too, but is untested).
* Django 2
## Requirements
django-xero should automatically download all necessary prerequisites, but I like
to give credit where credit is due.
We stand on the shoulders of the following giants:
* [django-encrypted-model-fields](https://gitlab.com/lansharkconsulting/django/django-encrypted-model-fields/)
* [pyxero](https://github.com/freakboy3742/pyxero)
## Installation
1. Install the package
```
pip install django-xero
```
2. Add `encrypted_model_fields` and `djxero` to `INSTALLED_APPS` in your settings.
Note that the authentication system is required.
```python
INSTALLED_APPS = [
'django.contrib.auth',
'django.contrib.sessions',
...
'encrypted_model_fields',
'djxero',
...
]
```
3. Generate an encryption key:
```bash
python -c 'import base64; import os; print(base64.urlsafe_b64encode(os.urandom(32)))'
```
and add it to your settings. NOTE: in production, you want to store this safely.
```python
FIELD_ENCRYPTION_KEY = b'A7c4T1Kx3XmttUjm2cX8ScYcUEdF7RzFziEzfoBO7x4='
```
4. Run migrations to create the necessary objects
```bash
python manage.py migrate djxero
```
5. Set the Xero secrets for your public app. You can do this from the admin site (easier),
or directly via `manage.py shell`:
```python
from djxero.models import XeroSecret
consumer_key = XeroSecret.objects.get(pk='xero_consumer_key')
consumer_key.value = 'your key'
consumer_key.save()
consumer_secret = XeroSecret.objects.get(pk='xero_consumer_secret')
consumer_secret.value = 'your secret'
consumer_secret.save()
```
6. in your project `urls.py`, add the following:
```python
urlpatterns = [
path('xero/', include('djxero.urls')),
...
]
```
## Issues
For problems, file an issue on [GitHub](https://github.com/toyg/django-xero).
The author is available for hire (hint hint).
## Credits and License
Copyright (c) 2019 [Giacomo Lacava](https://linkedin.com/in/glacava).
Released under the terms of the Apache Software License, version 2.
نیازمندی
| مقدار | نام |
|---|---|
| <3.0,>=2.2.3 | Django |
| <3.0,>=2.7 | cryptography |
| <0.6,>=0.5.8 | django-encrypted-model-fields |
| <1.0,>=0.9.1 | pyxero |
نحوه نصب
نصب پکیج whl django-xero-0.0.3:
pip install django-xero-0.0.3.whl
نصب پکیج tar.gz django-xero-0.0.3:
pip install django-xero-0.0.3.tar.gz