Coding Standards

How To Change This Document And Our Style

• Non-policy changes, typos, wording, formatting and such, can be done by anyone.
• Policy changes should be submitted as an issue.
• Changes to .perlcritic and .perltidy can be done as pull requests.

Checking and Correcting Style

• Anyone can correct the code to better match style.
• Syntax style is codified in .perltidy.
• As much coding style as possible is codified in .perlcritic
• Running ./Build tidy and ./Build critic will run perltidy and perlcritic respectively.

Testing

• t/00_TEST_TEMPLATE.t is a template for writing tests. Copy it to make new tests.
• Tests should use Test::Most.
• Tests should use perl5i::latest, not perl5i::2. This will make creating a new major version easier.
• Tests should have a #! line.
• Each test file should test a single method or group of related methods, or a single, complicated bug.
• Tests which require complicated set up should go in their own test file.
• Sets of related test files should go into a sub-directory.
• perl5i specific testing libraries should go into t/lib