84 lines
3.2 KiB
Markdown
84 lines
3.2 KiB
Markdown
<!---
|
|
Copyright (C) 2015, 2016, 2017 LoVullo Associates, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this
|
|
document under the terms of the GNU Free Documentation License,
|
|
Version 1.3 or any later version published by the Free Software
|
|
Foundation; with no Invariant Sections, no Front-Cover Texts, and no
|
|
Back-Cover Texts. A copy of the license is included the file
|
|
COPYING.FDL.
|
|
-->
|
|
# TAME
|
|
TAME is The Adaptive Metalanguage, a programming language and system of tools
|
|
designed to aid in the development, understanding, and maintenance of systems
|
|
performing numerous calculations on a complex graph of dependencies,
|
|
conditions, and a large number of inputs.
|
|
|
|
This system was developed at R-T Specialty (formerly LoVullo Associates) to
|
|
handle the complexity of comparative insurance rating systems. It is a
|
|
domain-specific language (DSL) that itself encourages, through the use of
|
|
templates, the creation of sub-DSLs. TAME itself is at heart a
|
|
calculator—processing only numerical input and output—driven by quantifiers
|
|
as predicates. Calculations and quantifiers are written declaratively
|
|
without concern for order of execution.
|
|
|
|
The system has powerful dependency resolution and data flow capabilities.
|
|
|
|
TAME consists of a macro processor (implementing a metalanguage), numerous
|
|
compilers for various targets (JavaScript, HTML documentation and debugging
|
|
environment, LaTeX, and others), linkers, and supporting tools. The input
|
|
grammar is XML, and the majority of the project (including the macro processor,
|
|
compilers, and linkers) is written in XSLT. There is a reason for that odd
|
|
choice; until an explanation is provided, know that someone is perverted enough
|
|
to implement a full compiler in XSLT.
|
|
|
|
|
|
## "Current"
|
|
The current state of the project as used in production is found in
|
|
`src/current/`. The environment surrounding the development of this
|
|
project resulted in a bit of a mess, which is being refactored into
|
|
`src/` as it is touched. Documentation is virtually non-existent.
|
|
|
|
|
|
## Documentation
|
|
Compiled documentation for the latest release is available via our GitLab
|
|
mirror, which uses the same build pipeline as we do on our internal GitLab
|
|
instance. Available formats are:
|
|
|
|
- [Multi-page HTML][doc-html]
|
|
- [PDF][doc-pdf]
|
|
- [Info][doc-info]
|
|
|
|
|
|
## Getting Started
|
|
To get started, make sure Saxon version 9 or later is available and its path
|
|
set as `SAXON_CP`; that the path to hoxsl is set via `HOXSL`; and then run
|
|
the `bootstrap` script:
|
|
|
|
```bash
|
|
$ export SAXON_CP=/path/to/saxon9he.jar
|
|
$ export HOXSL=/path/to/hoxsl/root
|
|
|
|
$ ./boostrap
|
|
```
|
|
|
|
|
|
## Hacking
|
|
Information for TAME developers can be found in the file `HACKING`.
|
|
|
|
|
|
## License
|
|
This program is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the Free
|
|
Software Foundation, either version 3 of the License, or (at your option)
|
|
any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
|
PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
[doc-html]: https://lovullo.gitlab.io/tame/
|
|
[doc-pdf]: https://lovullo.gitlab.io/tame/tame.pdf
|
|
[doc-info]: https://lovullo.gitlab.io/tame/tame.info
|
|
|