Enforce pep257

Additional update:
    .gitignore -> templates for vim, jetbrains, windows, python

Author: penguinolog

.gitignore

@@ -1,15 +1,80 @@
 # Created by .ignore support plugin (hsz.mobi)
+### JetBrains template
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff:
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+
+# Sensitive or high-churn files:
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.xml
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+
+# Gradle:
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Mongo Explorer plugin:
+.idea/**/mongoSettings.xml
+
+## File-based project format:
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
 ### Vim template
 # swap
-[._]*.s[a-w][a-z]
-[._]s[a-w][a-z]
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-v][a-z]
+[._]sw[a-p]
 # session
 Session.vim
 # temporary
 .netrwhist
 *~
 # auto-generated tag files
 tags
+### Windows template
+# Windows thumbnail cache files
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
 ### Python template
 # Byte-compiled / optimized / DLL files
 __pycache__/
@@ -33,6 +98,7 @@ lib64/
 parts/
 sdist/
 var/
+wheels/
 *.egg-info/
 .installed.cfg
 *.egg
@@ -74,13 +140,14 @@ instance/
 .scrapy
 
 # Sphinx documentation
+docs/_build/
 doc/build/
 doc/source/modules/
 
 # PyBuilder
 target/
 
-# IPython Notebook
+# Jupyter Notebook
 .ipynb_checkpoints
 
 # pyenv
@@ -93,6 +160,7 @@ celerybeat-schedule
 .env
 
 # virtualenv
+.venv
 venv/
 ENV/
 
@@ -102,6 +170,5 @@ ENV/
 # Rope project settings
 .ropeproject
 
-# Pycharm
-### Manually added
-.idea
+# Test results
+/*_result.xml

logwrap/__init__.py

@@ -14,9 +14,9 @@
 #    License for the specific language governing permissions and limitations
 #    under the License.
 
-"""logwrap module
+"""logwrap module.
 
-Contents: 'logwrap', 'pretty_repr'
+Contents: 'logwrap', 'pretty_repr', 'pretty_str'
 
 Original code was made for Mirantis Inc by Alexey Stepanov,
 later it has been reworked and extended for support of special cases.
@@ -31,9 +31,9 @@
 
 __version__ = '1.3.0'
 
-__all__ = [
+__all__ = (
     'logwrap',
     'PrettyFormat',
     'pretty_repr',
     'pretty_str'
-]
+)

logwrap/_formatters.py

@@ -6,9 +6,10 @@
 #    License for the specific language governing permissions and limitations
 #    under the License.
 
-"""formatters module
+"""formatters module.
 
-This is no reason to import this submodule directly, it's strictly internal"""
+This is no reason to import this submodule directly, it's strictly internal
+"""
 
 from __future__ import absolute_import
 from __future__ import unicode_literals
@@ -29,7 +30,7 @@
 
 
 def _strings_repr(indent, val):
-    """Custom repr for strings and binary strings"""
+    """Custom repr for strings and binary strings."""
     if isinstance(val, binary_type):
         val = val.decode(
             encoding='utf-8',
@@ -47,7 +48,7 @@ def _strings_repr(indent, val):
 
 
 def _set_repr(indent, val):
-    """Custom repr formatter for sets"""
+    """Custom repr formatter for sets."""
     return "{spc:<{indent}}{val}".format(
         spc='',
         indent=indent,
@@ -83,7 +84,7 @@ def _set_repr(indent, val):
 
 
 def _strings_str(indent, val):
-    """Custom repr for strings and binary strings"""
+    """Custom repr for strings and binary strings."""
     if isinstance(val, binary_type):
         val = val.decode(
             encoding='utf-8',
@@ -97,7 +98,7 @@ def _strings_str(indent, val):
 
 
 def _set_str(indent, val):
-    """Custom repr formatter for sets"""
+    """Custom repr formatter for sets."""
     return "{spc:<{indent}}{val}".format(
         spc='',
         indent=indent,
@@ -132,7 +133,7 @@ def _set_str(indent, val):
 }
 
 
-__all__ = [
+__all__ = (
     'c_repr_formatters', 's_repr_formatters',
     'c_str_formatters', 's_str_formatters',
-]
+)

logwrap/_log_wrap.py

@@ -14,7 +14,7 @@
 #    License for the specific language governing permissions and limitations
 #    under the License.
 
-"""log_wrap module
+"""log_wrap module.
 
 This is no reason to import this submodule directly, all required methods is
 available from the main module.
@@ -50,14 +50,13 @@
 
 
 def _get_func_args_repr(sig, args, kwargs, max_indent, blacklisted_names):
-    """Internal helper for reducing complexity of decorator code
+    """Internal helper for reducing complexity of decorator code.
 
     :type sig: inspect.Signature
     :type max_indent: int
     :type blacklisted_names: list
     :rtype: str
     """
-
     bound = sig.bind(*args, **kwargs).arguments
 
     param_str = ""
@@ -92,7 +91,7 @@ def logwrap(
     spec=None,
     blacklisted_names=None,
 ):
-    """Log function calls and return values
+    """Log function calls and return values.
 
     :param log: logger object for decorator, by default used 'logwrap'
     :type log: logging.Logger
@@ -119,7 +118,7 @@ def logwrap(
         blacklisted_names = []
 
     def real_decorator(func):
-        """Log function calls and return values
+        """Log function calls and return values.
 
         This decorator could be extracted as configured from outer function.
 
@@ -133,10 +132,6 @@ def real_decorator(func):
 
         @functools.wraps(func)
         def wrapped(*args, **kwargs):
-            """Real wrapper.
-
-             *args and **kwargs is bound in separate helpers
-             """
             args_repr = _get_func_args_repr(
                 sig=sig,
                 args=args,
@@ -184,4 +179,4 @@ def wrapped(*args, **kwargs):
     return real_decorator
 
 
-__all__ = ['logwrap']
+__all__ = ('logwrap', )