)]}'
{"doc/source/command-wrappers.rst":[{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":6,"context_line":"to intercepting the command execution at run-time to modify the command"},{"line_number":7,"context_line":"behaviour."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"For instance, when we want"},{"line_number":10,"context_line":"to deprecate a command, policy says we need to alert the user.  We do this"},{"line_number":11,"context_line":"with a message logged at WARNING level."},{"line_number":12,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_eee546dc","line":9,"updated":"2015-11-20 20:13:12.000000000","message":"this line dropped off rather suddenly, pull the text from the line below back up","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"The obvious approach would be to just add the message to the command class"},{"line_number":14,"context_line":"directly, but we can also wrap the command class and put all of the wrappers"},{"line_number":15,"context_line":"into a separate, dedicated module.  This lets us leave the original class"},{"line_number":16,"context_line":"unmodified and puts all of the deprecation bits in one place."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This is an example of a minimal wrapper around a command class that logs a"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_0e020a70","line":15,"updated":"2015-11-20 20:13:12.000000000","message":"Two spaces after a period? well lah-dee-dah mr. academia.","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":19,"context_line":"deprecation message as a warning to the user then calls the original"},{"line_number":20,"context_line":"class."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"* Subclass the deprecated command"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"* Set class attribute ``deprecated`` to ``True`` to signal cliff to not"},{"line_number":25,"context_line":"  emit help text for this command."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_2eb58ecf","line":22,"updated":"2015-11-20 20:13:12.000000000","message":"add a period at the end for consistency","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":25,"context_line":"  emit help text for this command."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"* Change the entry point class in ``setup.cfg`` to point to the new class."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"::"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"\tclass ListFooOld(ListFoo):"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_0e9d2a59","line":28,"updated":"2015-11-20 20:13:12.000000000","message":"* Add a warning message to the log, referring to the new command.","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"* Change the entry point class in ``setup.cfg`` to point to the new class."},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"::"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"\tclass ListFooOld(ListFoo):"},{"line_number":32,"context_line":"\t    \"\"\"List resources\"\"\""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_cec64249","line":29,"updated":"2015-11-20 20:13:12.000000000","message":"use .. code-block: python","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"},{"author":{"_account_id":6482,"name":"Steve Martinelli","email":"s.martinelli@gmail.com","username":"stevemar"},"change_message_id":"90ad5c563f1ecda3002e6f48abf8ba524d9b8b10","unresolved":false,"context_lines":[{"line_number":28,"context_line":""},{"line_number":29,"context_line":"::"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"\tclass ListFooOld(ListFoo):"},{"line_number":32,"context_line":"\t    \"\"\"List resources\"\"\""},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"\t    # This notifies cliff to not display the help for this command"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_0eb44acf","line":31,"updated":"2015-11-20 20:13:12.000000000","message":"use spaces and not hard tabs","commit_id":"2566b8ee4ad41819f492cf9d99c575230b7fbb63"}]}