Add new upcase and downcase verbs (#1217)

* upcase/downcase verbs

* unit-test cases

* doc files

* remaining `make dev` artifacts: manpage

docs/src/manpage.md

@@ -191,13 +191,14 @@ MILLER(1)                                                            MILLER(1)
 
 1mVERB LIST0m
        altkv bar bootstrap cat check clean-whitespace count-distinct count
-       count-similar cut decimate fill-down fill-empty filter flatten format-values
-       fraction gap grep group-by group-like having-fields head histogram json-parse
-       json-stringify join label latin1-to-utf8 least-frequent merge-fields
-       most-frequent nest nothing put regularize remove-empty-columns rename reorder
-       repeat reshape sample sec2gmtdate sec2gmt seqgen shuffle skip-trivial-records
-       sort sort-within-records split stats1 stats2 step summary tac tail tee
-       template top utf8-to-latin1 unflatten uniq unspace unsparsify
+       count-similar cut decimate downcase fill-down fill-empty filter flatten
+       format-values fraction gap grep group-by group-like having-fields head
+       histogram json-parse json-stringify join label latin1-to-utf8 least-frequent
+       merge-fields most-frequent nest nothing put regularize remove-empty-columns
+       rename reorder repeat reshape sample sec2gmtdate sec2gmt seqgen shuffle
+       skip-trivial-records sort sort-within-records split stats1 stats2 step summary
+       tac tail tee template top utf8-to-latin1 unflatten uniq unspace unsparsify
+       upcase
 
 1mFUNCTION LIST0m
        abs acos acosh any append apply arrayify asin asinh asserting_absent
@@ -1002,6 +1003,14 @@ MILLER(1)                                                            MILLER(1)
         -n {n} Decimation factor (default 10).
        -h|--help Show this message.
 
+   1mdowncase0m
+       Usage: mlr downcase [options]
+       Lowercases strings in record keys and/or values.
+       Options:
+       -k        Downcase only keys, not keys and values.
+       -v        Downcase only values, not keys and values.
+       -h|--help Show this message.
+
    1mfill-down0m
        Usage: mlr fill-down [options]
        If a given record has a missing value for a given field, fill that from
@@ -2111,6 +2120,14 @@ MILLER(1)                                                            MILLER(1)
        being 'b=3,c=4', then the output is the two records 'a=1,b=2,c=' and
        'a=,b=3,c=4'.
 
+   1mupcase0m
+       Usage: mlr upcase [options]
+       Uppercases strings in record keys and/or values.
+       Options:
+       -k        Upcase only keys, not keys and values.
+       -v        Upcase only values, not keys and values.
+       -h|--help Show this message.
+
 1mFUNCTIONS FOR FILTER/PUT0m
    1mabs0m
         (class=math #args=1) Absolute value.

docs/src/manpage.txt

@@ -170,13 +170,14 @@ MILLER(1)                                                            MILLER(1)
 
 1mVERB LIST0m
        altkv bar bootstrap cat check clean-whitespace count-distinct count
-       count-similar cut decimate fill-down fill-empty filter flatten format-values
-       fraction gap grep group-by group-like having-fields head histogram json-parse
-       json-stringify join label latin1-to-utf8 least-frequent merge-fields
-       most-frequent nest nothing put regularize remove-empty-columns rename reorder
-       repeat reshape sample sec2gmtdate sec2gmt seqgen shuffle skip-trivial-records
-       sort sort-within-records split stats1 stats2 step summary tac tail tee
-       template top utf8-to-latin1 unflatten uniq unspace unsparsify
+       count-similar cut decimate downcase fill-down fill-empty filter flatten
+       format-values fraction gap grep group-by group-like having-fields head
+       histogram json-parse json-stringify join label latin1-to-utf8 least-frequent
+       merge-fields most-frequent nest nothing put regularize remove-empty-columns
+       rename reorder repeat reshape sample sec2gmtdate sec2gmt seqgen shuffle
+       skip-trivial-records sort sort-within-records split stats1 stats2 step summary
+       tac tail tee template top utf8-to-latin1 unflatten uniq unspace unsparsify
+       upcase
 
 1mFUNCTION LIST0m
        abs acos acosh any append apply arrayify asin asinh asserting_absent
@@ -981,6 +982,14 @@ MILLER(1)                                                            MILLER(1)
         -n {n} Decimation factor (default 10).
        -h|--help Show this message.
 
+   1mdowncase0m
+       Usage: mlr downcase [options]
+       Lowercases strings in record keys and/or values.
+       Options:
+       -k        Downcase only keys, not keys and values.
+       -v        Downcase only values, not keys and values.
+       -h|--help Show this message.
+
    1mfill-down0m
        Usage: mlr fill-down [options]
        If a given record has a missing value for a given field, fill that from
@@ -2090,6 +2099,14 @@ MILLER(1)                                                            MILLER(1)
        being 'b=3,c=4', then the output is the two records 'a=1,b=2,c=' and
        'a=,b=3,c=4'.
 
+   1mupcase0m
+       Usage: mlr upcase [options]
+       Uppercases strings in record keys and/or values.
+       Options:
+       -k        Upcase only keys, not keys and values.
+       -v        Upcase only values, not keys and values.
+       -h|--help Show this message.
+
 1mFUNCTIONS FOR FILTER/PUT0m
    1mabs0m
         (class=math #args=1) Absolute value.

docs/src/reference-verbs.md

@@ -824,6 +824,20 @@ Options:
 -h|--help Show this message.
 </pre>
 
+## downcase
+
+<pre class="pre-highlight-in-pair">
+<b>mlr downcase --help</b>
+</pre>
+<pre class="pre-non-highlight-in-pair">
+Usage: mlr downcase [options]
+Lowercases strings in record keys and/or values.
+Options:
+-k        Downcase only keys, not keys and values.
+-v        Downcase only values, not keys and values.
+-h|--help Show this message.
+</pre>
+
 ## fill-down
 
 <pre class="pre-highlight-in-pair">
@@ -4271,3 +4285,16 @@ a b v u w x
 - - 1 - 2 -
 </pre>
 
+## upcase
+
+<pre class="pre-highlight-in-pair">
+<b>mlr upcase --help</b>
+</pre>
+<pre class="pre-non-highlight-in-pair">
+Usage: mlr upcase [options]
+Uppercases strings in record keys and/or values.
+Options:
+-k        Upcase only keys, not keys and values.
+-v        Upcase only values, not keys and values.
+-h|--help Show this message.
+</pre>

docs/src/reference-verbs.md.in

@@ -297,6 +297,12 @@ GENMD-RUN-COMMAND
 mlr decimate --help
 GENMD-EOF
 
+## downcase
+
+GENMD-RUN-COMMAND
+mlr downcase --help
+GENMD-EOF
+
 ## fill-down
 
 GENMD-RUN-COMMAND
@@ -1289,3 +1295,8 @@ GENMD-RUN-COMMAND
 mlr --ijson --opprint unsparsify -f a,b,u,v,w,x then regularize data/sparse.json
 GENMD-EOF
 
+## upcase
+
+GENMD-RUN-COMMAND
+mlr upcase --help
+GENMD-EOF