dinedal/textql is a open-source project on GitHub, written primarily in Go. It has 9.1k stars. Execute SQL against structured text like CSV or TSV
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Allows you to easily execute SQL against structured text like CSV or TSV.
Example session:
Major changes!
In the time since the initial release of textql, I've made some improvements as well as made the project much more modular. There've also been additional performance tweaks and added functionality, but this comes at the cost of breaking the original command-line flags and changing the install command.
Changes since v1
Additions:
Numeric values are automatically recognized in more cases.
Date / Time / DateTime values are automatically recognized in reasonable formats. See Time Strings for a list for accepted formats, and how to convert from other formats.
Added join support! Multiple files / directories can be loaded by listing them at the end of the command.
Directories are read by reading each file inside, and this is non-recursive.
You can list as many files / directories as you like.
Added flag '-output-file' to save output directly to a file.
Added flag '-output-dlm' to modify the output delimiter.
Added "short SQL" syntax.
For the case of a single table, the FROM [table] can be dropped from the query.
For simple selects, the SELECT keyword can be dropped from the query.
This means the v1 command textql -sql "select * from tbl" -source some_file.csv can be shortened to textql -sql "*" some_file.csv
Changes:
The flag '-outputHeader' was renamed to '-output-header'.
Removals:
Dropped the ability to override table names. This makes less sense after the automatic tablename generation based on filename, joins, and shorter SQL syntax changes.
Removed '-source', any files / paths at the end of the command are used, as well as piped-in data.
Bug fixes:
Writing to a directory no longer fails silently.
Key differences between textql and sqlite importing
sqlite import will not accept stdin, breaking unix pipes. textql will happily do so.
textql supports quote-escaped delimiters, sqlite does not.
textql leverages the sqlite in-memory database feature as much as possible and only touches disk if asked.
Is it any good?
Yes
Requirements
Go 1.4 or later
Install
Latest release on Homebrew (OS X)
brew install textql
Build from source
go get -u github.com/dinedal/textql/...
Docker
First build the image.
docker build -t textql .
Now use that image mounting your current directory into the container.
docker run --rm -it -v $(pwd):/tmp textql [rest_of_command]
Alias
You can add the following alias to your system to provide quick access to TextQL:
alias textql='docker run --rm -it -v $(pwd):/tmp textql '
AUR
Using an AUR-Helper
yaourt textql-git
Building from PKGBUILD
First clone the repository.
makepkg -cs
Then install the package using pacman or your favorite Package Manager
Usage
textql [-console] [-save-to path path] [-output-file path] [-output-dlm delimter] [-output-header] [-pretty] [-quiet] [-header] [-dlm delimter] [-sql sql_statements] [path ...]
-console
After all statements are run, open SQLite3 REPL with this data
-dlm string
Input delimiter character between fields -dlm=tab for tab, -dlm=0x## to specify a character code in hex (default ",")
-header
Treat input files as having the first row as a header row
-output-dlm string
Output delimiter character between fields -output-dlm=tab for tab, -dlm=0x## to specify a character code in hex (default ",")
-output-file file
Filename to write output to, if empty no output is written (default "stdout")
-output-header
Display column names in output
-quiet
Suppress logging
-pretty
Pretty print output
-save-to file
SQLite3 db is left on disk at this file
-sql string
SQL Statement(s) to run on the data
-version
Print version and exit
I want stdev, average, other functions
Just follow the install directions at go-sqlite3-extension-functions and textql will automatically load this library.
The most recent commit recorded on dinedal/textql was 3.1 years ago, based on the GitHub push timestamp. The repository has 294 forks — one of the better signals of community interest.
How many stars does dinedal/textql have?
dinedal/textql has 9.1k GitHub stars — refresh the page for the live number, or check github.com/dinedal/textql. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is dinedal/textql open source?
Yes — dinedal/textql ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/dinedal/textql.
What is dinedal/textql?
dinedal/textql (dinedal/textql) is a Go project on GitHub. From the project's own README: Execute SQL against structured text like CSV or TSV
Where do I read more about dinedal/textql?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/dinedal/textql is the definitive source.
Read full README in the tab above.
Still deciding about textql?
One click hands the question to an AI along with this page — see what it says about textql.