Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/so-dang-cool/dt
dt - duct tape for your unix pipes
https://github.com/so-dang-cool/dt
Last synced: 15 days ago
JSON representation
dt - duct tape for your unix pipes
- Host: GitHub
- URL: https://github.com/so-dang-cool/dt
- Owner: so-dang-cool
- License: bsd-3-clause
- Created: 2022-09-10T07:12:20.000Z (about 2 years ago)
- Default Branch: core
- Last Pushed: 2024-07-16T08:01:39.000Z (4 months ago)
- Last Synced: 2024-10-16T11:03:12.624Z (28 days ago)
- Language: Zig
- Homepage: https://dt.plumbing/
- Size: 46.6 MB
- Stars: 427
- Watchers: 6
- Forks: 12
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/so-dang-cool/dt/blob/core/LICENSE.md)
[](https://unconventions.org)
[](https://justforfunnoreally.dev)
# dt
It's duct tape for your unix pipes. A programming language for doing small
stuff fast, easy, and readable.
In the words of [Red Green](https://www.redgreen.com):
> Remember, it's only temporary... unless it works!
Note: [The dt User Guide](https://dt.plumbing/user-guide/) exists but is still
in progress. Basic usage is shown in the instructions below.
## Use in pipes
When piping in/out, the REPL is skipped. If something is piping into `dt` then
standard input is fed into `dt` as a list of lines.
```
$ seq 3 | dt rev pls
3
2
1
```
Great for aliases:
```
$ alias scream-lines="dt [upcase words unlines] map pls"
$ echo "hey you pikachu" | scream-lines
HEY
YOU
PIKACHU
```
If you want to read lines manually, use `stream` as the first command:
```
$ alias head.dt="dt stream [rl pl] args last to-int times"
$ seq 100 | head.dt 3
1
2
3
```
## Use as a shebang
When the first argument to `dt` is a file starting with `#!` it will interpret
the file. In short: `dt` supports shebang scripting.
A naive tee implementation:
`tee.dt`
```
#!/usr/bin/env dt
readln unlines \stdin :
args pop \file :
stdin pl
stdin file writef
```
Then use like:
```
cat wish-list | sed 's/red/green/g' | tee.dt new-wish-list
```
## Interactive mode
Running `dt` by itself with no pipes in or out starts a read-eval-print loop
(REPL).
```
$ dt
dt 1.x.x
Now, this is only temporary... unless it works.
» # Comments start with #
»
» 1 1 + println
2
»
» # Printing is common, so there are a bunch of printing shorthands.
» # "p" is print, "pl" is print line, "pls" is print lines (i.e. of a list of values)
» # Let's define a command that consumes a value, prints it, then returns its double.
»
» [ \n : n p " " p n 2 *] \print-and-double def
»
»
» # And let's do it... 7 times!
»
» 1 \print-and-double 7 times drop
1 2 4 8 16 32 64
»
»
» # You can conditionally execute code
»
» ["hi" pl] false do?
» ["bye" pl] true do?
bye
»
» quit
```
For a best experience, also install
[`rlwrap`](https://github.com/hanslub42/rlwrap) and set a shell alias like so:
```
$ alias dtsh='rlwrap dt'
$ dtsh
dt 1.x.x
Now, this is only temporary... unless it works.
»
```
The above example assumes a bash-like shell. Details on the syntax and
configuration files to set an alias that persists will vary by your shell.
## Installing
[](https://repology.org/project/dt-script/versions)
[](https://flakehub.com/flake/so-dang-cool/dt)
More ways to install: https://dt.plumbing/user-guide/install.html
## Community and resources
Discuss dt on Discord. As interest grows and the language matures we will probably prefer
discussion to be on platforms that can be indexed for searches. Let us know of other communities!
* Scripters, packagers, and terminal fans: [](https://discord.gg/9ByutGCrJX)
* Concatenative language theorists: [](https://discord.gg/pwrVPJJMfZ)
Other resources:
* [dt User Guide](https://dt.plumbing/user-guide/) ([sources](https://github.com/so-dang-cool/dt/tree/gh-pages))
* [dt on Rosetta Code](https://www.rosettacode.org/wiki/Category:Dt)
* [dt on the concatenative wiki](https://concatenative.org/wiki/view/dt)
## The nerdy stuff
The dt language is a functional programming language, and a
[concatenative language](https://concatenative.org/wiki/view/Concatenative%20language),
with a very imperative feel. For those interested, the user guide has a more
in-depth discussion of [the language classification](https://dt.plumbing/user-guide/misc/classification.html).
`dt` is implemented in Zig with no plans to self-host or rewrite in Rust or Go.
Please do suggest better strategies for memory management and optimizations! I
have some experience working at this level, but still much to learn. The
current implementation is still fairly naive.
## Credits
Shared as open source software, distributed under the terms of [the 3-Clause BSD License](https://opensource.org/license/BSD-3-clause/).
By J.R. Hill | https://so.dang.cool | https://github.com/booniepepper