Conditions | 1 |
Total Lines | 56 |
Code Lines | 36 |
Lines | 0 |
Ratio | 0 % |
Changes | 0 |
Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.
For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.
Commonly applied refactorings include:
If many parameters/temporary variables are present:
1 | # coding=utf-8 |
||
87 | def bind(self, configurator: Configurator): |
||
88 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop static files |
||
89 | configurator.add_static_view('static', 'static', cache_max_age=3600) |
||
90 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Do not rely |
||
91 | # on static file for 404 view |
||
92 | configurator.add_view( |
||
93 | self.notfound_view, |
||
94 | renderer='tracim:templates/404.jinja2', |
||
95 | context=NotFound, |
||
96 | ) |
||
97 | |||
98 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop this method |
||
99 | configurator.add_route('test_config', '/') |
||
100 | configurator.add_view( |
||
101 | self.test_config, |
||
102 | route_name='test_config', |
||
103 | renderer='tracim:templates/mytemplate.jinja2', |
||
104 | ) |
||
105 | |||
106 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop this method |
||
107 | configurator.add_route('test_contributor', '/test_contributor') |
||
108 | configurator.add_view( |
||
109 | self.test_contributor_page, |
||
110 | route_name='test_contributor', |
||
111 | renderer='tracim:templates/mytemplate.jinja2', |
||
112 | permission=CONTRIBUTE_PERM, |
||
113 | ) |
||
114 | |||
115 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop this method |
||
116 | configurator.add_route('test_admin', '/test_admin') |
||
117 | configurator.add_view( |
||
118 | self.test_admin_page, |
||
119 | route_name='test_admin', |
||
120 | renderer='tracim:templates/mytemplate.jinja2', |
||
121 | permission=ADMIN_PERM, |
||
122 | ) |
||
123 | |||
124 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop this method |
||
125 | configurator.add_route('test_manager', '/test_manager') |
||
126 | configurator.add_view( |
||
127 | self.test_user_page, |
||
128 | route_name='test_manager', |
||
129 | renderer='tracim:templates/mytemplate.jinja2', |
||
130 | permission=MANAGE_GLOBAL_PERM, |
||
131 | ) |
||
132 | |||
133 | # TODO - G.M - 10-04-2018 - [cleanup][tempExample] - Drop this method |
||
134 | configurator.add_route('test_user', '/test_user') |
||
135 | configurator.add_view( |
||
136 | self.test_user_page, |
||
137 | route_name='test_user', |
||
138 | renderer='tracim:templates/mytemplate.jinja2', |
||
139 | permission=USER_PERM, |
||
140 | ) |
||
141 | |||
142 | configurator.add_forbidden_view(self.forbidden_view) |
||
143 |
The coding style of this project requires that you add a docstring to this code element. Below, you find an example for methods:
If you would like to know more about docstrings, we recommend to read PEP-257: Docstring Conventions.