{"action":"created","comment":{"url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/comments/37639984","id":37639984,"diff_hunk":"@@ -4,81 +4,107 @@ Testing code changes\n Automated tests\n ---------------\n \n-At the bottom of many commit messages in\n-https://github.com/openmicroscopy/bioformats, you will find a few lines\n-similar to this:\n+The :source:`Bio-Formats testing framework <components/test-suite>` component\n+contains most of the infrastructure to run automated tests against the data\n+repository.\n \n-::\n+After checking out source code and building all the JAR files (see\n+:doc:`building-bioformats`), switch to the test-suite component and run the tests using the :program:`ant test-automated` target::\n \n-    To test, please run:\n+    $ cd components/test-suite\n+    $ ant -Dtestng.directory=$DATA/metamorph test-automated\n \n-    ant -Dtestng.directory=$DATA/metamorph test-automated\n+where $DATA is the path to the full data repository.\n \n-This shows the command(s) necessary to run automated tests against the\n-files likely to be affected by that commit. If you want to run these\n-tests, you will need to do the following:\n+.. program:: ant test-automated\n \n-Clone bioformats.git and checkout the appropriate branch (by following\n-the directions on the :devs_doc:`Git usage <using-git.html>`\n-page). Run this command to build all of the JAR files:\n+Multiple options can be passed to the :program:`ant test-automated` target \n+either by setting the ``testng.${option}`` environment variable or by passing\n+:option:`-Dtestng.${option}=value` via the command-line.\n \n-::\n+.. envvar:: testng.directory","path":"docs/sphinx/developers/commit-testing.txt","position":35,"original_position":35,"commit_id":"6a796abdef2ff25579bd5ca6d0db8411a2ecfd3b","original_commit_id":"6a796abdef2ff25579bd5ca6d0db8411a2ecfd3b","user":{"login":"sbesson","id":1355463,"avatar_url":"https://avatars.githubusercontent.com/u/1355463?v=3","gravatar_id":"","url":"https://api.github.com/users/sbesson","html_url":"https://github.com/sbesson","followers_url":"https://api.github.com/users/sbesson/followers","following_url":"https://api.github.com/users/sbesson/following{/other_user}","gists_url":"https://api.github.com/users/sbesson/gists{/gist_id}","starred_url":"https://api.github.com/users/sbesson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sbesson/subscriptions","organizations_url":"https://api.github.com/users/sbesson/orgs","repos_url":"https://api.github.com/users/sbesson/repos","events_url":"https://api.github.com/users/sbesson/events{/privacy}","received_events_url":"https://api.github.com/users/sbesson/received_events","type":"User","site_admin":false},"body":"Cannot. Sphinx will not cope with the middle dot. Which is why I used envvar.","created_at":"2015-08-21T14:36:21Z","updated_at":"2015-08-21T14:36:21Z","html_url":"https://github.com/openmicroscopy/bioformats/pull/1937#discussion_r37639984","pull_request_url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937","_links":{"self":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/comments/37639984"},"html":{"href":"https://github.com/openmicroscopy/bioformats/pull/1937#discussion_r37639984"},"pull_request":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937"}}},"pull_request":{"url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937","id":42750784,"html_url":"https://github.com/openmicroscopy/bioformats/pull/1937","diff_url":"https://github.com/openmicroscopy/bioformats/pull/1937.diff","patch_url":"https://github.com/openmicroscopy/bioformats/pull/1937.patch","issue_url":"https://api.github.com/repos/openmicroscopy/bioformats/issues/1937","number":1937,"state":"open","locked":false,"title":"Automated tests documentation","user":{"login":"sbesson","id":1355463,"avatar_url":"https://avatars.githubusercontent.com/u/1355463?v=3","gravatar_id":"","url":"https://api.github.com/users/sbesson","html_url":"https://github.com/sbesson","followers_url":"https://api.github.com/users/sbesson/followers","following_url":"https://api.github.com/users/sbesson/following{/other_user}","gists_url":"https://api.github.com/users/sbesson/gists{/gist_id}","starred_url":"https://api.github.com/users/sbesson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sbesson/subscriptions","organizations_url":"https://api.github.com/users/sbesson/orgs","repos_url":"https://api.github.com/users/sbesson/repos","events_url":"https://api.github.com/users/sbesson/events{/privacy}","received_events_url":"https://api.github.com/users/sbesson/received_events","type":"User","site_admin":false},"body":"See https://trello.com/c/wT2zpjrM/41-add-documentation-for-automated-test-output\r\n\r\nThis PR reviews and updates the content of the Sphinx documentation about automated tests. Additionally, this downgrade the `FormatReaderTest` memo file size and used files lines to `DEBUG` level so that it does not appear in the main console output (but should still be logged in thread log files).","created_at":"2015-08-18T21:24:54Z","updated_at":"2015-08-21T14:36:21Z","closed_at":null,"merged_at":null,"merge_commit_sha":"8b3e14a938c727ef999bec8dccf9bada429fca0f","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937/commits","review_comments_url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937/comments","review_comment_url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openmicroscopy/bioformats/issues/1937/comments","statuses_url":"https://api.github.com/repos/openmicroscopy/bioformats/statuses/6a796abdef2ff25579bd5ca6d0db8411a2ecfd3b","head":{"label":"sbesson:automated_tests_doc","ref":"automated_tests_doc","sha":"6a796abdef2ff25579bd5ca6d0db8411a2ecfd3b","user":{"login":"sbesson","id":1355463,"avatar_url":"https://avatars.githubusercontent.com/u/1355463?v=3","gravatar_id":"","url":"https://api.github.com/users/sbesson","html_url":"https://github.com/sbesson","followers_url":"https://api.github.com/users/sbesson/followers","following_url":"https://api.github.com/users/sbesson/following{/other_user}","gists_url":"https://api.github.com/users/sbesson/gists{/gist_id}","starred_url":"https://api.github.com/users/sbesson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sbesson/subscriptions","organizations_url":"https://api.github.com/users/sbesson/orgs","repos_url":"https://api.github.com/users/sbesson/repos","events_url":"https://api.github.com/users/sbesson/events{/privacy}","received_events_url":"https://api.github.com/users/sbesson/received_events","type":"User","site_admin":false},"repo":{"id":3541327,"name":"bioformats","full_name":"sbesson/bioformats","owner":{"login":"sbesson","id":1355463,"avatar_url":"https://avatars.githubusercontent.com/u/1355463?v=3","gravatar_id":"","url":"https://api.github.com/users/sbesson","html_url":"https://github.com/sbesson","followers_url":"https://api.github.com/users/sbesson/followers","following_url":"https://api.github.com/users/sbesson/following{/other_user}","gists_url":"https://api.github.com/users/sbesson/gists{/gist_id}","starred_url":"https://api.github.com/users/sbesson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sbesson/subscriptions","organizations_url":"https://api.github.com/users/sbesson/orgs","repos_url":"https://api.github.com/users/sbesson/repos","events_url":"https://api.github.com/users/sbesson/events{/privacy}","received_events_url":"https://api.github.com/users/sbesson/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/sbesson/bioformats","description":"Bio-Formats is a Java library for reading and writing data in life sciences image file formats. It is developed by the  Open Microscopy Environment (particularly  UW-Madison LOCI and  Glencoe Software). Bio-Formats is released under the  GNU General Public License (GPL); commercial licenses are available from  Glencoe Software. ","fork":true,"url":"https://api.github.com/repos/sbesson/bioformats","forks_url":"https://api.github.com/repos/sbesson/bioformats/forks","keys_url":"https://api.github.com/repos/sbesson/bioformats/keys{/key_id}","collaborators_url":"https://api.github.com/repos/sbesson/bioformats/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/sbesson/bioformats/teams","hooks_url":"https://api.github.com/repos/sbesson/bioformats/hooks","issue_events_url":"https://api.github.com/repos/sbesson/bioformats/issues/events{/number}","events_url":"https://api.github.com/repos/sbesson/bioformats/events","assignees_url":"https://api.github.com/repos/sbesson/bioformats/assignees{/user}","branches_url":"https://api.github.com/repos/sbesson/bioformats/branches{/branch}","tags_url":"https://api.github.com/repos/sbesson/bioformats/tags","blobs_url":"https://api.github.com/repos/sbesson/bioformats/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/sbesson/bioformats/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/sbesson/bioformats/git/refs{/sha}","trees_url":"https://api.github.com/repos/sbesson/bioformats/git/trees{/sha}","statuses_url":"https://api.github.com/repos/sbesson/bioformats/statuses/{sha}","languages_url":"https://api.github.com/repos/sbesson/bioformats/languages","stargazers_url":"https://api.github.com/repos/sbesson/bioformats/stargazers","contributors_url":"https://api.github.com/repos/sbesson/bioformats/contributors","subscribers_url":"https://api.github.com/repos/sbesson/bioformats/subscribers","subscription_url":"https://api.github.com/repos/sbesson/bioformats/subscription","commits_url":"https://api.github.com/repos/sbesson/bioformats/commits{/sha}","git_commits_url":"https://api.github.com/repos/sbesson/bioformats/git/commits{/sha}","comments_url":"https://api.github.com/repos/sbesson/bioformats/comments{/number}","issue_comment_url":"https://api.github.com/repos/sbesson/bioformats/issues/comments{/number}","contents_url":"https://api.github.com/repos/sbesson/bioformats/contents/{+path}","compare_url":"https://api.github.com/repos/sbesson/bioformats/compare/{base}...{head}","merges_url":"https://api.github.com/repos/sbesson/bioformats/merges","archive_url":"https://api.github.com/repos/sbesson/bioformats/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/sbesson/bioformats/downloads","issues_url":"https://api.github.com/repos/sbesson/bioformats/issues{/number}","pulls_url":"https://api.github.com/repos/sbesson/bioformats/pulls{/number}","milestones_url":"https://api.github.com/repos/sbesson/bioformats/milestones{/number}","notifications_url":"https://api.github.com/repos/sbesson/bioformats/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/sbesson/bioformats/labels{/name}","releases_url":"https://api.github.com/repos/sbesson/bioformats/releases{/id}","created_at":"2012-02-25T00:50:54Z","updated_at":"2015-05-07T13:40:01Z","pushed_at":"2015-08-21T07:05:01Z","git_url":"git://github.com/sbesson/bioformats.git","ssh_url":"git@github.com:sbesson/bioformats.git","clone_url":"https://github.com/sbesson/bioformats.git","svn_url":"https://github.com/sbesson/bioformats","homepage":"http://trac.openmicroscopy.org.uk/ome/wiki/BioFormats","size":257621,"stargazers_count":2,"watchers_count":2,"language":"Java","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":2,"default_branch":"develop"}},"base":{"label":"openmicroscopy:develop","ref":"develop","sha":"f88a220e30f03f65e3d91d4406419d80b653927d","user":{"login":"openmicroscopy","id":975861,"avatar_url":"https://avatars.githubusercontent.com/u/975861?v=3","gravatar_id":"","url":"https://api.github.com/users/openmicroscopy","html_url":"https://github.com/openmicroscopy","followers_url":"https://api.github.com/users/openmicroscopy/followers","following_url":"https://api.github.com/users/openmicroscopy/following{/other_user}","gists_url":"https://api.github.com/users/openmicroscopy/gists{/gist_id}","starred_url":"https://api.github.com/users/openmicroscopy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openmicroscopy/subscriptions","organizations_url":"https://api.github.com/users/openmicroscopy/orgs","repos_url":"https://api.github.com/users/openmicroscopy/repos","events_url":"https://api.github.com/users/openmicroscopy/events{/privacy}","received_events_url":"https://api.github.com/users/openmicroscopy/received_events","type":"Organization","site_admin":false},"repo":{"id":2510503,"name":"bioformats","full_name":"openmicroscopy/bioformats","owner":{"login":"openmicroscopy","id":975861,"avatar_url":"https://avatars.githubusercontent.com/u/975861?v=3","gravatar_id":"","url":"https://api.github.com/users/openmicroscopy","html_url":"https://github.com/openmicroscopy","followers_url":"https://api.github.com/users/openmicroscopy/followers","following_url":"https://api.github.com/users/openmicroscopy/following{/other_user}","gists_url":"https://api.github.com/users/openmicroscopy/gists{/gist_id}","starred_url":"https://api.github.com/users/openmicroscopy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openmicroscopy/subscriptions","organizations_url":"https://api.github.com/users/openmicroscopy/orgs","repos_url":"https://api.github.com/users/openmicroscopy/repos","events_url":"https://api.github.com/users/openmicroscopy/events{/privacy}","received_events_url":"https://api.github.com/users/openmicroscopy/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openmicroscopy/bioformats","description":"Bio-Formats is a Java library for reading and writing data in life sciences image file formats. It is developed by the  Open Microscopy Environment (particularly  UW-Madison LOCI and  Glencoe Software). Bio-Formats is released under the  GNU General Public License (GPL); commercial licenses are available from  Glencoe Software. ","fork":false,"url":"https://api.github.com/repos/openmicroscopy/bioformats","forks_url":"https://api.github.com/repos/openmicroscopy/bioformats/forks","keys_url":"https://api.github.com/repos/openmicroscopy/bioformats/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openmicroscopy/bioformats/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openmicroscopy/bioformats/teams","hooks_url":"https://api.github.com/repos/openmicroscopy/bioformats/hooks","issue_events_url":"https://api.github.com/repos/openmicroscopy/bioformats/issues/events{/number}","events_url":"https://api.github.com/repos/openmicroscopy/bioformats/events","assignees_url":"https://api.github.com/repos/openmicroscopy/bioformats/assignees{/user}","branches_url":"https://api.github.com/repos/openmicroscopy/bioformats/branches{/branch}","tags_url":"https://api.github.com/repos/openmicroscopy/bioformats/tags","blobs_url":"https://api.github.com/repos/openmicroscopy/bioformats/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openmicroscopy/bioformats/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openmicroscopy/bioformats/git/refs{/sha}","trees_url":"https://api.github.com/repos/openmicroscopy/bioformats/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openmicroscopy/bioformats/statuses/{sha}","languages_url":"https://api.github.com/repos/openmicroscopy/bioformats/languages","stargazers_url":"https://api.github.com/repos/openmicroscopy/bioformats/stargazers","contributors_url":"https://api.github.com/repos/openmicroscopy/bioformats/contributors","subscribers_url":"https://api.github.com/repos/openmicroscopy/bioformats/subscribers","subscription_url":"https://api.github.com/repos/openmicroscopy/bioformats/subscription","commits_url":"https://api.github.com/repos/openmicroscopy/bioformats/commits{/sha}","git_commits_url":"https://api.github.com/repos/openmicroscopy/bioformats/git/commits{/sha}","comments_url":"https://api.github.com/repos/openmicroscopy/bioformats/comments{/number}","issue_comment_url":"https://api.github.com/repos/openmicroscopy/bioformats/issues/comments{/number}","contents_url":"https://api.github.com/repos/openmicroscopy/bioformats/contents/{+path}","compare_url":"https://api.github.com/repos/openmicroscopy/bioformats/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openmicroscopy/bioformats/merges","archive_url":"https://api.github.com/repos/openmicroscopy/bioformats/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openmicroscopy/bioformats/downloads","issues_url":"https://api.github.com/repos/openmicroscopy/bioformats/issues{/number}","pulls_url":"https://api.github.com/repos/openmicroscopy/bioformats/pulls{/number}","milestones_url":"https://api.github.com/repos/openmicroscopy/bioformats/milestones{/number}","notifications_url":"https://api.github.com/repos/openmicroscopy/bioformats/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openmicroscopy/bioformats/labels{/name}","releases_url":"https://api.github.com/repos/openmicroscopy/bioformats/releases{/id}","created_at":"2011-10-04T08:06:14Z","updated_at":"2015-08-03T22:33:01Z","pushed_at":"2015-08-20T20:11:45Z","git_url":"git://github.com/openmicroscopy/bioformats.git","ssh_url":"git@github.com:openmicroscopy/bioformats.git","clone_url":"https://github.com/openmicroscopy/bioformats.git","svn_url":"https://github.com/openmicroscopy/bioformats","homepage":"http://www.openmicroscopy.org/site/products/bio-formats","size":283770,"stargazers_count":89,"watchers_count":89,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":107,"mirror_url":null,"open_issues_count":26,"forks":107,"open_issues":26,"watchers":89,"default_branch":"develop"}},"_links":{"self":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937"},"html":{"href":"https://github.com/openmicroscopy/bioformats/pull/1937"},"issue":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/issues/1937"},"comments":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/issues/1937/comments"},"review_comments":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937/comments"},"review_comment":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/pulls/1937/commits"},"statuses":{"href":"https://api.github.com/repos/openmicroscopy/bioformats/statuses/6a796abdef2ff25579bd5ca6d0db8411a2ecfd3b"}}}}