{"action":"created","comment":{"url":"https://api.github.com/repos/commonquail/require/pulls/comments/34412569","id":34412569,"diff_hunk":"@@ -0,0 +1,334 @@\n+# Require: Tiny Java Precondition Library\n+\n+*Require* is a small Java library that provides precondition validation\n+via static convenience methods\n+on two classes.\n+\n+The library is somewhat opinionated,\n+and perhaps controversially so;\n+be sure to read the documentation fully.\n+\n+## Usage\n+\n+Import the desired classes as necessary:\n+\n+```java\n+import org.require.Argument;\n+import org.require.State;\n+```\n+\n+The first of these is intended for method arguments\n+and throws only subtypes of `IllegalArgumentException`\n+on failure.\n+It is typically the more useful class.\n+\n+The second is intended for state validation\n+and throws only subtypes of `IllegalStateException`\n+on failure.\n+\n+```java\n+public void foo(final Object bar) {\n+    Argument.notNull(bar, \"bar\");\n+    State.notNull(this.baz, \"foo called before baz\");","path":"README.md","position":32,"original_position":32,"commit_id":"2d8d483208b3fd5ec2b21ff622f4c5458b839ce4","original_commit_id":"2d8d483208b3fd5ec2b21ff622f4c5458b839ce4","user":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"body":"This error message is nonsensically nonsensical. Largely, that is because of using `State.notNull` instead of boolean condition checking covered in #9, but it can probably be made a little better regardless.","created_at":"2015-07-11T13:20:23Z","updated_at":"2015-07-11T13:20:23Z","html_url":"https://github.com/commonquail/require/pull/8#discussion_r34412569","pull_request_url":"https://api.github.com/repos/commonquail/require/pulls/8","_links":{"self":{"href":"https://api.github.com/repos/commonquail/require/pulls/comments/34412569"},"html":{"href":"https://github.com/commonquail/require/pull/8#discussion_r34412569"},"pull_request":{"href":"https://api.github.com/repos/commonquail/require/pulls/8"}}},"pull_request":{"url":"https://api.github.com/repos/commonquail/require/pulls/8","id":37643728,"html_url":"https://github.com/commonquail/require/pull/8","diff_url":"https://github.com/commonquail/require/pull/8.diff","patch_url":"https://github.com/commonquail/require/pull/8.patch","issue_url":"https://api.github.com/repos/commonquail/require/issues/8","number":8,"state":"open","locked":false,"title":"[WIP] Write README","user":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"body":"Closes #7.\r\n\r\n[Rendered](../blob/readme/README.md).","created_at":"2015-06-14T15:57:06Z","updated_at":"2015-07-11T13:20:23Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e6a575625fd3b1577d5be193cc5dfe10400074ab","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/commonquail/require/pulls/8/commits","review_comments_url":"https://api.github.com/repos/commonquail/require/pulls/8/comments","review_comment_url":"https://api.github.com/repos/commonquail/require/pulls/comments{/number}","comments_url":"https://api.github.com/repos/commonquail/require/issues/8/comments","statuses_url":"https://api.github.com/repos/commonquail/require/statuses/2d8d483208b3fd5ec2b21ff622f4c5458b839ce4","head":{"label":"commonquail:readme","ref":"readme","sha":"2d8d483208b3fd5ec2b21ff622f4c5458b839ce4","user":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"repo":{"id":37273791,"name":"require","full_name":"commonquail/require","owner":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/commonquail/require","description":"A trivial Java precondition library","fork":false,"url":"https://api.github.com/repos/commonquail/require","forks_url":"https://api.github.com/repos/commonquail/require/forks","keys_url":"https://api.github.com/repos/commonquail/require/keys{/key_id}","collaborators_url":"https://api.github.com/repos/commonquail/require/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/commonquail/require/teams","hooks_url":"https://api.github.com/repos/commonquail/require/hooks","issue_events_url":"https://api.github.com/repos/commonquail/require/issues/events{/number}","events_url":"https://api.github.com/repos/commonquail/require/events","assignees_url":"https://api.github.com/repos/commonquail/require/assignees{/user}","branches_url":"https://api.github.com/repos/commonquail/require/branches{/branch}","tags_url":"https://api.github.com/repos/commonquail/require/tags","blobs_url":"https://api.github.com/repos/commonquail/require/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/commonquail/require/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/commonquail/require/git/refs{/sha}","trees_url":"https://api.github.com/repos/commonquail/require/git/trees{/sha}","statuses_url":"https://api.github.com/repos/commonquail/require/statuses/{sha}","languages_url":"https://api.github.com/repos/commonquail/require/languages","stargazers_url":"https://api.github.com/repos/commonquail/require/stargazers","contributors_url":"https://api.github.com/repos/commonquail/require/contributors","subscribers_url":"https://api.github.com/repos/commonquail/require/subscribers","subscription_url":"https://api.github.com/repos/commonquail/require/subscription","commits_url":"https://api.github.com/repos/commonquail/require/commits{/sha}","git_commits_url":"https://api.github.com/repos/commonquail/require/git/commits{/sha}","comments_url":"https://api.github.com/repos/commonquail/require/comments{/number}","issue_comment_url":"https://api.github.com/repos/commonquail/require/issues/comments{/number}","contents_url":"https://api.github.com/repos/commonquail/require/contents/{+path}","compare_url":"https://api.github.com/repos/commonquail/require/compare/{base}...{head}","merges_url":"https://api.github.com/repos/commonquail/require/merges","archive_url":"https://api.github.com/repos/commonquail/require/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/commonquail/require/downloads","issues_url":"https://api.github.com/repos/commonquail/require/issues{/number}","pulls_url":"https://api.github.com/repos/commonquail/require/pulls{/number}","milestones_url":"https://api.github.com/repos/commonquail/require/milestones{/number}","notifications_url":"https://api.github.com/repos/commonquail/require/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/commonquail/require/labels{/name}","releases_url":"https://api.github.com/repos/commonquail/require/releases{/id}","created_at":"2015-06-11T16:51:55Z","updated_at":"2015-06-11T17:02:28Z","pushed_at":"2015-06-28T16:31:19Z","git_url":"git://github.com/commonquail/require.git","ssh_url":"git@github.com:commonquail/require.git","clone_url":"https://github.com/commonquail/require.git","svn_url":"https://github.com/commonquail/require","homepage":null,"size":283,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":5,"forks":0,"open_issues":5,"watchers":0,"default_branch":"master"}},"base":{"label":"commonquail:master","ref":"master","sha":"8923e3ab5375917f6016dbbeb3874f97eef422fe","user":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"repo":{"id":37273791,"name":"require","full_name":"commonquail/require","owner":{"login":"commonquail","id":603326,"avatar_url":"https://avatars.githubusercontent.com/u/603326?v=3","gravatar_id":"","url":"https://api.github.com/users/commonquail","html_url":"https://github.com/commonquail","followers_url":"https://api.github.com/users/commonquail/followers","following_url":"https://api.github.com/users/commonquail/following{/other_user}","gists_url":"https://api.github.com/users/commonquail/gists{/gist_id}","starred_url":"https://api.github.com/users/commonquail/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/commonquail/subscriptions","organizations_url":"https://api.github.com/users/commonquail/orgs","repos_url":"https://api.github.com/users/commonquail/repos","events_url":"https://api.github.com/users/commonquail/events{/privacy}","received_events_url":"https://api.github.com/users/commonquail/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/commonquail/require","description":"A trivial Java precondition library","fork":false,"url":"https://api.github.com/repos/commonquail/require","forks_url":"https://api.github.com/repos/commonquail/require/forks","keys_url":"https://api.github.com/repos/commonquail/require/keys{/key_id}","collaborators_url":"https://api.github.com/repos/commonquail/require/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/commonquail/require/teams","hooks_url":"https://api.github.com/repos/commonquail/require/hooks","issue_events_url":"https://api.github.com/repos/commonquail/require/issues/events{/number}","events_url":"https://api.github.com/repos/commonquail/require/events","assignees_url":"https://api.github.com/repos/commonquail/require/assignees{/user}","branches_url":"https://api.github.com/repos/commonquail/require/branches{/branch}","tags_url":"https://api.github.com/repos/commonquail/require/tags","blobs_url":"https://api.github.com/repos/commonquail/require/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/commonquail/require/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/commonquail/require/git/refs{/sha}","trees_url":"https://api.github.com/repos/commonquail/require/git/trees{/sha}","statuses_url":"https://api.github.com/repos/commonquail/require/statuses/{sha}","languages_url":"https://api.github.com/repos/commonquail/require/languages","stargazers_url":"https://api.github.com/repos/commonquail/require/stargazers","contributors_url":"https://api.github.com/repos/commonquail/require/contributors","subscribers_url":"https://api.github.com/repos/commonquail/require/subscribers","subscription_url":"https://api.github.com/repos/commonquail/require/subscription","commits_url":"https://api.github.com/repos/commonquail/require/commits{/sha}","git_commits_url":"https://api.github.com/repos/commonquail/require/git/commits{/sha}","comments_url":"https://api.github.com/repos/commonquail/require/comments{/number}","issue_comment_url":"https://api.github.com/repos/commonquail/require/issues/comments{/number}","contents_url":"https://api.github.com/repos/commonquail/require/contents/{+path}","compare_url":"https://api.github.com/repos/commonquail/require/compare/{base}...{head}","merges_url":"https://api.github.com/repos/commonquail/require/merges","archive_url":"https://api.github.com/repos/commonquail/require/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/commonquail/require/downloads","issues_url":"https://api.github.com/repos/commonquail/require/issues{/number}","pulls_url":"https://api.github.com/repos/commonquail/require/pulls{/number}","milestones_url":"https://api.github.com/repos/commonquail/require/milestones{/number}","notifications_url":"https://api.github.com/repos/commonquail/require/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/commonquail/require/labels{/name}","releases_url":"https://api.github.com/repos/commonquail/require/releases{/id}","created_at":"2015-06-11T16:51:55Z","updated_at":"2015-06-11T17:02:28Z","pushed_at":"2015-06-28T16:31:19Z","git_url":"git://github.com/commonquail/require.git","ssh_url":"git@github.com:commonquail/require.git","clone_url":"https://github.com/commonquail/require.git","svn_url":"https://github.com/commonquail/require","homepage":null,"size":283,"stargazers_count":0,"watchers_count":0,"language":"Java","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":5,"forks":0,"open_issues":5,"watchers":0,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/commonquail/require/pulls/8"},"html":{"href":"https://github.com/commonquail/require/pull/8"},"issue":{"href":"https://api.github.com/repos/commonquail/require/issues/8"},"comments":{"href":"https://api.github.com/repos/commonquail/require/issues/8/comments"},"review_comments":{"href":"https://api.github.com/repos/commonquail/require/pulls/8/comments"},"review_comment":{"href":"https://api.github.com/repos/commonquail/require/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/commonquail/require/pulls/8/commits"},"statuses":{"href":"https://api.github.com/repos/commonquail/require/statuses/2d8d483208b3fd5ec2b21ff622f4c5458b839ce4"}}}}