⚠️ Remove filters

Filters were a feature very few people use and caused a lot of problems
to add new features. Since we can replicate the result using standard
Julia functions (like `filter` and `map`), we decided to remove it from
PrettyTables.jl to make it easier to maintain the code. For more
information, please, refer to:

    https://discourse.julialang.org/t/question-for-prettytables-jl-users-can-we-remove-filters/82609/8

Author: ronisbr

docs/make.jl

@@ -18,7 +18,6 @@ makedocs(
             "LaTeX"          => "man/latex_backend.md",
         ],
         "Alignment"          => "man/alignment.md",
-        "Filters"            => "man/filters.md",
         "Formatters"         => "man/formatters.md",
         "Examples"           => Any[
             "Text back-end"  => "man/text_examples.md",

docs/src/assets/ex_00011.png

@@ -30,7 +30,6 @@ Pages = [
     "man/html_backend.md"
     "man/latex_backend.md"
     "man/alignment.md"
-    "man/filters.md"
     "man/formatters.md"
     "man/text_examples.md"
     "man/html_examples.md"

docs/src/index.md

@@ -34,11 +34,10 @@ passed as keywords when calling the function [`pretty_table`](@ref):
         drawn if `0` is in `hlines`, and the header and subheaders are
         considered as only 1 row. Furthermore, it is important to mention that
         the row number in this variable is related to the **printed rows**.
-        Thus, it is affected by filters, and by the option to suppress the
-        header `noheader`. Finally, for convenience, the top and bottom lines
-        can be drawn by adding the symbols `:begin` and `:end` to this vector,
-        respectively, and the line after the header can be drawn by adding the
-        symbol `:header`.
+        Thus, it is affected by the option to suppress the header `noheader`.
+        Finally, for convenience, the top and bottom lines can be drawn by
+        adding the symbols `:begin` and `:end` to this vector, respectively, and
+        the line after the header can be drawn by adding the symbol `:header`.
 
 !!! info
     The values of `body_hlines` will be appended to this vector. Thus,
@@ -65,10 +64,10 @@ passed as keywords when calling the function [`pretty_table`](@ref):
     case, the vertical lines will be drawn only after the columns in the vector.
     Notice that the left border will be drawn if `0` is in `vlines`.
     Furthermore, it is important to mention that the column number in this
-    variable is related to the **printed columns**. Thus, it is affected by
-    filters, and by the columns added using the variable `show_row_number`.
-    Finally, for convenience, the left and right border can be drawn by adding
-    the symbols `:begin` and `:end` to this vector, respectively.
+    variable is related to the **printed columns**. Thus, it is affected by the
+    columns added using the variable `show_row_number`. Finally, for
+    convenience, the left and right border can be drawn by adding the symbols
+    `:begin` and `:end` to this vector, respectively.
     (**Default** = `:none`)
 - `wrap_table::Union{Nothing, String}`: This variable controls whether to wrap
     the table in a environment defined by the variable `wrap_table_environment`.

docs/src/man/filters.md

@@ -96,11 +96,10 @@ passed as keywords when calling the function `pretty_table`:
         drawn if `0` is in `hlines`, and the header and subheaders are
         considered as only 1 row. Furthermore, it is important to mention that
         the row number in this variable is related to the **printed rows**.
-        Thus, it is affected by filters, and by the option to suppress the
-        header `show_header`. Finally, for convenience, the top and bottom lines
-        can be drawn by adding the symbols `:begin` and `:end` to this vector,
-        respectively, and the line after the header can be drawn by adding the
-        symbol `:header`.
+        Thus, it is affected by the option to suppress the header `show_header`.
+        Finally, for convenience, the top and bottom lines can be drawn by
+        adding the symbols `:begin` and `:end` to this vector, respectively, and
+        the line after the header can be drawn by adding the symbol `:header`.
 
 !!! info
     The values of `body_hlines` will be appended to this vector. Thus,
@@ -152,11 +151,11 @@ passed as keywords when calling the function `pretty_table`:
         after the columns in the vector. Notice that the top line will be drawn
         if `0` is in `vlines`. Furthermore, it is important to mention that the
         column number in this variable is related to the **printed column**.
-        Thus, it is affected by filters, and by the options `row_names` and
-        `show_row_number`. Finally, for convenience, the left and right vertical
-        lines can be drawn by adding the symbols `:begin` and `:end` to this
-        vector, respectively, and the line after the header can be drawn by
-        adding the symbol `:header`.
+        Thus, it is affected by the options `row_names` and `show_row_number`.
+        Finally, for convenience, the left and right vertical lines can be drawn
+        by adding the symbols `:begin` and `:end` to this vector, respectively,
+        and the line after the header can be drawn by adding the symbol
+        `:header`.
 
 The following keywords related to crayons are available to customize the output
 decoration:

docs/src/man/latex_backend.md

@@ -124,25 +124,6 @@ julia> pretty_table(data, tf = tf_borderless, show_header = false)
 
 ![](../assets/ex_00010.png)
 
-In the following, it is shown how the filters can be used to print only the even
-rows and columns:
-
-```julia-repl
-julia> A = [(0:1:10)'
-            (1:1:11)'
-            (2:1:12)'
-            (3:1:13)'
-            (4:1:14)']
-
-julia> f_c(data, i) = i % 2 == 0
-
-julia> f_r(data, i) = i % 2 == 0
-
-julia> pretty_table(A, filters_row = (f_r,), filters_col = (f_c,), show_row_number = true)
-```
-
-![](../assets/ex_00011.png)
-
 By default, if the data is larger than the display, then it will be cropped to
 fit it. This can be changed by using the keywords `crop` and `display_size`.
 

docs/src/man/text_backend.md

@@ -72,8 +72,6 @@ Each back-end defines its own configuration keywords that can be passed using
     will be printed. (**Default** = `false`)
 - `compact_printing::Bool`: Select if the option `:compact` will be used when
     printing the data. (**Default** = `true`)
-- `column_filters::Union{Nothing, Tuple}`: Filters for the columns (see the
-    section [Filters](@ref)).
 - `formatters::Union{Nothing, Function, Tuple}`: See the section
     [Formatters](@ref).
 - `header::Union{Symbol, Vector{Symbol}}`: The header must be a tuple of
@@ -107,8 +105,6 @@ Each back-end defines its own configuration keywords that can be passed using
     `print` or `:show` to use the function `show`. Notice that this selection is
     applicable only to the table data. Headers, sub-headers, and row name column
     are always rendered with print. (**Default** = `:print`)
-- `row_filters::Union{Nothing, Tuple}`: Filters for the rows (see the section
-    [Filters](@ref)).
 - `row_names::Union{Nothing, AbstractVector}`: A vector containing the row names
     that will be appended to the left of the table. If it is `nothing`, then the
     column with the row names will not be shown. Notice that the size of this

docs/src/man/text_examples.md

@@ -111,17 +111,6 @@ function precompilation_input()
 
     pretty_table(dict, sortkeys = true)
 
-    # Filters
-    # ==========================================================================
-
-    pretty_table(data, filters_row = ((data, i) -> i % 2 == 0,))
-    pretty_table(data, filters_col = ((data, i) -> i % 2 == 0,))
-    pretty_table(
-        data,
-        filters_col = ((data, i) -> i % 2 == 0,),
-        filters_row = ((data, i) -> i % 2 == 0,)
-    )
-
     # Input: Data with URLTextCell
     # ==========================================================================