incoming 0.3.1

概述

验证任何东西都会变得非常混乱。json是最常用的 数据交换格式，incoming旨在解决 使用结构和易用性验证json。

incoming是一个用于验证json的小框架。这取决于你在哪里 如何使用。一个常见的用例（以及我写这篇文章的主要原因 framework）正在写入http服务器时验证传入的json。

安装

安装很简单。

pip install incoming

基本用法

importjsonfromdatetimeimportdatefromincomingimportdatatypes,PayloadValidatorclassMovieValidator(PayloadValidator):name=datatypes.String()rating=datatypes.Function('validate_rating',error='Rating must be in between 1 and 10.',)actors=datatypes.Array()is_3d=datatypes.Boolean()release_year=datatypes.Function('validate_release_year',error='Release year must be in between 1800 and current year.',)# validation method can be a regular methoddefvalidate_rating(self,val,*args,**kwargs):returnisinstance(val,int)andval>=1andval<=10# validation method can be a staticmethod as well@staticmethoddefvalidate_release_year(val,*args,**kwargs):returnall((isinstance(val,int),val>=1800,val<=date.today().year,))payload={'name':'Avengers','rating':5,'actors':['Robert Downey Jr.','Samuel L. Jackson','Scarlett Johansson','Mark Ruffalo'],'is_3d':True,'release_year':2012}result,errors=MovieValidator().validate(payload)assertresultanderrorsisNone,'Validation failed.\n%s'%json.dumps(errors,indent=2)payload={'name':'Avengers','rating':11,'actors':['Robert Downey Jr.','Samuel L. Jackson','Scarlett Johansson','Mark Ruffalo'],'is_3d':'True','release_year':9000}result,errors=MovieValidator().validate(payload)assertresultanderrorsisNone,'Validation failed.\n%s'%json.dumps(errors,indent=2)

如果运行上述脚本，您将获得：

Traceback (most recent call last):
  File "code.py", line 67, in <module>
    assert result and errors is None, 'Validation failed.\n%s' % json.dumps(errors, indent=2)
AssertionError: Validation failed.
{
  "rating": [
    "Rating must be in between 1 and 10."
  ],
  "is_3d": [
    "Invalid data. Expected a boolean value."
  ],
  "release_year": [
    "Release year must be in between 1800 and current year."
  ]
}

文档

文档可在Read The Docs上找到。

测试

只需运行：

python setup.py test

或：

py.test incoming

贡献者

• Vaidik Kapoor（作者）
• Dhruv Baldawa
• James Rowe

许可证

见LICENCE。

麻省理工学院许可证（MIT）

版权所有（c）2013 Vaidik Kapoor

兹免费准许任何人取得 本软件和相关文档文件（“软件”），用于处理 不受限制的软件，包括但不限于 使用、复制、修改、合并、发布、分发、再授权和/或出售 软件，并允许向其提供软件的人员这样做， 必须满足以下条件：

上述版权公告及本许可公告须包括在 软件的拷贝或大部分。

本软件按“原样”提供，无任何形式的保证，明示或 默示的，包括但不限于适销性、适用性的保证 为了特殊目的和不侵权。在任何情况下，作者或 版权持有人应对任何索赔、损害或其他责任负责，无论 在合同诉讼、侵权诉讼或其他诉讼中，由 与软件的连接或软件的使用或其他交易。

更改日志

开发版本