Enable passthru args for python run.

Also enabled an explicit flag for this, which we shockingly didn't have before somehow.

Made some changes to example code to allow manual testing of this. Try:

./pants goal run.py --args="benjy"  examples/src/python/example/hello/main/ -- zundel jsirois

Changed the python run task's registration name from 'python-run' to 'py',  so that the cmd-line
scope is run.py instead of run.python_run.

Also added some missing __init__.py files.

Reviewed at https://rbcommons.com/s/twitter/r/1321/
Allow more succinct invocations with passthru args.

If passthru args "belong" to a goal scope then all tasks in that goal get them.

E.g., you can do:

pants goal run <python-target> -- passthru args

and the run.py task will get the passthru args. So will run.jvm, but that's OK
because it's a no-op for <python-target>.

This obviously is only good when in practice only one passthru-arg-supporting
task in that goal is not a no-op. However that is the common case.

Reviewed at https://rbcommons.com/s/twitter/r/1323/
Get rid of the 'build' and 'py' commands.

Only one more non-goal command to go!

Testing Done:
CI passed.

Reviewed at https://rbcommons.com/s/twitter/r/1327/
Don't highlight 'goal eclipse' in the first Pants Tutorial

In hindsight, the ide-gen goals are not so exemplary.

Bugs closed: 708

Reviewed at https://rbcommons.com/s/twitter/r/1315/
Add java_sources to the depmap-info.

More context:
Ity added this diff long long ago https://rbcommons.com/s/twitter/r/733 to include java_sources in self.context which had some performance issues.

I went ahead and removed it https://rbcommons.com/s/twitter/r/1130.
We relied on java_sources to be already present in self.targets for depmap goal.

This diff fixes the issue where for a scala target owning java_sources, the java_target is included in depmap output under targets found.

Without this patch, the java_sources is mising from targets but is present in targets['examples/src/scala/com/pants/example/scala_with_java_sources:scala_with_java_source']['targets']

[tw-172-25-146-131 pants]$ ./pants goal depmap --depmap-project-info examples/src/scala/com/pants/example/scala_with_java_sources:
*** Running pants in dev mode from /Users/tdesai/projects/pants/src/python/pants/bin/pants_exe.py ***
{
    "libraries": {},
    "targets": {
        "examples/src/scala/com/pants/example/scala_with_java_sources:scala_with_java_sources": {
            "libraries": [
                "org.scala-lang:scala-library:2.9.3"
            ],
            "is_code_gen": false,
            "targets": [
                ":scala-library-2.9.3",
                "examples/src/java/com/pants/examples/java_sources:java_sources"
            ],
            "roots": [
                {
                    "source_root":   "/Users/tdesai/projects/pants/examples/src/scala/com/pants/example/scala_with_java_sources",
                    "package_prefix": "com.pants.example.scala_with_java_sources"
                }
            ],
            "target_type": "SOURCE"
        },

        "examples/src/java/com/pants/examples/java_sources:java_sources": {
            "libraries": [],
            "is_code_gen": false,
            "targets": [],
            "roots": [
                {
                    "source_root": "/Users/tdesai/projects/pants/examples/src/java/com/pants/examples/java_sources",
                    "package_prefix": "com.pants.examples.java_sources"
                }
            ],
            "target_type": "SOURCE"
        },
        ":scala-library-2.9.3": {
            "libraries": [],
            "is_code_gen": false,
            "targets": [],
            "roots": [],
            "target_type": "SOURCE"
        }
    }
}

Testing Done:
yes.

./pants tests/python/pants_test/tasks:depmap_integration

and
./pants tests/python/pants_test/tasks:depmap

pass

CI:
https://travis-ci.org/pantsbuild/pants/builds/40829185

Reviewed at https://rbcommons.com/s/twitter/r/1324/
Merge branch 'master' into new_docs
rm redundant fns
add a comment