Add root level variables option

[jopemachine]

Related Issue

Fixes #43

Usage

alfy.output(
	[
		{
			title: 'API key register',
		}
	],
	{ 
		variables: {
            "apiKey": apiKey,
            "error": errorOccured
        } 
	}
);

Test

Here is test code.

const alfy = require("alfy");

const apiKey = "some API key";
const errorOccured = false;

alfy.output(
	[
		{
			title: 'API key register',
		}
	],
	{ 
		variables: {
            "apiKey": apiKey,
            "error": errorOccured
        } 
	}
);

And this is the debug log.

I logged {var:apiKey}, {allVars}.

[16:07:39.158] alfred-evernote-workflow[Script Filter] Queuing argument ''
[16:07:39.878] alfred-evernote-workflow[Script Filter] Script with argv '(null)' finished
[16:07:39.880] alfred-evernote-workflow[Script Filter] {
	"items": [
		{
			"title": "API key register"
		}
	],
	"variables": {
		"apiKey": "some API key",
		"error": false
	}
}
[16:07:39.944] alfred-evernote-workflow[Script Filter] Processing complete
[16:07:39.945] alfred-evernote-workflow[Script Filter] Passing output '' to Debug
[16:07:39.946] alfred-evernote-workflow[Debug] some API key, {allVars}

You can check variables property works by the above test log.

Please let me know if there's anything lacking.

[jopemachine]

And as for item-level variables,

I think we don't need additional work because we can handle it by the present's code.

If you don't think so, or there is something we need to do, pls let me know.

[sindresorhus]

I think you need to put some more work into the docs.

[jopemachine]

I think you need to put some more work into the docs.

Thank you for your feedback.

I've added some info about item-level variable.

[jopemachine]

Do we still need more work about docs?

If so, could I get some hints about what should be included in the document?

[stdavis]

This would be super-helpful when attempting to post a message using Alfred's "Post Notification" output. Right now, the best I can get is a stringified object...

[sindresorhus]

@stdavis If you need this, help reviewing this PR is welcome :)

[sindresorhus]

I think you need to put some more work into the docs.

This still applies.

[jopemachine]

I've added an example (email-validate) using root-level variable to README.md.

To prevent unnecessary complexity of README, the email-validate example excluded logic to determine whether the input is the valid email by regex.

In fact, the screenshot I just uploaded doesn't look good.
(Especially, compared to other neat screenshots)

But, I updated this because I want to know whether this example explains enough how to use variables.

I would appreciate it if you let me know if this example still doesn't explain enough how to use variable to users.

[jopemachine]

To be honest, I don't have an idea about how to reinforce the document.
I would be very grateful if anyone could do the work or give me some advice :)

[sindresorhus]

I appreciate the effort, but it's simply not close to being mergeable and I don't currently have the time to clean it up.