1
1
mirror of https://github.com/encode/django-rest-framework.git synced 2025-05-10 02:43:41 +03:00
Commit Graph

180 Commits

Author SHA1 Message Date
Bruno Alla
125ad42eb3
Accept integers as min/max values of DecimalField ()
* Use Decimal for min/max values of DecimalField in tests

* Update docs to mention that min/max values should be Decimal objects

* Accept integer values for DecimalField min and max values

* Update expected error messages in tests

* Update expected warning message in tests
2024-09-07 17:07:28 +06:00
Tom Christie
4ef3aaf0ad
Revert ()
* Revert 

* Fix test case
2024-03-22 09:40:34 +01:00
Christian Clauss
ab694eccde
Fix typo () 2024-01-24 23:17:01 +01:00
Denis Surkov
2843b925f9
Add note for HiddenField behavior ()
* Add note for HiddenField behavior

* Update docs/api-guide/fields.md

* Update docs/api-guide/validators.md

---------

Co-authored-by: Asif Saif Uddin <auvipy@gmail.com>
2023-08-15 11:20:05 +06:00
rizwanshaikh
7a9db57eaf
Propagate 'default' from model_field to serializer field. ()
* Propagate 'default' from model_field to serializer field

Fix .

Co-authored-by: Nikhil Benesch <nikhil.benesch@gmail.com>

* updated field default on serializer according to openapi generation and added that to options action response

* added notes regarding default value propagation from model to serializer field

* updated note

* Update docs/api-guide/fields.md

* Update docs/api-guide/fields.md

* Update docs/api-guide/fields.md

* Update docs/api-guide/fields.md

* Update docs/api-guide/fields.md

* Update docs/api-guide/fields.md

---------

Co-authored-by: John Parton <john.parton.iv@gmail.com>
Co-authored-by: Nikhil Benesch <nikhil.benesch@gmail.com>
Co-authored-by: Rizwan Shaikh <rshaikh@ces-ltd.com>
Co-authored-by: Asif Saif Uddin <auvipy@gmail.com>
2023-08-07 12:35:54 +06:00
Mathieu Dupuy
c9e7b68a4c
minor documentation improvements and fixes ()
* minor documentation improvements and fixes

* Update docs/api-guide/fields.md

---------

Co-authored-by: Tom Christie <tom@tomchristie.com>
2023-03-14 13:31:34 +00:00
Henrik Wahlgren
d5f228dd00
Possibility to remove trailing zeros on DecimalFields representation ()
* Added normalize parameter to DecimalField to be able to strip trailing zeros. Fixes .

* Updated docs to include normalize option on DecimalField

* Fixed linting error in test_fields

* Removed comment and renamed normalize to normalize_output as suggested in code review

Co-authored-by: Tom Christie <tom@tomchristie.com>
2022-11-16 14:31:50 +00:00
Francisco Couzo
041b88f8bb
Improve style, fix some typos ()
* Improve style, fix some typos

* Update docs/api-guide/fields.md

Co-authored-by: Tom Christie <tom@tomchristie.com>

Co-authored-by: Tom Christie <tom@tomchristie.com>
2022-10-19 11:20:11 +01:00
Shyamkumar Yadav
1fd268ae2b
Docs: use asterisk for unordered list () 2022-10-14 11:22:19 +01:00
Aaron Taajik
058424c16a
docs: delete duplicate explanation () 2022-09-22 10:50:23 +01:00
Tim Schilling
b658915846
Version 3.14.0 proposal ()
* Version 3.14.0

* Update docs/community/release-notes.md to use proper links.

Co-authored-by: Adam Johnson <me@adamj.eu>

* Add community announcement page for version 3.14

* Remove deprecated NullBooleanField.

* Change openapi _get_reference removal to 3.15

This deprecation was never released in the 3.13.x series and therefore
can't be removed at the same time the replacement is released.

* Removing deprecated openapi methods.

