What does DCli do?
Writing your first CLI app
Add DCli to your project
Dart lambda functions
stdin/stdout/stderr a primer
Using DCli functions
Managing Files And Directories
Command Line Arguments
The evils of CD
Use a shebang #!
build CLI apps in dart - part 1
build CLI apps in dart - part 2
Dealing with permissions
3rd Party console packages
Dart on Linux - the perfect CLI tooling
Improving your build environment
Olivier Revial - CLI apps made easy
Video: package of the week
Use a shebang #!
A Shebang is a special entry on the first line of your script that tells the OS which command interpreter to use to execute your script.
Shebangs are currently only supported on Linux and OSx.
By adding a Shebang to the start of you Dart script you can directly run a script from the cli.
Without a Shebang:
With a Shebang:
It's a small difference but rather useful particularly if you are calling one script from another.
To use a shebang you must have activated the optional DCli command line tools.
You do NOT need the DCli tools if you just want to use the DCli API but they are required if you want to use the Shebang feature.
If you want to use the DCli tools you must first activate them.
dart pub global activate dcli
So let's look at how hello.dart looks with a shebang added.
The Shebang #! must be the very first line!
/// import DCli's global functions
On Linux and OSX you must mark the file as executable for the Shebang to work.
Mark the file as executable:
if you used the
dcli create <script>
command then DCli will have already set the execute permission on your script and added the shebang!
Now run the script from the cli:
You're now officially in the land of DCli magic.
Faster you say?
Read the section on
your script to make it run even faster.
DCli Tools - Previous
Next - DCli Tools