Update 2022-04-13:
Since version 1.20 deno now includes a task runner. You can finde the details in the release note: new subcommand deno task.
Feel free to ignore the rest of this article.
Sooo I tried deno, did the traditional "hello world" and 5 seconds later I felt the pain of not having the npm cli and the package.json file. I can't npm start
anymore and it bothers me more than it should. Say whatever you want about the node_module
folder and npm, Inc.
but npm scripts are the bee's knees.
Anyway, as I was saying, Deno's simplicity just punched me in the face. Now this is usually the part were I search for a third party library to fill the void, but not today. Today I just want to run a couple of commands in a sequence, that's not hard, I can do that with some functions. So I created this file in the root of the project.
// Taskfile.js
function run([name, ...args], tasks) {
name in tasks
? tasks[name](...args)
: console.log(`Task "${name}" not found`);
}
async function exec(args) {
const proc = await Deno.run({ cmd: args }).status();
if(proc.success == false) {
Deno.exit(proc.code);
}
return proc;
}
The function run
is the one that decides which task is going to be executed, and it will be kind enough to tell you if the task you asked for can't be found. But the interesting part of this story is exec
, that's the one that's going to execute the external commands I need using Deno.run. Now we can define our tasks.
run(Deno.args, {
start() {
exec(['deno', 'run', './src/mod.ts']);
},
async install() {
await exec(['echo', 'Installing stuff....']);
// do other things
},
echo(str) {
return exec(['echo', str, "\nThis is javascript, y'all"]);
},
async test() {
// need more power? You got it
if(/* some condition */) {
await this.echo('Awesome');
}
// do other things
}
});
You can make this even better if you use a dependency to parse the arguments. Deno has one on their standard library.
This is how you run it.
deno run --allow-run ./Taskfile.js start
Now simplicity strikes again. That is quite a command, no one wants to type that, lucky for us we have the shell on our side. To solve this we can make an alias.
alias deno-task='deno run --allow-run ./Taskfile.js'
On windows using powershell.
Set-Alias -Name deno-task -Value deno run --allow-run ./Taskfile.js
You can even improve this with some shell kung-fu.
alias deno-root-task='deno run --allow-run $(git rev-parse --show-toplevel)/Taskfile.js'
If you are in a folder controlled by git, this command can be used to make sure you execute the Taskfile
of the root of the project.
If anyone knows how to make an alias in cmd.exe, please put it in the comments.
Now we are done, we can use deno-task start
to start our application/script or use any other custom commands to automate what we need. There is a bunch of things that this script doesn't do but if npm scripts
were enough for you so will this.
edit: I wrote another post about this exact same thing but using a "shell function": Extending the deno cli using a shell function
Thank you for reading. If you find this article useful and want to support my efforts, buy me a coffee ☕.
Top comments (19)
Thanks for the article, I've been also working on a tool to replace npm scripts in Deno.
It uses YAML and currently supports permissions github.com/BentoumiTech/denox/
Looks really good. I see that it can run a selected file with the permissions, but what about random commands? Is there a plan for that?
I was able to use the code from this article and the denox package to create a similar npm feel. If you pass your script in as a string then split the script on the spaces to get your arguments it becomes much more usable.
If Khaled added a logical check on the config file to check if a file or script is being provided I'm sure we could achieve the desired outcome.
github.com/BentoumiTech/denox/pull/15 I took the liberty to add the functionality you're looking for. Denox is a pretty awesome package so hopefully, this gets picked up.
That's awesome. But I'm a little bit worried by this right here:
const args = script.split(' ');
, it doesn't handle quoted arguments. If you give it something like thisYou would get.
Would
Deno.run
handle that?That's a great observation. Do you have any suggestions on how to handle this case?
I found this package: exec. It does the same thing as that function with more options. You could use that. It only handles double quotes but it's an improvement.
If anyone is curious how they do it, here it is.
What about double quotes enclosed within single quotes, echo 'And he said: "My name is!" ${name}'. It's a contrived example but you get the gist.
For that you would get.
See, the double quotes stayed, but everything else is broken. Having a bulletproof regex is a real pain. If you want to improve it, you have to modify this
var myRegexp = /[^\s"]+|"([^"]*)"/gi;
.AFAIK, they are going to make
denox run
as alias todenox run default
, so it's even faster to type thandenox start
. Clear and concise IMO!denon
,velociraptor
, andtrex
seem promising. I think that they have more chances to be widespread.I really like the work you've done! It needs an ability to put an "on the fly" script like in package.json
I think robo is nice. YAML is so much better than JSON, only inferior to real scripts.
It does look nice. I've been using task, it also uses YAML but I think it has more features. But really like how robo handle the arguments for the subcommands.
While on the subject of task runners, a few days ago I saw this one: mask. It uses markdown files to define the options of the subcommands. I haven't use it but it looks really cool.
Hey, I turned Taskfile.js into Taskfile.ts and added some typing info. Let me know what you think.
gist.github.com/brianboyko/735c9d9...
It's awesome. May I suggest a "task" to list the other available tasks in the object. I do something like this:
Yeah, so much true. I was learning Deno and the pain of writing flags for each network or dotenv files burns me up. Was looking for a solution. Thank you for the article.
Thanks for your Article.
Here's a tutorial on how to make an Alias in PowerShell
Thanks.
I've added the alias example on powershell. I hope I got it right.