This is a package that extends docassemble-scasp and docassemble-datatypes to facilitate the rapid prototyping of expert systems based on code written in the l4 language.

Install this package using docassemble's package manager from the github source.

• docassemble-scasp
• gf-python
• pyparsing
• networkx

In order for the interview generator to be able to install newly-generated interviews onto your playground, it needs API access. To provide that, go to "Profile", "Other Settings", "API Keys", and generate an API Key. Then add it to your docassemble server configuration as follows:

l4:
  API Key: XXXXXXX

The docassemble.l4.intgen namespace includes generate_interview(LExSIS_source,scasp_source), which accepts the contents of a LExSIS file as a string, and the contents of an s(CASP) source file as a string. The scasp_source file contents are expected to use our LPDAT implementation in s(CASP).

That function will return the content of a docassemble interview that should function on a server with this module and scasp installed, such as the l4-docassemble server.

You can also access that functionality in a friendlier interface by running the docassemble.l4:intgen.yml interview, which accepts a LExSIS file and an s(CASP) file from the current user's playground static folder.

• s(CASP) example files
• LExSIS Documentation

It should be noted that drafting an s(CASP) file to be used for the interview generator is slightly different. Particularly, one does not include a model-finding query within the s(CASP) file, but instead adds it to the LExSIS file under the query header-value pair instead. For an example, see the treatment of a "Rock Paper Scissors" scenario from a pure s(CASP) perspective vs the interview generation perspective.

If you've never used docassemble before, we highly suggest that you familiarize yourself with it before proceeding.

Once you've got an idea of what docassemble does & how it works, we recommend you read the following articles:

• Docassemble package management
• DAObject
• Generic Objects in docassemble

After reading the above, familiarize yourself with the package.

• the bulk of the logic is located in intgen.py
• the user-facing interview generator is in intgen.yml
• the question defaults for the various datatypes used l4.yml

We use pipenv to manage dependencies, and pytest to handle tests.