Message from the developer
As duck is being rewritten, this documentation might contain incorrect informations. I will get it up to date asap.
Introduction
Duck
is a developer tool which brings abstraction to the terminal.
Examples usage
C++ : compile
before
$ g++ -o ./binary1.4.3 main.cpp Logger.cpp AnotherFile.cpp MyClass.cpp -lm -Wall
after
$ @ build
Go : create packages
before
$ mkdir myNewPackage
$ touch myNewPackage/myNewPackage.go
after
$ @ pack myNewPackage
git: add, commit, push
before
$ git add *
$ git commit -a -m "My message"
$ git push origin master
after
$ @ gcp "My message"
Dependencies, name, installation process, ---, ---, curl, apt install curl or brew install curl or whatever, go, official tutorial, ## Installation
-
Download the latest version of duck here
-
Move it into /usr/local/bin and name it
duck -
Run
ln -s /usr/local/bin/duck /usr/local/bin/@to add@support -
Download the
project.confin ressources/duck.conf (on the repo) and put it in /etc/duck/duck.conf -
Start using duck !
One-line Installation
Currently not available
Installing duck from sources is a very easy step.
Once you have curl and go installed, just run :
WARNING : Due to recent changes, this script is being rewritten. You can still install duck but not with the script.
$ curl https://raw.githubusercontent.com/snwfdhmp/duck/master/INSTALL.sh, bash
This will download the installation script and execute it. Ensure to have sudo permissions.
Manual Installation
This will come later.
Usage
duck is available under the alias @ to speed up the command-writing process.
if
@is not available for you, runln -s $(which duck) /usr/local/bin/@
usage: @ <action> [args], command, description, ---, ---, @ init, add duck to your project, @ install pkg, download and install package pkg, @ lings, view loaded lings, @ exec, run your project, @ repo-list, print a list of installed repositories, @ mkdir, mkdir a directory if it doesn't exist, @ buid, build your project, To see the list of all available commands, type @ help
Getting started
Create a new directory for your projects
$ mkdir my-project
$ cd my-project
Init a duck repo in this directory
$ @ init
Name: tictactoe
Lang: go
Main: game.go
Install the packages you want
see the official repo here to discover packages
$ @ install snwfdhmp/std
$ @ install snwfdhmp/go
$ @ install snwfdhmp/cpp
$ @ install snwfdhmp/junk
Make a ling
Lings are duck's most interesting part.
They are custom commands you build to avoid repeating commands.
Examples :, This, Will execute, ---, ---, @ pack MyPackage, mkdir MyPackage && touch MyPackage/MyPackage.go, @ gcp "My message", git add * && git commit -a -m "My message" && git push, ### Tags
You can use different $tags in a ling, Tag, Description, Example, ---, ---, ---, $main, Your project's main file, main.go, $name, Your project's name, myAwesomeProject, $path, Path to your project, /home/snwfdhmp/my-project, $1, $2, ..., $9, Commands arguments (like in shell), @ create toto => mkdir toto && touch toto/toto.go, Example lings using tags :, This, Will execute, ---, ---, @ build, go build -o $path/$name, @ junk fileToThrow.txt, mv fileToThrow.txt $path/.junk, ### Sample package
Packages contain lings
You can build packages to import/export lings.
Create a file in YOURPROJECT/.duck/YOURNAME/PKGNAME.pkg
.duck/pkg/snwfdhmp/go.pkg
{
"Dependencies":[],
"Lings":[
{
"Label":"build",
"Description":"compile project",
"Commands":["go build -o $name $main"],
"Aliases":["b"]
},
{
"Label":"pack",
"Description":"create a new package",
"Commands":[
"mkdir $1",
"touch $1/$1.go"
],
"Aliases":["p"]
},
{
"Label":"run",
"Description":"go run your project",
"Commands":[
"go run $main"
],
"Aliases":["r"]
}
]
}
Contributing
Duck is currently closed to contributions.
However, please feel free to open issues.
Author
- snwfdhmp (I'm currently the only one on this project.)
Thanks to
- GoReleaser used for releases management