view release on metacpan or  search on metacpan

docs/docs/02-cookbook.md  view on Meta::CPAN

---
title: 'Cookbook'
layout: default
---

# Cookbook

Some quick answers to common needs.

## Define the application structure in JSON

It might be a good idea to define the application's structure through
a JSON file. In this case, there are several ways to use it, all through
the `run` command.

If the specification is inside a standalone JSON file, just pass the path
to the file:

```perl
run('/path/to/app.json', \@ARGV);
```

If the specification is in a variable as a string, pass a reference to that string:

```perl
run(\$app_definition_in_json, \@ARGV);
```

## Partition code into multiple files

If your application definition grows a lot, it can make sense to break it into
multiple files, especially the implementation parts. This can be done
out of the box in [App::Easer][], even though there are some tricks that
can make the process smoother.

We will concentrate on an example about the `execute` callback, but this
is generally applied to all other *executables* as well.

An executable can be a string, in which case it is resolved into
a function. At a basic level, it's sufficient to provide the name of
a package, and [App::Easer][] will do the heavy-lifting:

```perl
my $app = {
    commands => {
        foo => {
            execute => 'MyApp::Foo',
        }
    }
};
```

By default, [App::Easer][] will look for a function that matches the
specific callback it is resolving:

```
Callback name | Searched function
--------------+------------------
collect       | collect   
commit        | commit    
dispatch      | dispatch  
execute       | execute   
fallback      | fallback  
merge         | merge     
validate      | validate  
```