Skip to content

Commit cdb1ac9

Browse files
authored
docs: Fix docs check list items (#340)
1 parent e6ebab1 commit cdb1ac9

13 files changed

Lines changed: 160 additions & 96 deletions

File tree

dataframely/columns/_base.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,15 +60,19 @@ def __init__(
6060
this checks uniqueness for this column independently. Multiple columns
6161
can each have `unique=True` without forming a composite constraint.
6262
check: A custom rule or multiple rules to run for this column. This can be:
63+
6364
- A single callable that returns a non-aggregated boolean expression.
64-
The name of the rule is derived from the callable name, or defaults to
65-
"check" for lambdas.
65+
The name of the rule is derived from the callable name, or defaults to
66+
"check" for lambdas.
67+
6668
- A list of callables, where each callable returns a non-aggregated
67-
boolean expression. The name of the rule is derived from the callable
68-
name, or defaults to "check" for lambdas. Where multiple rules result
69-
in the same name, the suffix __i is appended to the name.
69+
boolean expression. The name of the rule is derived from the callable
70+
name, or defaults to "check" for lambdas. Where multiple rules result
71+
in the same name, the suffix __i is appended to the name.
72+
7073
- A dictionary mapping rule names to callables, where each callable
71-
returns a non-aggregated boolean expression.
74+
returns a non-aggregated boolean expression.
75+
7276
All rule names provided here are given the prefix `"check_"`.
7377
alias: An overwrite for this column's name which allows for using a column
7478
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/any.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,15 +34,19 @@ def __init__(
3434
"""
3535
Args:
3636
check: A custom rule or multiple rules to run for this column. This can be:
37+
3738
- A single callable that returns a non-aggregated boolean expression.
38-
The name of the rule is derived from the callable name, or defaults to
39-
"check" for lambdas.
39+
The name of the rule is derived from the callable name, or defaults to
40+
"check" for lambdas.
41+
4042
- A list of callables, where each callable returns a non-aggregated
41-
boolean expression. The name of the rule is derived from the callable
42-
name, or defaults to "check" for lambdas. Where multiple rules result
43-
in the same name, the suffix __i is appended to the name.
43+
boolean expression. The name of the rule is derived from the callable
44+
name, or defaults to "check" for lambdas. Where multiple rules result
45+
in the same name, the suffix __i is appended to the name.
46+
4447
- A dictionary mapping rule names to callables, where each callable
45-
returns a non-aggregated boolean expression.
48+
returns a non-aggregated boolean expression.
49+
4650
All rule names provided here are given the prefix `"check_"`.
4751
alias: An overwrite for this column's name which allows for using a column
4852
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/array.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -50,15 +50,19 @@ def __init__(
5050
this checks uniqueness for this column independently. Multiple columns
5151
can each have `unique=True` without forming a composite constraint.
5252
check: A custom rule or multiple rules to run for this column. This can be:
53+
5354
- A single callable that returns a non-aggregated boolean expression.
54-
The name of the rule is derived from the callable name, or defaults to
55-
"check" for lambdas.
55+
The name of the rule is derived from the callable name, or defaults to
56+
"check" for lambdas.
57+
5658
- A list of callables, where each callable returns a non-aggregated
57-
boolean expression. The name of the rule is derived from the callable
58-
name, or defaults to "check" for lambdas. Where multiple rules result
59-
in the same name, the suffix __i is appended to the name.
59+
boolean expression. The name of the rule is derived from the callable
60+
name, or defaults to "check" for lambdas. Where multiple rules result
61+
in the same name, the suffix __i is appended to the name.
62+
6063
- A dictionary mapping rule names to callables, where each callable
61-
returns a non-aggregated boolean expression.
64+
returns a non-aggregated boolean expression.
65+
6266
All rule names provided here are given the prefix `"check_"`.
6367
alias: An overwrite for this column's name which allows for using a column
6468
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/categorical.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -40,15 +40,19 @@ def __init__(
4040
this checks uniqueness for this column independently. Multiple columns
4141
can each have `unique=True` without forming a composite constraint.
4242
check: A custom rule or multiple rules to run for this column. This can be:
43+
4344
- A single callable that returns a non-aggregated boolean expression.
44-
The name of the rule is derived from the callable name, or defaults to
45-
"check" for lambdas.
45+
The name of the rule is derived from the callable name, or defaults to
46+
"check" for lambdas.
47+
4648
- A list of callables, where each callable returns a non-aggregated
47-
boolean expression. The name of the rule is derived from the callable
48-
name, or defaults to "check" for lambdas. Where multiple rules result
49-
in the same name, the suffix __i is appended to the name.
49+
boolean expression. The name of the rule is derived from the callable
50+
name, or defaults to "check" for lambdas. Where multiple rules result
51+
in the same name, the suffix __i is appended to the name.
52+
5053
- A dictionary mapping rule names to callables, where each callable
51-
returns a non-aggregated boolean expression.
54+
returns a non-aggregated boolean expression.
55+
5256
All rule names provided here are given the prefix `"check_"`.
5357
alias: An overwrite for this column's name which allows for using a column
5458
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/datetime.py

Lines changed: 40 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -69,15 +69,19 @@ def __init__(
6969
For example, a value `1mo` expects all dates to be on the first of the
7070
month. Note that this setting does *not* affect the storage resolution.
7171
check: A custom rule or multiple rules to run for this column. This can be:
72+
7273
- A single callable that returns a non-aggregated boolean expression.
73-
The name of the rule is derived from the callable name, or defaults to
74-
"check" for lambdas.
74+
The name of the rule is derived from the callable name, or defaults to
75+
"check" for lambdas.
76+
7577
- A list of callables, where each callable returns a non-aggregated
76-
boolean expression. The name of the rule is derived from the callable
77-
name, or defaults to "check" for lambdas. Where multiple rules result
78-
in the same name, the suffix __i is appended to the name.
78+
boolean expression. The name of the rule is derived from the callable
79+
name, or defaults to "check" for lambdas. Where multiple rules result
80+
in the same name, the suffix __i is appended to the name.
81+
7982
- A dictionary mapping rule names to callables, where each callable
80-
returns a non-aggregated boolean expression.
83+
returns a non-aggregated boolean expression.
84+
8185
All rule names provided here are given the prefix `"check_"`.
8286
alias: An overwrite for this column's name which allows for using a column
8387
name that is not a valid Python identifier. Especially note that setting
@@ -207,15 +211,19 @@ def __init__(
207211
For example, a value `1h` expects all times to be full hours. Note
208212
that this setting does *not* affect the storage resolution.
209213
check: A custom rule or multiple rules to run for this column. This can be:
214+
210215
- A single callable that returns a non-aggregated boolean expression.
211-
The name of the rule is derived from the callable name, or defaults to
212-
"check" for lambdas.
216+
The name of the rule is derived from the callable name, or defaults to
217+
"check" for lambdas.
218+
213219
- A list of callables, where each callable returns a non-aggregated
214-
boolean expression. The name of the rule is derived from the callable
215-
name, or defaults to "check" for lambdas. Where multiple rules result
216-
in the same name, the suffix __i is appended to the name.
220+
boolean expression. The name of the rule is derived from the callable
221+
name, or defaults to "check" for lambdas. Where multiple rules result
222+
in the same name, the suffix __i is appended to the name.
223+
217224
- A dictionary mapping rule names to callables, where each callable
218-
returns a non-aggregated boolean expression.
225+
returns a non-aggregated boolean expression.
226+
219227
All rule names provided here are given the prefix `"check_"`.
220228
alias: An overwrite for this column's name which allows for using a column
221229
name that is not a valid Python identifier. Especially note that setting
@@ -357,15 +365,19 @@ def __init__(
357365
`America/New_York`.
358366
time_unit: Unit of time. Defaults to `us` (microseconds).
359367
check: A custom rule or multiple rules to run for this column. This can be:
368+
360369
- A single callable that returns a non-aggregated boolean expression.
361-
The name of the rule is derived from the callable name, or defaults to
362-
"check" for lambdas.
370+
The name of the rule is derived from the callable name, or defaults to
371+
"check" for lambdas.
372+
363373
- A list of callables, where each callable returns a non-aggregated
364-
boolean expression. The name of the rule is derived from the callable
365-
name, or defaults to "check" for lambdas. Where multiple rules result
366-
in the same name, the suffix __i is appended to the name.
374+
boolean expression. The name of the rule is derived from the callable
375+
name, or defaults to "check" for lambdas. Where multiple rules result
376+
in the same name, the suffix __i is appended to the name.
377+
367378
- A dictionary mapping rule names to callables, where each callable
368-
returns a non-aggregated boolean expression.
379+
returns a non-aggregated boolean expression.
380+
369381
All rule names provided here are given the prefix `"check_"`.
370382
alias: An overwrite for this column's name which allows for using a column
371383
name that is not a valid Python identifier. Especially note that setting
@@ -521,15 +533,19 @@ def __init__(
521533
that this setting does *not* affect the storage resolution.
522534
time_unit: Unit of time. Defaults to `us` (microseconds).
523535
check: A custom rule or multiple rules to run for this column. This can be:
536+
524537
- A single callable that returns a non-aggregated boolean expression.
525-
The name of the rule is derived from the callable name, or defaults to
526-
"check" for lambdas.
538+
The name of the rule is derived from the callable name, or defaults to
539+
"check" for lambdas.
540+
527541
- A list of callables, where each callable returns a non-aggregated
528-
boolean expression. The name of the rule is derived from the callable
529-
name, or defaults to "check" for lambdas. Where multiple rules result
530-
in the same name, the suffix __i is appended to the name.
542+
boolean expression. The name of the rule is derived from the callable
543+
name, or defaults to "check" for lambdas. Where multiple rules result
544+
in the same name, the suffix __i is appended to the name.
545+
531546
- A dictionary mapping rule names to callables, where each callable
532-
returns a non-aggregated boolean expression.
547+
returns a non-aggregated boolean expression.
548+
533549
All rule names provided here are given the prefix `"check_"`.
534550
alias: An overwrite for this column's name which allows for using a column
535551
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/decimal.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -58,15 +58,19 @@ def __init__(
5858
max_exclusive: Like `max` but exclusive. May not be specified if `max`
5959
is specified and vice versa.
6060
check: A custom rule or multiple rules to run for this column. This can be:
61+
6162
- A single callable that returns a non-aggregated boolean expression.
62-
The name of the rule is derived from the callable name, or defaults to
63-
"check" for lambdas.
63+
The name of the rule is derived from the callable name, or defaults to
64+
"check" for lambdas.
65+
6466
- A list of callables, where each callable returns a non-aggregated
65-
boolean expression. The name of the rule is derived from the callable
66-
name, or defaults to "check" for lambdas. Where multiple rules result
67-
in the same name, the suffix __i is appended to the name.
67+
boolean expression. The name of the rule is derived from the callable
68+
name, or defaults to "check" for lambdas. Where multiple rules result
69+
in the same name, the suffix __i is appended to the name.
70+
6871
- A dictionary mapping rule names to callables, where each callable
69-
returns a non-aggregated boolean expression.
72+
returns a non-aggregated boolean expression.
73+
7074
All rule names provided here are given the prefix `"check_"`.
7175
alias: An overwrite for this column's name which allows for using a column
7276
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/enum.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -47,15 +47,19 @@ def __init__(
4747
this checks uniqueness for this column independently. Multiple columns
4848
can each have `unique=True` without forming a composite constraint.
4949
check: A custom rule or multiple rules to run for this column. This can be:
50+
5051
- A single callable that returns a non-aggregated boolean expression.
51-
The name of the rule is derived from the callable name, or defaults to
52-
"check" for lambdas.
52+
The name of the rule is derived from the callable name, or defaults to
53+
"check" for lambdas.
54+
5355
- A list of callables, where each callable returns a non-aggregated
54-
boolean expression. The name of the rule is derived from the callable
55-
name, or defaults to "check" for lambdas. Where multiple rules result
56-
in the same name, the suffix __i is appended to the name.
56+
boolean expression. The name of the rule is derived from the callable
57+
name, or defaults to "check" for lambdas. Where multiple rules result
58+
in the same name, the suffix __i is appended to the name.
59+
5760
- A dictionary mapping rule names to callables, where each callable
58-
returns a non-aggregated boolean expression.
61+
returns a non-aggregated boolean expression.
62+
5963
All rule names provided here are given the prefix `"check_"`.
6064
alias: An overwrite for this column's name which allows for using a column
6165
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/float.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,15 +60,19 @@ def __init__(
6060
max_exclusive: Like `max` but exclusive. May not be specified if `max`
6161
is specified and vice versa.
6262
check: A custom rule or multiple rules to run for this column. This can be:
63+
6364
- A single callable that returns a non-aggregated boolean expression.
64-
The name of the rule is derived from the callable name, or defaults to
65-
"check" for lambdas.
65+
The name of the rule is derived from the callable name, or defaults to
66+
"check" for lambdas.
67+
6668
- A list of callables, where each callable returns a non-aggregated
67-
boolean expression. The name of the rule is derived from the callable
68-
name, or defaults to "check" for lambdas. Where multiple rules result
69-
in the same name, the suffix __i is appended to the name.
69+
boolean expression. The name of the rule is derived from the callable
70+
name, or defaults to "check" for lambdas. Where multiple rules result
71+
in the same name, the suffix __i is appended to the name.
72+
7073
- A dictionary mapping rule names to callables, where each callable
71-
returns a non-aggregated boolean expression.
74+
returns a non-aggregated boolean expression.
75+
7276
All rule names provided here are given the prefix `"check_"`.
7377
alias: An overwrite for this column's name which allows for using a column
7478
name that is not a valid Python identifier. Especially note that setting

dataframely/columns/integer.py

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -56,15 +56,19 @@ def __init__(
5656
is_in: A (non-contiguous) list of integers indicating valid values in this
5757
column. If specified, both `min` and `max` must not bet set.
5858
check: A custom rule or multiple rules to run for this column. This can be:
59+
5960
- A single callable that returns a non-aggregated boolean expression.
60-
The name of the rule is derived from the callable name, or defaults to
61-
"check" for lambdas.
61+
The name of the rule is derived from the callable name, or defaults to
62+
"check" for lambdas.
63+
6264
- A list of callables, where each callable returns a non-aggregated
63-
boolean expression. The name of the rule is derived from the callable
64-
name, or defaults to "check" for lambdas. Where multiple rules result
65-
in the same name, the suffix __i is appended to the name.
65+
boolean expression. The name of the rule is derived from the callable
66+
name, or defaults to "check" for lambdas. Where multiple rules result
67+
in the same name, the suffix __i is appended to the name.
68+
6669
- A dictionary mapping rule names to callables, where each callable
67-
returns a non-aggregated boolean expression.
70+
returns a non-aggregated boolean expression.
71+
6872
All rule names provided here are given the prefix `"check_"`.
6973
alias: An overwrite for this column's name which allows for using a column
7074
name that is not a valid Python identifier. Especially note that setting

0 commit comments

Comments
 (0)