Quickstart

Contents

• Quickstart
• Usage

The Atmark – Awk+sed for humans.

Do this:

# Rename a files in current directory (file-name -> file_name.jpg)
$ ls | @ replace - _ "mv # @.jpg" | sh

Except this:

# Rename a files in current directory (file-name -> file_name.jpg)
$ ls | awk '{print $1 $1}' | sed s/"-"/"_"/ | awk '{print "mv", $2, $1, ".jpg"}' | sh

More deep:

$ ls | @  replace   -   _   "mv # @.jpg" | sh
          -------   |   |   ------------
            |       |   |       \_ format string (# - link on first state,
            |       |   |                         @ - link on current state (after replace))
            |       |   |
            |       |    \_ second replace param (to replace)
            |       |
            |        \_ first replace param (what replace)
            |
             \_ function name (replace)

More examples:

Change file’s extension .html > .php

# Atmark
$ ls | @ split . head "mv # @.php"

# Awk/Sed
$ ls | awk '{printf "mv "$0; sub(/html/,"php"); print " "$0}' | sh

Print all but the first three columns

# Atmark
$ ls -la | @ split_ drop 3 join_

# Awk/Sed
$ ls -la | awk '{for(i=1;i<4;i++) $i="";print}'

Kill process by name

# Atmark
$ ps aux | @ grep sysmond$ index 2 "kill @" | sh

# Awk/Sed
$ ps aux | grep [s]ysmond | awk '{print "kill "$2}' | sh

And more, more, more.

Usage

$ @ --help

Atmark (@) -- is a command line utility for parsing text input and generating output.

You can pipe data within a Atmark (@) statement using standard unix style pipes ("|").
Provide for Atmark function composition and let them work for you.

Example. Replace "_" with "-" in files in current dir and change the files extensions to jpg:

    $ ls | @ replace _ -  split . "mv # @.jpg"

It is mean:

    $ ls > replace($LINE, "_", "-") > split($RESULT, ".") > format($RESULT, "mv $LINE $RESULT.jpg")

You can use "@ --debug ARGS" for debug Armark commands.

===================================================================================
LIST OF THE BUILT IN FUNCTIONS

format PATTERN -- format and print a string.

    Symbol '#' in PATTERN represents the line of the input (before pipe "|").
    Symbol '@' in PATTERN represents the current value in process of composition of fuctions.

    Synonyms: You can drop `format` function name. This lines are equalent:

        $ ls | @ upper format "@.BAK"
        $ ls | @ upper "@.BAK"

capitalize/c -- capitalize the string.

drop N -- drop N elements from list/string.

filter/if -- filter results by value has length

grep/g REGEXP -- filter results by REGEXP

head/h -- extract the first element/character of a list/string

index/ix/i N -- get the N-th element/character from list/string.

join/j SEPARATOR -- concatenate a list/string with intervening occurrences of SEPARATOR

join_/j_ -- same as join but SEPARATOR set as ' '

last -- get last element/character of incoming list/string.

length/len -- return length of list/string.

lower/l -- make the string is lowercase

replace/r FROM TO -- replace in a string/list FROM to TO.

reverse -- reverse list/string.

rstrip/rs PATTERN -- return the string with trailing PATTERN removed.

sort -- sort list/string.

split/sp SEPARATOR -- return a list of the substrings of the string splited by SEPARATOR

split_/sp_ -- same as split by splited a string by whitespace characters

strip/s PATTERN -- return the string with leading and trailing PATTERN removed.

tail/t -- extract the elements after the head of a list

take N -- take N elements from list/string.

upper/u -- make the string is uppercase