django-extra-fields-lab 0.3

DRF-EXTRA-FIELDS
================

Django Rest Framework的附加字段


用法
================

安装包

```bash
pip install django-extra-fields
```

**注意：**
- 对于Django Rest Framework 2.*，安装版本0.1
- 对于Django Rest Framework 3.*，安装版本0.3


字段
----------------


## Base64ImageField

Base64ImageField的图像表示

继承自`ImageField`


**签名：** `Base64ImageField()`

- 它接受一个作为字符串的base64图像。
- base64图像：`data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7`
- Base64ImageField仅接受base64后的部分，`R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7`


**示例：**

```python
# 序列化

from drf_extra_fields.fields import Base64ImageField

class UploadedBase64ImageSerializer(serializers.Serializer)
file = Base64ImageField(required=False)
created = serializers.DateTimeField()

# 使用序列化器
file = 'R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw=='
serializer = UploadedBase64ImageSerializer(data={'created': now, 'file': file})
```


## PointField

GeoDjango的Point字段


**签名：** `PointField()`

- 它接受一个包含纬度和经度键的字典，如下所示

{
"latitude": 49.8782482189424,
"longitude": 24.452545489
}

**示例：**

```python
# 序列化

from drf_extra_fields.geo_fields import PointField

class PointFieldSerializer(serializers.Serializer)
point = PointField(required=False)
created = serializers.DateTimeField()

# 使用序列化器
point = {
"latitude": 49.8782482189424,
"longitude": 24.452545489
}
serializer = PointFieldSerializer(data={'created': now, 'point': point})
```

CONTRIBUTION
=================

*TESTS*
- 确保您将贡献字段的测试添加到test/test_fields.py中，并在发送拉取请求之前使用以下命令运行
$ pip install tox # 如果尚未安装

```bash
$ tox
$ tox
```

*README*
- 确保将添加的字段文档添加到 README.md 中


授权协议
====================

版权所有 DRF EXTRA FIELDS HIPO

遵循 Apache 许可协议版本 2.0（“本协议”）；
除非符合本协议，否则不得使用此文件。
您可以在以下地址获得本协议的副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件
是按“原样”分发的，
不提供任何形式（明示或暗示）的保证或条件。
有关许可证下权限和限制的具体语言，请参阅许可证。
许可证