Wrong output in jake -ls

[OscarGodson]

If I have this code:

desc('Setup Piggybank for the first time');
task('setup', function () {
  // ...
});

desc('Runs the app and watches files for changes and rebuilds when there\'s updates');
task('app', function () {
  // ...
});
namespace('app', function () {
  task('start', ['app']);
});

// TODO: Add these deployments
desc('Deploys the site to staging or prod. **WIP**');
namespace('deploy', function () {
  task('staging', function () {
    // ...
  });
  task('prod', function () {
    // ...
  });
});

I get:

jake setup            # Setup Piggybank for the first time
jake app              # Runs the app and watches files for changes and rebuilds when there's updates
jake deploy:staging   # Deploys the site to staging or prod. **WIP**

But I'd expect:

jake setup            # Setup Piggybank for the first time
jake app              # Runs the app and watches files for changes and rebuilds when there's updates
jake app:start        # Runs the app and watches files for changes and rebuilds when there's updates
jake deploy:prod      # Deploys the site to staging or prod. **WIP**
jake deploy:staging   # Deploys the site to staging or prod. **WIP**

[mde]

desc describes a task, not a namespace. It doesn't do anything if you call it before a namespace invocation. I'm not sure we'd want to implement that -- what would happen if you attached one to both the namespace and the tasks inside? Seems like a confusing API.

[giodamelio]

I think it would be helpful for complicated jakefiles. I was working on one with nested namespaces the other day, and the output from jake -T is not very helpful. Example

    # The client tasks
    desc "The client tasks"
    namespace "client", ->
        desc "Coffeescript tasks"
        namespace "coffeescript", ->
            desc "Compile the coffeescript"
            task "build", ->
                console.log "Building coffeescipt"

            desc "Compile and watch the coffeescript"
            task "watch", ->
                console.log "Watching the coffeescript"

    # The server tasks
    desc "The server tasks"
    namespace "server", ->
        desc "Coffeescript tasks"
        namespace "coffeescript", ->
            desc "Compile the coffeescript"
            task "build", ->
                console.log "Building coffeescipt"

            desc "Compile and watch the coffeescript"
            task "watch", ->
                console.log "Watching the coffeescript"

Returns

jake client:coffeescript:build   # Compile the coffeescript  
jake client:coffeescript:watch   # Compile and watch the coffeescript  
jake server:coffeescript:build   # Compile the coffeescript  
jake server:coffeescript:watch   # Compile and watch the coffeescript

I think it would be better to list somthing like

namespace client # The client tasks
    namespace coffeescript # Coffeescript tasks
        task build # Compile the coffeescript
        task watch # Compile and watch the coffeescript

namespace server # The server tasks
    namespace coffeescript # Coffeescript tasks
        task build # Compile the coffeescript
        task watch # Compile and watch the coffeescript

The only problem I can see with this is it stops copy and pasting the task names.

[mde]

I'd be totally down for creating a "-lsi" (-ls indented) or something that does this. We know that people actually use the copy-paste from "ls." Would you like to send a PR for this?

[giodamelio]

Sure, Ill take a look at it later today.

[giodamelio]

That commit just add indented listing by namespace. I was wondering how you felt about implementing desc and namespaces?

[mde]

You shouldn't need to implement desc for namespaces. Just consider it visible if there's a visible task (a task with its own desc) that lives in that namespace.

[giodamelio]

I don't follow. Are you talking about when to print the namespaces(added in above commits)? I was talking about being able to attach separate descriptions to namespaces.

namespace client # The client tasks <---- Like this
    namespace coffeescript # Coffeescript tasks
        task build # Compile the coffeescript
        task watch # Compile and watch the coffeescript