miller README

The project's README from github.com/johnkerl/miller. As one markdown file: README.md.

What is Miller?

Miller is like awk, sed, cut, join, and sort for data formats such as CSV, TSV, JSON, JSON Lines, and positionally-indexed.

What can Miller do for me?

With Miller, you get to use named fields without needing to count positional indices, using familiar formats such as CSV, TSV, JSON, JSON Lines, and positionally-indexed. Then, on the fly, you can add new fields which are functions of existing fields, drop fields, sort, aggregate statistically, pretty-print, and more.

cover-art

In the above image you can see how Miller embraces the common themes of key-value-pair data in a variety of data formats.

Installing

There's a good chance you can get Miller pre-built for your system: Ubuntu Ubuntu 16.04 LTS Fedora Debian Gentoo Pro-Linux Arch Linux NetBSD FreeBSD Anaconda Snap Homebrew/MacOSX MacPorts/MacOSX Chocolatey WinGet

OS Installation command
Linux yum install miller
apt-get install miller
snap install miller
Mac brew install miller
port install miller
Windows choco install miller
winget install Miller.Miller
scoop install main/miller

See also README-versions.md for a full list of package versions. Note that long-term-support (LtS) releases will likely be on older versions.

See also building from source.

Features

Getting started

deepwiki

More documentation links

Community

GitHub stars Homebrew downloads Conda downloads

All Contributors

Build status

Multi-platform build status CodeQL status Codespell status 🧪 Snap Builds

Building from source

For developers

License

License: BSD2

What people are saying about Miller

Today I discovered Miller—it's like jq but for CSV: https://t.co/pn5Ni241KM

Also, "Miller complements data-analysis tools such as R, pandas, etc.: you can use Miller to clean and prepare your data." @GreatBlueC @nfmcclure

— Adrien Trouillaud (@adrienjt) September 24, 2020

Underappreciated swiss-army command-line chainsaw.

"Miller is like awk, sed, cut, join, and sort for [...] CSV, TSV, and [...] JSON." https://t.co/TrQqSUK3KK

— Dirk Eddelbuettel (@eddelbuettel) February 28, 2017

Miller looks like a great command line tool for working with CSV data. Sed, awk, cut, join all rolled into one: http://t.co/9BBb6VCZ6Y

— Mike Loukides (@mikeloukides) August 16, 2015

Miller is like sed, awk, cut, join, and sort for name-indexed data such as CSV: http://t.co/1zPbfg6B2W - handy tool!

— Ilya Grigorik (@igrigorik) August 22, 2015

Btw, I think Miller is the best CLI tool to deal with CSV. I used to use this when I need to preprocess too big CSVs to load into R (now we have vroom, so such cases might be rare, though...)https://t.co/kUjrSSGJoT

— Hiroaki Yutani (@yutannihilat_en) April 21, 2020

Miller: a *format-aware* data munging tool By @__jo_ker__ to overcome limitations with *line-aware* workshorses like awk, sed et al https://t.co/LCyPkhYvt9

The project website is a fantastic example of good software documentation!!

— Donny Daniel (@dnnydnl) September 9, 2018

Holy holly data swiss army knife batman! How did no one suggest Miller https://t.co/JGQpmRAZLv for solving database cleaning / ETL issues to me before

Congrats to @__jo_ker__ for amazingly intuitive tool for critical data management tasks!#DataScienceandLaw #ComputationalLaw

— James Miller (@japanlawprof) June 12, 2018

🤯@__jo_ker__'s Miller easily reads, transforms, + writes all sorts of tabular data. It's standalone, fast, and built for streaming data (operating on one line at a time, so you can work on files larger than memory).

And the docs are dream. I've been reading them all morning! https://t.co/Be2pGPZK6t

— Benjamin Wolfe (he/him) (@BenjaminWolfe) September 9, 2021

Contributors ✨

Thanks to all the fine people who help make Miller better (emoji key):


Andrea Borruso

🤔 🎨

Shaun Jackman

🤔

Fred Trotter

🤔 🎨

komosa

🤔

jungle-boogie

🤔

Thomas Klausner

🚇

Stephen Kitt

📦

Leah Neukirchen

🤔

Luigi Baldoni

📦

Hiroaki Yutani

🤔

Daniel M. Drucker

🤔

Nikos Alexandris

🤔

kundeng

📦

Victor Sergienko

📦

Adrian Ho

🎨

zachp

📦</

miller (johnkerl/miller)

Searching Database…

10K ·GitHub
Что это такое?Miller — это набор утилит для командной строки, похожий на awk, sed, cut, join и sort, но созданный для данных с именованными полями, таких как CSV, TSV, JSON и JSON Lines: вы обращаетесь к полям по имени, а не высчитываете номера столбцов.
Так это библиотека, которую я подключаю, или программа, которую запускаю?Это самостоятельный исполняемый файл для командной строки, а не библиотека. Там, где классические Unix-утилиты видят нумерованные элементы массива, Miller видит в каждой записи упорядоченный набор пар «ключ — значение», и обработка у него учитывает формат данных.
Какая команда установки на моей системе?Готовые пакеты: brew или port на macOS; yum, apt или snap на Linux; choco, winget или scoop на Windows (например, winget install Miller.Miller). Можно также собрать из исходников через make или go install.
Нужно ли сначала ставить какие-то среды выполнения или библиотеки?Нет. Miller написан на переносимом современном Go и не имеет никаких зависимостей во время выполнения — это один бинарник, который можно скопировать на удалённую машину через scp, и он просто заработает.
Версия из моего пакетного менеджера будет самой свежей?Не обязательно: в README сказано, что выпуски долгосрочной поддержки (LtS) часто выходят на старых версиях, так что если нужна самая новая, посмотрите README-versions.md или соберите из исходников.
Почему взять Miller, а не pandas или R для работы с данными?Они дополняют друг друга, а не конкурируют: можно подготовить и почистить данные с помощью Miller в командной строке, а потом загрузить результат в R или pandas для более глубокой статистики и графиков. К тому же потоковая обработка за один проход позволяет уменьшить очень большие файлы ещё до того, как их увидят эти инструменты.
А он умеет конвертировать файлы между форматами?Да — среди поддерживаемых форматов ввода-вывода есть CSV, TSV, JSON, JSON Lines, позиционно-индексированный формат и красивый табличный вывод, и Miller конвертирует между ними. Конвертация учитывает формат: например, при сортировке CSV строка заголовков остаётся первой.
Как называется сама команда?mlr — именно этот исполняемый файл вы и запускаете (на Windows это mlr.exe). При сборке из исходников получается ./mlr, а go install кладёт его в GOPATH/bin.
Можно использовать его как быструю базу данных поверх моих файлов?Для разовых задач — да: в README хвастаются, что можно без всякой настройки делать запросы к данным, лежащим в файлах на диске, когда времени в обрез. Кроме того, Miller умеет нарезать, фильтровать и переформатировать данные по пути в базу SQL или из неё.
What are similar projects?visidata, xsv, q, yq, fx, gron, SolidityScanLegend, coreutils
Creator
johnkerl
Size
212.2 MB
Stars
10K
Age
11y
Commits · 90 Days