Skip to content

filter kdocs #1288

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jul 1, 2025
Merged

filter kdocs #1288

merged 4 commits into from
Jul 1, 2025

Conversation

AndreiKingsley
Copy link
Collaborator

@AndreiKingsley AndreiKingsley commented Jun 30, 2025

Closes #1278

@AndreiKingsley
Copy link
Collaborator Author

Deprecated filterBy

@Jolanrensen Jolanrensen self-requested a review July 1, 2025 09:45
Copy link
Collaborator

@Jolanrensen Jolanrensen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great! just some small notes, as usual :)

*
* See also:
* - [drop][DataFrame.drop], which drops rows based on values within the row.
* - [distinct][DataFrame.distinct], which filters rows with duplicated values.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

*filters out? If you say "filters", it could also mean that you only keep rows with duplicate values.

*
* See also: [filter], which allows filtering rows based on values within the row.
*
* ### This Gather Overload
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Gather overload? ;P

@@ -110,6 +110,9 @@ internal const val CONVERT_TO_URL_REPLACE = "convertToUrl()"
internal const val TO_URL = "This function is replaced by `toUrl()`. $MESSAGE_1_0"
internal const val TO_URL_REPLACE = "toUrl()"

internal const val FILTER_BY = "This function is deprecated in favor of `filter { }`. $MESSAGE_1_0"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

double spaces

@@ -110,6 +110,9 @@ internal const val CONVERT_TO_URL_REPLACE = "convertToUrl()"
internal const val TO_URL = "This function is replaced by `toUrl()`. $MESSAGE_1_0"
internal const val TO_URL_REPLACE = "toUrl()"

internal const val FILTER_BY = "This function is deprecated in favor of `filter { }`. $MESSAGE_1_0"
internal const val FILTER_BY_REPLACE = "filter { column }"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure whether the ReplaceWith can fully handle this transition... in filterBy { column }, column is a ColumnAccessor<T>, in filter { column }, it's a value T. But let's keep it like this, the user can probably figure it out.

@ExcludeFromSources
internal interface FilterByDocs

/**
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

probably don't need kdocs for this if we're gonna deprecate it, right?

@AndreiKingsley AndreiKingsley merged commit 58012fc into master Jul 1, 2025
4 of 6 checks passed
@AndreiKingsley AndreiKingsley deleted the filter_kdocs branch July 1, 2025 11:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add KDocs for function filter and filterBy
2 participants