Co-authored-by: Adam Johnson <me@adamj.eu>
2022-09-21 14:08:12 +01:00
Q_back
cdc956a96c
Update description of docs/api-guide/fields.md -> required ()
fix: Documentation did not point out that default value of `required`
`Field` parameter is `False` depending on the Django's `Model.field`.
2022-05-03 11:10:37 +01:00
thetarby
6ea95b6ad1
Highlight select_related and prefetch_related usage in documentation ()
* docs updated to highlight use of select_related and prefetch related to avoid n+1 problems

* Apply suggestions from code review

cosmetic changes

Co-authored-by: Xavier Ordoquy <xordoquy@linovia.com>

* cosmetic changes

Co-authored-by: Xavier Ordoquy <xordoquy@linovia.com>
2021-10-05 15:33:55 +01:00
Carlton Gibson
f651878df3 Adjusted DateTimeField docs for zoneinfo. 2021-09-22 10:23:46 +02:00
Joe Michelini
71e6c30034
update SerializerMethodField example in docs ()
* update SerializerMethodField example

* fix formatting
2021-03-22 12:08:19 +00:00
Adam Johnson
fd5e1a745a
Fixed some documentation headings to use a space () 2020-10-10 17:42:59 +01:00
Ngô Thanh Lợi (Leonn)
19915d1917
Fix docs typo () 2020-06-22 14:24:50 -07:00
Nikhil Kumar
9dc7021770
Fixed h4 rendering 2020-06-01 14:03:10 -04:00
johnthagen
fccfdd21c0
Remove object inheritance in docs () 2020-05-13 17:54:46 -07:00
Ran Benita
d985c7cbb9 Remove a few no longer needed compat checks and references ()
* serializers: removes no longer needed compat checks

UUIDField and DurationField are both supported in all supported Django
versions.

IPAddressField was removed in Django 1.9, which is no longer supported.

* serializers: move related code closer together

This way it's easier to see all of the mappings in one place.

* serializers,docs: remove some DRF 2.x references

The last release of DRF 2.x was 5 years ago, it seems fine to remove
these references now.
2019-12-16 18:59:25 +00:00
Tom Christie
070cff5a03
Drop set_context() ()
* Do not persist the context in validators

Fixes 

* Drop set_context() in favour of 'requires_context = True'
2019-12-03 11:16:27 +00:00
Chris Guo
5ee970c090 Fix docs typos () 2019-10-24 11:31:12 -07:00
Law Karingithi
0e4811e9ce Fix minor grammatical errors in docs () 2019-10-08 09:38:14 -07:00
Luke Plant
f0dbf0a264 Update docs to use lists instead of tuples () 2019-07-12 18:15:36 -07:00
linchiwei123
373195996e Update fields.md ()
Example ==> Example
2019-07-05 14:24:52 +01:00
Ryan P Kilby
82c2b5c3e7
Update mkdocs () 2019-06-30 19:04:36 -07:00
Min ho Kim
72de94a05d Fix typos in docs () 2019-06-18 12:58:01 -07:00
Raffaele Salmaso
514033815d Allow JSONField encoder customization. () 2019-05-24 12:47:35 +01:00
gaetano-guerriero
a7c577cb31 Dict field allow empty ()
* dict field: support allow_empty option

* document ListField allow_empty option

* document HStoreField allow_empty parameter
2019-05-09 09:18:20 +01:00
Carlton Gibson
0407a0df8a
Dropped Python 2 compatibility. ()
Thanks to Jon Dufresne (@jdufresne) for review.

