wiki@my.terrot.net

Wiki@my.terrot.net is a service provided by Terrot.Net a company of the Terrot Research & Services Group.

Outils pour utilisateurs

Outils du site


python

Ceci est une ancienne révision du document !


Development Environment and librairies

Please here after the typical list of addition packages I'm using.

pip compliant package

* pip install <package>

  • doxypypy : required for documentation generation
  • pylint: required for code quality
  • openxl : MS Excel & Libreoffice calc files manipulation
  • pyqt5 :
  • py2exe
  • rtcclient : optional RTC management
  • lxml
  • pywin32

other installation mode

lxml

As on Windows pip lxml installation failed, download the package from Unofficial Windows binaries as described by lxml.de official site.

C:\Apps\Python36>python.exe -m pip install <download path location>\lxml-3.7.1-cp36-cp36m-win_amd64.whl

pywin32

* use pypiwin32 a pip compliant version of pywin32 but at time I'm writing this lines only the 2.19 is available where the official package is now available in version 2.20 * download the installation package from official site direct access to build 220 files

Fundamental Rules

RUL_GEN_001 Comments

A comment is there to explain the code not to rephrase it.
Comment shall not contradict the code, update the comment with the code.

RUL_GEN_002 Important Rule

<note tip> If you don't understand why you should not modify a line, DON'T MODIFY IT! </note>

RUL_GEN_003 More Important Rule

Don't modify a line just to make it nicer, better, what ever justification you want, until there is a declared issue or an enhancement or task assigned to you linked with the line.

RUL_GEN_004 Mosy Important Rule

<note warning> In any case, Keep it simple </note>

Coding Rules

RUL_COD_001

Follow the Python development guidelines described in PEP008 with the following adaptations

Edition Rule

ADV_GEN_005 Tab is not space

Configure your editor to replace tab by 4 spaces (4). If your editor is not enable to replace don't insert TAB.

RUL_GEN_006 Indentation

Always use 4 space indentation except for arguments indentation

Strings

RUL_STR_01 str usage

Use str only for internal 7 bits characters string or bytes storage

RUL_STR_002 QString usage

Use QString only for Qt API functions and methods, convert results as soon as possible to unicode to be compliant for Python functions.

RUL_STR_003 Use unicode

For all other strings use unicode only strings.

Classes

python.1483032918.txt.gz · Dernière modification : 2016/12/29 18:35 de francois

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki