added common escape sequences

added ability to run imported commands from current directory directly
added ability to call other tasks in the middle of a task

Author: Ayehavgunne

.mog

@@ -29,20 +29,19 @@ fmt:
 
 @desc(for testing)
 test:
-	echo {v_path}
+	echo {$bold}{v_path}{$normal_intensity}
+	{up.test}
 	sleep 2
-	echo {$1}
+	echo {$dim}{$1}
 	echo Enter your name
 	read name
-	echo hello ${name}
-	echo ${EDITOR}
+	echo {$normal_intensity}hello ${name}
+	echo {$green}${EDITOR}
 	hogwash || echo no hogwash
 
 test2:
 	echo testing
-	pwd
-	cd ..
-	pwd
+	echo {v_path}
 
 @dep(up.test)
 test3:

README.md

@@ -12,10 +12,12 @@ Define your tasks in a `.mog` file and run them with the `mog` command. Indentat
 - interpolation of variables using `{}` (unless the `{` has a `$` in front, in which case it is left alone for the shell to interpret)
 - escape the `[` and `{` characters with `\`
 - additional cli arguments are passed to the task being ran
-- task dependencies
-- task descriptions
-- single line comments with #
+- task dependencies with `@dep()` decorator
+- task descriptions with `@desc()` decorator
+- single line comments with `#`
 - importing other `.mog` files and using the tasks or variables with dot syntax
+- call another task in the middle of a task
+- execute an imported task directly from the cli `$ mog imported_mog.task_name`
 
 
 ## What does it look like?
@@ -37,9 +39,9 @@ v_path = [which v] # storing a shell eval into a variable
 # the default task which is executed when calling a bare 'mog' with no arguments
 @dep(run)
 default:
-# with a declared dependacy and no body this is basically an alias
+# with a declared dependency and no body this is basically an alias
 
