Friday, August 19, 2016

I updated the Lino Community Guide section and started a new page Developer interview.

I tested the Installing a Lino developer environment guide and discovered that it needs more changes.

• inv prep failed when everything was installed as instructed. I added lino_cosi and several other dependencies to The lino-book package. And then I released Lino Così 0.0.3.

TODO:

• It is not necessary to define a LINO_CACHE_ROOT. This section should go to a later tutorial.

• It seems that we need to split the installation guide: one version for those who just want to see a quick result and another version which installs a full developer environment. The quickstart version would clone only the The lino-book package repository. This will work of couse only when we get the templates problem fixed. Note that the The lino-book package project is probably the only one for which a version on PyPI makes no sense because it is solely for educational, testing and documentation purposes and not meant for use on a production server.

• Also inv test now works almost out of the box, except e.g. for a TemplateNotFound: iban/uppercasetextfield.js. The files are contained in the tar.gz file, but it seems that they don’t get unpacked.

  In my ~/.invoke.py I have:

  sdist_dir = '/home/luc/work/book/docs/dl'
  

  Now I can create an sdist archive in that directory:

  $ go cosi ; inv sdist
  

  This does not get published on PyPI since I don’t add the upgrade option.

  And then I can simulate a “real” install via PyPI by doing:

  $ pip install -f /home/luc/work/book/docs/dl/ lino-cosi