Bug fixes:
- Use fixed-point notation rather than engineering notation when serializing with
Decimal
(:issue:`534`). Thanks :user:`gdub`. - Fix UUID validation on serialization and deserialization of
uuid.UUID
objects (:issue:`532`). Thanks :user:`pauljz`.
Bug fixes:
- Fix behavior when using
validate.Equal(False)
(:issue:`484`). Thanks :user:`pktangyue` for reporting and thanks :user:`tuukkamustonen` for the fix. - Fix
strict
behavior when errors are raised inpre_dump
/post_dump
processors (:issue:`521`). Thanks :user:`tvuotila` for the catch and patch. - Fix validation of nested fields on dumping (:issue:`528`). Thanks again :user:`tvuotila`.
Features:
- Errors raised by pre/post-load/dump methods will be added to a schema's errors dictionary (:issue:`472`). Thanks :user:`dbertouille` for the suggestion and for the PR.
Bug fixes:
- Fix serialization of
datetime.time
objects with microseconds (:issue:`464`). Thanks :user:`Tim-Erwin` for reporting and thanks :user:`vuonghv` for the fix. - Make
@validates
consistent with field validator behavior: if validation fails, the field will not be included in the deserialized output (:issue:`391`). Thanks :user:`martinstein` for reporting and thanks :user:`vuonghv` for the fix.
Decimal
field coerces input values to a string before deserializing to a decimal.Decimal object in order to avoid transformation of float values under 12 significant digits (:issue:`434`, :issue:`435`). Thanks :user:`davidthornton` for the PR.
Features:
- Allow
only
andexclude
parameters to take nested fields, using dot-delimited syntax (e.g.only=['blog.author.email']
) (:issue:`402`). Thanks :user:`Tim-Erwin` and :user:`deckar01` for the discussion and implementation.
Support:
- Update tasks.py for compatibility with invoke>=0.13.0. Thanks :user:`deckar01`.
- Make
field.parent
andfield.name
accessible toon_bind_field
(:issue:`449`). Thanks :user:`immerrr`.
No code changes in this release. This is a reupload in order to distribute an sdist for the last hotfix release. See :issue:`443`.
Support:
- Update license entry in setup.py to fix RPM distributions (:issue:`433`). Thanks :user:`rrajaravi` for reporting.
Bug fixes:
- Only add Schemas to class registry if a class name is provided. This allows Schemas to be
constructed dynamically using the
type
constructor without getting added to the class registry (which is useful for saving memory).
Features:
- Make context available to
Nested
field'son_bind_field
method (:issue:`408`). Thanks :user:`immerrr` for the PR. - Pass through user
ValidationError
kwargs (:issue:`418`). Thanks :user:`russelldavies` for helping implement this.
Other changes:
- Remove unused attributes
root
,parent
, andname
fromSchemaABC
(:issue:`410`). Thanks :user:`Tim-Erwin` for the PR.
Bug fixes:
- Respect load_from when reporting errors for nested required fields (:issue:`414`). Thanks :user:`yumike`.
Features:
- Add
partial
argument toSchema.validate
(:issue:`379`). Thanks :user:`tdevelioglu` for the PR. - Add
equal
argument tovalidate.Length
. Thanks :user:`daniloakamine`. - Collect all validation errors for each item deserialized by a
List
field (:issue:`345`). Thanks :user:`maximkulkin` for the report and the PR.
Features:
- Allow a tuple of field names to be passed as the
partial
argument toSchema.load
(:issue:`369`). Thanks :user:`tdevelioglu` for the PR. - Add
schemes
argument tovalidate.URL
(:issue:`356`).
Bug fixes:
- Prevent duplicate error messages when validating nested collections (:issue:`360`). Thanks :user:`alexmorken` for the catch and patch.
Bug fixes:
- Serializing an iterator will not drop the first item (:issue:`343`, :issue:`353`). Thanks :user:`jmcarp` for the patch. Thanks :user:`edgarallang` and :user:`jmcarp` for reporting.
Features:
- Add
skip_on_field_errors
parameter tovalidates_schema
(:issue:`323`). Thanks :user:`jjvattamattom` for the suggestion and :user:`d-sutherland` for the PR.
Bug fixes:
- Fix
FormattedString
serialization (:issue:`348`). Thanks :user:`acaird` for reporting. - Fix
@validates
behavior when used whenattribute
is specified andstrict=True
(:issue:`350`). Thanks :user:`density` for reporting.
Features:
- Add
dump_to
parameter to fields (:issue:`310`). Thanks :user:`ShayanArmanPercolate` for the suggestion. Thanks :user:`franciscod` and :user:`ewang` for the PRs. - The
deserialize
function passed tofields.Function
can optionally receive acontext
argument (:issue:`324`). Thanks :user:`DamianHeard`. - The
serialize
function passed tofields.Function
is optional (:issue:`325`). Thanks again :user:`DamianHeard`. - The
serialize
function passed tofields.Method
is optional (:issue:`329`). Thanks :user:`justanr`.
Deprecation/Removal:
- The
func
argument offields.Function
has been renamed toserialize
. - The
method_name
argument offields.Method
has been renamed toserialize
.
func
and method_name
are still present for backwards-compatibility, but they will both be removed in marshmallow 3.0.
Bug fixes:
- Skip field validators for fields that aren't included in
only
(:issue:`320`). Thanks :user:`carlos-alberto` for reporting and :user:`eprikazc` for the PR.
Features:
- Add support for partial deserialization with the
partial
argument toSchema
andSchema.load
(:issue:`290`). Thanks :user:`taion`.
Deprecation/Removals:
Query
andQuerySelect
fields are removed.- Passing of strings to
required
andallow_none
is removed. Pass theerror_messages
argument instead.
Support:
- Add example of Schema inheritance in docs (:issue:`225`). Thanks :user:`martinstein` for the suggestion and :user:`juanrossi` for the PR.
- Add "Customizing Error Messages" section to custom fields docs.
Bug fixes:
- Fix serialization of collections for which iter will modify position, e.g. Pymongo cursors (:issue:`303`). Thanks :user:`Mise` for the catch and patch.
Bug fixes:
- Fix passing data to schema validator when using
@validates_schema(many=True)
(:issue:`297`). Thanks :user:`d-sutherland` for reporting. - Fix usage of
@validates
with a nested field whenmany=True
(:issue:`298`). Thanks :user:`nelfin` for the catch and patch.
Bug fixes:
Constant
field deserializes to its value regardless of whether its field name is present in input data (:issue:`291`). Thanks :user:`fayazkhan` for reporting.
Features:
- Add
Dict
field for arbitrary mapping data (:issue:`251`). Thanks :user:`dwieeb` for adding this and :user:`Dowwie` for the suggestion. - Add
Field.root
property, which references the field's Schema.
Deprecation/Removals:
- The
extra
param ofSchema
is deprecated. Add extra data in apost_load
method instead. UnmarshallingError
andMarshallingError
are removed.
Bug fixes:
- Fix storing multiple schema-level validation errors (:issue:`287`). Thanks :user:`evgeny-sureev` for the patch.
- If
missing=None
on a field,allow_none
will be set toTrue
.
Other changes:
- A
List's
inner field will have the list field set as its parent. Useroot
to access theSchema
.
Features:
- Make error messages configurable at the class level and instance level (
Field.default_error_messages
attribute anderror_messages
parameter, respectively).
Deprecation/Removals:
- Remove
make_object
. Use apost_load
method instead (:issue:`277`). - Remove the
error
parameter and attribute ofField
. - Passing string arguments to
required
andallow_none
is deprecated. Pass theerror_messages
argument instead. This API will be removed in version 2.2. - Remove
Arbitrary
,Fixed
, andPrice
fields (:issue:`86`). UseDecimal
instead. - Remove
Select
/Enum
fields (:issue:`135`). Use theOneOf
validator instead.
Bug fixes:
- Fix error format for
Nested
fields whenmany=True
. Thanks :user:`alexmorken`. pre_dump
methods are invoked before implicit field creation. Thanks :user:`makmanalp` for reporting.- Return correct "required" error message for
Nested
field. - The
only
argument passed to aSchema
is bounded by thefields
option (:issue:`183`). Thanks :user:`lustdante` for the suggestion.
Changes from 2.0.0rc2:
error_handler
andaccessor
options are replaced with thehandle_error
andget_attribute
methods :issue:`284`.- Remove
marshmallow.compat.plain_function
since it is no longer used. - Non-collection values are invalid input for
List
field (:issue:`231`). Thanks :user:`density` for reporting. - Bug fix: Prevent infinite loop when validating a required, self-nested field. Thanks :user:`Bachmann1234` for the fix.
Deprecation/Removals:
make_object
is deprecated. Use apost_load
method instead (:issue:`277`). This method will be removed in the final 2.0 release.Schema.accessor
andSchema.error_handler
decorators are deprecated. Define theaccessor
anderror_handler
class Meta options instead.
Bug fixes:
- Allow non-field names to be passed to
ValidationError
(:issue:`273`). Thanks :user:`evgeny-sureev` for the catch and patch.
Changes from 2.0.0rc1:
- The
raw
parameter of thepre_*
,post_*
,validates_schema
decorators was renamed topass_many
(:issue:`276`). - Add
pass_original
parameter topost_load
andpost_dump
(:issue:`216`). - Methods decorated with the
pre_*
,post_*
, andvalidates_*
decorators must be instance methods. Class methods and instance methods are not supported at this time.
Features:
- Backwards-incompatible:
fields.Field._deserialize
now takesattr
anddata
as arguments (:issue:`172`). Thanks :user:`alexmic` and :user:`kevinastone` for the suggestion. - Allow a
Field's
attribute
to be modified during deserialization (:issue:`266`). Thanks :user:`floqqi`. - Allow partially-valid data to be returned for
Nested
fields (:issue:`269`). Thanks :user:`jomag` for the suggestion. - Add
Schema.on_bind_field
hook which allows aSchema
to modify its fields when they are bound. - Stricter validation of string, boolean, and number fields (:issue:`231`). Thanks :user:`touilleMan` for the suggestion.
- Improve consistency of error messages.
Deprecation/Removals:
Schema.validator
,Schema.preprocessor
, andSchema.data_handler
are removed. Usevalidates_schema
,pre_load
, andpost_dump
instead.QuerySelect
andQuerySelectList
are deprecated (:issue:`227`). These fields will be removed in version 2.1.utils.get_callable_name
is removed.
Bug fixes:
- If a date format string is passed to a
DateTime
field, it is always used for deserialization (:issue:`248`). Thanks :user:`bartaelterman` and :user:`praveen-p`.
Support:
- Documentation: Add "Using Context" section to "Extending Schemas" page (:issue:`224`).
- Include tests and docs in release tarballs (:issue:`201`).
- Test against Python 3.5.
Features:
- If a field corresponds to a callable attribute, it will be called upon serialization. Thanks :user:`alexmorken`.
- Add
load_only
anddump_only
class Meta options. Thanks :user:`kelvinhammond`. - If a
Nested
field is required, recursively validate any required fields in the nested schema (:issue:`235`). Thanks :user:`max-orhai`. - Improve error message if a list of dicts is not passed to a
Nested
field for whichmany=True
. Thanks again :user:`max-orhai`.
Bug fixes:
- make_object is only called after all validators and postprocessors have finished (:issue:`253`). Thanks :user:`sunsongxp` for reporting.
- If an invalid type is passed to
Schema
andstrict=False
, store a_schema
error in the errors dict rather than raise an exception (:issue:`261`). Thanks :user:`density` for reporting.
Other changes:
make_object
is only called when input data are completely valid (:issue:`243`). Thanks :user:`kissgyorgy` for reporting.- Change default error messages for
URL
andEmail
validators so that they don't include user input (:issue:`255`). Email
validator permits email addresses with non-ASCII characters, as per RFC 6530 (:issue:`221`). Thanks :user:`lextoumbourou` for reporting and :user:`mwstobo` for sending the patch.
Features:
List
field respects theattribute
argument of the inner field. Thanks :user:`jmcarp`.- The
container
fieldList
field has access to its parentSchema
via itsparent
attribute. Thanks again :user:`jmcarp`.
Deprecation/Removals:
- Legacy validator functions have been removed (:issue:`73`). Use the class-based validators in
marshmallow.validate
instead.
Bug fixes:
fields.Nested
correctly serializes nestedsets
(:issue:`233`). Thanks :user:`traut`.
Changes from 2.0.0b3:
- If
load_from
is used on deserialization, the value ofload_from
is used as the key in the errors dict (:issue:`232`). Thanks :user:`alexmorken`.
Features:
- Add
marshmallow.validates_schema
decorator for defining schema-level validators (:issue:`116`). - Add
marshmallow.validates
decorator for defining field validators as Schema methods (:issue:`116`). Thanks :user:`philtay`. - Performance improvements.
- Defining
__marshallable__
on complex objects is no longer necessary. - Add
fields.Constant
. Thanks :user:`kevinastone`.
Deprecation/Removals:
- Remove
skip_missing
class Meta option. By default, missing inputs are excluded from serialized output (:issue:`211`). - Remove optional
context
parameter that gets passed to methods forMethod
fields. Schema.validator
is deprecated. Usemarshmallow.validates_schema
instead.utils.get_func_name
is removed. Useutils.get_callable_name
instead.
Bug fixes:
- Fix serializing values from keyed tuple types (regression of :issue:`28`). Thanks :user:`makmanalp` for reporting.
Other changes:
- Remove unnecessary call to
utils.get_value
forFunction
andMethod
fields (:issue:`208`). Thanks :user:`jmcarp`. - Serializing a collection without passing
many=True
will not result in an error. Be very careful to pass themany
argument when necessary.
Support:
- Documentation: Update Flask and Peewee examples. Update Quickstart.
Changes from 2.0.0b2:
Boolean
field serializesNone
toNone
, for consistency with other fields (:issue:`213`). Thanks :user:`cmanallen` for reporting.- Bug fix:
load_only
fields do not get validated during serialization. - Implicit passing of original, raw data to Schema validators is removed. Use
@marshmallow.validates_schema(pass_original=True)
instead.
Features:
- Add useful
__repr__
methods to validators (:issue:`204`). Thanks :user:`philtay`. - Backwards-incompatible: By default,
NaN
,Infinity
, and-Infinity
are invalid values forfields.Decimal
. Passallow_nan=True
to allow these values. Thanks :user:`philtay`.
Changes from 2.0.0b1:
- Fix serialization of
None
for Time, TimeDelta, and Date fields (a regression introduced in 2.0.0a1).
Includes bug fixes from 1.2.6.
Features:
- Errored fields will not appear in (de)serialized output dictionaries (:issue:`153`, :issue:`202`).
- Instantiate
OPTIONS_CLASS
inSchemaMeta
. This makesSchema.opts
available in metaclass methods. It also causes validation to occur earlier (uponSchema
class declaration rather than instantiation). - Add
SchemaMeta.get_declared_fields
class method to support adding additional declared fields.
Deprecation/Removals:
- Remove
allow_null
parameter offields.Nested
(:issue:`203`).
Changes from 2.0.0a1:
- Fix serialization of None for
fields.Email
.
Features:
- Backwards-incompatible: When
many=True
, the errors dictionary returned bydump
andload
will be keyed on the indices of invalid items in the (de)serialized collection (:issue:`75`). Addindex_errors=False
on a Schema'sclass Meta
options to disable this behavior. - Backwards-incompatible: By default, fields will raise a ValidationError if the input is
None
. Theallow_none
parameter can override this behavior. - Backwards-incompatible: A
Field's
default
parameter is only used if explicitly set and the field's value is missing in the input to Schema.dump. If not set, the key will not be present in the serialized output for missing values . This is the behavior for all fields.fields.Str
no longer defaults to''
,fields.Int
no longer defaults to0
, etc. (:issue:`199`). Thanks :user:`jmcarp` for the feedback. - In
strict
mode, aValidationError
is raised. Error messages are accessed via theValidationError's
messages
attribute (:issue:`128`). - Add
allow_none
parameter tofields.Field
. IfFalse
(the default), validation fails when the field's value isNone
(:issue:`76`, :issue:`111`). Ifallow_none
isTrue
,None
is considered valid and will deserialize toNone
. - Schema-level validators can store error messages for multiple fields (:issue:`118`). Thanks :user:`ksesong` for the suggestion.
- Add
pre_load
,post_load
,pre_dump
, andpost_dump
Schema method decorators for defining pre- and post- processing routines (:issue:`153`, :issue:`179`). Thanks :user:`davidism`, :user:`taion`, and :user:`jmcarp` for the suggestions and feedback. Thanks :user:`taion` for the implementation. - Error message for
required
validation is configurable. (:issue:`78`). Thanks :user:`svenstaro` for the suggestion. Thanks :user:`0xDCA` for the implementation. - Add
load_from
parameter to fields (:issue:`125`). Thanks :user:`hakjoon`. - Add
load_only
anddump_only
parameters to fields (:issue:`61`, :issue:`87`). Thanks :user:`philtay`. - Add missing parameter to fields (:issue:`115`). Thanks :user:`philtay`.
- Schema validators can take an optional
raw_data
argument which contains raw input data, incl. data not specified in the schema (:issue:`127`). Thanks :user:`ryanlowe0`. - Add
validate.OneOf
(:issue:`135`) andvalidate.ContainsOnly
(:issue:`149`) validators. Thanks :user:`philtay`. - Error messages for validators can be interpolated with {input} and other values (depending on the validator).
fields.TimeDelta
always serializes to an integer value in order to avoid rounding errors (:issue:`105`). Thanks :user:`philtay`.- Add
include
class Meta option to support field names which are Python keywords (:issue:`139`). Thanks :user:`nickretallack` for the suggestion. exclude
parameter is respected when used together withonly
parameter (:issue:`165`). Thanks :user:`lustdante` for the catch and patch.fields.List
works as expected with generators and sets (:issue:`185`). Thanks :user:`sergey-aganezov-jr`.
Deprecation/Removals:
MarshallingError
andUnmarshallingError
error are deprecated in favor of a singleValidationError
(:issue:`160`).context
argument passed to Method fields is deprecated. Useself.context
instead (:issue:`184`).- Remove
ForcedError
. - Remove support for generator functions that yield validators (:issue:`74`). Plain generators of validators are still supported.
- The
Select/Enum
field is deprecated in favor of using validate.OneOf validator (:issue:`135`). - Remove legacy, pre-1.0 API (
Schema.data
andSchema.errors
properties) (:issue:`73`). - Remove
null
value.
Other changes:
Marshaller
,Unmarshaller
were moved tomarshmallow.marshalling
. These should be considered private API (:issue:`129`).- Make
allow_null=True
the default forNested
fields. This will makeNone
serialize toNone
rather than a dictionary with empty values (:issue:`132`). Thanks :user:`nickrellack` for the suggestion.
Bug fixes:
- Fix validation error message for
fields.Decimal
. - Allow error message for
fields.Boolean
to be customized with theerror
parameter (like other fields).
Bug fixes:
- Fix validation of invalid types passed to a
Nested
field whenmany=True
(:issue:`188`). Thanks :user:`juanrossi` for reporting.
Support:
- Fix pep8 dev dependency for flake8. Thanks :user:`taion`.
Bug fixes:
- Fix behavior of
as_string
onfields.Integer
(:issue:`173`). Thanks :user:`taion` for the catch and patch.
Other changes:
- Remove dead code from
fields.Field
. Thanks :user:`taion`.
Support:
- Correction to
_postprocess
method in docs. Thanks again :user:`taion`.
Bug fixes:
- Fix inheritance of
ordered
class Meta option (:issue:`162`). Thanks :user:`stephenfin` for reporting.
Bug fixes:
- Fix behavior of
skip_missing
andaccessor
options whenmany=True
(:issue:`137`). Thanks :user:`3rdcycle`. - Fix bug that could cause an
AttributeError
when nesting schemas with schema-level validators (:issue:`144`). Thanks :user:`vovanbo` for reporting.
Bug fixes:
- A
Schema's
error_handler
--if defined--will execute ifSchema.validate
returns validation errors (:issue:`121`). - Deserializing None returns None rather than raising an
AttributeError
(:issue:`123`). Thanks :user:`RealSalmon` for the catch and patch.
Features:
- Add
QuerySelect
andQuerySelectList
fields (:issue:`84`). - Convert validators in
marshmallow.validate
into class-based callables to make them easier to use when declaring fields (:issue:`85`). - Add
Decimal
field which is safe to use when dealing with precise numbers (:issue:`86`).
Thanks :user:`philtay` for these contributions.
Bug fixes:
Date
fields correctly deserializes to adatetime.date
object whenpython-dateutil
is not installed (:issue:`79`). Thanks :user:`malexer` for the catch and patch.- Fix bug that raised an
AttributeError
when using a class-based validator. - Fix
as_string
behavior of Number fields when serializing to default value. - Deserializing
None
or the empty string with either aDateTime
,Date
,Time
orTimeDelta
results in the correct unmarshalling errors (:issue:`96`). Thanks :user:`svenstaro` for reporting and helping with this. - Fix error handling when deserializing invalid UUIDs (:issue:`106`). Thanks :user:`vesauimonen` for the catch and patch.
Schema.loads
correctly defaults to use the value ofself.many
rather than defaulting toFalse
(:issue:`108`). Thanks :user:`davidism` for the catch and patch.- Validators, data handlers, and preprocessors are no longer shared between schema subclasses (:issue:`88`). Thanks :user:`amikholap` for reporting.
- Fix error handling when passing a
dict
orlist
to aValidationError
(:issue:`110`). Thanks :user:`ksesong` for reporting.
Deprecation:
- The validator functions in the
validate
module are deprecated in favor of the class-based validators (:issue:`85`). - The
Arbitrary
,Price
, andFixed
fields are deprecated in favor of theDecimal
field (:issue:`86`).
Support:
- Update docs theme.
- Update contributing docs (:issue:`77`).
- Fix namespacing example in "Extending Schema" docs. Thanks :user:`Ch00k`.
- Exclude virtualenv directories from syntax checking (:issue:`99`). Thanks :user:`svenstaro`.
Features:
- Add
Schema.validate
method which validates input data against a schema. Similar toSchema.load
, but does not callmake_object
and only returns the errors dictionary. - Add several validation functions to the
validate
module. Thanks :user:`philtay`. - Store field name and instance on exceptions raised in
strict
mode.
Bug fixes:
- Fix serializing dictionaries when field names are methods of
dict
(e.g."items"
). Thanks :user:`rozenm` for reporting. - If a Nested field is passed
many=True
,None
serializes to an empty list. Thanks :user:`nickretallack` for reporting. - Fix behavior of
many
argument passed todump
andload
. Thanks :user:`svenstaro` for reporting and helping with this. - Fix
skip_missing
behavior forString
andList
fields. Thanks :user:`malexer` for reporting. - Fix compatibility with python-dateutil 2.3.
- More consistent error messages across DateTime, TimeDelta, Date, and Time fields.
Support:
- Update Flask and Peewee examples.
Hotfix release.
- Ensure that errors dictionary is correctly cleared on each call to Schema.dump and Schema.load.
Adds new features, speed improvements, better error handling, and updated documentation.
- Add
skip_missing
class Meta
option. - A field's
default
may be a callable. - Allow accessor function to be configured via the
Schema.accessor
decorator or the__accessor__
class member. URL
andEmail
fields are validated upon serialization.dump
andload
can receive themany
argument.- Move a number of utility functions from fields.py to utils.py.
- More useful
repr
forField
classes. - If a field's default is
fields.missing
and its serialized value isNone
, it will not be included in the final serialized result. - Schema.dumps no longer coerces its result to a binary string on Python 3.
- Backwards-incompatible: Schema output is no longer an
OrderedDict
by default. If you want ordered field output, you must explicitly set theordered
option toTrue
. - Backwards-incompatible: error parameter of the Field constructor is deprecated. Raise a ValidationError instead.
- Expanded test coverage.
- Updated docs.
Major reworking and simplification of the public API, centered around support for deserialization, improved validation, and a less stateful Schema
class.
- Rename
Serializer
toSchema
. - Support for deserialization.
- Use the
Schema.dump
andSchema.load
methods for serializing and deserializing, respectively. - Backwards-incompatible: Remove
Serializer.json
andSerializer.to_json
. UseSchema.dumps
instead. - Reworked fields interface.
- Backwards-incompatible:
Field
classes implement_serialize
and_deserialize
methods.serialize
anddeserialize
comprise the public API for aField
.Field.format
andField.output
have been removed. - Add
exceptions.ForcedError
which allows errors to be raised during serialization (instead of storing errors in theerrors
dict). - Backwards-incompatible:
DateTime
field serializes to ISO8601 format by default (instead of RFC822). - Backwards-incompatible: Remove
Serializer.factory
method. It is no longer necessary with thedump
method. - Backwards-incompatible: Allow nesting a serializer within itself recursively. Use
exclude
oronly
to prevent infinite recursion. - Backwards-incompatible: Multiple errors can be stored for a single field. The errors dictionary returned by
load
anddump
have lists of error messages keyed by field name. - Remove
validated
decorator. Validation occurs withinField
methods. Function
field raises aValueError
if an uncallable object is passed to its constructor.Nested
fields inherit context from their parent.- Add
Schema.preprocessor
andSchema.validator
decorators for registering preprocessing and schema-level validation functions respectively. - Custom error messages can be specified by raising a
ValidationError
within a validation function. - Extra keyword arguments passed to a Field are stored as metadata.
- Fix ordering of field output.
- Fix behavior of the
required
parameter onNested
fields. - Fix serializing keyed tuple types (e.g.
namedtuple
) withclass Meta
options. - Fix default value for
Fixed
andPrice
fields. - Fix serialization of binary strings.
Schemas
can inherit fields from non-Schema
base classes (e.g. mixins). Also, fields are inherited according to the MRO (rather than recursing over base classes). Thanks :user:`jmcarp`.- Add
Str
,Bool
, andInt
field class aliases.
- Add
Serializer.error_handler
decorator that registers a custom error handler. - Add
Serializer.data_handler
decorator that registers data post-processing callbacks. - Backwards-incompatible:
process_data
method is deprecated. Use thedata_handler
decorator instead. - Fix bug that raised error when passing
extra
data together withmany=True
. Thanks :user:`buttsicles` for reporting. - If
required=True
validation is violated for a givenField
, it will raise an error message that is different from the message specified by theerror
argument. Thanks :user:`asteinlein`. - More generic error message raised when required field is missing.
validated
decorator should only wrap aField
class'soutput
method.
- Fix bug in serializing keyed tuple types, e.g.
namedtuple
andKeyedTuple
. - Nested field can load a serializer by its class name as a string. This makes it easier to implement 2-way nesting.
- Make Serializer.data override-able.
- Add
Serializer.factory
for creating a factory function that returns a Serializer instance. MarshallingError
stores its underlying exception as an instance variable. This is useful for inspecting errors.fields.Select
is aliased tofields.Enum
.- Add
fields.__all__
andmarshmallow.__all__
so that the modules can be more easily extended. - Expose
Serializer.OPTIONS_CLASS
as a class variable so that options defaults can be overridden. - Add
Serializer.process_data
hook that allows subclasses to manipulate the final output data.
- Add
json_module
class Meta option. - Add
required
option to fields . Thanks :user:`DeaconDesperado`. - Tested on Python 3.4 and PyPy.
- Fix
Integer
field default. It is now0
instead of0.0
. Thanks :user:`kalasjocke`. - Add
context
param toSerializer
. Allows accessing arbitrary objects inFunction
andMethod
fields. Function
andMethod
fields raiseMarshallingError
if their argument is uncallable.
- Enable custom field validation via the
validate
parameter. - Add
utils.from_rfc
for parsing RFC datestring to Python datetime object.
- Avoid unnecessary attribute access in
utils.to_marshallable_type
for improved performance. - Fix RFC822 formatting for localized datetimes.
- Can customize validation error messages by passing the
error
parameter to a field. - Backwards-incompatible: Rename
fields.NumberField
->fields.Number
. - Add
fields.Select
. Thanks :user:`ecarreras`. - Support nesting a Serializer within itself by passing
"self"
intofields.Nested
(only up to depth=1). - Backwards-incompatible: No implicit serializing of collections. Must set
many=True
if serializing to a list. This ensures that marshmallow handles singular objects correctly, even if they are iterable. - If Nested field
only
parameter is a field name, only return a single value for the nested object (instead of a dict) or a flat list of values. - Improved performance and stability.
- An object's
__marshallable__
method, if defined, takes precedence over__getitem__
. - Generator expressions can be passed to a serializer.
- Better support for serializing list-like collections (e.g. ORM querysets).
- Other minor bugfixes.
- Add
additional
class Meta option. - Add
dateformat
class Meta option. - Support for serializing UUID, date, time, and timedelta objects.
- Remove
Serializer.to_data
method. Just useSerialize.data
property. - String field defaults to empty string instead of
None
. - Backwards-incompatible:
isoformat
andrfcformat
functions moved to utils.py. - Backwards-incompatible: Validation functions moved to validate.py.
- Backwards-incompatible: Remove types.py.
- Reorder parameters to
DateTime
field (first parameter is dateformat). - Ensure that
to_json
returns bytestrings. - Fix bug with including an object property in
fields
Meta option. - Fix bug with passing
None
to a serializer.
- Fix bug with serializing dictionaries.
- Fix error raised when serializing empty list.
- Add
only
andexclude
parameters to Serializer constructor. - Add
strict
parameter and option: causes Serializer to raise an error if invalid data are passed in, rather than storing errors. - Updated Flask + SQLA example in docs.
- Declaring Serializers just got easier. The class Meta paradigm allows you to specify fields more concisely. Can specify
fields
andexclude
options. - Allow date formats to be changed by passing
format
parameter toDateTime
field constructor. Can either be"rfc"
(default),"iso"
, or a date format string. - More useful error message when declaring fields as classes (instead of an instance, which is the correct usage).
- Rename MarshallingException -> MarshallingError.
- Rename marshmallow.core -> marshmallow.serializer.
- Allow prefixing field names.
- Fix storing errors on Nested Serializers.
- Python 2.6 support.
- Field-level validation.
- Add
fields.Method
. - Add
fields.Function
. - Allow binding of extra data to a serialized object by passing the
extra
param when initializing aSerializer
. - Add
relative
paramater tofields.Url
that allows for relative URLs.
- First release.