summaryrefslogtreecommitdiffstats
path: root/plugins/python/python_style_guide.md
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/python/python_style_guide.md')
-rw-r--r--plugins/python/python_style_guide.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/plugins/python/python_style_guide.md b/plugins/python/python_style_guide.md
new file mode 100644
index 00000000..41db2474
--- /dev/null
+++ b/plugins/python/python_style_guide.md
@@ -0,0 +1,26 @@
+# HexChat Python Module Style Guide
+
+(This is a work in progress).
+
+## General rules
+
+- PEP8 as general fallback recommendations
+- Max line length: 120
+- Avoid overcomplex compound statements. i.e. dont do this: `somevar = x if x == y else z if a == b and c == b else x`
+
+## Indentation style
+
+### Multi-line functions
+
+```python
+foo(really_long_arg_1,
+ really_long_arg_2)
+```
+
+### Mutli-line lists/dicts
+
+```python
+foo = {
+ 'bar': 'baz',
+}
+```