Notes on how this package is tested.
────────────────────────────────────

This package can be tested by executing

    sh call-pymol-scripts /usr/share/pymol/examples "(multiclip_ray)|(xmlrpc01)|(sd_annotate)|(povray01)"

in order to confirm its integrity.

`call-pymol-scripts` searches for various pymol scripts (*.py or *.pml files)
in the directory of interest (that directory must be provided as a script 
parameter). It calls all scripts one by one from pymol with `-c` 
flag. pymol doesn't indicate that it has exited successfully when run in batch
mode. It also checks if any errors appear in output (for now error is
detected if word 'Traceback' or 'error' is present).

First parameter of `call-pymol-scripts` should be the directory of interest. 
Second parameter is optional - it is a pattern for `egrep` to detect files 
which must be skipped.

In the provided example several files are skipped - to run them, follow the 
instructions below.

/usr/share/pymol/examples/devel/sd_annotate.pml
-----------------------------------------------
This script must be executed from the directory it is located at:

  (cd /usr/share/pymol/examples/devel/; pymol -c sd_annotate.pml)
  
/usr/share/pymol/examples/devel/xmlrpc01.py
-------------------------------------------
To run this script, follow the instructions provided inside of it. 
Was not tested.

/usr/share/pymol/examples/cookbook/multiclip_ray.pml
----------------------------------------------------
This script can be run by executing
  
    pymol /usr/share/pymol/examples/cookbook/multiclip_ray.pml
  
Note that this requires display to be installed and can't be run with Xvfb-run,
because at final step it actually displays image, and this is blocking operation.
It also requires ImageMagick to be installed (which can be done by executing 
`sudo apt-get install imagemagick`).


FIXME: /usr/share/pymol/examples/devel/importing.py
---------------------------------------------------

Fails with
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/pymol/parsing.py", line 483, in run
    run_(path, ns_pymol, ns_pymol)
  File "/usr/lib/python3/dist-packages/pymol/parsing.py", line 532, in run_file
    execfile(file,global_ns,local_ns)
  File "/usr/lib/python3/dist-packages/pymol/parsing.py", line 527, in execfile
    exec(co, global_ns, local_ns)
  File "/usr/share/pymol/examples/devel/importing.py", line 21, in <module>
    __main__.pymol_argv= string.split("pymol -qxiF  -X 300 -Y 100 -H 400 -W 400")
AttributeError: module 'string' has no attribute 'split'

---> Needs fixing


----------------------------------
Many other useful scripts for PyMOL (according to information given on this 
page: http://www.pymolwiki.org/index.php/Git_intro) are available on Github:
https://github.com/Pymol-Scripts/Pymol-script-repo
