将常用范围表示法解析为Python对象
项目描述
py-range-parse

py-range-parse是一个库,用于将常用范围表示法解析为Python对象,这些对象的行为类似于集合。
py-range-parse被以下项目使用:
希望还有更多其他项目 :)
如何使用
pip install py-range-parse
from py_range_parse import parse_range
range = parse_range("[0..5]")
或手动创建
from py_range_parse import Range
range = Range(0,5)
输入格式
从str
解析Range
时,任何空白都将被忽略。
int
范围
如果起始值和结束值都是int
类型,则结果Range
将只考虑整数。如果您还想包括float
值,则至少有一个值必须是float
。
[-2 .. 5]
[10 .. 1]
如果结束值大于起始值,则结果范围将自动反转。因此,在Range
中range.start <= range.end
始终是True
。
float
范围
一个 float
Range
包含了从 开始 到 结束 之间所有可能的 float
值。
[-2.2 .. 5.123]
[-2.0 .. 5]
无穷大
无穷大也可以使用 inf
以及 Unicode 符号 ∞
来指定。由于它内部使用 math.inf
表示,所以它的行为类似于 float
。
]-inf .. inf[
]-∞ .. ∞[
排除边界
可以使用开括号符号独立地排除 开始 和 结束 值,使它们不在 Range
中。
]0 .. 5.5]
]0 .. inf[
操作
包含
您可以轻松检查一个值是否在给定的 Range
中,如下所示
> from py_range_parse import parse_range
> range = parse_range("[0 .. 5]")
> print(4 in range)
True
比较
您可以使用 ==
操作符比较两个 Range
实例的相等性。对于两个范围相等,它们必须具有相同的
start
值end
值- 开始包含
- 结束包含
- 类型(
int
或float
)
> from py_range_parse import parse_range
> range1 = parse_range("[0 .. 5]")
> range2 = parse_range("[0 .. 5]")
> range3 = parse_range("[0 .. 5.0]")
> print(range1 == range2)
True
> print(range1 == range3)
False
贡献
GitHub 是用于社交编码的地方:如果您想编写代码,我鼓励通过从这个仓库的分叉中提交拉取请求来贡献。为错误和新的特性创建 GitHub 事务,并对您感兴趣的事务进行评论。
许可协议
py-range-parse
Copyright (c) 2019 Markus Ressel
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.