Add dictionary to documentation.

This commit is contained in:
Sergey Vartanov 2021-10-09 11:50:39 +03:00
parent 96092fe43f
commit 916eb3d8fa
6 changed files with 23 additions and 8 deletions

View file

@ -11,7 +11,7 @@ Please, create an issue with `icon` label.
Report a bug Report a bug
------------ ------------
Please, create an issue with `bug` and `generator` labels. Please, create an issue with `bug` label.
Fix a typo in documentation Fix a typo in documentation
--------------------------- ---------------------------
@ -26,9 +26,15 @@ First of all, configure your workspace.
* Install formatter, linter and test system: `pip install black flake8 pytest`. * Install formatter, linter and test system: `pip install black flake8 pytest`.
* Be sure to run `git config --local core.hooksPath data/githooks` to enable Git hooks. * Be sure to run `git config --local core.hooksPath data/githooks` to enable Git hooks.
If you are using Pycharm, you may want to set up user dictionary as well:
* `cp data/dictionary.xml .idea/dictionaries/<user name>.xml`
* in `.idea/dictionaries/<user name>.xml` change `%USERNAME%` to your user name,
* restart Pycharm.
### Code style ### ### Code style ###
We use [Black](http://github.com/psf/black) code formatter with maximum 80 characters line lenght for all Python files within the project. Reformat a file is as simple as `black -l 80 <file name>`. We use [Black](http://github.com/psf/black) code formatter with maximum 80 characters line length for all Python files within the project. Reformat a file is as simple as `black -l 80 <file name>`.
If you create new Python file, make sure you add `__author__ = "<first name> <second name>"` and `__email__ = "<author e-mail>"` string variables. If you create new Python file, make sure you add `__author__ = "<first name> <second name>"` and `__email__ = "<author e-mail>"` string variables.

4
.gitignore vendored
View file

@ -4,7 +4,6 @@ dist/
doc/*.html doc/*.html
doc/*.svg doc/*.svg
doc/*.wiki doc/*.wiki
missed_tags.yml
out/ out/
# Cache # Cache
@ -22,3 +21,6 @@ cache/
work work
precommit.py precommit.py
venv
.idea

View file

@ -1,4 +1,4 @@
#!/usr/local/bin/python3 #!/usr/bin/env python3
""" """
Commit message checking. Commit message checking.
""" """

View file

@ -13,5 +13,5 @@ echo "Lint with Flake8..."
flake8 \ flake8 \
--max-line-length=80 \ --max-line-length=80 \
--ignore=E203,W503,ANN002,ANN003,ANN101,ANN102 \ --ignore=E203,W503,ANN002,ANN003,ANN101,ANN102 \
--exclude=work,python3.8 \ map_machine setup.py tests \
|| { echo "FAIL"; exit 1; } || { echo "FAIL"; exit 1; }

View file

@ -12,7 +12,7 @@ Please, create an issue with \m {icon} label.
\2 {Report a bug} {} \2 {Report a bug} {}
Please, create an issue with \m {bug} and \m {generator} labels. Please, create an issue with \m {bug} label.
\2 {Fix a typo in documentation} {} \2 {Fix a typo in documentation} {}
@ -26,8 +26,15 @@ First of all, configure your workspace.
{Install formatter, linter and test system\: \m {pip install black flake8 pytest}.} {Install formatter, linter and test system\: \m {pip install black flake8 pytest}.}
{Be sure to run \m {git config --local core.hooksPath data/githooks} to enable Git hooks.} {Be sure to run \m {git config --local core.hooksPath data/githooks} to enable Git hooks.}
If you are using Pycharm, you may want to set up user dictionary as well:
\list
{\m {cp data/dictionary.xml .idea/dictionaries/<user name>.xml}}
{in \m {.idea/dictionaries/<user name>.xml} change \m {%USERNAME%} to your user name,}
{restart Pycharm.}
\3 {Code style} {code-style} \3 {Code style} {code-style}
We use \ref {http://github.com/psf/black} {Black} code formatter with maximum 80 characters line lenght for all Python files within the project. Reformat a file is as simple as \m {black -l 80 \formal {file name}}. We use \ref {http://github.com/psf/black} {Black} code formatter with maximum 80 characters line length for all Python files within the project. Reformat a file is as simple as \m {black -l 80 \formal {file name}}.
If you create new Python file, make sure you add \m {__author__ = "\formal {first name} \formal {second name}"} and \m {__email__ = "\formal {author e-mail}"} string variables. If you create new Python file, make sure you add \m {__author__ = "\formal {first name} \formal {second name}"} and \m {__email__ = "\formal {author e-mail}"} string variables.

View file

@ -13,7 +13,7 @@ __email__ = "me@enzet.ru"
def is_bright(color: Color) -> bool: def is_bright(color: Color) -> bool:
""" """
Check whether color bright enough to have black outline instead of white. Check whether color is bright enough to have black outline instead of white.
""" """
return ( return (
0.2126 * color.red + 0.7152 * color.green + 0.0722 * color.blue 0.2126 * color.red + 0.7152 * color.green + 0.0722 * color.blue