feat: add $.args

Author: c4spar

README.md

@@ -223,7 +223,7 @@ script.
 - **flags:** Deno's `std/flags` module.
 
   ```ts
-  console.log($.blue.bold("Hello world!"));
+  const args: flags.Args = flags.parse($.args);
   ```
 
 ## Variables
@@ -240,6 +240,8 @@ script.
   `"piped"`, `"null"` or `number`. Will be reverted to default after all async
   ops are done. Default: `"piped"`
 - **$.throwErrors:** Throw errors instead of calling `Deno.exit`.
+- **$.args:** Equivalent to `Deno.args`, but without the script name as first
+  argument.
 - **$.startTime:** The execution start time in ms.
 - **$.time:** The time left since execution start (now() - $.startTime).
 - **$.quote:** Parser method that is used to safely quote strings. Used by:

src/cli/mod.ts

@@ -61,8 +61,9 @@ export function dzx() {
       async (
         { worker, ...perms },
         script?: string,
-        _args?: Array<string>,
+        args: Array<string> = [],
       ) => {
+        $.args = args;
         if (script) {
           $.mainModule = addProtocool(script);
           if (worker) {
@@ -90,6 +91,9 @@ export function dzx() {
           import "${new URL("./src/runtime/mod.ts", Deno.mainModule)}";
           $.mainModule = "${$.mainModule}";
           $.startTime = ${$.startTime};
+          $.args = JSON.parse(decodeURIComponent("${
+          encodeURIComponent(JSON.stringify($.args))
+        }"));
           await import("${$.mainModule}");
           if ($.verbose) {
             const end = Date.now();

src/runtime/mod.ts

@@ -9,10 +9,11 @@ export type $ = typeof exec & typeof colors & {
   verbose: boolean;
   stdout: NonNullable<Deno.RunOptions["stdout"]>;
   stderr: NonNullable<Deno.RunOptions["stderr"]>;
+  args: Array<string>;
+  quote: typeof shq;
   throwErrors: boolean;
   startTime: number;
   time: number;
-  quote: typeof shq;
 };
 
 export const $: $ = exec as $;
@@ -25,6 +26,7 @@ $.mainModule = "";
 $.verbose = false;
 $.stdout = "piped";
 $.stderr = "piped";
+$.args = [];
 $.quote = shq;
 $.throwErrors = false;
 $.startTime = Date.now();