Metadata-Version: 2.1
Name: alfred3
Version: 2.1.0
Summary: A library for rapid development of dynamic and interactive online experiments in the social sciences.
Home-page: https://github.com/ctreffe/alfred
Author: Christian Treffenstädt, Johannes Brachem, Paul Wiemann
Author-email: treffenstaedt@psych.uni-goettingen.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: pymongo (>=3.10)
Requires-Dist: cryptography (>=3.4)
Requires-Dist: jinja2 (>=2.11)
Requires-Dist: Flask (>=1.1)
Requires-Dist: thesmuggler (>=1.0)
Requires-Dist: Click (>=7.1)
Requires-Dist: emoji (>=1.2)
Requires-Dist: cmarkgfm (>=0.5)
Requires-Dist: requests (>=2.25)
Requires-Dist: bleach (>=3.3)

# Welcome to alfred3 [![zenodo](https://zenodo.org/badge/150700371.svg)](https://zenodo.org/badge/latestdoi/150700371)


Alfred3 is a package for Python 3 offering experimenters in the social 
sciences a fast and easy way to create truly dynamic computer experiments 
for a wide range of applications.

## Installation

If you have Python 3.7 or newer installed, just install alfred3 via pip

```
$ pip3 install alfred3
```

## Documentation

Documentation and tutorials for alfred3's most important features
is available here: [Link to docs](https://jobrachem.github.io/alfred_docs/html/index.html)

## A "Hello, world" experiment

Creating a hello-world experiment is as easy as writing this *script.py*
file. You can even do it in a simple text editor. Note that the file
must be named ``script.py``

```python
import alfred3 as al
exp = al.Experiment()
exp += al.Page("Hello, world!", name="hello_world") 
```

To run the script, open a terminal and change the working directory to
your experiment directory:

```
$ cd path/to/experiment
```

Next, simply execute the following command in the terminal::

```
$ alfred3 run
```

If you have *Google Chrome* installed on your machine, a browser window 
with the experiment opens automatically. Otherwise, open any webbrowser 
and visit ``http://127.0.0.1:5000/start`` to start the experiment.

Of course, this "Hello, world" experiment does not contain much content:
Only a single page with a heading. To learn how to add content to an 
experiment, visit our tutorials: (to be filled)

## Citation

**If you are publishing research conducted using alfred3, the 
following citation is required:**

>Treffenstaedt, C., Brachem, J., & Wiemann, P. (2021). Alfred3 - A 
library for rapid experiment development (Version x.x.x). Göttingen, 
Germany: https://doi.org/10.5281/zenodo.1437219

If you want to use alfred3 and need more information, don't hesitate to 
contact us via alfred@psych.uni-goettingen.de.

## alfred3 Mailing List

If you want to stay up to date with current developments, you can join 
our [mailing list](mailto:https://listserv.gwdg.de/mailman/listinfo/Alfred).
We use this list to announce new releases and spread important 
information concerning the use of Alfred. You can expect to receive at 
most one mail per month.


