{"action":"created","comment":{"url":"https://api.github.com/repos/consolidation-org/Robo/pulls/comments/76128935","id":76128935,"diff_hunk":"@@ -0,0 +1,120 @@\n+# Packaging\n+\n+There are multiple ways to use and package Robo scripts; a few of the alternatives are presented below.\n+\n+## Adding a RoboFile to your Project\n+\n+In its simplest form, Robo is used by creating a RoboFile.php at the root of your project.\n+\n+If `robo` is in your $PATH:\n+```\n+$ cd myproject\n+$ robo mycommand\n+```\n+Alternately, add `robo` to your composer.json file:\n+```\n+$ cd myproject\n+$ composer require consolidation/Robo:~1\n+$ ./vendor/bin/robo mycommand\n+```\n+There are more examples of this in the [Getting Started](getting-started.md) guide.\n+\n+## Implementing Composer Scripts with Robo\n+\n+When using Robo in your project, it is convenient to define Composer scripts that call your Robo commands.  Simply add the following to your composer.json file:\n+```\n+{\n+    \"name\": \"myorg/myproject\",\n+    \"require\": {\n+        \"consolidation/Robo\": \"~1\"\n+    },\n+    \"scripts\": {\n+        \"test\": \"composer robo test\",\n+        \"phar\": \"composer robo phar:build\",\n+        \"robo\": \"robo --ansi --load-from $(pwd)/scripts/BuildCommands.php\"\n+    }\n+}\n+```\n+*Note*: When you include Robo as a library like this, some external projects used by certain core Robo tasks are not automatically included in your project.  See the `\"suggest\":` section of Robo's composer.json for a list of external projects you might also want to require in your project.\n+\n+Once you have set up your composer.json file (and ran `composer update` if you manually changed the `require` or `require-dev` sections), Composer will ensure that your project-local copy of Robo in the `vendor/bin` dir is in your $PATH when you run the additional Composer scripts that you declared:\n+```\n+$ cd myproject\n+$ composer test\n+$ composer phar\n+```\n+This will call the public methods `test()` and `phar()` in your RoboFile.php when using `composer test` and `composer phar`, respectively.\n+\n+Advertising your build commands as Composer scripts is a useful way to provide the key commands used for testing, building or packaging your application. Also, if your application should happen to provide a commandline tool to perform the operations of the application itself, then defining your build commands in their own RoboFile provides desirable separation, keeping your build commands out of the help and list commands of your primary script.\n+\n+If you would like to simplify the output of your script (e.g. when running on a CI service), replace the `--ansi` option in the example above with `--no-ansi`, and  colored terminal output and progress bars will be disabled. \n+\n+## Creating a Standalone Phar with Robo","path":"docs/packaging.md","position":52,"original_position":52,"commit_id":"bd909c828b766e944f77487b746fe299e1ec7213","original_commit_id":"bd909c828b766e944f77487b746fe299e1ec7213","user":{"login":"DavertMik","id":220264,"avatar_url":"https://avatars.githubusercontent.com/u/220264?v=3","gravatar_id":"","url":"https://api.github.com/users/DavertMik","html_url":"https://github.com/DavertMik","followers_url":"https://api.github.com/users/DavertMik/followers","following_url":"https://api.github.com/users/DavertMik/following{/other_user}","gists_url":"https://api.github.com/users/DavertMik/gists{/gist_id}","starred_url":"https://api.github.com/users/DavertMik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DavertMik/subscriptions","organizations_url":"https://api.github.com/users/DavertMik/orgs","repos_url":"https://api.github.com/users/DavertMik/repos","events_url":"https://api.github.com/users/DavertMik/events{/privacy}","received_events_url":"https://api.github.com/users/DavertMik/received_events","type":"User","site_admin":false},"body":"And this can go to \"Framework page\". The idea is a step y step instructions on how to create custom CLI application using Robo as a framework. Don't hesitate to provide examples using your experience with Drush ","created_at":"2016-08-24T20:06:48Z","updated_at":"2016-08-24T20:06:48Z","html_url":"https://github.com/consolidation-org/Robo/pull/415#discussion_r76128935","pull_request_url":"https://api.github.com/repos/consolidation-org/Robo/pulls/415","_links":{"self":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/comments/76128935"},"html":{"href":"https://github.com/consolidation-org/Robo/pull/415#discussion_r76128935"},"pull_request":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/415"}}},"pull_request":{"url":"https://api.github.com/repos/consolidation-org/Robo/pulls/415","id":82232659,"html_url":"https://github.com/consolidation-org/Robo/pull/415","diff_url":"https://github.com/consolidation-org/Robo/pull/415.diff","patch_url":"https://github.com/consolidation-org/Robo/pull/415.patch","issue_url":"https://api.github.com/repos/consolidation-org/Robo/issues/415","number":415,"state":"open","locked":false,"title":"Documentation on extending / packaging Robo and Robo-based scripts.","user":{"login":"greg-1-anderson","id":612191,"avatar_url":"https://avatars.githubusercontent.com/u/612191?v=3","gravatar_id":"","url":"https://api.github.com/users/greg-1-anderson","html_url":"https://github.com/greg-1-anderson","followers_url":"https://api.github.com/users/greg-1-anderson/followers","following_url":"https://api.github.com/users/greg-1-anderson/following{/other_user}","gists_url":"https://api.github.com/users/greg-1-anderson/gists{/gist_id}","starred_url":"https://api.github.com/users/greg-1-anderson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/greg-1-anderson/subscriptions","organizations_url":"https://api.github.com/users/greg-1-anderson/orgs","repos_url":"https://api.github.com/users/greg-1-anderson/repos","events_url":"https://api.github.com/users/greg-1-anderson/events{/privacy}","received_events_url":"https://api.github.com/users/greg-1-anderson/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-08-22T17:43:08Z","updated_at":"2016-08-24T20:06:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"bba4b919940e624343999400ca14f3d0d55fc448","assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/consolidation-org/Robo/milestones/3","html_url":"https://github.com/consolidation-org/Robo/milestones/1.0","labels_url":"https://api.github.com/repos/consolidation-org/Robo/milestones/3/labels","id":1498461,"number":3,"title":"1.0","description":"Stable version of Robo","creator":{"login":"DavertMik","id":220264,"avatar_url":"https://avatars.githubusercontent.com/u/220264?v=3","gravatar_id":"","url":"https://api.github.com/users/DavertMik","html_url":"https://github.com/DavertMik","followers_url":"https://api.github.com/users/DavertMik/followers","following_url":"https://api.github.com/users/DavertMik/following{/other_user}","gists_url":"https://api.github.com/users/DavertMik/gists{/gist_id}","starred_url":"https://api.github.com/users/DavertMik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DavertMik/subscriptions","organizations_url":"https://api.github.com/users/DavertMik/orgs","repos_url":"https://api.github.com/users/DavertMik/repos","events_url":"https://api.github.com/users/DavertMik/events{/privacy}","received_events_url":"https://api.github.com/users/DavertMik/received_events","type":"User","site_admin":false},"open_issues":3,"closed_issues":19,"state":"open","created_at":"2016-01-11T22:43:32Z","updated_at":"2016-08-22T17:43:08Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/consolidation-org/Robo/pulls/415/commits","review_comments_url":"https://api.github.com/repos/consolidation-org/Robo/pulls/415/comments","review_comment_url":"https://api.github.com/repos/consolidation-org/Robo/pulls/comments{/number}","comments_url":"https://api.github.com/repos/consolidation-org/Robo/issues/415/comments","statuses_url":"https://api.github.com/repos/consolidation-org/Robo/statuses/bd909c828b766e944f77487b746fe299e1ec7213","head":{"label":"consolidation-org:extending-packaging","ref":"extending-packaging","sha":"bd909c828b766e944f77487b746fe299e1ec7213","user":{"login":"consolidation-org","id":17601275,"avatar_url":"https://avatars.githubusercontent.com/u/17601275?v=3","gravatar_id":"","url":"https://api.github.com/users/consolidation-org","html_url":"https://github.com/consolidation-org","followers_url":"https://api.github.com/users/consolidation-org/followers","following_url":"https://api.github.com/users/consolidation-org/following{/other_user}","gists_url":"https://api.github.com/users/consolidation-org/gists{/gist_id}","starred_url":"https://api.github.com/users/consolidation-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/consolidation-org/subscriptions","organizations_url":"https://api.github.com/users/consolidation-org/orgs","repos_url":"https://api.github.com/users/consolidation-org/repos","events_url":"https://api.github.com/users/consolidation-org/events{/privacy}","received_events_url":"https://api.github.com/users/consolidation-org/received_events","type":"Organization","site_admin":false},"repo":{"id":16185196,"name":"Robo","full_name":"consolidation-org/Robo","owner":{"login":"consolidation-org","id":17601275,"avatar_url":"https://avatars.githubusercontent.com/u/17601275?v=3","gravatar_id":"","url":"https://api.github.com/users/consolidation-org","html_url":"https://github.com/consolidation-org","followers_url":"https://api.github.com/users/consolidation-org/followers","following_url":"https://api.github.com/users/consolidation-org/following{/other_user}","gists_url":"https://api.github.com/users/consolidation-org/gists{/gist_id}","starred_url":"https://api.github.com/users/consolidation-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/consolidation-org/subscriptions","organizations_url":"https://api.github.com/users/consolidation-org/orgs","repos_url":"https://api.github.com/users/consolidation-org/repos","events_url":"https://api.github.com/users/consolidation-org/events{/privacy}","received_events_url":"https://api.github.com/users/consolidation-org/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/consolidation-org/Robo","description":"Modern task runner for PHP","fork":false,"url":"https://api.github.com/repos/consolidation-org/Robo","forks_url":"https://api.github.com/repos/consolidation-org/Robo/forks","keys_url":"https://api.github.com/repos/consolidation-org/Robo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/consolidation-org/Robo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/consolidation-org/Robo/teams","hooks_url":"https://api.github.com/repos/consolidation-org/Robo/hooks","issue_events_url":"https://api.github.com/repos/consolidation-org/Robo/issues/events{/number}","events_url":"https://api.github.com/repos/consolidation-org/Robo/events","assignees_url":"https://api.github.com/repos/consolidation-org/Robo/assignees{/user}","branches_url":"https://api.github.com/repos/consolidation-org/Robo/branches{/branch}","tags_url":"https://api.github.com/repos/consolidation-org/Robo/tags","blobs_url":"https://api.github.com/repos/consolidation-org/Robo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/consolidation-org/Robo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/consolidation-org/Robo/git/refs{/sha}","trees_url":"https://api.github.com/repos/consolidation-org/Robo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/consolidation-org/Robo/statuses/{sha}","languages_url":"https://api.github.com/repos/consolidation-org/Robo/languages","stargazers_url":"https://api.github.com/repos/consolidation-org/Robo/stargazers","contributors_url":"https://api.github.com/repos/consolidation-org/Robo/contributors","subscribers_url":"https://api.github.com/repos/consolidation-org/Robo/subscribers","subscription_url":"https://api.github.com/repos/consolidation-org/Robo/subscription","commits_url":"https://api.github.com/repos/consolidation-org/Robo/commits{/sha}","git_commits_url":"https://api.github.com/repos/consolidation-org/Robo/git/commits{/sha}","comments_url":"https://api.github.com/repos/consolidation-org/Robo/comments{/number}","issue_comment_url":"https://api.github.com/repos/consolidation-org/Robo/issues/comments{/number}","contents_url":"https://api.github.com/repos/consolidation-org/Robo/contents/{+path}","compare_url":"https://api.github.com/repos/consolidation-org/Robo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/consolidation-org/Robo/merges","archive_url":"https://api.github.com/repos/consolidation-org/Robo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/consolidation-org/Robo/downloads","issues_url":"https://api.github.com/repos/consolidation-org/Robo/issues{/number}","pulls_url":"https://api.github.com/repos/consolidation-org/Robo/pulls{/number}","milestones_url":"https://api.github.com/repos/consolidation-org/Robo/milestones{/number}","notifications_url":"https://api.github.com/repos/consolidation-org/Robo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/consolidation-org/Robo/labels{/name}","releases_url":"https://api.github.com/repos/consolidation-org/Robo/releases{/id}","deployments_url":"https://api.github.com/repos/consolidation-org/Robo/deployments","created_at":"2014-01-23T20:47:44Z","updated_at":"2016-08-24T16:52:18Z","pushed_at":"2016-08-23T16:03:15Z","git_url":"git://github.com/consolidation-org/Robo.git","ssh_url":"git@github.com:consolidation-org/Robo.git","clone_url":"https://github.com/consolidation-org/Robo.git","svn_url":"https://github.com/consolidation-org/Robo","homepage":"http://robo.li","size":11269,"stargazers_count":1350,"watchers_count":1350,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":167,"mirror_url":null,"open_issues_count":78,"forks":167,"open_issues":78,"watchers":1350,"default_branch":"master"}},"base":{"label":"consolidation-org:master","ref":"master","sha":"560cec46dfe909f3011c0a8574f8d96f042cee34","user":{"login":"consolidation-org","id":17601275,"avatar_url":"https://avatars.githubusercontent.com/u/17601275?v=3","gravatar_id":"","url":"https://api.github.com/users/consolidation-org","html_url":"https://github.com/consolidation-org","followers_url":"https://api.github.com/users/consolidation-org/followers","following_url":"https://api.github.com/users/consolidation-org/following{/other_user}","gists_url":"https://api.github.com/users/consolidation-org/gists{/gist_id}","starred_url":"https://api.github.com/users/consolidation-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/consolidation-org/subscriptions","organizations_url":"https://api.github.com/users/consolidation-org/orgs","repos_url":"https://api.github.com/users/consolidation-org/repos","events_url":"https://api.github.com/users/consolidation-org/events{/privacy}","received_events_url":"https://api.github.com/users/consolidation-org/received_events","type":"Organization","site_admin":false},"repo":{"id":16185196,"name":"Robo","full_name":"consolidation-org/Robo","owner":{"login":"consolidation-org","id":17601275,"avatar_url":"https://avatars.githubusercontent.com/u/17601275?v=3","gravatar_id":"","url":"https://api.github.com/users/consolidation-org","html_url":"https://github.com/consolidation-org","followers_url":"https://api.github.com/users/consolidation-org/followers","following_url":"https://api.github.com/users/consolidation-org/following{/other_user}","gists_url":"https://api.github.com/users/consolidation-org/gists{/gist_id}","starred_url":"https://api.github.com/users/consolidation-org/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/consolidation-org/subscriptions","organizations_url":"https://api.github.com/users/consolidation-org/orgs","repos_url":"https://api.github.com/users/consolidation-org/repos","events_url":"https://api.github.com/users/consolidation-org/events{/privacy}","received_events_url":"https://api.github.com/users/consolidation-org/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/consolidation-org/Robo","description":"Modern task runner for PHP","fork":false,"url":"https://api.github.com/repos/consolidation-org/Robo","forks_url":"https://api.github.com/repos/consolidation-org/Robo/forks","keys_url":"https://api.github.com/repos/consolidation-org/Robo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/consolidation-org/Robo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/consolidation-org/Robo/teams","hooks_url":"https://api.github.com/repos/consolidation-org/Robo/hooks","issue_events_url":"https://api.github.com/repos/consolidation-org/Robo/issues/events{/number}","events_url":"https://api.github.com/repos/consolidation-org/Robo/events","assignees_url":"https://api.github.com/repos/consolidation-org/Robo/assignees{/user}","branches_url":"https://api.github.com/repos/consolidation-org/Robo/branches{/branch}","tags_url":"https://api.github.com/repos/consolidation-org/Robo/tags","blobs_url":"https://api.github.com/repos/consolidation-org/Robo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/consolidation-org/Robo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/consolidation-org/Robo/git/refs{/sha}","trees_url":"https://api.github.com/repos/consolidation-org/Robo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/consolidation-org/Robo/statuses/{sha}","languages_url":"https://api.github.com/repos/consolidation-org/Robo/languages","stargazers_url":"https://api.github.com/repos/consolidation-org/Robo/stargazers","contributors_url":"https://api.github.com/repos/consolidation-org/Robo/contributors","subscribers_url":"https://api.github.com/repos/consolidation-org/Robo/subscribers","subscription_url":"https://api.github.com/repos/consolidation-org/Robo/subscription","commits_url":"https://api.github.com/repos/consolidation-org/Robo/commits{/sha}","git_commits_url":"https://api.github.com/repos/consolidation-org/Robo/git/commits{/sha}","comments_url":"https://api.github.com/repos/consolidation-org/Robo/comments{/number}","issue_comment_url":"https://api.github.com/repos/consolidation-org/Robo/issues/comments{/number}","contents_url":"https://api.github.com/repos/consolidation-org/Robo/contents/{+path}","compare_url":"https://api.github.com/repos/consolidation-org/Robo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/consolidation-org/Robo/merges","archive_url":"https://api.github.com/repos/consolidation-org/Robo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/consolidation-org/Robo/downloads","issues_url":"https://api.github.com/repos/consolidation-org/Robo/issues{/number}","pulls_url":"https://api.github.com/repos/consolidation-org/Robo/pulls{/number}","milestones_url":"https://api.github.com/repos/consolidation-org/Robo/milestones{/number}","notifications_url":"https://api.github.com/repos/consolidation-org/Robo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/consolidation-org/Robo/labels{/name}","releases_url":"https://api.github.com/repos/consolidation-org/Robo/releases{/id}","deployments_url":"https://api.github.com/repos/consolidation-org/Robo/deployments","created_at":"2014-01-23T20:47:44Z","updated_at":"2016-08-24T16:52:18Z","pushed_at":"2016-08-23T16:03:15Z","git_url":"git://github.com/consolidation-org/Robo.git","ssh_url":"git@github.com:consolidation-org/Robo.git","clone_url":"https://github.com/consolidation-org/Robo.git","svn_url":"https://github.com/consolidation-org/Robo","homepage":"http://robo.li","size":11269,"stargazers_count":1350,"watchers_count":1350,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":167,"mirror_url":null,"open_issues_count":78,"forks":167,"open_issues":78,"watchers":1350,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/415"},"html":{"href":"https://github.com/consolidation-org/Robo/pull/415"},"issue":{"href":"https://api.github.com/repos/consolidation-org/Robo/issues/415"},"comments":{"href":"https://api.github.com/repos/consolidation-org/Robo/issues/415/comments"},"review_comments":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/415/comments"},"review_comment":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/consolidation-org/Robo/pulls/415/commits"},"statuses":{"href":"https://api.github.com/repos/consolidation-org/Robo/statuses/bd909c828b766e944f77487b746fe299e1ec7213"}}}}
{"actor":{"display_login":"DavertMik"}}