source: sasmodels/doc/genapi.py @ 1f058ea

core_shell_microgelscostrafo411magnetic_modelticket-1257-vesicle-productticket_1156ticket_1265_superballticket_822_more_unit_tests
Last change on this file since 1f058ea was 2e66ef5, checked in by Paul Kienzle <pkienzle@…>, 7 years ago

add a short scripting guide; start in on developer docs

  • Property mode set to 100644
File size: 2.6 KB
Line 
1from __future__ import with_statement
2import os.path
3
4MODULE_TEMPLATE = """.. Autogenerated by genmods.py
5
6******************************************************************************
7%(name)s
8******************************************************************************
9
10:mod:`%(package)s.%(module)s`
11==============================================================================
12
13.. automodule:: %(package)s.%(module)s
14   :members:
15   :undoc-members:
16   :inherited-members:
17   :show-inheritance:
18
19"""
20
21INDEX_TEMPLATE = """.. Autogenerated by genmods.py
22
23.. _api-index:
24
25##############################################################################
26   %(package_name)s
27##############################################################################
28
29.. only:: html
30
31   :Release: |version|
32   :Date: |today|
33
34.. toctree::
35   :titlesonly:
36   :numbered: 1
37   :maxdepth: 2
38
39   %(rsts)s
40"""
41
42
43def genfiles(package, package_name, modules, dir='api'):
44
45    if not os.path.exists(dir):
46        os.makedirs(dir)
47
48    for module, name in modules:
49        with open(os.path.join(dir, module+'.rst'), 'w') as f:
50            f.write(MODULE_TEMPLATE%locals())
51
52    rsts = "\n   ".join(module+'.rst' for module, name in modules)
53    with open(os.path.join(dir, 'index.rst'), 'w') as f:
54        f.write(INDEX_TEMPLATE%locals())
55
56
57modules = [
58    ('__init__', 'Sasmodels package'),
59    #('alignment', 'GPU data alignment [unused]'),
60    ('bumps_model', 'Bumps interface'),
61    ('compare_many', 'Batch compare models on different compute engines'),
62    ('compare', 'Compare models on different compute engines'),
63    ('convert', 'Sasview to sasmodel converter'),
64    ('core', 'Model access'),
65    ('data', 'Data layout and plotting routines'),
66    ('details', 'Parameter packing for kernel calls'),
67    ('direct_model', 'Simple interface'),
68    ('exception', 'Annotate exceptions'),
69    ('generate', 'Model parser'),
70    ('kernel', 'Evaluator type definitions'),
71    ('kernelcl', 'OpenCL model evaluator'),
72    ('kerneldll', 'Ctypes model evaluator'),
73    ('kernelpy', 'Python model evaluator'),
74    ('list_pars', 'Identify all parameters in all models'),
75    ('mixture', 'Mixture model evaluator'),
76    ('model_test', 'Unit test support'),
77    ('modelinfo', 'Parameter and model definitions'),
78    ('product', 'Product model evaluator'),
79    ('resolution', '1-D resolution functions'),
80    ('resolution2d', '2-D resolution functions'),
81    ('rst2html', 'Convert doc strings the web pages'),
82    ('sasview_model', 'Sasview interface'),
83    ('sesans', 'SESANS calculation routines'),
84    ('weights', 'Distribution functions'),
85]
86package = 'sasmodels'
87package_name = 'Reference'
88genfiles(package, package_name, modules)
Note: See TracBrowser for help on using the repository browser.