Mirrors/miller
1
0
Fork 0
mirror of https://github.com/johnkerl/miller.git synced 2026-07-18 00:45:47 +00:00
Code Issues Projects Releases Wiki Activity

Prepare 6.19.0 release

Browse source
This commit is contained in:
John Kerl 2026-06-19 18:28:13 -04:00
parent 5976b43d04
commit 0c675ee6da
6 changed files with 38 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/src/manpage.md
View file

@ -52,7 +52,7 @@ This is simply a copy of what you should see on running `man mlr` at a command p
insertion-ordered hash map. This encompasses a variety of data
formats, including but not limited to the familiar CSV, TSV, and JSON.
(Miller can handle positionally-indexed data as a special case.) This
manpage documents mlr 6.18.1-dev.
manpage documents mlr 6.19.0.
1mEXAMPLES0m
mlr --icsv --opprint cat example.csv
@ -1431,9 +1431,9 @@ This is simply a copy of what you should see on running `man mlr` at a command p
Tip: you can use --lk "": this means the left file becomes solely a row-selector
for the input files.
--lp {text} Additional prefix for non-join output field names from
the left file
the left file. Applies to paired and unpaired output records.
--rp {text} Additional prefix for non-join output field names from
the right file(s)
the right file(s). Applies to paired and unpaired output records.
--np Do not emit paired records
--ul Emit unpaired records from the left file
--ur Emit unpaired records from the right file(s)
@ -2465,12 +2465,13 @@ This is simply a copy of what you should see on running `man mlr` at a command p
concat([1,2],[3]) is [1,2,3]
1mcontains0m
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0`but with less keystroking.
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0` but with less keystroking. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. To test for array membership, use `any`, e.g. `any([1,2,3], func(e) {return e == $foo})`.
Examples:
contains("abcde", "e") gives true
contains("abcde", "x") gives false
contains(12345, 34) gives true
contains("fort", "") gives true
contains([1,2,3], 2) gives (error)
1mcos0m
(class=math #args=1) Trigonometric cosine.
@ -2627,12 +2628,13 @@ This is simply a copy of what you should see on running `man mlr` at a command p
(class=system #args=0) Returns the hostname as a string.
1mindex0m
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string inputs. Uses UTF-8 encoding to count characters, not bytes.
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. Uses UTF-8 encoding to count characters, not bytes.
Examples:
index("abcde", "e") gives 5
index("abcde", "x") gives -1
index(12345, 34) gives 3
index("fort", "t") gives 5
index([1,2,3], 2) gives (error)
1mint0m
(class=conversion #args=1,2) Convert int/float/bool/string to int. If the second argument is omitted and the first argument is a string, base is inferred from the first argument's prefix. If the second argument is provided and the first argument is a string, the second argument is used as the base. If the second argument is provided and the first argument is not a string, the second argument is ignored.
@ -3850,5 +3852,5 @@ This is simply a copy of what you should see on running `man mlr` at a command p
MIME Type for Comma-Separated Values (CSV) Files, the Miller docsite
https://miller.readthedocs.io
2026-05-17 4mMILLER24m(1)
2026-06-19 4mMILLER24m(1)
</pre>

14
docs/src/manpage.txt
View file

@ -31,7 +31,7 @@
insertion-ordered hash map. This encompasses a variety of data
formats, including but not limited to the familiar CSV, TSV, and JSON.
(Miller can handle positionally-indexed data as a special case.) This
manpage documents mlr 6.18.1-dev.
manpage documents mlr 6.19.0.
1mEXAMPLES0m
mlr --icsv --opprint cat example.csv
@ -1410,9 +1410,9 @@
Tip: you can use --lk "": this means the left file becomes solely a row-selector
for the input files.
--lp {text} Additional prefix for non-join output field names from
the left file
the left file. Applies to paired and unpaired output records.
--rp {text} Additional prefix for non-join output field names from
the right file(s)
the right file(s). Applies to paired and unpaired output records.
--np Do not emit paired records
--ul Emit unpaired records from the left file
--ur Emit unpaired records from the right file(s)
@ -2444,12 +2444,13 @@
concat([1,2],[3]) is [1,2,3]
1mcontains0m
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0`but with less keystroking.
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0` but with less keystroking. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. To test for array membership, use `any`, e.g. `any([1,2,3], func(e) {return e == $foo})`.
Examples:
contains("abcde", "e") gives true
contains("abcde", "x") gives false
contains(12345, 34) gives true
contains("fort", "") gives true
contains([1,2,3], 2) gives (error)
1mcos0m
(class=math #args=1) Trigonometric cosine.
@ -2606,12 +2607,13 @@
(class=system #args=0) Returns the hostname as a string.
1mindex0m
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string inputs. Uses UTF-8 encoding to count characters, not bytes.
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. Uses UTF-8 encoding to count characters, not bytes.
Examples:
index("abcde", "e") gives 5
index("abcde", "x") gives -1
index(12345, 34) gives 3
index("fort", "t") gives 5
index([1,2,3], 2) gives (error)
1mint0m
(class=conversion #args=1,2) Convert int/float/bool/string to int. If the second argument is omitted and the first argument is a string, base is inferred from the first argument's prefix. If the second argument is provided and the first argument is a string, the second argument is used as the base. If the second argument is provided and the first argument is not a string, the second argument is ignored.
@ -3829,4 +3831,4 @@
MIME Type for Comma-Separated Values (CSV) Files, the Miller docsite
https://miller.readthedocs.io
2026-05-17 4mMILLER24m(1)
2026-06-19 4mMILLER24m(1)

14
man/manpage.txt
View file

@ -31,7 +31,7 @@
insertion-ordered hash map. This encompasses a variety of data
formats, including but not limited to the familiar CSV, TSV, and JSON.
(Miller can handle positionally-indexed data as a special case.) This
manpage documents mlr 6.18.1-dev.
manpage documents mlr 6.19.0.
1mEXAMPLES0m
mlr --icsv --opprint cat example.csv
@ -1410,9 +1410,9 @@
Tip: you can use --lk "": this means the left file becomes solely a row-selector
for the input files.
--lp {text} Additional prefix for non-join output field names from
the left file
the left file. Applies to paired and unpaired output records.
--rp {text} Additional prefix for non-join output field names from
the right file(s)
the right file(s). Applies to paired and unpaired output records.
--np Do not emit paired records
--ul Emit unpaired records from the left file
--ur Emit unpaired records from the right file(s)
@ -2444,12 +2444,13 @@
concat([1,2],[3]) is [1,2,3]
1mcontains0m
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0`but with less keystroking.
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0` but with less keystroking. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. To test for array membership, use `any`, e.g. `any([1,2,3], func(e) {return e == $foo})`.
Examples:
contains("abcde", "e") gives true
contains("abcde", "x") gives false
contains(12345, 34) gives true
contains("fort", "") gives true
contains([1,2,3], 2) gives (error)
1mcos0m
(class=math #args=1) Trigonometric cosine.
@ -2606,12 +2607,13 @@
(class=system #args=0) Returns the hostname as a string.
1mindex0m
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string inputs. Uses UTF-8 encoding to count characters, not bytes.
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. Uses UTF-8 encoding to count characters, not bytes.
Examples:
index("abcde", "e") gives 5
index("abcde", "x") gives -1
index(12345, 34) gives 3
index("fort", "t") gives 5
index([1,2,3], 2) gives (error)
1mint0m
(class=conversion #args=1,2) Convert int/float/bool/string to int. If the second argument is omitted and the first argument is a string, base is inferred from the first argument's prefix. If the second argument is provided and the first argument is a string, the second argument is used as the base. If the second argument is provided and the first argument is not a string, the second argument is ignored.
@ -3829,4 +3831,4 @@
MIME Type for Comma-Separated Values (CSV) Files, the Miller docsite
https://miller.readthedocs.io
2026-05-17 4mMILLER24m(1)
2026-06-19 4mMILLER24m(1)

16
man/mlr.1
View file

@ -2,12 +2,12 @@
.\" Title: mlr
.\" Author: [see the "AUTHOR" section]
.\" Generator: ./mkman.rb
.\" Date: 2026-05-17
.\" Date: 2026-06-19
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "MILLER" "1" "2026-05-17" "\ \&" "\ \&"
.TH "MILLER" "1" "2026-06-19" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Portability definitions
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -50,7 +50,7 @@ on integer-indexed fields: if the natural data structure for the latter is the
array, then Miller's natural data structure is the insertion-ordered hash map.
This encompasses a variety of data formats, including but not limited to the
familiar CSV, TSV, and JSON. (Miller can handle positionally-indexed data as
a special case.) This manpage documents mlr 6.18.1-dev.
a special case.) This manpage documents mlr 6.19.0.
.SH "EXAMPLES"
.sp
@ -1772,9 +1772,9 @@ Options:
Tip: you can use --lk "": this means the left file becomes solely a row-selector
for the input files.
--lp {text} Additional prefix for non-join output field names from
the left file
the left file. Applies to paired and unpaired output records.
--rp {text} Additional prefix for non-join output field names from
the right file(s)
the right file(s). Applies to paired and unpaired output records.
--np Do not emit paired records
--ul Emit unpaired records from the left file
--ur Emit unpaired records from the right file(s)
@ -3300,12 +3300,13 @@ concat([1,2],[3]) is [1,2,3]
.RS 0
.\}
.nf
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0`but with less keystroking.
(class=string #args=2) Returns true if the first argument contains the second as a substring. This is like saying `index(arg1, arg2) >= 0` but with less keystroking. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. To test for array membership, use `any`, e.g. `any([1,2,3], func(e) {return e == $foo})`.
Examples:
contains("abcde", "e") gives true
contains("abcde", "x") gives false
contains(12345, 34) gives true
contains("forêt", "ê") gives true
contains([1,2,3], 2) gives (error)
.fi
.if n \{\
.RE
@ -3678,12 +3679,13 @@ gsub("prefix4529:suffix8567", "(....ix)([0-9]+)", "[\e1 : \e2]") gives "[prefix
.RS 0
.\}
.nf
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string inputs. Uses UTF-8 encoding to count characters, not bytes.
(class=string #args=2) Returns the index (1-based) of the second argument within the first. Returns -1 if the second argument isn't a substring of the first. Stringifies non-string scalar inputs; raises an error if either argument is an array or map. Uses UTF-8 encoding to count characters, not bytes.
Examples:
index("abcde", "e") gives 5
index("abcde", "x") gives -1
index(12345, 34) gives 3
index("forêt", "t") gives 5
index([1,2,3], 2) gives (error)
.fi
.if n \{\
.RE

5
miller.spec
View file

@ -1,6 +1,6 @@
Summary: Name-indexed data processing tool
Name: miller
Version: 6.18.1
Version: 6.19.0
Release: 1%{?dist}
License: BSD
Source: https://github.com/johnkerl/miller/releases/download/%{version}/miller-%{version}.tar.gz
@ -36,6 +36,9 @@ make install
%{_mandir}/man1/mlr.1*
%changelog
* Fri Jun 19 2026 John Kerl <kerl.john.r@gmail.com> - 6.19.0-1
- 6.19.0 release
* Sun Apr 19 2026 John Kerl <kerl.john.r@gmail.com> - 6.18.1-1
- 6.18.1 release

2
pkg/version/version.go
View file

@ -4,4 +4,4 @@ package version
// Nominally things like "6.0.0" for a release, then "6.0.0-dev" in between.
// This makes it clear that a given build is on the main dev branch, not a
// particular snapshot tag.
var STRING string = "6.18.1-dev"
var STRING string = "6.19.0"