{"action":"created","issue":{"url":"https://api.github.com/repos/astropy/astropy/issues/4242","labels_url":"https://api.github.com/repos/astropy/astropy/issues/4242/labels{/name}","comments_url":"https://api.github.com/repos/astropy/astropy/issues/4242/comments","events_url":"https://api.github.com/repos/astropy/astropy/issues/4242/events","html_url":"https://github.com/astropy/astropy/pull/4242","id":111375249,"number":4242,"title":"format_doc decorator.","user":{"login":"MSeifert04","id":14200878,"avatar_url":"https://avatars.githubusercontent.com/u/14200878?v=3","gravatar_id":"","url":"https://api.github.com/users/MSeifert04","html_url":"https://github.com/MSeifert04","followers_url":"https://api.github.com/users/MSeifert04/followers","following_url":"https://api.github.com/users/MSeifert04/following{/other_user}","gists_url":"https://api.github.com/users/MSeifert04/gists{/gist_id}","starred_url":"https://api.github.com/users/MSeifert04/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MSeifert04/subscriptions","organizations_url":"https://api.github.com/users/MSeifert04/orgs","repos_url":"https://api.github.com/users/MSeifert04/repos","events_url":"https://api.github.com/users/MSeifert04/events{/privacy}","received_events_url":"https://api.github.com/users/MSeifert04/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/astropy/astropy/labels/Affects-release","name":"Affects-release","color":"0052cc"},{"url":"https://api.github.com/repos/astropy/astropy/labels/Enhancement","name":"Enhancement","color":"fad8c7"},{"url":"https://api.github.com/repos/astropy/astropy/labels/utils","name":"utils","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/astropy/astropy/milestones/26","html_url":"https://github.com/astropy/astropy/milestones/v1.2.0","labels_url":"https://api.github.com/repos/astropy/astropy/milestones/26/labels","id":1114049,"number":26,"title":"v1.2.0","description":"","creator":{"login":"astrofrog","id":314716,"avatar_url":"https://avatars.githubusercontent.com/u/314716?v=3","gravatar_id":"","url":"https://api.github.com/users/astrofrog","html_url":"https://github.com/astrofrog","followers_url":"https://api.github.com/users/astrofrog/followers","following_url":"https://api.github.com/users/astrofrog/following{/other_user}","gists_url":"https://api.github.com/users/astrofrog/gists{/gist_id}","starred_url":"https://api.github.com/users/astrofrog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/astrofrog/subscriptions","organizations_url":"https://api.github.com/users/astrofrog/orgs","repos_url":"https://api.github.com/users/astrofrog/repos","events_url":"https://api.github.com/users/astrofrog/events{/privacy}","received_events_url":"https://api.github.com/users/astrofrog/received_events","type":"User","site_admin":false},"open_issues":34,"closed_issues":26,"state":"open","created_at":"2015-05-17T16:11:47Z","updated_at":"2016-01-27T01:32:41Z","due_on":null,"closed_at":null},"comments":36,"created_at":"2015-10-14T11:03:26Z","updated_at":"2016-01-27T18:51:03Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/astropy/astropy/pulls/4242","html_url":"https://github.com/astropy/astropy/pull/4242","diff_url":"https://github.com/astropy/astropy/pull/4242.diff","patch_url":"https://github.com/astropy/astropy/pull/4242.patch"},"body":"In the discussion of #4234 @embray asked me to build a decorator to create dynamical docstrings. Since there might be other use-cases out there and I want to use it in several distinct files/classes I just thought there might be a place in the ``astropy.utils.decorators`` for it.\r\n\r\nPlease feel free to comment. If there shouldn't be use-cases outside my class or if there is already such a decorator in the python built-ins (I have looked but apparently there is no such thing) just speak up and I will only use this for my classes.\r\n\r\nThe decorator is very simple just a 4-liner but I tested it with functions, methods and it works within a python console, for sphinx and even (very happy about that) the spyder object inspector."},"comment":{"url":"https://api.github.com/repos/astropy/astropy/issues/comments/175790197","html_url":"https://github.com/astropy/astropy/pull/4242#issuecomment-175790197","issue_url":"https://api.github.com/repos/astropy/astropy/issues/4242","id":175790197,"user":{"login":"mwcraig","id":1147167,"avatar_url":"https://avatars.githubusercontent.com/u/1147167?v=3","gravatar_id":"","url":"https://api.github.com/users/mwcraig","html_url":"https://github.com/mwcraig","followers_url":"https://api.github.com/users/mwcraig/followers","following_url":"https://api.github.com/users/mwcraig/following{/other_user}","gists_url":"https://api.github.com/users/mwcraig/gists{/gist_id}","starred_url":"https://api.github.com/users/mwcraig/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mwcraig/subscriptions","organizations_url":"https://api.github.com/users/mwcraig/orgs","repos_url":"https://api.github.com/users/mwcraig/repos","events_url":"https://api.github.com/users/mwcraig/events{/privacy}","received_events_url":"https://api.github.com/users/mwcraig/received_events","type":"User","site_admin":false},"created_at":"2016-01-27T18:51:03Z","updated_at":"2016-01-27T18:51:03Z","body":"Merging -- thanks again, @MSeifert04!"}}