From b7fa63c7ced460fd2d3aceb35257a62ff08831c1 Mon Sep 17 00:00:00 2001 From: Rami Ali Date: Tue, 7 Feb 2017 16:43:41 +1100 Subject: tools: Add gen-cpydiff.py to generate docs differences. This patch introduces the a small framework to track differences between uPy and CPython. The framework consists of: - A set of "tests" which test for an individual feature that differs between uPy and CPy. Each test is like a normal uPy test in the test suite, but has a special comment at the start with some meta-data: a category (eg syntax, core language), a human-readable description of the difference, a cause, and a workaround. Following the meta-data there is a short code snippet which demonstrates the difference. See tests/cpydiff directory for the initial set of tests. - A program (this patch) which runs all the tests (on uPy and CPy) and generates nicely-formated .rst documenting the differences. - Integration into the docs build so that everything is automatic, and the differences appear in a way that is easy for users to read/reference (see latter commits). The idea with using this new framework is: - When a new difference is found it's easy to write a short test for it, along with a description, and add it to the existing ones. It's also easy for contributors to submit tests for differences they find. - When something is no longer different the tool will give an error and difference can be removed (or promoted to a proper feature test). --- docs/differences/index_template.txt | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 docs/differences/index_template.txt (limited to 'docs/differences') diff --git a/docs/differences/index_template.txt b/docs/differences/index_template.txt new file mode 100644 index 000000000..6ade2c2da --- /dev/null +++ b/docs/differences/index_template.txt @@ -0,0 +1,8 @@ +MicroPython Differences from CPython +==================================== + +The operations listed in this section produce conflicting results in MicroPython when compared to standard Python. + +.. toctree:: + :maxdepth: 2 + -- cgit v1.2.3