Co-authored-by: Asif Saif Uddin <auvipy@gmail.com>
Co-authored-by: Rizwan Mansuri <Rizwan@webbyfox.com>
2019-04-30 17:53:44 +02:00
Ryan Siemens
d2d1888217 Document DateTimeField default_timezone argument () 2019-03-12 21:15:12 -07:00
Carlton Gibson
31bf597081 Updated note on BooleanField required kwarg generation.
Closes .
2019-03-01 12:48:12 +01:00
Noam
7268643b25 min_value/max_value support in DurationField ()
* Added min_value/max_value field arguments to DurationField.
* Made field mapping use mix/max kwargs for DurationField validators.
2018-04-24 09:24:05 +02:00
Mikkel Munch Mortensen
9dbb49ef22 Docs: Match original argument names ()
Change argument names in overridden field methods to match those of the base classes.
2018-04-20 15:35:09 +02:00
Carlton Gibson
6c0c69ed65
Correct allow_null behaviour when required=False ()
* Revert "Non-required fields with 'allow_null=True' should not imply a default value ()"
    This reverts commit 905a5579df.
    Closes 

* Add test for allow_null + required=False
    Ref : allow_null should imply default=None, even for non-required fields.

* Re-order allow_null and default in field docs
    default is prior to allow_null. allow_null implies an outgoing default=None.

* Adjust allow_null note.
2018-03-20 21:24:39 +01:00
Max Goodridge
3e5d3752e7 Fixed a typo () 2018-01-29 08:41:55 +01:00
Ryan P Kilby
2709de1310 Add HStoreField, postgres fields tests ()
* Test postgres field mapping

* Add HStoreField

* Ensure 'HStoreField' child is a 'CharField'

* Add HStoreField docs
2018-01-15 15:52:30 +01:00
Jon Dufresne
d3f3c3d9c1 Prefer https protocol for links in docs when available 2018-01-15 15:15:21 +01:00
Jon Dufresne
d5c34aa813 Remove unused links from docs ()
Each removed link has no inline use.
2018-01-15 15:03:44 +01:00
Ryan P Kilby
5fc35eb7eb Add missing word in 'Field.allow_null' docs 2017-12-22 12:23:07 -05:00
Carlton Gibson
cf3929d88d
Add example using source=‘*’ to custom field docs. ()
* Add example using `source=‘*’` to custom field docs.
* Add nested serialiser example

Closes  closes 
2017-12-20 10:04:12 +01:00
Carlton Gibson
2359d3981b
Add docs note re generated BooleanField being required=False ()
* Note that BooleanField default is required=False

Closes 
2017-12-14 11:39:54 +01:00
Ryan P Kilby
5f42cb7027 Add allow_null serialization output note () 2017-12-01 10:07:33 +01:00
Jon Dufresne
ff556a91fd Remove references to unsupported Django versions in docs and code ()
Per the trove classifiers, DRF only supports Django versions 1.10+. Can
drop documentation, code comments, and workarounds for older Django
versions.
2017-11-20 09:35:54 +01:00
Carlton Gibson
331c31370f
Add rounding parameter to DecimalField ()
* Adding rounding parameter to DecimalField.

* Using standard `assert` instead of `self.fail()`.

* add testcase and PEP8 multilines fix

* flake8 fixes

* Use decimal module constants in tests.

* Add docs note for `rounding` parameter.
2017-11-06 09:55:09 +01:00
Ryan P Kilby
6221124e0d Docs about default value for dotted source, additional tests ()
* Add docs note on dotted source + default value

* Add additional dotted source tests
2017-10-16 11:33:46 +02:00
Carlton Gibson
43c7af0bb5 Adjust ListField & DictField signature docs ()
Closes 
2017-08-17 10:06:09 +01:00
Steven Johns
9b5a6bea67 Fix typo on fields.md ()
> keeps you error messages

to

> keeps your error messages

and 

> more cleanly separated from your code

to 

> cleaner and more separated from your code
2017-08-09 15:21:23 -04:00
Tibo Beijen
cf5d401a0e Allow required false and default ()
* Default value will now be used when serializing if key or attribute is missing.
2017-03-07 13:19:19 +00:00
Eduard Iskandarov
de8fcbf696 Refs: delete unrelevant documentation 2017-02-14 13:27:33 +03:00