@@ -100,10 +100,10 @@ err.message("{0:d} out of {1:d} sources remaining.".format(n_new, n_old))
...
@@ -100,10 +100,10 @@ err.message("{0:d} out of {1:d} sources remaining.".format(n_new, n_old))
### Coding style
### Coding style
I recommend sticking to the [PEP 8 Style Guide](https://www.python.org/dev/peps/pep-0008/) when writing your code, with the two notable exceptions below.
I recommend sticking to the [PEP 8 Style Guide](https://www.python.org/dev/peps/pep-0008/) when writing your code, with the two notable exceptions below.
1. I recommend using tabulators instead of spaces for indentation for the following reasons:
1. I recommend using **tabulators** instead of spaces for indentation for the following reasons:
* **Smaller files** – A tab takes up less space than _N_ spaces.
* **Smaller files** – A tab takes up less space than _N_ spaces.
* **Consistency** – 1 tab per indentation level instead of _N_ spaces, where _N_ can be 2, 4, 8 or any other integer value.
* **Consistency** – 1 tab per indentation level instead of _N_ spaces, where _N_ can be 2, 4, 8 or any other integer value.
* **Semantics** – Tabs for indentation, spaces for spacing.
* **Semantics** – Tabs for indentation, spaces for spacing.
2. I recommend using double quotation marks (`"…"`) for strings instead of single quotation marks (`'…'`) for the following reasons:
2. I recommend using **double quotation marks** (`"…"`) for strings instead of single quotation marks (`'…'`) for the following reasons:
* **Consistency** – All other major programming languages use double quotation marks for strings.
* **Consistency** – All other major programming languages use double quotation marks for marking strings.
* **Apostrophe** – The ASCII character for a single quotation mark is also used as the apostrophe in the English language and would have to be escaped.<br />Hence: `"That's nice!"` instead of `'That\'s ugly!'`.
* **Apostrophe** – The ASCII character for a single quotation mark is also used as the apostrophe in the English language and would have to be escaped.<br />Hence: `"That's nice!"` instead of `'That\'s ugly!'`.
