@@ -15,6 +15,8 @@ import org.jetbrains.kotlinx.dataframe.documentation.DslGrammarTemplateColumnsSe
15
15
import org.jetbrains.kotlinx.dataframe.documentation.Indent
16
16
import org.jetbrains.kotlinx.dataframe.documentation.LineBreak
17
17
import org.jetbrains.kotlinx.dataframe.impl.columns.atAnyDepthImpl
18
+ import org.jetbrains.kotlinx.dataframe.util.COLS_AT_ANY_DEPTH
19
+ import org.jetbrains.kotlinx.dataframe.util.COLS_AT_ANY_DEPTH_REPLACE
18
20
import kotlin.reflect.KProperty
19
21
20
22
// region ColumnsSelectionDsl
@@ -36,18 +38,16 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
36
38
* {@include [DslGrammarTemplate.ColumnSetDef]}
37
39
* {@include [LineBreak]}
38
40
* {@include [DslGrammarTemplate.ColumnGroupDef]}
39
- * {@include [LineBreak]}
40
- * {@include [DslGrammarTemplate.ConditionDef]}
41
41
* }
42
42
*
43
43
* {@set [DslGrammarTemplate.PLAIN_DSL_FUNCTIONS]
44
- * {@include [PlainDslName]}` [ `**`{ `**{@include [DslGrammarTemplate.ConditionRef]}**` \}`**` ] `
44
+ * {@include [PlainDslName]}`() `
45
45
* }
46
46
* {@set [DslGrammarTemplate.COLUMN_SET_FUNCTIONS]
47
- * {@include [Indent]}{@include [ColumnSetName]}` [ `**`{ `**{@include [DslGrammarTemplate.ConditionRef]}**` \}`**` ] `
47
+ * {@include [Indent]}{@include [ColumnSetName]}`() `
48
48
* }
49
49
* {@set [DslGrammarTemplate.COLUMN_GROUP_FUNCTIONS]
50
- * {@include [Indent]}{@include [ColumnGroupName]}` [ `**`{ `**{@include [DslGrammarTemplate.ConditionRef]}**` \}`**` ] `
50
+ * {@include [Indent]}{@include [ColumnGroupName]}`() `
51
51
* }
52
52
*/
53
53
public interface Grammar {
@@ -99,11 +99,11 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
99
99
*
100
100
* `dfsOf<Type> { condition } -> `[colsAtAnyDepth][colsAtAnyDepth]`().`[colsOf][ColumnsSelectionDsl.colsOf]`<Type> { condition }`
101
101
*
102
- * [cols][ColumnsSelectionDsl.cols]` { condition }.`[ recursively][recursively]` () -> `[colsAtAnyDepth][colsAtAnyDepth]`().`[filter][FilterColumnsSelectionDsl.filter]` { condition }`
102
+ * [cols][ColumnsSelectionDsl.cols]` { condition }.recursively() -> `[colsAtAnyDepth][colsAtAnyDepth]`().`[filter][FilterColumnsSelectionDsl.filter]` { condition }`
103
103
*
104
- * [first][ColumnsSelectionDsl.first]` { condition }.`[ rec][rec]` () -> `[colsAtAnyDepth][colsAtAnyDepth]` { condition }.`[first][ColumnsSelectionDsl.first]`()`
104
+ * [first][ColumnsSelectionDsl.first]` { condition }.rec() -> `[colsAtAnyDepth][colsAtAnyDepth]` { condition }.`[first][ColumnsSelectionDsl.first]`()`
105
105
*
106
- * [all][ColumnsSelectionDsl.all]`().`[ recursively][recursively]` () -> `[colsAtAnyDepth][colsAtAnyDepth]`()`
106
+ * [all][ColumnsSelectionDsl.all]`().recursively() -> `[colsAtAnyDepth][colsAtAnyDepth]`()`
107
107
*
108
108
* @see [DataFrame.flatten\]
109
109
* @see [ColumnsSelectionDsl.simplify\]
@@ -121,7 +121,11 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
121
121
* `df.`[select][DataFrame.select]` { `[colGroups][ColumnsSelectionDsl.colGroups]`().`[colsAtAnyDepth][ColumnsSelectionDsl.colsAtAnyDepth]` { "Alice" `[in][Iterable.contains]` it.`[values][DataColumn.values]`() } }`
122
122
*/
123
123
@Interpretable(" ColsAtAnyDepth0" )
124
- @Deprecated(" " , replaceWith = ReplaceWith (" colsAtAnyDepth().filter(predicate)" ))
124
+ @Deprecated(
125
+ message = COLS_AT_ANY_DEPTH ,
126
+ replaceWith = ReplaceWith (COLS_AT_ANY_DEPTH_REPLACE ),
127
+ level = DeprecationLevel .WARNING ,
128
+ )
125
129
public fun ColumnSet <* >.colsAtAnyDepth (predicate : ColumnFilter <* > = { true }): ColumnSet <* > =
126
130
colsAtAnyDepthInternal(predicate)
127
131
@@ -143,7 +147,11 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
143
147
* `df.`[select][DataFrame.select]` { `[colsAtAnyDepth][ColumnsSelectionDsl.colsAtAnyDepth]` { !it.`[isColumnGroup][DataColumn.isColumnGroup]` } }`
144
148
*/
145
149
@Interpretable(" ColsAtAnyDepth1" )
146
- @Deprecated(" " , replaceWith = ReplaceWith (" colsAtAnyDepth().filter(predicate)" ))
150
+ @Deprecated(
151
+ message = COLS_AT_ANY_DEPTH ,
152
+ replaceWith = ReplaceWith (COLS_AT_ANY_DEPTH_REPLACE ),
153
+ level = DeprecationLevel .WARNING ,
154
+ )
147
155
public fun ColumnsSelectionDsl <* >.colsAtAnyDepth (predicate : ColumnFilter <* > = { true }): ColumnSet <* > =
148
156
asSingleColumn().colsAtAnyDepthInternal(predicate)
149
157
@@ -165,7 +173,11 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
165
173
* `df.`[select][DataFrame.select]` { myColGroup.`[colsAtAnyDepth][SingleColumn.colsAtAnyDepth]` { "Alice" `[in][Iterable.contains]` it.`[values][DataColumn.values]`() } }`
166
174
*/
167
175
@Interpretable(" ColsAtAnyDepth2" )
168
- @Deprecated(" " , replaceWith = ReplaceWith (" colsAtAnyDepth().filter(predicate)" ))
176
+ @Deprecated(
177
+ message = COLS_AT_ANY_DEPTH ,
178
+ replaceWith = ReplaceWith (COLS_AT_ANY_DEPTH_REPLACE ),
179
+ level = DeprecationLevel .WARNING ,
180
+ )
169
181
public fun SingleColumn <DataRow <* >>.colsAtAnyDepth (predicate : ColumnFilter <* > = { true }): ColumnSet <* > =
170
182
ensureIsColumnGroup().colsAtAnyDepthInternal(predicate)
171
183
@@ -185,7 +197,11 @@ public interface ColsAtAnyDepthColumnsSelectionDsl {
185
197
*
186
198
* `df.`[select][DataFrame.select]` { "myColumnGroup".`[colsAtAnyDepth][String.colsAtAnyDepth]` { "Alice" `[in][Iterable.contains]` it.`[values][DataColumn.values]`() } }`
187
199
*/
188
- @Deprecated(" " , replaceWith = ReplaceWith (" colsAtAnyDepth().filter(predicate)" ))
200
+ @Deprecated(
201
+ message = COLS_AT_ANY_DEPTH ,
202
+ replaceWith = ReplaceWith (COLS_AT_ANY_DEPTH_REPLACE ),
203
+ level = DeprecationLevel .WARNING ,
204
+ )
189
205
public fun String.colsAtAnyDepth (predicate : ColumnFilter <* > = { true }): ColumnSet <* > =
190
206
columnGroup(this ).colsAtAnyDepth(predicate)
191
207
0 commit comments