Metadata-Version: 2.1
Name: docassemble.InterviewStats
Version: 0.1.1
Summary: A docassemble extension, to view stats from other interviews
Home-page: https://courtformsonline.org/about/
Author: Bryce Willey, Quinten Steenhuis
Author-email: bwilley@suffolk.com
License: The MIT License (MIT)
Description: # docassemble.InterviewStats
        
        A docassemble interview that lets you view statistics from other saved interview responses. 
        
        ## Getting Started
        
        1. Pull this package into your [docassemble playground](https://docassemble.org/docs/playground.html), or install it on your [docassemble server](https://docassemble.org/docs/packages.html).
        1. To generate data that this interview can consume, use the [store_variables_snapshot()](https://docassemble.org/docs/functions.html#store_variables_snapshot) function in your interview, i.e.  `store_variables_snapshot(data={'zip': users[0].address.zip})`.
        1. Once you have reached the `store_variables_snapshot` point in your target interview, start the stats interview.
          1. If you're in the playground, run the `stats.yml` interview.
          1. If you installed the package, go to the `/start/InterviewStats/stats/` URL to start the interview.
        1. Select the target interview in the drop down. 
        1. You can export the data in a Excel format by clicking the `Download` link on the stats page.
        
        ## Anonymous stats
        
        If you would like to provide login-less access to stats for an interview
        in your `dispatch` directive, you can do so as follows:
        
        1. Add a directive in your configuration file, like this: 
        ```yaml
        stats subscriptions:
          - cdc_moratorium: 12345abcedfg17821309
          - 209a: 4859123jkljsafdsf0913132
        ```
        
        Where the value on the left corresponds to the key of an entry in your
        `dispatch` directive, and the value on the right is an arbitrary password you
        create. I recommend using something like https://onlinehashtools.com/generate-random-md5-hash
        to create a random password to control access.
        
        You can add as many unique passwords as you want for each entry you share.
        This means you can distribute multiple links without sharing the password.
        
        Then, someone can access the link to a specific interview's stats by 
        visiting this url:
        
        /start/InterviewStats/subscribe/?link=cdc_moratorium&auth=12345abcedfg17821309
        
        They will be directed immediately to download an XlSX file containing the
        statistics.
        
        ## Example
        
        ![Example Pic](static/example_pic.png)
        
        
        ## Roadmap
        
        Currently, we can show simple grouping over all the data points in the interview stats. However, the
        special visualization are only shown on based on the `zip` attribute. We're working to expand the
        features available here in conjunction with our [EFiling Integration](https://github.com/SuffolkLITLab/EfileProxyServer).
        
        If you have specific feature requests, feel free to open an issue or make a PR!
        
        
        ## Authors
        
        * Quinten Steenhuis
        * Bryce Willey
        
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
