alauncher

Create your alias with the single ini file for Windows.

Requirement

• Golang
• "github.com/stretchr/testify/assert" for unittest
• "github.com/go-ini/ini" for ini operation

Installation

$ go get github.com/stakiran/alauncher

If you want to use an alias of alauncher, like this:

[ala]
rawbin=alauncher %*

Usage

Firstly, create the ini file.

$ alauncher
The ini file 'C:\Users\XXXXXXXX\.ala.ini' not found, so create firstly.

Secondly, edit the ini file.

• Add a directory path passed to PATH to outdir.
• Add your aliaes.

Build and so on.

After editing, Do alauncher command to create aliases from the ini file.

$ alauncher

You can also use dryrun.

$ alauncher -dryrun

Edit the ini file with your editor.

$ alauncher -edit

About the ini file

See also your first .ala.ini or sample .ala.ini.

Nmae and location

The ini file name is .ala.ini, and this is created on %HOME% or %USERPROFILE% directory.

Section

There are three type of section: options, variables and alias.

Section > options

[_options]
outdir=D:\bin1\alauncher

You must set a directory path passed to PATH to outdir.

Section > variables

[_variables]
sys32=%windir%\system32
aladir=D:\bin1\alauncher
hidemaru=C:\Program Files (x86)\Hidemaru\HIDEMARU.EXE
conemu=C:\Program Files\ConEmu\ConEmu64.exe

If need, you can define variables with key=value format.

Section > alias > rawbin

[Example] pd command as the alias of pushd.

Ini:

[pd]
rawbin=pushd %*
disable=setlocal,echooff

[pd1]
rawbin=pushd %*
disable=setlocal,echooff

Generated batches:

$ type pd.bat




pushd %*
$ type pd1.bat
@echo off

setlocal

pushd %*

Section > alias > bin

[Example] hide and hidemaru command as the alias of my favorite text editor "Hidemaru Editor".

Ini:

[_variables]
hidemaru=C:\Program Files (x86)\Hidemaru\HIDEMARU.EXE

[hidemaru]
bin=%hidemaru%
prm=%*
alias=hide

Generated batched:

$ type hidemaru.bat
@echo off

setlocal

pushd %cd%

start "" "C:\Program Files (x86)\Hidemaru\HIDEMARU.EXE" %*

popd
$ type hide.bat
@echo off

call %~dp0hidemaru.bat %*

Section > alias > separator

If you have many aliases, you can use a separator alias as a readable section.

[____CUIAliaes____]
ignore_this=true

Use ignore_this=true, do not create the batch file.

FAQ

Q: Is it possible that use prefix or suffix spaces?

Ans: possible.

Use %s% variable. This is alauncher's system variable and means a space.

Ini:

[pp]
rawbin=prompt $$%s%
disable=setlocal

pp.bat:

$ type pp.bat
@echo off



prompt $$ 

Use:

C:\Users\XXXXXXX>pp

$ echo Yeah!
Yeah!

$ 

Q: Is it possible that multi-line alias?

Ans: possible.

Use %n% variable. This is alauncher's system variable and means a \n.

Ini:

[b]
rawbin=echo %cd%%n%echo %s%VVV%s%%n%cd ..%n%echo %cd%
disable=setlocal

b.bat:

$ type b.bat
@echo off



echo %cd%
echo  VVV 
cd ..
echo %cd%

Use:

$ cd
c:\work\dir1\dir2

$ b
c:\work\dir1\dir2
 VVV
c:\work\dir1

$ cd
c:\work\dir1

How to develop

Call run.bat to run.

Call test.bat to test.

Call build.bat to build.

test_alias.ini is one of the test data.

License

MIT License

Author

stakiran