maykin-json-logic-py 0.13.0

简单

from json_logic import jsonLogic
jsonLogic( { "==" : [1, 1] } )
# True

这是一个简单的测试，相当于1 == 1。关于格式的一些注意事项

1. 运算符始终位于“键”位置。每个JsonLogic规则只有一个键。

2. 值通常是数组。

3. 每个值可以是字符串、数字、布尔值、数组（非关联数组）或null

复合

这里我们开始嵌套规则。

jsonLogic(
  {"and" : [
    { ">" : [3,1] },
    { "<" : [1,3] }
  ] }
)
# True

在算符优先语言（如Python）中，这可以写成

( (3 > 1) and (1 < 3) )

数据驱动

显然，如果这些规则只能接受静态字面数据，它们就不会很有趣。通常，jsonLogic 会与一个规则对象和一个数据对象一起调用。您可以使用 var 操作符来获取数据对象的属性

jsonLogic(
  { "var" : ["a"] }, # Rule
  { a : 1, b : 2 }   # Data
)
# 1

如果您喜欢，我们支持在一元运算符上使用 语法糖 以跳过值周围的数组

jsonLogic(
  { "var" : "a" },
  { a : 1, b : 2 }
)
# 1

您还可以使用 var 操作符通过数字索引访问数组

jsonLogic(
  {"var" : 1 },
  [ "apple", "banana", "carrot" ]
)
# "banana"

这里有一个混合了字面值和数据对象复杂规则的例子。只有当派对这个温度低于110度并且装满了苹果时，它才准备好吃。

rules = { "and" : [
  {"<" : [ { "var" : "temp" }, 110 ]},
  {"==" : [ { "var" : "pie.filling" }, "apple" ] }
] }

data = { "temp" : 100, "pie" : { "filling" : "apple" } }

jsonLogic(rules, data)
# True

日期

您可以使用 date 操作符将日期包含在 json 逻辑中。日期在内部被转换为 datetime.date 对象，然后执行比较。

rule = {"<=": [{"date": {"var": "testDate"}}, {"date": "2021-01-01"}]}
data = {"testDate": "2020-01-01"}

jsonLogic(rule, data)
# True

运算符 {"today": []} 获取当前日期。您还可以向日期添加/减去年。这是使用 dateutils 的 relativedelta 来实现的。

rule = {"-": [{"date": "2021-01-01"}, {"years": 18}]}

jsonLogic(rule)
# date(2003, 1, 1)

日期时间

您可以使用 datetime 操作符将日期时间包含在 json 逻辑中。日期时间在内部被转换为 datetime.datetime 对象，然后执行比较。

rule = {
    "<=": [
        {"datetime": {"var": "testDatetime"}},
        {"datetime": "2022-12-01T10:00:00.000+02:00"},
    ]
}
data = {"testDatetime": "2022-11-01T10:00:00.000+02:00"}

jsonLogic(rule, data)
# True

总是和从不

有时您想要处理的规则是“总是”或“从不”。如果传递给 jsonLogic 的第一个参数不是对象或非关联数组，它将立即返回。

#Always
jsonLogic(True, data_will_be_ignored);
# True

#Never
jsonLogic(False, i_wasnt_even_supposed_to_be_here);
# False