-@dep(
+@dep( # defines dependencies that will be run before this task (in the same shell instance)
 	build
 	start
 	my_alias.some_task_name

src/.mog

@@ -1,9 +1,14 @@
+import (
+	another
+)
+
 val = yes
 uname = [uname -s]
 
 @dep(test2)
 default:
 
+@desc(hey)
 test:
 	echo in src test
 	echo {uname}

src/another/.mog

@@ -0,0 +1,2 @@
+test:
+	echo in another

src/lexer.v

@@ -183,9 +183,8 @@ fn (mut l Lexer) eat_command_body() !Token {
 		return l.eat_newline()
 	}
 	if l.current_char != indent {
-		debug("not at indent")
 		l.context = .root
-		return error("no indent")
+		return error('no indent')
 	}
 	l.skip_whitespace()
 	l.add_to_word(['\n', ''])

src/main.v

@@ -10,6 +10,12 @@ fn main() {
 	mut args := arguments()[1..]
 	mut dash_args := []string{}
 
+	if args.len > 0 && args.first() == 'symlink' {
+		result := os.execute('ln -s ${os.getwd()}/mog ${os.home_dir()}/.local/bin/mog')
+		println(result.output)
+		exit(result.exit_code)
+	}
+
 	for arg in args {
 		if arg.starts_with('-') {
 			dash_args << arg
@@ -27,27 +33,43 @@ fn main() {
 	}
 
 	mog_file := os.read_file('.mog') or {
-		println('Failed to read file.')
-		exit(1)
+		if args.len == 0 || 'help' !in args {
+			println('Failed to read file.')
+			exit(1)
+		}
+		''
 	}
+	mut parse_args := []string{}
 
-	mut m := parse(mog_file) or {
-		println('Failed to parse .mog file. ${err}')
-		exit(1)
+	if args.len > 0 {
+		parse_args = args[1..].clone()
+	}
+
+	mut m := Mog{}
+
+	if mog_file.len > 0 {
+		m = parse(mog_file, parse_args) or {
+			println('Failed to parse .mog file. ${err}')
+			exit(1)
+		}
+		debug('${m}')
 	}
-	debug('${m}')
 
 	if '-l' in dash_args || '--list' in dash_args {
 		print_commands(m)
 		exit(0)
 	}
 
-	if '-h' in dash_args || '--help' in dash_args {
+	if '-h' in dash_args || '--help' in dash_args || (args.len > 0 && 'help' == args.first()) {
+		if args.len > 1 && args[1] == 'arguments' {
+			print_arguments_help()
+			exit(0)
+		}
 		print_help(m)
 		exit(0)
 	}
 
-	if args.len == 0 && defualt_task in m.tasks.keys() {
+	if args.len == 0 && defualt_task in m.tasks {
 		args << defualt_task
 	}
 
@@ -60,12 +82,11 @@ fn main() {
 	}
 
 	task_name := args.pop_left()
-	if task_name !in m.tasks.keys() {
+	mut task := m.get_task(task_name) or {
 		eprint("No task named '${task_name}' found")
 		exit(1)
 	}
-	mut task := m.tasks[task_name]
-	m.execute(mut task, args)
+	task.execute()
 }
 
 fn print_version() {
@@ -75,35 +96,68 @@ fn print_version() {
 
 fn print_commands(m ?Mog) {
 	definite_m := m or { return }
-	println('Tasks available from the current .mog file:')
-	mut labels := definite_m.tasks.keys()
+	println('Available tasks:')
+	sub_print_commands(definite_m, '')
+}
+
+fn sub_print_commands(m Mog, mog_name string) {
+	mut mut_mog_name := mog_name.clone()
+	if mog_name.len > 0 {
+		mut_mog_name += '.'
+	}
+	mut labels := m.tasks.keys()
 	for mut label in labels {
-		label = '  ${label}:'
+		label = '  ${mut_mog_name}${label}:'
 	}
 	len := longest(labels)
-	for name, task in definite_m.tasks {
-		just_name := ljust('  ${name}:', len, ' ')
+	for name, task in m.tasks {
+		just_name := ljust('  ${mut_mog_name}${name}:', len, ' ')
 		if task.desc.len > 0 {
 			println('${just_name}\t${task.desc}')
 		} else {
 			println('${just_name}')
 		}
 	}
+	for import_mog_name, imported_mog in m.imports {
+		sub_print_commands(imported_mog, '${mut_mog_name}${import_mog_name}')
+	}
 }
 
 fn print_help(m ?Mog) {
 	println('Mog is a tool for running tasks from a .mog file in the current directory\n')
 	println('Usage:')
 	println('  mog [options] [task] [arguments]\n')
-	println('Any arguments passed after the task name will be forwarded to that task\n')
-	println('Options:')
-	println('  -l | --list:\tList available tasks')
-	println('  -h | --help:\tShow this output')
-	println('  -V | --version:\tShow the version of mog')
+	println('Any arguments passed after the task name will be forwarded to that task if you use the bash like {$#} syntax. For more info run "mog help arguments"\n')
+	print_options()
+	println('')
+	print_builtins_help()
 	println('')
 	print_commands(m)
 }
 
+fn print_options() {
+	println('Options:')
+	println('  -l | --list:\t\tList available tasks')
+	println('  -h | --help:\t\tShow the help output')
+	println('  -V | --version:\tShow the version of mog')
+}
+
+fn print_builtins_help() {
+	println("Built in task names that shouldn't be used in a .mog file:")
+	println('  help:\t\tShow the help output')
+	println('  symlink:\tCreate a symlink for the mog command to ~/.local/bin')
+}
+
+fn print_arguments_help() {
+	println('Mog argument access:\n')
+	println('- Individual arguments are accessed using {$1} for the first argument, {$2} for the second, and so on')
+	println('- {$#} holds the total count of positional arguments')
+	println('- {$*} expands all positional parameters into a single string, separated by the a space')
+	println('- {$"*"} becomes a single string, e.g., "arg1 arg2 arg3"')
+	println('- {$@} expands positional parameters as separate quoted strings')
+	println('- {$"@"} expands to "{$1}" "{$2}" "{$3}", treating each argument as a distinct entity')
+}
+
 fn ljust(str string, len int, fill string) string {
 	if str.len >= len {
 		return str