A developer environment manager with a nice future

Wess Cope

Last update: Dec 3, 2022

Related tags

Development tools motive

Overview

Motive

A developer environment manager with a nice future. But first let's just make a simple task runner that takes advantage of a special version of Lua.

Installing

macOS

$ brew tap wess/packages
$ brew update
$ brew install motive
$ cd /to/some/dir
$ motive init

windows

to do

linux

to do

Getting started

Once Motive is installed run: $ motive init and this will create a manifest file in your current directory. Anything in the manifest you write is standard lua, the only exception is defining tasks. Motive uses task to identify commands that can be run from the command line. For example:

-- task identifies what can be run using: $ motive taskname

task taskname do -- this will get printed when running: $ motive list
  exec("echo", "Hello world")
end

-- This function cannot be called from the command line and only available
-- in the manifest
function hello() 
  print("Hello, world!")
end

-- A task can call a lua function
task funcall do -- Call a lua function
  hello()
end

With your Manifest in place, simply call your task from the command line:

$ motive funcall
> Hello, world!
$ motive taskname
> Hello world

What's included?

Everything Lua offers with the addition of a fancy exec function that runs shell commands.

Todo

Easy ways to install.
Built-in file watch, change, execute.
Request client because why not.

Contributing

Contributions are welcome, just make a pull request. If you are including new functionality, please write a usage example, and include any information that will impact installation and/or setup.

License

Motive is released under the MIT license. See LICENSE for details.

Comments

Use docker to build Linux builds

This PR includes a script (just the script) that can be explicitly called when you, on say, an x86 or arm based mac, want to produce a linux build for the build system.

Requires: Docker installed, and your user has permission to use it (otherwise you can run it with sudo, but you will have permission issues if you go to build motive natively after the fact).

Uses a volume to build, and the release binary will be in the usual spot target/release/motive

opened by jeremytregunna 0
Removes _do_ from init example task

fc73277a deprecated the need for the do statement in task declarations. The default manifest from motive init still contained do, which causes every command to break.

This PR removes the deprecated statement from the default manifest.

opened by kodumbeats 0

`exec()` does not run in task context

For some reason, exec() doesn't work in a task context. This also means that the shorthand syntax (removing exec()) is also affected.

For instance, the example task does not work unless the shell call is moved into the lua function:

> motive init
[motive] ✔  Created Manifest file: /home/snowdum/tmp/manifest
> motive list

Motive Tasks:

[motive] ℹ  example      - This is a task description


> motive example

Hello world

> vim manifest
> motive example

Hello world
total 12
drwxr-xr-x  2 snowdum snowdum 4096 Mar 10 08:44 .
drwx------ 38 snowdum snowdum 4096 Mar 10 08:44 ..
-rw-r--r--  1 snowdum snowdum  168 Mar 10 08:44 manifest

>

> git diff manifest manifest.bak
diff --git a/manifest b/manifest.bak
index 4242315..67c9514 100644
--- a/manifest
+++ b/manifest.bak
@@ -3,11 +3,11 @@

 function example_function()
   print("Hello world")
+  exec("ls -la")
 end

 task example -- This is a task description
   example_function()

-  exec("ls -la")
 end

system info: arch linux - kernel 5.16.12-arch1-1 cargo 1.59.0 (49d8809dc 2022-02-10) commit 781e1140f46beefbbba856f932b694be38d13364

opened by kodumbeats 0

Alias `list` to `ls`
For my convenience, I create a task to alias motive list to motive ls:

task ls exec("motive list") end

Does it make sense to alias this by default?
opened by kodumbeats 0
Misconfigured manifest breaks CLI functionality
When a manifest is misconfigured, motive list does not work, nor provide any hints on what's misconfigured. Using the manifest in #3:

$ motive list [motive] ✖ Something went wrong...
opened by kodumbeats 0

Manifest does not support bash linebreaks

Trying to include bash linebreaks in a motive task is unsupported.

Example manifest:

task postgres
docker run \
  --name postgres \
  --detach \
  --publish 5432:5432 \
  --env POSTGRES_USER=postgres \
  --env POSTGRES_PASSWORD=postgres \
  postgres:latest
end

Wrapping in exec() results in the same issue

task postgres
exec([[
docker run \
  --name postgres \
  --detach \
  --publish 5432:5432 \
  --env POSTGRES_USER=postgres \
  --env POSTGRES_PASSWORD=postgres \
  postgres:latest
]])
end

Error message: [motive] ✖ Something went wrong...

bug

opened by kodumbeats 0

Releases(0.0.3)

0.0.3(Mar 3, 2022)
Moves to formal parsing instead of hack-ish string replace for Lua subsect

Adds ability to mute shell comands output by prefix with @ ex: @ls -la

Improves binary size.

Source code(tar.gz)
Source code(zip)
motive-0.0.3-x86_64-apple-darwin.tar.gz(752.95 KB)
0.0.2(Feb 16, 2022)
Removes do from task declaration

Adds assumed shell command unless call to function

Allows for native lua "local" variable definition.

Adds check to ensure Lua specific keywords are not misinterpreted.

Updates readme to reflect chnages (breaking)

Source code(tar.gz)
Source code(zip)
motive-0.0.2-x86_64-apple-darwin.tar.gz(1.04 MB)
0.0.1(Feb 11, 2022)

Initial release with simple Lua interpreter built in and extend and basic task runner.
Source code(tar.gz)
Source code(zip)
motive-0.0.1-x86_64-apple-darwin.tar.gz(737.50 KB)