simon-git: spigot (master): Simon Tatham

[Commits to Tartarus hosted VCS]

TL;DR:
  67c19d7 Python: fix termination problem in from_digits().
  4e71ec2 Python: add an assertion in BASE_DIGIT constructor.
  1eef6cd Python setup.py: use MANIFEST.in instead of data_files.
  cf721bb Python testenv: add an --exec option.
  51e7c2c Remove some unused variables.
  9259988 Docs: update the Tau Manifesto URL to https.
  5342610 Write a full manual for the Python module.

Repository:     https://git.tartarus.org/simon/spigot.git
On the web:     https://git.tartarus.org/?p=simon/spigot.git
Branch updated: master
Committer:      Simon Tatham <anakin at pobox.com>
Date:           2017-10-23 19:53:07

commit 67c19d74ce7714b60f641d9390143687f5022eaf
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=67c19d74ce7714b60f641d9390143687f5022eaf;hp=cf825076ac100fd6ab504170402c87c9129a7655
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:43:02 2017 +0100

    Python: fix termination problem in from_digits().
    
    If the user supplies a terminating digit stream, then the converting
    helper function _base_digit_to_interval will get an argument of None,
    which I forgot to include a handler for. Fortunately, the right
    handling isn't hard - just narrow the interval to a single point at
    its low end.

 python-module/__init__.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

commit 4e71ec21d74c3c7a566dc02af491083ffc03eee2
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=4e71ec21d74c3c7a566dc02af491083ffc03eee2;hp=67c19d74ce7714b60f641d9390143687f5022eaf
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:43:45 2017 +0100

    Python: add an assertion in BASE_DIGIT constructor.
    
    The previous assertion would have permitted a digit of 0 in base 1,
    which is a no-op digit and not something I'd intended to allow.

 python-module/__init__.py | 1 +
 1 file changed, 1 insertion(+)

commit 1eef6cd70fcd91412eed69798cf0f71651137a03
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=1eef6cd70fcd91412eed69798cf0f71651137a03;hp=4e71ec21d74c3c7a566dc02af491083ffc03eee2
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:45:12 2017 +0100

    Python setup.py: use MANIFEST.in instead of data_files.
    
    I belatedly realise that using the 'data_files' parameter to setup()
    is not the right way to indicate extra files I want included in the
    source distribution tarball: it does have that effect, but it _also_
    has the effect of delivering them into the install directory.
    
    MANIFEST.in is the right way, apparently; that lets me specify a list
    of files to be added to the MANIFEST file describing the source
    archive contents, without any other side effects.

 MANIFEST.in | 5 +++++
 setup.py    | 9 +--------
 2 files changed, 6 insertions(+), 8 deletions(-)

commit cf721bb39508c75b2b734c94d48721950610accc
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=cf721bb39508c75b2b734c94d48721950610accc;hp=1eef6cd70fcd91412eed69798cf0f71651137a03
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:45:46 2017 +0100

    Python testenv: add an --exec option.
    
    This lets me set up the same PYTHONPATH environment variable as usual,
    but then run a program that _isn't_ the Python interpreter. I'm about
    to use that in my build process.

 python-module/testenv | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

commit 51e7c2cc59ef63210506ced5dc72c7e69851091b
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=51e7c2cc59ef63210506ced5dc72c7e69851091b;hp=cf721bb39508c75b2b734c94d48721950610accc
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:46:37 2017 +0100

    Remove some unused variables.
    
    Introduced to Spigot_parse_literal() by insufficient tidying after
    cut-and-pasting from Spigot_parse() in commit cf825076a.

 python-module/internal.cpp | 1 -
 1 file changed, 1 deletion(-)

commit 92599889e9e131ba63143b0ec2277efcabc4d7f6
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=92599889e9e131ba63143b0ec2277efcabc4d7f6;hp=51e7c2cc59ef63210506ced5dc72c7e69851091b
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:46:51 2017 +0100

    Docs: update the Tau Manifesto URL to https.

 manual.but | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

commit 53426105a41f45cfb4ed25f53474ce99a05ddca5
web diff https://git.tartarus.org/?p=simon/spigot.git;a=commitdiff;h=53426105a41f45cfb4ed25f53474ce99a05ddca5;hp=92599889e9e131ba63143b0ec2277efcabc4d7f6
Author: Simon Tatham <anakin at pobox.com>
Date:   Mon Oct 23 19:48:38 2017 +0100

    Write a full manual for the Python module.
    
    Using Sphinx, which seems to be in fashion at the moment - and I can
    see why, given that it provides documentation-driven testing (I can
    run 'make doctest' to verify on every build that the example snippets
    through the new manual still behave as advertised when run for real),
    documentation coverage checking (I can arrange to cause a build
    failure if I add a new function without either giving it a docstring
    or writing it up directly in the .rst files), and LaTeX-syntax
    equations via MathJax.

 .gitignore                 |    1 +
 Buildscr                   |    4 +
 MANIFEST.in                |    2 +
 python-doc/Makefile        |  216 +++++++
 python-doc/api.rst         |  379 ++++++++++++
 python-doc/conf.py         |  288 +++++++++
 python-doc/index.rst       |   23 +
 python-doc/intro.rst       |  279 +++++++++
 python-doc/make.bat        |  263 ++++++++
 python-module/__init__.py  | 1433 +++++++++++++++++++++++++++++++++++++++++++-
 python-module/internal.cpp |    7 +-
 11 files changed, 2889 insertions(+), 6 deletions(-)