Hello world!
7 | 8 |11 | Visit svelte.dev to learn how to build Svelte 12 | apps. 13 |
14 | 15 |16 | Check out SvelteKit for 17 | the officially supported framework, also powered by Vite! 18 |
19 |
6 |
11 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | .DS_Store
2 | *.db
3 | *.tgz
4 | *.tar.zst
5 | *.zip
6 | tajriba.json
7 | internal/vendored/transport
8 | yarn-error.log
9 | node_modules
10 | go.work
11 | go.work.sum
12 |
13 | playwright-results
14 | playwright-report
15 | test-results
16 | e2e-tests/test-experiment-*
17 | e2e-tests/cache
18 |
19 | out
20 | .vscode
21 | NOTES
--------------------------------------------------------------------------------
/tests/stress/experiment/.empirica/lobbies.yaml:
--------------------------------------------------------------------------------
1 | lobbies:
2 | - name: Default shared fail
3 | kind: shared
4 | duration: 50m
5 | strategy: fail
6 | - name: Default shared ignore
7 | kind: shared
8 | duration: 50m
9 | strategy: ignore
10 | - name: Default individual
11 | kind: individual
12 | duration: 50m
13 |
--------------------------------------------------------------------------------
/.empirica/empirica.toml:
--------------------------------------------------------------------------------
1 | name = "myexperiment"
2 |
3 | [callbacks]
4 | path = "internal/templates/source/callbacks"
5 |
6 | [player]
7 | path = "internal/templates/source/react"
8 |
9 | [tajriba.auth]
10 | srtoken = "01234567890123456789"
11 |
12 | [[tajriba.auth.users]]
13 | name = "Admin"
14 | username = "admin"
15 | password = "123123123"
16 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/components/Avatar.jsx:
--------------------------------------------------------------------------------
1 | import React from "react";
2 |
3 | export function Avatar({ player }) {
4 | return (
5 | 7 | {$stageTimer === null ? "-" : $stageTimer} 8 |
9 | seconds 10 |
10 | );
11 | }
12 |
--------------------------------------------------------------------------------
/lib/@empirica/core/modd.conf:
--------------------------------------------------------------------------------
1 | package.json src/**/*.ts src/**/*.tsx src/**/*.js !src/**/*_test.ts !src/**/*_test.tsx !src/**/*_test.js {
2 | prep: rm -rf dist &
3 | prep: npm run build
4 | prep: npm run check
5 | }
6 |
7 | # {
8 | # daemon: npm run test:watch
9 | # }
10 |
11 | # src/**/*_test.ts src/**/*_test.tsx {
12 | # prep: npm run test
13 | # }
14 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/StopIcon.svelte:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/.editorconfig:
--------------------------------------------------------------------------------
1 | # EditorConfig is awesome: http://EditorConfig.org
2 |
3 | # top-most EditorConfig file
4 | root = true
5 |
6 | # Unix-style newlines with a newline ending every file
7 | [*]
8 | indent_style = space
9 | indent_size = 2
10 | end_of_line = lf
11 | charset = utf-8
12 | insert_final_newline = true
13 |
14 | [*.md]
15 | trim_trailing_whitespace = false
16 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/index.ts:
--------------------------------------------------------------------------------
1 | export { ListenersCollector } from "./admin";
2 | export {
3 | Classic,
4 | classicKinds,
5 | ClassicListenersCollector,
6 | ClassicLoader,
7 | } from "./admin/classic";
8 | export * from "./player/classic";
9 | export * from "./player/classic/react";
10 | export * from "./player/react";
11 | export * from "./utils/console";
12 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/PlayIcon.svelte:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/promises.ts:
--------------------------------------------------------------------------------
1 | export interface PromiseHandle
6 |
9 | );
10 | }
11 |
--------------------------------------------------------------------------------
/lib/admin-ui/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | Finished
7 |Thank you for participating
8 |
8 |
11 |
15 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/index.css:
--------------------------------------------------------------------------------
1 | @layer utilities {
2 | /* Chrome, Safari, Edge, Opera */
3 | input.number-arrows-none::-webkit-outer-spin-button,
4 | input.number-arrows-none::-webkit-inner-spin-button {
5 | -webkit-appearance: none;
6 | margin: 0;
7 | }
8 |
9 | /* Firefox */
10 | input.number-arrows-none[type="number"] {
11 | -moz-appearance: textfield;
12 | }
13 | }
14 |
--------------------------------------------------------------------------------
/tests/stress/experiment/client/src/index.css:
--------------------------------------------------------------------------------
1 | @layer utilities {
2 | /* Chrome, Safari, Edge, Opera */
3 | input.number-arrows-none::-webkit-outer-spin-button,
4 | input.number-arrows-none::-webkit-inner-spin-button {
5 | -webkit-appearance: none;
6 | margin: 0;
7 | }
8 |
9 | /* Firefox */
10 | input.number-arrows-none[type="number"] {
11 | -moz-appearance: textfield;
12 | }
13 | }
14 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/config.yml:
--------------------------------------------------------------------------------
1 | blank_issues_enabled: false
2 | contact_links:
3 | - name: Slack Community Support
4 | url: https://join.slack.com/t/empirica-ly/shared_invite/zt-1fb34yq47-YlgYUJmXJAdv7QmHsa_fdw
5 | about: "Please ask and answer questions in our #tech-support Slack channel."
6 | - name: Empirica Documentation
7 | url: https://docs.empirica.ly
8 | about: Check the Empirica documentation.
9 |
--------------------------------------------------------------------------------
/internal/templates/source/svelte/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "svelte",
3 | "version": "0.0.0",
4 | "private": true,
5 | "type": "module",
6 | "scripts": {
7 | "dev": "vite",
8 | "build": "vite build",
9 | "serve": "vite preview"
10 | },
11 | "devDependencies": {
12 | "@sveltejs/vite-plugin-svelte": "^1.0.0-next.11",
13 | "svelte": "^3.37.0",
14 | "vite": "^2.4.4"
15 | }
16 | }
17 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/ArrowIcon.svelte:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/.changeset/config.json:
--------------------------------------------------------------------------------
1 | {
2 | "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
3 | "changelog": "@changesets/cli/changelog",
4 | "commit": false,
5 | "fixed": [[
6 | "@empirica/core"
7 | ]],
8 | "linked": [],
9 | "access": "public",
10 | "baseBranch": "main",
11 | "updateInternalDependencies": "patch",
12 | "ignore": [],
13 | "bumpVersionsWithWorkspaceProtocolOnly": true
14 | }
15 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/utils/clickoutside.js:
--------------------------------------------------------------------------------
1 | export function clickOutside(node, handler) {
2 | const onClick = (event) =>
3 | node &&
4 | !node.contains(event.target) &&
5 | !event.defaultPrevented &&
6 | handler();
7 |
8 | document.addEventListener("click", onClick, true);
9 |
10 | return {
11 | destroy() {
12 | document.removeEventListener("click", onClick, true);
13 | },
14 | };
15 | }
16 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/types.d.ts:
--------------------------------------------------------------------------------
1 | declare module "youch-terminal" {
2 | function YouchForTerminal(
3 | err: { error: Error },
4 | opts: YouchTerminalOptions
5 | ): void;
6 | interface YouchTerminalOptions {
7 | prefix: String;
8 | displayShortPath: Boolean;
9 | hideErrorTitle: Boolean;
10 | hideMessage: Boolean;
11 | displayMainFrameOnly: Boolean;
12 | }
13 | export = YouchForTerminal;
14 | }
15 |
--------------------------------------------------------------------------------
/internal/templates/source/svelte/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
12 |
14 | .empirica/treatments.yaml file.
9 | Updates are automatically saved on this page. If you make changes to the yaml
10 | file, make sure to reload this page.
11 |
12 |
13 |
14 |
16 | .empirica/lobbies.yaml.
15 | Make sure the server is started then reload. ({error.toString()})
16 |
9 |
10 |
21 |
--------------------------------------------------------------------------------
/internal/term/context.go:
--------------------------------------------------------------------------------
1 | package term
2 |
3 | import "context"
4 |
5 | type ctxType int
6 |
7 | // A private key for context that only this package can access. This is
8 | // important to prevent collisions between different context uses.
9 | const ctxKey = ctxType(0)
10 |
11 | // ForContext finds the Runtime from the context.
12 | func ForContext(ctx context.Context) *UI {
13 | raw, _ := ctx.Value(ctxKey).(*UI)
14 |
15 | return raw
16 | }
17 |
18 | // SetContext sets the user on the context.
19 | func SetContext(ctx context.Context, c *UI) context.Context {
20 | return context.WithValue(ctx, ctxKey, c)
21 | }
22 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/treatments/TreatmentsPage.svelte:
--------------------------------------------------------------------------------
1 |
6 |
7 |
11 |
15 |
16 |
12 |
14 |
17 |
18 | Not found
19 |
20 | .empirica/treatments.yaml file. Updates are automatically saved
11 | on this page. If you make changes to the yaml file, make sure to reload this
12 | page.
13 |
14 |
15 |
16 |
18 | .empirica/treatments.yaml.
15 | Make sure the server is started then reload. ({error.toString()})
16 |
15 |
21 | );
22 | }
23 |
--------------------------------------------------------------------------------
/.github/actions/upload-empirica-cli/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "upload-empirica-cli",
3 | "version": "1.0.0",
4 | "description": "",
5 | "main": "index.js",
6 | "scripts": {
7 | "build": "ncc build index.js -o dist",
8 | "test": "ava -v",
9 | "test:watch": "ava --watch -v"
10 | },
11 | "keywords": [],
12 | "author": "Nicolas Paton",
13 | "private": true,
14 | "volta": {
15 | "node": "20.10.0",
16 | "npm": "10.2.3"
17 | },
18 | "dependencies": {
19 | "@actions/core": "1.10.0",
20 | "@actions/github": "^4.0.0",
21 | "@zeit/ncc": "^0.22.3",
22 | "aws-sdk": "^2.730.0",
23 | "semver": "7.3.7"
24 | },
25 | "devDependencies": {
26 | "ava": "4.3.1",
27 | "sinon": "14.0.0"
28 | }
29 | }
30 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/utils/equal.js:
--------------------------------------------------------------------------------
1 | export function deepEqual(obj1, obj2) {
2 | if (obj1 === obj2)
3 | // it's just the same object. No need to compare.
4 | return true;
5 |
6 | if (isPrimitive(obj1) && isPrimitive(obj2))
7 | // compare primitives
8 | return obj1 === obj2;
9 |
10 | if (Object.keys(obj1).length !== Object.keys(obj2).length) return false;
11 |
12 | // compare objects with same number of keys
13 | for (let key in obj1) {
14 | if (!(key in obj2)) return false; //other object doesn't have this prop
15 | if (!deepEqual(obj1[key], obj2[key])) return false;
16 | }
17 |
18 | return true;
19 | }
20 |
21 | //check if value is primitive
22 | function isPrimitive(obj) {
23 | return obj !== Object(obj);
24 | }
25 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/constants.js:
--------------------------------------------------------------------------------
1 | export const DEFAULT_TOKEN_KEY = "emp:part:token";
2 | export const DEFAULT_PART_KEY = "emp:part";
3 |
4 | export const DEFAULT_TREATMENT = {
5 | name: "",
6 | desc: "",
7 | factors: [{ key: "playerCount", value: 1 }],
8 | };
9 | export const DEFAULT_FACTOR = { name: "", desc: "", values: [{ value: "" }] };
10 | export const DEFAULT_LOBBY = {
11 | name: "",
12 | desc: "",
13 | kind: "shared",
14 | strategy: "fail",
15 | duration: "5m",
16 | extensions: 0,
17 | };
18 |
19 | // URL
20 |
21 | let origin = window.location.origin;
22 |
23 | // When developing the admin-ui (3001), the API is served from 3000.
24 | if (origin === "http://localhost:3001") {
25 | origin = "http://localhost:3000";
26 | }
27 |
28 | export const ORIGIN = origin;
29 |
--------------------------------------------------------------------------------
/internal/lobbies/lobbies.go:
--------------------------------------------------------------------------------
1 | package lobbies
2 |
3 | import "time"
4 |
5 | type LobbyConfig struct {
6 | Name string `json:"name,omitempty" yaml:"name,omitempty"`
7 | Description string `json:"desc,omitempty" yaml:"desc,omitempty"`
8 | Kind string `validate:"required,oneof=shared individual" json:"kind" yaml:"kind"`
9 | Duration time.Duration `validate:"required,min=5s" json:"duration" yaml:"duration"`
10 | Strategy string `validate:"required_if=Kind shared,oneof=fail ignore ''" json:"strategy,omitempty" yaml:"strategy,omitempty"`
11 | Extensions int `validate:"min=0" json:"extensions,omitempty" yaml:"extensions,omitempty"`
12 | }
13 |
14 | type Lobbies struct {
15 | Lobbies []*LobbyConfig `validate:"dive" json:"lobbies" yaml:"lobbies"`
16 | }
17 |
--------------------------------------------------------------------------------
/lib/@empirica/core/docs.sh:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 |
3 | set -e
4 | trap "exit" INT
5 |
6 | # define your list of paths here
7 | docs="src/admin/index.ts src/admin/classic/index.ts src/player/index.ts src/player/react/index.ts src/player/classic/index.ts src/player/classic/react/index.ts src/utils/console.ts"
8 |
9 | # "../../../../docsv2/api"
10 | outdir="${OUT:-docs}"
11 |
12 | # loop over each path
13 | for path in $docs; do
14 | echo $path
15 | # remove "src/" and "/index.ts" from the path
16 | cleaned_path=${path#src/}
17 | cleaned_path=${cleaned_path%/index.ts}
18 | underscored_path=$(echo $cleaned_path | tr '/' '_')
19 | npx typedoc --kindsWithOwnFile none --excludeInternal --excludePrivate --excludeProtected --plugin typedoc-plugin-markdown --out "${outdir}/${underscored_path}" $path
20 | done
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/Duplicate.svelte:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/tests/stress/tests/utils.js:
--------------------------------------------------------------------------------
1 | import { exec as cpexec } from "child_process";
2 |
3 | export async function sleep(ms) {
4 | return new Promise((resolve) => setTimeout(resolve, ms));
5 | }
6 | export function randomString(length) {
7 | const chars = "0123456789abcdefghijklmnopqrstuvwxyz";
8 | let result = "";
9 | for (let i = length; i > 0; --i) {
10 | result += chars[Math.floor(Math.random() * chars.length)];
11 | }
12 | return result;
13 | }
14 |
15 | export function exec(cmd, wd) {
16 | return new Promise((resolve, reject) => {
17 | cpexec(
18 | cmd,
19 | {
20 | cwd: wd,
21 | },
22 | (error, stdout, stderr) => {
23 | if (error) {
24 | reject(error);
25 | }
26 |
27 | resolve({ stdout, stderr });
28 | }
29 | );
30 | });
31 | }
32 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/intro-exit/Introduction.jsx:
--------------------------------------------------------------------------------
1 | import React from "react";
2 | import { Button } from "../components/Button";
3 |
4 | export function Introduction({ next }) {
5 | return (
6 |
7 |
21 | );
22 | }
23 |
--------------------------------------------------------------------------------
/internal/templates/source/export/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "export",
3 | "description": "",
4 | "main": "src/index.js",
5 | "private": true,
6 | "scripts": {
7 | "export": "npm run build && node --trace-warnings --enable-source-maps dist/index.js",
8 | "export:runonly": "node --trace-warnings --enable-source-maps dist/index.js",
9 | "build": "esbuild src/index.js --platform=node --define:process.env.NODE_ENV='\"production\"' --bundle --minify --outfile=dist/index.js --sourcemap",
10 | "test": "echo \"Error: no test specified\" && exit 1"
11 | },
12 | "version": "1.0.0",
13 | "volta": {
14 | "node": "20.11.1",
15 | "npm": "10.2.4"
16 | },
17 | "dependencies": {
18 | "@empirica/core": "latest",
19 | "minimist": "1.2.6"
20 | },
21 | "devDependencies": {
22 | "esbuild": "0.14.47"
23 | }
24 | }
25 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/Game.jsx:
--------------------------------------------------------------------------------
1 | import { Chat, useGame } from "@empirica/core/player/classic/react";
2 |
3 | import React from "react";
4 | import { Profile } from "./Profile";
5 | import { Stage } from "./Stage";
6 |
7 | export function Game() {
8 | const game = useGame();
9 | const { playerCount } = game.get("treatment");
10 |
11 | return (
12 | 8 | Instruction One 9 |
10 |
11 |
17 |
20 | 12 | Lorem ipsum, dolor sit amet consectetur adipisicing elit. Eius aliquam 13 | laudantium explicabo pariatur iste dolorem animi vitae error totam. At 14 | sapiente aliquam accusamus facere veritatis. 15 |
16 |
13 |
26 | );
27 | }
28 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/EmptyState.svelte:
--------------------------------------------------------------------------------
1 |
5 |
6 |
28 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/user.ts:
--------------------------------------------------------------------------------
1 | export { Attribute } from "../shared/attributes";
2 | export type { AttributeOptions } from "../shared/attributes";
3 | export type { ScopeUpdate } from "../shared/scopes";
4 | export { TajribaConnection } from "../shared/tajriba_connection";
5 | export { Attributes } from "./attributes";
6 | export { AdminConnection } from "./connection";
7 | export { EventContext, ListenersCollector, TajribaEvent } from "./events";
8 | export type { Subscriber } from "./events";
9 | export { participantsSub } from "./participants";
10 | export type { Participant } from "./participants";
11 | export { Scope, Scopes } from "./scopes";
12 | export { Subscriptions } from "./subscriptions";
13 | export type { ScopeSubscriptionInput, Subs } from "./subscriptions";
14 | export { transitionsSub } from "./transitions";
15 | export type { Transition } from "./transitions";
16 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/components/Button.jsx:
--------------------------------------------------------------------------------
1 | import React from "react";
2 |
3 | const base =
4 | "inline-flex items-center px-4 py-2 border text-sm font-medium rounded-md focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-empirica-500";
5 | const prim =
6 | "border-gray-300 shadow-sm text-gray-700 bg-white hover:bg-gray-50";
7 | const sec =
8 | "border-transparent shadow-sm text-white bg-empirica-600 hover:bg-empirica-700";
9 |
10 | export function Button({
11 | children,
12 | handleClick = null,
13 | className = "",
14 | primary = false,
15 | type = "button",
16 | autoFocus = false,
17 | }) {
18 | return (
19 |
27 | );
28 | }
29 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/utils/treatments.js:
--------------------------------------------------------------------------------
1 | import { ORIGIN } from "../constants.js";
2 |
3 | export async function getTreatments() {
4 | return (await fetch(ORIGIN + "/treatments")).json();
5 | }
6 |
7 | export function formatFactorsToString(factors, sep = " | ") {
8 | let factorArr = [];
9 | for (const key in factors) {
10 | let val = factors[key];
11 |
12 | // check for object/array type data
13 | if (val === Object(val)) {
14 | // Object
15 | if (!val.length) {
16 | let tempVal = [];
17 | for (const k in val) {
18 | tempVal.push(k + ": " + val[k]);
19 | }
20 |
21 | val = "{" + tempVal.join(", ") + "}";
22 | } else {
23 | // array object here
24 | val = "[" + val.join(", ") + "]";
25 | }
26 | }
27 |
28 | factorArr.push(key + ": " + val);
29 | }
30 |
31 | return factorArr.join(sep);
32 | }
33 |
--------------------------------------------------------------------------------
/internal/templates/source/callbacks/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "empirica-server",
3 | "private": true,
4 | "scripts": {
5 | "dev": "npm run build && node --trace-warnings --enable-source-maps --unhandled-rejections=warn-with-error-code dist/index.js",
6 | "build": "rsync -aP --exclude=node_modules --exclude=*.js -m src/* dist/ && esbuild src/index.js --color=true --log-level=warning --log-level=warning --platform=node --define:process.env.NODE_ENV='\"production\"' --bundle --minify --outfile=dist/index.js --sourcemap",
7 | "serve": "node --trace-warnings --enable-source-maps --unhandled-rejections=warn-with-error-code index.js"
8 | },
9 | "volta": {
10 | "node": "20.11.1",
11 | "npm": "10.2.4"
12 | },
13 | "dependencies": {
14 | "@empirica/core": "latest",
15 | "minimist": "1.2.6"
16 | },
17 | "devDependencies": {
18 | "esbuild": "0.14.47"
19 | }
20 | }
21 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/classic/loader.ts:
--------------------------------------------------------------------------------
1 | import { z } from "zod";
2 | import { ListenersCollector } from "../events";
3 | import { ClassicKinds, Context } from "./models";
4 |
5 | const string = z.string();
6 |
7 | /** ClassicLoader loads. */
8 | export function ClassicLoader(
9 | /** This is the listener */
10 | _: ListenersCollector
14 |
19 |
20 | {playerCount > 1 && (
21 |
16 |
18 |
22 |
24 | )}
25 |
4 |
26 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/cloud/signin.go:
--------------------------------------------------------------------------------
1 | package cloudcmd
2 |
3 | import (
4 | "github.com/empiricaly/empirica/internal/cloud"
5 | "github.com/pkg/errors"
6 | "github.com/spf13/cobra"
7 | "github.com/spf13/viper"
8 | )
9 |
10 | func AddSigninCommand(parent *cobra.Command) error {
11 | cmd := &cobra.Command{
12 | Use: "signin",
13 | Aliases: []string{"login"},
14 | Short: "Sign into Empirica Cloud",
15 | SilenceUsage: true,
16 | SilenceErrors: true,
17 | Hidden: true,
18 | Args: cobra.NoArgs,
19 | RunE: func(cmd *cobra.Command, args []string) error {
20 | ctx := initContext()
21 | _, err := cloud.SignIn(ctx)
22 | return errors.Wrap(err, "sign into empirica cloud")
23 | },
24 | }
25 |
26 | err := viper.BindPFlags(cmd.Flags())
27 | if err != nil {
28 | return errors.Wrap(err, "bind bundle flags")
29 | }
30 |
31 | parent.AddCommand(cmd)
32 |
33 | return nil
34 | }
35 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/node.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "github.com/empiricaly/empirica/internal/experiment"
5 | "github.com/empiricaly/empirica/internal/settings"
6 | "github.com/pkg/errors"
7 | "github.com/spf13/cobra"
8 | )
9 |
10 | func addNodeCommand(parent *cobra.Command) error {
11 | cmd := &cobra.Command{
12 | Use: "node",
13 | Short: "Run node",
14 | // Long: ``,
15 | SilenceUsage: true,
16 | SilenceErrors: true,
17 | // Args: cobra.An,
18 | Hidden: false,
19 | DisableFlagParsing: true,
20 | TraverseChildren: true,
21 | RunE: func(cmd *cobra.Command, args []string) error {
22 | ctx := initContext()
23 |
24 | if err := settings.InstallVoltaIfNeeded(ctx); err != nil {
25 | return errors.Wrap(err, "check node")
26 | }
27 |
28 | return experiment.RunCmd(ctx, "", "node", args...)
29 | },
30 | }
31 |
32 | parent.AddCommand(cmd)
33 |
34 | return nil
35 | }
36 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/npm.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "github.com/empiricaly/empirica/internal/experiment"
5 | "github.com/empiricaly/empirica/internal/settings"
6 | "github.com/pkg/errors"
7 | "github.com/spf13/cobra"
8 | )
9 |
10 | func addNPMCommand(parent *cobra.Command) error {
11 | cmd := &cobra.Command{
12 | Use: "npm",
13 | Short: "Run npm commands",
14 | // Long: ``,
15 | SilenceUsage: true,
16 | SilenceErrors: true,
17 | // Args: cobra.An,
18 | Hidden: false,
19 | DisableFlagParsing: true,
20 | TraverseChildren: true,
21 | RunE: func(cmd *cobra.Command, args []string) error {
22 | ctx := initContext()
23 |
24 | if err := settings.InstallVoltaIfNeeded(ctx); err != nil {
25 | return errors.Wrap(err, "check node")
26 | }
27 |
28 | return experiment.RunCmd(ctx, "", "npm", args...)
29 | },
30 | }
31 |
32 | parent.AddCommand(cmd)
33 |
34 | return nil
35 | }
36 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/yarn.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "github.com/empiricaly/empirica/internal/experiment"
5 | "github.com/empiricaly/empirica/internal/settings"
6 | "github.com/pkg/errors"
7 | "github.com/spf13/cobra"
8 | )
9 |
10 | func addYarnCommand(parent *cobra.Command) error {
11 | cmd := &cobra.Command{
12 | Use: "yarn",
13 | Short: "Run yarn commands",
14 | // Long: ``,
15 | SilenceUsage: true,
16 | SilenceErrors: true,
17 | // Args: cobra.An,
18 | Hidden: true,
19 | DisableFlagParsing: true,
20 | TraverseChildren: true,
21 | RunE: func(cmd *cobra.Command, args []string) error {
22 | ctx := initContext()
23 |
24 | if err := settings.InstallVoltaIfNeeded(ctx); err != nil {
25 | return errors.Wrap(err, "check node")
26 | }
27 |
28 | return experiment.RunCmd(ctx, "", "yarn", args...)
29 | },
30 | }
31 |
32 | parent.AddCommand(cmd)
33 |
34 | return nil
35 | }
36 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/Trash.svelte:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/tests/stress/experiment/server/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "dependencies": {
3 | "@empirica/core": "1.8.5",
4 | "minimist": "1.2.6"
5 | },
6 | "devDependencies": {
7 | "esbuild": "0.14.47"
8 | },
9 | "name": "empirica-server",
10 | "private": true,
11 | "scripts": {
12 | "build": "rsync -aP --exclude=node_modules --exclude=*.js -m src/* dist/ && esbuild src/index.js --color=true --log-level=warning --log-level=warning --platform=node --define:process.env.NODE_ENV='\"production\"' --bundle --minify --outfile=dist/index.js --sourcemap",
13 | "dev": "npm run build && node --trace-warnings --enable-source-maps --unhandled-rejections=warn-with-error-code dist/index.js",
14 | "serve": "node --trace-warnings --enable-source-maps --unhandled-rejections=warn-with-error-code index.js"
15 | },
16 | "volta": {
17 | "node": "20.12.0",
18 | "npm": "10.5.0"
19 | },
20 | "engines": {
21 | "node": ">= 20.12.0"
22 | }
23 | }
24 |
--------------------------------------------------------------------------------
/tests/stress/experiment/client/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "dependencies": {
3 | "@empirica/core": "1.8.5",
4 | "esbuild": "0.17.15",
5 | "react": "18.2.0",
6 | "react-dom": "18.2.0"
7 | },
8 | "devDependencies": {
9 | "@types/react": "18.0.14",
10 | "@types/react-dom": "18.0.5",
11 | "@unocss/reset": "^0.51.4",
12 | "@vitejs/plugin-react-refresh": "1.3.6",
13 | "autoprefixer": "10.4.7",
14 | "path": "0.12.7",
15 | "unocss": "^0.51.4",
16 | "vite": "2.9.15",
17 | "vite-plugin-restart": "0.1.1"
18 | },
19 | "name": "react",
20 | "private": true,
21 | "scripts": {
22 | "build": "vite build",
23 | "dev": "NODE_ENV=\"development\" vite",
24 | "dev:prod": "NODE_ENV=\"production\" vite",
25 | "serve": "vite preview"
26 | },
27 | "version": "0.0.0",
28 | "volta": {
29 | "node": "20.12.0",
30 | "npm": "10.5.0"
31 | },
32 | "engines": {
33 | "node": ">= 20.12.0"
34 | }
35 | }
36 |
--------------------------------------------------------------------------------
/internal/templates/source/react/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "react",
3 | "private": true,
4 | "type": "module",
5 | "scripts": {
6 | "dev": "NODE_ENV=\"development\" vite",
7 | "dev:prod": "NODE_ENV=\"production\" vite",
8 | "build": "vite build",
9 | "serve": "vite preview"
10 | },
11 | "volta": {
12 | "node": "20.11.1",
13 | "npm": "10.2.4"
14 | },
15 | "dependencies": {
16 | "@empirica/core": "latest",
17 | "esbuild": "0.17.15",
18 | "react": "18.2.0",
19 | "react-dom": "18.2.0"
20 | },
21 | "devDependencies": {
22 | "@types/react": "18.0.14",
23 | "@types/react-dom": "18.0.5",
24 | "@unocss/reset": "^0.51.4",
25 | "@vitejs/plugin-react": "4.2.1",
26 | "autoprefixer": "10.4.7",
27 | "path": "0.12.7",
28 | "rollup-plugin-polyfill-node": "^0.13.0",
29 | "unocss": "^0.58.5",
30 | "vite": "5.1.4",
31 | "vite-plugin-restart": "0.4.0"
32 | },
33 | "version": "0.0.0"
34 | }
35 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/classic/export/export.ts:
--------------------------------------------------------------------------------
1 | import { Conn, connect } from "../api/api";
2 | import { exportCSV } from "./export_csv";
3 |
4 | async function exportJSON(_: Conn, __: string) {
5 | throw new Error("JSON export not implemented");
6 | }
7 |
8 | export enum ExportFormat {
9 | CSV = "csv",
10 | JSON = "json",
11 | }
12 |
13 | export async function runExport(
14 | url: string,
15 | token: string | null,
16 | srtoken: string,
17 | format: ExportFormat,
18 | output: string
19 | ) {
20 | const taj = await connect(url, token, srtoken);
21 |
22 | console.info("\nExporting", format.toUpperCase(), "to", output, "\n");
23 |
24 | switch (format) {
25 | case ExportFormat.CSV:
26 | await exportCSV(taj, output);
27 | break;
28 | case ExportFormat.JSON:
29 | await exportJSON(taj, output);
30 | break;
31 | default:
32 | throw new Error(`Unknown format ${format}`);
33 | }
34 |
35 | taj.stop();
36 | }
37 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/index.ts:
--------------------------------------------------------------------------------
1 | export { Attribute, Attributes } from "../shared/attributes";
2 | export type {
3 | AttributeChange,
4 | AttributeOptions,
5 | AttributeUpdate,
6 | } from "../shared/attributes";
7 | export { Globals } from "../shared/globals";
8 | export type { Constructor } from "../shared/helpers";
9 | export type {
10 | AttributeInput,
11 | ScopeConstructor,
12 | ScopeUpdate,
13 | ScopeIdent,
14 | Scope as SharedScope,
15 | } from "../shared/scopes";
16 | export type { Json, JsonArray, JsonValue } from "../utils/json";
17 | export { TajribaProvider } from "./provider";
18 | export type { ParticipantUpdate } from "./provider";
19 | export { Scope, Scopes } from "./scopes";
20 | export { Step, Steps } from "./steps";
21 | export type { Epoch, StepChange, StepTick, StepUpdate } from "./steps";
22 | export {
23 | createNewParticipant,
24 | isDevelopment,
25 | isProduction,
26 | isTest,
27 | } from "./utils";
28 | import "./index.css";
29 |
--------------------------------------------------------------------------------
/internal/treatments/treatments.go:
--------------------------------------------------------------------------------
1 | package treatments
2 |
3 | type FactorValue struct {
4 | Name string `json:"name,omitempty" yaml:"name,omitempty"`
5 | Value interface{} `validate:"required" json:"value" yaml:"value"`
6 | }
7 |
8 | type Factor struct {
9 | Name string `validate:"required,gt=0,alphanumunicode" json:"name" yaml:"name"`
10 | Desc string `json:"desc,omitempty" yaml:"desc,omitempty"`
11 | Values []*FactorValue `json:"values" yaml:"values"`
12 | }
13 |
14 | type Treatment struct {
15 | Name string `json:"name,omitempty" yaml:"name,omitempty"`
16 | Desc string `json:"desc,omitempty" yaml:"desc,omitempty"`
17 | Factors map[string]interface{} `validate:"required,dive,keys,gt=0,alphanumunicode,endkeys" json:"factors" yaml:"factors"`
18 | }
19 |
20 | type Treatments struct {
21 | Factors []*Factor `validate:"dive" json:"factors" yaml:"factors"`
22 | Treatments []*Treatment `validate:"dive" json:"treatments" yaml:"treatments"`
23 | }
24 |
--------------------------------------------------------------------------------
/.github/actions/upload-empirica-cli/action.yaml:
--------------------------------------------------------------------------------
1 | name: "Upload empirica CLI"
2 | description: "Uploads empirica CLI to S3"
3 | inputs:
4 | withVariants:
5 | description: "Upload variants"
6 | required: false
7 | default: "true"
8 | fileName:
9 | description: "Binary file name"
10 | required: false
11 | default: "empirica"
12 | bucket:
13 | description: "S3 Bucket"
14 | required: true
15 | root:
16 | description: "Root path in bucket"
17 | required: true
18 | awsEndpoint:
19 | description: "AWS Endpoint (to use S3 alternatives)"
20 | required: false
21 | awsSignatureVersion:
22 | description: "AWS Signature Version"
23 | required: false
24 | AWS_ACCESS_KEY_ID:
25 | description: "AWS Access Key ID"
26 | required: true
27 | AWS_SECRET_ACCESS_KEY:
28 | description: "AWS Secret Access Key"
29 | required: true
30 | path:
31 | description: "Input directory"
32 | required: true
33 | runs:
34 | using: "node16"
35 | main: "dist/index.js"
36 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/setup.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "fmt"
5 |
6 | "github.com/empiricaly/empirica/internal/settings"
7 | "github.com/pkg/errors"
8 | "github.com/spf13/cobra"
9 | )
10 |
11 | const postInstallMsg = `
12 | To get started fast:
13 |
14 | empirica create my-experiment
15 | cd my-experiment
16 | empirica
17 |
18 | Otherwise head over to https://docs.empirica.ly.
19 | `
20 |
21 | func addSetupCommand(parent *cobra.Command) error {
22 | cmd := &cobra.Command{
23 | Use: "setup",
24 | Short: "Setup empirica",
25 | // Long: ``,
26 | SilenceUsage: true,
27 | SilenceErrors: true,
28 | Args: cobra.NoArgs,
29 | Hidden: true,
30 | RunE: func(cmd *cobra.Command, args []string) error {
31 | if err := settings.InstallVoltaIfNeeded(initContext()); err != nil {
32 | return errors.Wrap(err, "install volta")
33 | }
34 |
35 | fmt.Println(postInstallMsg)
36 |
37 | return nil
38 | },
39 | }
40 |
41 | parent.AddCommand(cmd)
42 |
43 | return nil
44 | }
45 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/treatments/FactorsString.svelte:
--------------------------------------------------------------------------------
1 |
5 |
6 | {#each Object.keys(factors) as key, i}
7 |
8 |
9 | {key}
10 |
11 |
12 | {#if factors[key] === Object(factors[key])}
13 | {#if factors[key].length}
14 | [{factors[key].join(", ")}]
15 | {:else}
16 | {"{"}
17 | {#each Object.keys(factors[key]) as k, j}
18 | {k}: {factors[key][k]}
19 | {#if j !== Object.keys(factors[key]).length - 1}
20 | ,
21 | {/if}
22 | {/each}
23 | {"}"}
24 | {/if}
25 | {:else}
26 | {factors[key]}
27 | {/if}
28 | {#if !lines && i !== Object.keys(factors).length - 1}
29 | {" | "}
30 | {/if}
31 |
32 |
33 | {/each}
34 |
--------------------------------------------------------------------------------
/tests/stress/README.md:
--------------------------------------------------------------------------------
1 | Inside that directory, you can run several commands:
2 |
3 | ```
4 | pnpm exec playwright test
5 | Runs the end-to-end tests.
6 |
7 | pnpm exec playwright test --ui
8 | Starts the interactive UI mode.
9 |
10 | pnpm exec playwright test --project=chromium
11 | Runs the tests only on Desktop Chrome.
12 |
13 | pnpm exec playwright test example
14 | Runs the tests in a specific file.
15 |
16 | pnpm exec playwright test --debug
17 | Runs the tests in debug mode.
18 |
19 | pnpm exec playwright codegen
20 | Auto generate tests with Codegen.
21 | ```
22 |
23 | We suggest that you begin by typing:
24 |
25 | ```
26 | pnpm exec playwright test
27 | ```
28 |
29 | And check out the following files:
30 |
31 | - ./tests/example.spec.js - Example end-to-end test
32 | - ./tests-examples/demo-todo-app.spec.js - Demo Todo App end-to-end tests
33 | - ./playwright.config.js - Playwright Test configuration
34 |
35 | Visit https://playwright.dev/docs/intro for more information. ✨
36 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/Button.svelte:
--------------------------------------------------------------------------------
1 |
22 |
23 |
26 |
--------------------------------------------------------------------------------
/internal/templates/source/react/src/Stage.jsx:
--------------------------------------------------------------------------------
1 | import {
2 | usePlayer,
3 | usePlayers,
4 | useRound,
5 | } from "@empirica/core/player/classic/react";
6 | import { Loading } from "@empirica/core/player/react";
7 | import React from "react";
8 | import { JellyBeans } from "./examples/JellyBeans";
9 | import { MineSweeper } from "./examples/MineSweeper";
10 |
11 | export function Stage() {
12 | const player = usePlayer();
13 | const players = usePlayers();
14 | const round = useRound();
15 |
16 | if (player.stage.get("submit")) {
17 | if (players.length === 1) {
18 | return
5 |
25 |
6 |
7 |
20 |
21 |
24 |
23 | Please wait for other player(s).
24 |
25 | );
26 | }
27 |
28 | switch (round.get("task")) {
29 | case "jellybeans":
30 | return Unknown task
;
35 | }
36 | }
37 |
--------------------------------------------------------------------------------
/internal/templates/source/react/uno.config.ts:
--------------------------------------------------------------------------------
1 | import {
2 | defineConfig,
3 | presetAttributify,
4 | presetIcons,
5 | presetTypography,
6 | presetUno,
7 | presetWebFonts,
8 | transformerDirectives,
9 | transformerVariantGroup,
10 | } from "unocss";
11 |
12 | export default defineConfig({
13 | theme: {
14 | extend: {
15 | colors: {
16 | empirica: {
17 | 50: "#fbfcfe",
18 | 100: "#f2f7fd",
19 | 200: "#bcd8f6",
20 | 300: "#8abbef",
21 | 400: "#549ce8",
22 | 500: "#237fe1",
23 | 600: "#1966b8",
24 | 700: "#124b87",
25 | 800: "#0c325a",
26 | 900: "#06192d",
27 | },
28 | },
29 | },
30 | },
31 | presets: [
32 | presetUno(),
33 | presetAttributify(),
34 | presetIcons(),
35 | presetTypography(),
36 | presetWebFonts({
37 | fonts: {
38 | // ...
39 | },
40 | }),
41 | ],
42 | transformers: [transformerDirectives(), transformerVariantGroup()],
43 | });
44 |
--------------------------------------------------------------------------------
/tests/stress/experiment/client/uno.config.ts:
--------------------------------------------------------------------------------
1 | import {
2 | defineConfig,
3 | presetAttributify,
4 | presetIcons,
5 | presetTypography,
6 | presetUno,
7 | presetWebFonts,
8 | transformerDirectives,
9 | transformerVariantGroup,
10 | } from "unocss";
11 |
12 | export default defineConfig({
13 | theme: {
14 | extend: {
15 | colors: {
16 | empirica: {
17 | 50: "#fbfcfe",
18 | 100: "#f2f7fd",
19 | 200: "#bcd8f6",
20 | 300: "#8abbef",
21 | 400: "#549ce8",
22 | 500: "#237fe1",
23 | 600: "#1966b8",
24 | 700: "#124b87",
25 | 800: "#0c325a",
26 | 900: "#06192d",
27 | },
28 | },
29 | },
30 | },
31 | presets: [
32 | presetUno(),
33 | presetAttributify(),
34 | presetIcons(),
35 | presetTypography(),
36 | presetWebFonts({
37 | fonts: {
38 | // ...
39 | },
40 | }),
41 | ],
42 | transformers: [transformerDirectives(), transformerVariantGroup()],
43 | });
44 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/classic/export/bytes.ts:
--------------------------------------------------------------------------------
1 | // From https://stackoverflow.com/a/14919494
2 | /**
3 | * Format bytes as human-readable text.
4 | *
5 | * @param bytes Number of bytes.
6 | * @param si True to use metric (SI) units, aka powers of 1000. False to use
7 | * binary (IEC), aka powers of 1024.
8 | * @param dp Number of decimal places to display.
9 | *
10 | * @return Formatted string.
11 | */
12 | export function humanBytes(bytes: number, si = false, dp = 1) {
13 | const thresh = si ? 1000 : 1024;
14 |
15 | if (Math.abs(bytes) < thresh) {
16 | return bytes + " B";
17 | }
18 |
19 | const units = si
20 | ? ["kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"]
21 | : ["KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
22 | let u = -1;
23 | const r = 10 ** dp;
24 |
25 | do {
26 | bytes /= thresh;
27 | ++u;
28 | } while (
29 | Math.round(Math.abs(bytes) * r) / r >= thresh &&
30 | u < units.length - 1
31 | );
32 |
33 | return bytes.toFixed(dp) + " " + units[u];
34 | }
35 |
--------------------------------------------------------------------------------
/lib/@empirica/core/uno.config.ts:
--------------------------------------------------------------------------------
1 | import {
2 | defineConfig,
3 | presetAttributify,
4 | presetIcons,
5 | presetTypography,
6 | presetUno,
7 | presetWebFonts,
8 | transformerDirectives,
9 | transformerVariantGroup,
10 | } from "unocss";
11 | import { presetForms } from "@julr/unocss-preset-forms";
12 |
13 | export default defineConfig({
14 | theme: {
15 | colors: {
16 | empirica: {
17 | 50: "#fbfcfe",
18 | 100: "#f2f7fd",
19 | 200: "#bcd8f6",
20 | 300: "#8abbef",
21 | 400: "#549ce8",
22 | 500: "#237fe1",
23 | 600: "#1966b8",
24 | 700: "#124b87",
25 | 800: "#0c325a",
26 | 900: "#06192d",
27 | },
28 | },
29 | },
30 | presets: [
31 | presetUno(),
32 | presetForms(),
33 | presetAttributify(),
34 | presetIcons(),
35 | presetTypography(),
36 | presetWebFonts({
37 | fonts: {
38 | // ...
39 | },
40 | }),
41 | ],
42 | transformers: [transformerDirectives(), transformerVariantGroup()],
43 | });
44 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/cloud/random.go:
--------------------------------------------------------------------------------
1 | package cloudcmd
2 |
3 | import (
4 | "math/rand"
5 | "strings"
6 | "time"
7 | )
8 |
9 | const letterBytes = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
10 | const (
11 | letterIdxBits = 6 // 6 bits to represent a letter index
12 | letterIdxMask = 1<
7 |
30 | );
31 | }
32 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/Export.svelte:
--------------------------------------------------------------------------------
1 |
24 |
25 |
8 |
29 | No experiments available
9 |10 | There are currently no available experiments. Please wait until an 11 | experiment becomes available or come back at a later date. 12 |
13 | {isDevelopment ? ( 14 |15 | Go to{" "} 16 | 21 | Admin 22 | {" "} 23 | to get started 24 |
25 | ) : ( 26 | "" 27 | )} 28 |
29 |
30 |
32 |
33 |
37 |
34 |
35 |
36 |
14 |
18 | );
19 | }
20 |
21 | function humanTimer(seconds) {
22 | if (seconds === null || seconds === undefined) {
23 | return "--:--";
24 | }
25 |
26 | let out = "";
27 | const s = seconds % 60;
28 | out += s < 10 ? "0" + s : s;
29 |
30 | const min = (seconds - s) / 60;
31 | if (min === 0) {
32 | return `00:${out}`;
33 | }
34 |
35 | const m = min % 60;
36 | out = `${m < 10 ? "0" + m : m}:${out}`;
37 |
38 | const h = (min - m) / 60;
39 | if (h === 0) {
40 | return out;
41 | }
42 |
43 | return `${h}:${out}`;
44 | }
45 |
--------------------------------------------------------------------------------
/lib/admin-ui/jsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 | "compilerOptions": {
3 | "module": "esnext",
4 | "moduleResolution": "nodenext",
5 | "target": "esnext",
6 | /**
7 | * svelte-preprocess cannot figure out whether you have
8 | * a value or a type, so tell TypeScript to enforce using
9 | * `import type` instead of `import` for Types.
10 | */
11 | // "importsNotUsedAsValues": "error",
12 | "isolatedModules": true,
13 | /**
14 | * To have warnings / errors of the Svelte compiler at the
15 | * correct position, enable source maps by default.
16 | */
17 | "sourceMap": true,
18 | "esModuleInterop": true,
19 | "skipLibCheck": true,
20 | "forceConsistentCasingInFileNames": true,
21 | "baseUrl": ".",
22 | /**
23 | * Typecheck JS in `.svelte` and `.js` files by default.
24 | * Disable this if you'd like to use dynamic types.
25 | */
26 | "checkJs": true
27 | },
28 | /**
29 | * Use globals.d.ts instead of compilerOptions.types
30 | * to avoid limiting type declarations.
31 | */
32 | "include": ["globals.d.ts", "src/**/*.js", "src/**/*.svelte"]
33 | }
34 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/Alert.svelte:
--------------------------------------------------------------------------------
1 |
4 |
5 | 15 | {humanTimer(remaining)} 16 |
17 |
6 |
35 |
--------------------------------------------------------------------------------
/internal/templates/source/svelte/jsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 | "compilerOptions": {
3 | "moduleResolution": "node",
4 | "target": "esnext",
5 | "module": "esnext",
6 | /**
7 | * svelte-preprocess cannot figure out whether you have
8 | * a value or a type, so tell TypeScript to enforce using
9 | * `import type` instead of `import` for Types.
10 | */
11 | "importsNotUsedAsValues": "error",
12 | "isolatedModules": true,
13 | "resolveJsonModule": true,
14 | /**
15 | * To have warnings / errors of the Svelte compiler at the
16 | * correct position, enable source maps by default.
17 | */
18 | "sourceMap": true,
19 | "esModuleInterop": true,
20 | "skipLibCheck": true,
21 | "forceConsistentCasingInFileNames": true,
22 | "baseUrl": ".",
23 | /**
24 | * Typecheck JS in `.svelte` and `.js` files by default.
25 | * Disable this if you'd like to use dynamic types.
26 | */
27 | "checkJs": true
28 | },
29 | /**
30 | * Use global.d.ts instead of compilerOptions.types
31 | * to avoid limiting type declarations.
32 | */
33 | "include": ["src/**/*.d.ts", "src/**/*.js", "src/**/*.svelte"]
34 | }
35 |
--------------------------------------------------------------------------------
/internal/templates/source/callbacks/src/index.js:
--------------------------------------------------------------------------------
1 | import { AdminContext } from "@empirica/core/admin";
2 | import {
3 | Classic,
4 | classicKinds,
5 | ClassicLoader,
6 | Lobby,
7 | } from "@empirica/core/admin/classic";
8 | import { info, setLogLevel } from "@empirica/core/console";
9 | import minimist from "minimist";
10 | import process from "process";
11 | import { Empirica } from "./callbacks";
12 |
13 | const argv = minimist(process.argv.slice(2), { string: ["token"] });
14 |
15 | setLogLevel(argv["loglevel"] || "info");
16 |
17 | (async () => {
18 | const ctx = await AdminContext.init(
19 | argv["url"] || "http://localhost:3000/query",
20 | argv["sessionTokenPath"],
21 | "callbacks",
22 | argv["token"],
23 | {},
24 | classicKinds
25 | );
26 |
27 | ctx.register(ClassicLoader);
28 | ctx.register(Classic());
29 | ctx.register(Lobby());
30 | ctx.register(Empirica);
31 | ctx.register(function (_) {
32 | _.on("ready", function () {
33 | info("server: started");
34 | });
35 | });
36 | })();
37 |
38 | process.on("unhandledRejection", function (reason, p) {
39 | process.exitCode = 1;
40 | console.error("Unhandled Promise Rejection. Reason: ", reason);
41 | });
42 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/layout/SidebarButton.svelte:
--------------------------------------------------------------------------------
1 |
11 |
12 |
19 |
7 |
34 |
8 |
9 |
22 |
23 |
24 | {#if title}
25 |
33 | 26 | {title} 27 |
28 | {/if} 29 |
30 |
32 |
13 | {#if !selected && placeholder}
14 | {placeholder}
15 | {/if}
16 |
31 |
32 |
33 |
41 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/classic/api/api_test.ts:
--------------------------------------------------------------------------------
1 | import test from "ava";
2 | import { connect } from "./api";
3 | import { withTajriba } from "./connection_test_helper";
4 |
5 | const t = test;
6 | // const t = test.serial;
7 | // const to = test.only;
8 |
9 | t("query with api", async (t) => {
10 | await withTajriba(
11 | async ({ url, srtoken }) => {
12 | const taj = await connect(url, null, srtoken);
13 |
14 | t.truthy(taj);
15 | for await (const player of taj.players()) {
16 | console.log("player", player.id);
17 | for (const attr of player.attributes) {
18 | console.log(` ${attr.key} ${attr.value}`);
19 | }
20 | }
21 | for await (const batch of taj.batches()) {
22 | console.log("batch", batch.id);
23 | for (const attr of batch.attributes) {
24 | console.log(` ${attr.key} ${attr.value}`);
25 | }
26 | }
27 | for await (const game of taj.games()) {
28 | console.log("game", game.id);
29 | for (const attr of game.attributes) {
30 | console.log(` ${attr.key} ${attr.value}`);
31 | }
32 | }
33 | },
34 | { tajFile: "src/admin/classic/api/tajriba.json", printLogs: false }
35 | );
36 | });
37 |
--------------------------------------------------------------------------------
/internal/templates/source/export/src/index.js:
--------------------------------------------------------------------------------
1 | import {
2 | ExportFormat,
3 | runExport,
4 | withTajriba,
5 | } from "@empirica/core/admin/classic";
6 | import { setLogLevel } from "@empirica/core/console";
7 | import minimist from "minimist";
8 |
9 | const argv = minimist(process.argv.slice(2), {
10 | string: ["token", "srtoken", "filename", "tajfile", "url"],
11 | });
12 |
13 | setLogLevel(argv["loglevel"] || "info");
14 |
15 | (async () => {
16 | try {
17 | const run = async (url, srtoken = argv["srtoken"]) => {
18 | await runExport(
19 | url,
20 | argv["token"],
21 | srtoken,
22 | ExportFormat.CSV,
23 | argv["filename"]
24 | );
25 | };
26 |
27 | if (argv["url"]) {
28 | await run(argv["url"]);
29 |
30 | return;
31 | }
32 |
33 | if (!argv["tajfile"]) {
34 | throw new Error("Missing tajfile");
35 | }
36 |
37 | await withTajriba(
38 | async ({ url, srtoken }) => {
39 | await run(url, srtoken);
40 | },
41 | {
42 | tajFile: argv["tajfile"],
43 | printLogs: false,
44 | }
45 | );
46 |
47 | process.exit(0);
48 | } catch (err) {
49 | console.error(err);
50 | process.exit(1);
51 | }
52 | })();
53 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/layout/Logo.svelte:
--------------------------------------------------------------------------------
1 |
4 |
5 |
46 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/classic/index.ts:
--------------------------------------------------------------------------------
1 | export { Attribute, Attributes } from "../../shared/attributes";
2 | export type {
3 | AttributeChange,
4 | AttributeOptions,
5 | AttributeUpdate,
6 | } from "../../shared/attributes";
7 | export { Globals } from "../../shared/globals";
8 | export type { Constructor } from "../../shared/helpers";
9 | export type {
10 | AttributeInput,
11 | ScopeConstructor,
12 | ScopeIdent,
13 | ScopeUpdate,
14 | Scope as SharedScope,
15 | } from "../../shared/scopes";
16 | export type { Json, JsonArray, JsonValue } from "../../utils/json";
17 | export { TajribaProvider } from "../provider";
18 | export type { ParticipantUpdate } from "../provider";
19 | export { Scope, Scopes } from "../scopes";
20 | export { Step, Steps } from "../steps";
21 | export type { Epoch, StepChange, StepTick, StepUpdate } from "../steps";
22 | export {
23 | createNewParticipant,
24 | isDevelopment,
25 | isProduction,
26 | isTest,
27 | } from "../utils";
28 | export {
29 | EmpiricaClassic,
30 | Game,
31 | Player,
32 | PlayerGame,
33 | PlayerRound,
34 | PlayerStage,
35 | Round,
36 | Stage,
37 | } from "./classic";
38 | export type {
39 | Context,
40 | EmpiricaClassicContext,
41 | EmpiricaClassicKinds,
42 | } from "./classic";
43 | import "../index.css";
44 |
--------------------------------------------------------------------------------
/lib/admin-ui/uno.config.ts:
--------------------------------------------------------------------------------
1 | import { presetForms } from "@julr/unocss-preset-forms";
2 | import {
3 | defineConfig,
4 | presetTypography,
5 | presetUno,
6 | transformerDirectives,
7 | transformerVariantGroup,
8 | } from "unocss";
9 |
10 | export default defineConfig({
11 | safelist: [
12 | ...["blue", "green", "yellow", "grey"]
13 | .map((color) => [
14 | `border-${color}-600`,
15 | `text-${color}-600`,
16 | `bg-${color}-600`,
17 | `hover:bg-${color}-700`,
18 | `bg-${color}-100`,
19 | `text-${color}-800`,
20 | ])
21 | .flat(),
22 | ],
23 | theme: {
24 | colors: {
25 | empirica: {
26 | 50: "#fbfcfe",
27 | 100: "#f2f7fd",
28 | 200: "#bcd8f6",
29 | 300: "#8abbef",
30 | 400: "#549ce8",
31 | 500: "#237fe1",
32 | 600: "#1966b8",
33 | 700: "#124b87",
34 | 800: "#0c325a",
35 | 900: "#06192d",
36 | },
37 | },
38 | },
39 | presets: [
40 | presetUno(),
41 | presetForms(),
42 | // presetAttributify(),
43 | // presetIcons(),
44 | presetTypography(),
45 | // presetWebFonts({
46 | // fonts: {
47 | // // ...
48 | // },
49 | // }),
50 | ],
51 | transformers: [transformerDirectives(), transformerVariantGroup()],
52 | });
53 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/admin/transitions.ts:
--------------------------------------------------------------------------------
1 | import { EventType, State, TajribaAdmin } from "@empirica/tajriba";
2 | import { Subject } from "rxjs";
3 | import { error } from "../utils/console";
4 |
5 | export interface Step {
6 | id: string;
7 | state: State;
8 | duration: number;
9 | startedAt?: number;
10 | endedAt?: number;
11 | }
12 |
13 | export interface Transition {
14 | id: string;
15 | from: State;
16 | to: State;
17 | step: Step;
18 | }
19 |
20 | export function transitionsSub(
21 | taj: TajribaAdmin,
22 | transitions: Subject
27 |
34 |
29 |
30 |
32 |
33 |
19 |
44 | );
45 | }
46 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/react/EmpiricaParticipant.tsx:
--------------------------------------------------------------------------------
1 | import React from "react";
2 | import { Mode, ParticipantContext, ParticipantModeContext } from "../context";
3 | import { WithChildren } from "./helpers";
4 |
5 | export const ParticipantCtx = React.createContext<
6 | ParticipantContext | undefined
7 | >(undefined);
8 |
9 | export type EmpiricaParticipantProps = WithChildren<{
10 | url: string;
11 | ns: string;
12 | modeFunc?: Mode
20 |
27 |
28 |
21 | {round ? round.get("name") : ""}
22 |
23 |
24 | {stage ? stage.get("name") : ""}
25 |
26 |
31 |
43 |
32 |
39 |
33 | Score
34 |
35 |
36 | {score}
37 |
38 |
40 |
42 |
16 | {#if prefix}
17 |
45 |
46 |
51 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/classic/react/Slider.tsx:
--------------------------------------------------------------------------------
1 | import React, { ChangeEventHandler, RefObject, useRef } from "react";
2 |
3 | export interface SliderProps {
4 | value: number;
5 | onChange: ChangeEventHandler
18 | {prefix}
19 |
20 | {/if}
21 | {#if type === "text"}
22 |
23 | {:else if type === "number"}
24 |
34 | {:else}
35 | Type not implemented ('{type}')
36 | {/if}
37 | {#if suffix}
38 |
39 |
40 | {suffix}
41 |
42 |
43 | {/if}
44 |
35 |
45 | {noVal ? (
46 | ""
47 | ) : (
48 |
54 | )}
55 |
56 | );
57 | }
58 |
--------------------------------------------------------------------------------
/lib/@empirica/core/README.md:
--------------------------------------------------------------------------------
1 | # @empirica/core
2 |
3 | The `@empirica/core` package contains multiple modules that are used by the
4 | Empirica platform.
5 |
6 | There are two main categories of modules:
7 |
8 | - **Admin**: modules that are used with full access to Tajriba data and
9 | functionality. These modules are used by the Empirica Admin Panel and the
10 | server.
11 | - **Player**: modules that are used by the Empirica Player. These modules are
12 | used in the frontend.
13 |
14 | There is also a console module that is used throughout for logging.
15 |
16 | Empirica is built on top of Tajriba, which is a server-side framework for
17 | building experiments. Parts of the `@empirica/core` package are building blocks
18 | on top of Tajriba and are not specific to Empirica.
19 |
20 | The parts of the `@empirica/core` package that are specific to Empirica are
21 | called `classic`. They implement the core functionality of Empirica, which are
22 | objects such as Batches, Games, Players, Rounds and Stage, and the logic for
23 | running Empirica experiments.
24 |
25 | The `@empirica/core` package can be used to build different models of
26 | experiments that do not follow the Empirica conventions.
27 |
28 | ## Module details
29 |
30 | - **Admin**:
31 | - `admin`: the main admin module, which is not empirica-specific.
32 | - `admin/classic`: the Empirica logic for admin functionality.
33 | - **Player**:
34 | - `player`: the main player module, which is not empirica-specific.
35 | - `player/react`: React utilities, which are not empirica-specific.
36 | - `player/classic`: the Empirica logic for player functionality.
37 | - `player/classic/react`: Empirica React utilities for players.
38 | - **Utils**:
39 | - `utils/console`: logging facilities.
40 |
--------------------------------------------------------------------------------
/internal/templates/source/react/vite.config.js:
--------------------------------------------------------------------------------
1 | import react from "@vitejs/plugin-react";
2 | import builtins from "rollup-plugin-polyfill-node";
3 | import { defineConfig, searchForWorkspaceRoot } from "vite";
4 | import restart from "vite-plugin-restart";
5 | import UnoCSS from "unocss/vite";
6 | import dns from "dns";
7 |
8 | dns.setDefaultResultOrder("verbatim");
9 |
10 | const builtinsPlugin = {
11 | ...builtins({ include: ["fs/promises"] }),
12 | name: "rollup-plugin-polyfill-node",
13 | };
14 |
15 | // https://vitejs.dev/config/
16 | export default defineConfig({
17 | optimizeDeps: {
18 | exclude: ["@empirica/tajriba", "@empirica/core"],
19 | },
20 | server: {
21 | port: 8844,
22 | open: false,
23 | strictPort: true,
24 | host: "0.0.0.0",
25 | hmr: {
26 | host: "localhost",
27 | protocol: "ws",
28 | port: 8844,
29 | },
30 | fs: {
31 | allow: [
32 | // search up for workspace root
33 | searchForWorkspaceRoot(process.cwd()),
34 | ],
35 | },
36 | },
37 | build: {
38 | minify: false,
39 | target: "esnext",
40 | sourcemap: true,
41 | rollupOptions: {
42 | preserveEntrySignatures: "strict",
43 | plugins: [builtinsPlugin],
44 | output: {
45 | sourcemap: true,
46 | },
47 | },
48 | },
49 | clearScreen: false,
50 | plugins: [
51 | restart({
52 | restart: [
53 | "./uno.config.cjs",
54 | "./node_modules/@empirica/core/dist/**/*.{js,ts,jsx,tsx,css}",
55 | "./node_modules/@empirica/core/assets/**/*.css",
56 | ],
57 | }),
58 | UnoCSS(),
59 | react(),
60 | ],
61 | define: {
62 | "process.env": {
63 | NODE_ENV: process.env.NODE_ENV || "development",
64 | },
65 | },
66 | });
67 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/create.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "fmt"
5 | "os/exec"
6 | "strings"
7 |
8 | "github.com/empiricaly/empirica/internal/experiment"
9 | "github.com/empiricaly/empirica/internal/settings"
10 | "github.com/pkg/errors"
11 | "github.com/rs/zerolog/log"
12 | "github.com/spf13/cobra"
13 | )
14 |
15 | func addCreateCommand(parent *cobra.Command) error {
16 | parent.AddCommand(&cobra.Command{
17 | Use: "create",
18 | Short: "Create a new Empirica project",
19 | // Long: ``,
20 | SilenceUsage: true,
21 | SilenceErrors: true,
22 | Args: cobra.ExactArgs(1),
23 | RunE: func(cmd *cobra.Command, args []string) error {
24 | if len(args) != 1 {
25 | return errors.New("missing project name")
26 | }
27 |
28 | ctx := initContext()
29 |
30 | if err := settings.InstallVoltaIfNeeded(ctx); err != nil {
31 | return errors.Wrap(err, "check node")
32 | }
33 |
34 | // current, err := os.Getwd()
35 | // if
36 |
37 | if err := experiment.Create(ctx, args[0]); err != nil {
38 | return errors.Wrap(err, "get current directory")
39 | }
40 |
41 | return nil
42 | },
43 | })
44 |
45 | return nil
46 | }
47 |
48 | func commandExists(cmd string) bool {
49 | _, err := exec.LookPath(cmd)
50 | return err == nil
51 | }
52 |
53 | func askForConfirmation() bool {
54 | var response string
55 |
56 | _, err := fmt.Scanln(&response)
57 | if err != nil {
58 | log.Error().Err(err).Msg("Failed to read input")
59 |
60 | return false
61 | }
62 |
63 | switch strings.ToLower(response) {
64 | case "y", "yes":
65 | return true
66 | case "n", "no":
67 | return false
68 | default:
69 | fmt.Println("I'm sorry but I didn't get what you meant, please type (y)es or (n)o and then press enter:")
70 | return askForConfirmation()
71 | }
72 | }
73 |
--------------------------------------------------------------------------------
/internal/server/config.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "fmt"
5 |
6 | "github.com/empiricaly/empirica/internal/settings"
7 | "github.com/pkg/errors"
8 | "github.com/spf13/cobra"
9 | "github.com/spf13/viper"
10 | )
11 |
12 | // Config is server configuration.
13 | type Config struct {
14 | Addr string `mapstructure:"addr"`
15 | Treatments string `mapstructure:"treatments"`
16 | Lobbies string `mapstructure:"lobbies"`
17 |
18 | // Player frontend proxy
19 | ProxyAddr string `mapstructure:"proxyaddr"`
20 |
21 | Production bool `mapstructure:"-"`
22 | }
23 |
24 | // Validate configuration is ok.
25 | func (c *Config) Validate() error {
26 | return nil
27 | }
28 |
29 | const DefaultAddr = ":3000"
30 |
31 | // ConfigFlags helps configure cobra and viper flags.
32 | func ConfigFlags(cmd *cobra.Command, prefix string) error {
33 | if cmd == nil {
34 | return errors.New("command required")
35 | }
36 |
37 | if prefix == "" {
38 | return errors.New("prefix required")
39 | }
40 |
41 | viper.SetDefault(prefix, &Config{})
42 |
43 | flag := prefix + ".addr"
44 | sval := DefaultAddr
45 | cmd.Flags().StringP(flag, "s", sval, "Address of the server")
46 | viper.SetDefault(flag, sval)
47 |
48 | flag = prefix + ".treatments"
49 | sval = fmt.Sprintf("%s/treatments.yaml", settings.EmpiricaDir)
50 | cmd.Flags().String(flag, sval, "Treatments config file")
51 | viper.SetDefault(flag, sval)
52 |
53 | flag = prefix + ".lobbies"
54 | sval = fmt.Sprintf("%s/lobbies.yaml", settings.EmpiricaDir)
55 | cmd.Flags().String(flag, sval, "Lobbies config file")
56 | viper.SetDefault(flag, sval)
57 |
58 | flag = prefix + ".proxyaddr"
59 | sval = "http://127.0.0.1:8844"
60 | cmd.Flags().String(flag, sval, "Frontend proxy address")
61 | viper.SetDefault(flag, sval)
62 |
63 | return nil
64 | }
65 |
--------------------------------------------------------------------------------
/internal/templates/source/callbacks/src/callbacks.js:
--------------------------------------------------------------------------------
1 | import { ClassicListenersCollector } from "@empirica/core/admin/classic";
2 | export const Empirica = new ClassicListenersCollector();
3 |
4 | Empirica.onGameStart(({ game }) => {
5 | const round = game.addRound({
6 | name: "Round 1 - Jelly Beans",
7 | task: "jellybeans",
8 | });
9 | round.addStage({ name: "Answer", duration: 300 });
10 | round.addStage({ name: "Result", duration: 120 });
11 |
12 | const round2 = game.addRound({
13 | name: "Round 2 - Minesweeper",
14 | task: "minesweeper",
15 | });
16 | round2.addStage({ name: "Play", duration: 300 });
17 | });
18 |
19 | Empirica.onRoundStart(({ round }) => {});
20 |
21 | Empirica.onStageStart(({ stage }) => {});
22 |
23 | Empirica.onStageEnded(({ stage }) => {
24 | calculateJellyBeansScore(stage);
25 | });
26 |
27 | Empirica.onRoundEnded(({ round }) => {});
28 |
29 | Empirica.onGameEnded(({ game }) => {});
30 |
31 | // Note: this is not the actual number of beans in the pile, it's a guess...
32 | const jellyBeansCount = 634;
33 |
34 | function calculateJellyBeansScore(stage) {
35 | if (
36 | stage.get("name") !== "Answer" ||
37 | stage.round.get("task") !== "jellybeans"
38 | ) {
39 | return;
40 | }
41 |
42 | for (const player of stage.currentGame.players) {
43 | let roundScore = 0;
44 |
45 | const playerGuess = player.round.get("guess");
46 |
47 | if (playerGuess) {
48 | const deviation = Math.abs(playerGuess - jellyBeansCount);
49 | const score = Math.round((1 - deviation / jellyBeansCount) * 10);
50 | roundScore = Math.max(0, score);
51 | }
52 |
53 | player.round.set("score", roundScore);
54 |
55 | const totalScore = player.get("score") || 0;
56 | player.set("score", totalScore + roundScore);
57 | }
58 | }
59 |
--------------------------------------------------------------------------------
/modd.conf:
--------------------------------------------------------------------------------
1 | # .golangci.yml **/*.go !internal/graph/**/*.go {
2 | # prep: golangci-lint run --color always
3 | # }
4 |
5 | # {
6 | # prep: rm /usr/local/bin/empirica
7 | # }
8 |
9 | # {
10 | # prep: rm internal/templates/source/admin-ui || echo ""
11 | # prep: ln -s ../../../lib/admin-ui/dist internal/templates/source/admin-ui
12 | # }
13 |
14 | internal/templates/sources/**/* {
15 | prep: go generate ./internal/templates/...
16 | }
17 |
18 | go.mod go.sum **/*.go !**/*_test.go ../tajriba/**/*.go !../tajriba/**/*_test.go !internal/graph/generated.go !internal/graph/models_gen.go internal/graph/*.resolvers.go {
19 | prep: go install -race -ldflags "-X 'github.com/empiricaly/empirica/internal/build.DevBuild=true' -X 'github.com/empiricaly/empirica/internal/build.SHA=abcd123' -X 'github.com/empiricaly/empirica/internal/build.Tag=v1.2.3' -X 'github.com/empiricaly/empirica/internal/build.Branch=thisbranch' -X 'github.com/empiricaly/empirica/internal/build.BuildNum=42' -X 'github.com/empiricaly/empirica/internal/build.Time=$(date -u +'%Y-%m-%dT%H:%M:%SZ')'" ./cmds/empirica
20 | prep: mv $(go env GOPATH)/bin/empirica $(go env GOPATH)/bin/emp
21 |
22 | # prep: rm .empirica/local/tajriba.json 2> /dev/null || echo ""
23 | # daemon: unbuffer emp --log.tty --tajriba.log.tty --log.level trace # --tajriba.auth.username "hey" --tajriba.auth.name "hey" --tajriba.auth.password "lalalala"
24 | # prep: unbuffer emp cloud deploy --bundle /tmp/bWJDnWaraj.zstd
25 | # prep: unbuffer emp cloud login
26 | }
27 |
28 | # go.mod go.sum **/*.go !**/*_test.go !internal/graph/generated.go !internal/graph/models_gen.go internal/graph/*.resolvers.go {
29 | # prep: go install ./cmds/proxy
30 |
31 | # # prep: rm .empirica/local/tajriba.json 2> /dev/null || echo ""
32 | # # prep: unbuffer proxy version --help
33 | # }
34 |
--------------------------------------------------------------------------------
/internal/utils/log/config.go:
--------------------------------------------------------------------------------
1 | package log
2 |
3 | import (
4 | "github.com/pkg/errors"
5 | "github.com/rs/zerolog"
6 | "github.com/spf13/cobra"
7 | "github.com/spf13/viper"
8 | )
9 |
10 | // Config configures the logger.
11 | type Config struct {
12 | Level string `mapstructure:"level"`
13 | ForceTTY bool `mapstructure:"tty"`
14 | JSON bool `mapstructure:"json"`
15 | ShowLine bool `mapstructure:"line"`
16 | }
17 |
18 | // Validate configuration is ok.
19 | func (c *Config) Validate() error {
20 | _, err := zerolog.ParseLevel(c.Level)
21 | if err != nil {
22 | return errors.Wrap(err, "parse log level")
23 | }
24 |
25 | return nil
26 | }
27 |
28 | // ConfigFlags helps configure cobra and viper flags.
29 | func ConfigFlags(cmd *cobra.Command, prefix, defaultLevel string) error {
30 | if cmd == nil {
31 | return errors.New("command required")
32 | }
33 |
34 | if prefix == "" {
35 | return errors.New("prefix required")
36 | }
37 |
38 | if defaultLevel == "" {
39 | return errors.New("default level required")
40 | }
41 |
42 | viper.SetDefault(prefix, &Config{})
43 |
44 | flag := prefix + ".level"
45 | cmd.PersistentFlags().String(flag, defaultLevel, "Log level: trace, debug, info, warn, error, fatal or panic")
46 | viper.SetDefault(flag, defaultLevel)
47 |
48 | flag = prefix + ".tty"
49 | cmd.PersistentFlags().Bool(flag, false, "Force behavior of attached TTY (color, human output)")
50 | viper.SetDefault(flag, false)
51 |
52 | flag = prefix + ".json"
53 | cmd.PersistentFlags().Bool(flag, false, "Output JSON formatted logs (takes precedence over forcetty)")
54 | viper.SetDefault(flag, false)
55 |
56 | flag = prefix + ".line"
57 | cmd.PersistentFlags().Bool(flag, false, "Show file and line number of log call")
58 | viper.SetDefault(flag, false)
59 |
60 | return nil
61 | }
62 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/UnderConstruction.svelte:
--------------------------------------------------------------------------------
1 |
2 |
22 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/common/Loading.svelte:
--------------------------------------------------------------------------------
1 |
2 |
3 |
17 |
18 | Under Construction
19 |
20 |
21 |
3 |
58 |
59 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/classic/react/index.ts:
--------------------------------------------------------------------------------
1 | export { Attribute, Attributes } from "../../../shared/attributes";
2 | export type {
3 | AttributeChange,
4 | AttributeOptions,
5 | AttributeUpdate,
6 | } from "../../../shared/attributes";
7 | export type { Constructor } from "../../../shared/helpers";
8 | export type {
9 | Attributable,
10 | AttributeInput,
11 | ScopeConstructor,
12 | ScopeIdent,
13 | ScopeUpdate,
14 | Scope as SharedScope,
15 | } from "../../../shared/scopes";
16 | export type { Json, JsonArray, JsonValue } from "../../../utils/json";
17 | export type { ConsentProps } from "../../react/Consent";
18 | export type { PlayerCreateProps } from "../../react/PlayerCreate";
19 | export type { WithChildren } from "../../react/helpers";
20 | export { Scope, Scopes } from "../../scopes";
21 | export { Step, Steps } from "../../steps";
22 | export type { StepChange, StepTick, StepUpdate } from "../../steps";
23 | export {
24 | EmpiricaClassicKinds,
25 | Game,
26 | Player,
27 | PlayerGame,
28 | PlayerRound,
29 | PlayerStage,
30 | Round,
31 | Stage,
32 | } from "../classic";
33 | export type { Context } from "../classic";
34 | export { EmpiricaContext } from "./EmpiricaContext";
35 | export type { EmpiricaContextProps } from "./EmpiricaContext";
36 | export { Lobby } from "./Lobby";
37 | export { Quiz } from "./Quiz";
38 | export { Slider } from "./Slider";
39 | export type { SliderProps } from "./Slider";
40 | export type { StepsFunc, StepsProps } from "./Steps";
41 | export { Chat } from "./chat/Chat";
42 | export type { ChatProps } from "./chat/Chat";
43 | export { Sweeper } from "./examples/Sweeper";
44 | export {
45 | useGame,
46 | usePartModeCtx,
47 | usePartModeCtxKey,
48 | usePlayer,
49 | usePlayers,
50 | useRound,
51 | useStage,
52 | useStageTimer,
53 | } from "./hooks";
54 | import "./slider.css";
55 |
--------------------------------------------------------------------------------
/tests/stress/experiment/.empirica/treatments.yaml:
--------------------------------------------------------------------------------
1 | factors:
2 | - name: playerCount
3 | desc: playerCount determines the number of Players are in a Game.
4 | values:
5 | - value: 1
6 | - value: 2
7 | - value: 3
8 | - value: 5
9 | - value: 8
10 | - value: 10
11 | - value: 13
12 | - name: roundCount
13 | desc: Number of rounds in a game
14 | values:
15 | - value: 10
16 | - value: 50
17 | - value: 100
18 | - name: stageCount
19 | desc: Number of stages in a round
20 | values:
21 | - value: 1
22 | - value: 3
23 | - value: 9
24 | - name: newKeyRate
25 | desc: Rate at which new keys are generated (per second)
26 | values:
27 | - value: 0.25
28 | - value: 0.5
29 | - value: 1
30 | - value: 2
31 |
32 | treatments:
33 | - name: 100player
34 | desc: "100 Players"
35 | factors:
36 | playerCount: 100
37 | roundCount: 10
38 | stageCount: 3
39 | newKeyRate: 0.5
40 | - name: 40player
41 | desc: "40 Players"
42 | factors:
43 | playerCount: 40
44 | roundCount: 10
45 | stageCount: 3
46 | newKeyRate: 0.5
47 | - name: 20player
48 | desc: "20 Players"
49 | factors:
50 | playerCount: 20
51 | roundCount: 10
52 | stageCount: 3
53 | newKeyRate: 0.5
54 | - name: 10player
55 | desc: "10 Players"
56 | factors:
57 | playerCount: 10
58 | roundCount: 10
59 | stageCount: 3
60 | newKeyRate: 0.5
61 | - name: 2player
62 | desc: "2 players"
63 | factors:
64 | playerCount: 2
65 | roundCount: 10
66 | stageCount: 3
67 | newKeyRate: 0.5
68 | - name: solo
69 | desc: "1 player"
70 | factors:
71 | playerCount: 1
72 | roundCount: 1
73 | stageCount: 1
74 | newKeyRate: 0.5
75 |
--------------------------------------------------------------------------------
/lib/admin-ui/src/components/batches/CustomAssignment.svelte:
--------------------------------------------------------------------------------
1 |
19 |
20 |
34 |
54 |
35 |
53 |
36 |
37 |
50 | Must be valid JSON.
51 |
52 |
30 |
54 | );
55 | }
56 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/provider_test.ts:
--------------------------------------------------------------------------------
1 | import test from "ava";
2 | import {
3 | attrChange,
4 | partChange,
5 | scopeChange,
6 | setupProvider,
7 | stepChange,
8 | } from "../shared/test_helpers";
9 |
10 | test("TajribaProvider should split out scope, attribute and participant changes", (t) => {
11 | const { changes, provider } = setupProvider();
12 |
13 | let dones = 0;
14 | provider.dones.subscribe({
15 | next: () => {
16 | dones++;
17 | },
18 | });
19 |
20 | let attrs = [];
21 | provider.attributes.subscribe({
22 | next: (attr) => {
23 | attrs.push(attr);
24 | },
25 | });
26 |
27 | let parts = [];
28 | provider.participants.subscribe({
29 | next: (part) => {
30 | parts.push(part);
31 | },
32 | });
33 |
34 | let scopes = [];
35 | provider.scopes.subscribe({
36 | next: (scope) => {
37 | scopes.push(scope);
38 | },
39 | });
40 |
41 | let steps = [];
42 | provider.steps.subscribe({
43 | next: (step) => {
44 | steps.push(step);
45 | },
46 | });
47 |
48 | changes.next(partChange({ done: false, removed: false }));
49 | changes.next(
50 | attrChange({
51 | key: "a",
52 | val: "1",
53 | nodeID: "abc",
54 | done: false,
55 | removed: false,
56 | })
57 | );
58 | changes.next(
59 | attrChange({
60 | key: "a",
61 | val: "1",
62 | nodeID: "abc",
63 | done: true,
64 | removed: false,
65 | })
66 | );
67 | changes.next(stepChange({ done: false, removed: false }));
68 | changes.next(stepChange({ done: false, removed: false }));
69 | changes.next(stepChange({ done: false, removed: false }));
70 | changes.next(
71 | scopeChange({ id: "123", kind: "round", done: true, removed: false })
72 | );
73 |
74 | t.is(dones, 2);
75 | t.is(attrs.length, 2);
76 | t.is(parts.length, 1);
77 | t.is(scopes.length, 1);
78 | t.is(steps.length, 3);
79 | });
80 |
--------------------------------------------------------------------------------
/.changeset/README.md:
--------------------------------------------------------------------------------
1 | # Changesets
2 |
3 | Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
4 | with multi-package repos, or single-package repos to help you version and publish your code. You can
5 | find the full documentation for it [in our repository](https://github.com/changesets/changesets)
6 |
7 | We have a quick list of common questions to get you started engaging with this project in
8 | [our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
9 |
10 | Since we only have one package in this repo, we will only have one package in
11 | changesets.
12 |
13 | ```md
14 | ---
15 | "@empirica/core": minor
16 | ---
17 | ```
18 |
19 | ```md
20 | ---
21 | "@empirica/core": patch
22 | ---
23 | ```
24 |
25 | # Prereleases
26 |
27 | 1. Every time we want to make a pre-release, we create a names prerelease/...
28 | branch with the feature we want to release (for example,
29 | prerelease/engine-rewrite)
30 | 1. In the prerelease branch, we enter pre mode. Normally we want to set the npm
31 | tag to be next (npm run changeset pre enter next), but if we want to have
32 | concurrent tags, we can have them (npm run changeset pre enter other_tag)
33 | 1. We PR into the prerelease branch, and we merge to the prerelease branch.
34 | 1. Like with main, every time we merge to the prerelease branch, a Version
35 | Package PR will be created, that we can merge back a prerelease into the
36 | prerelease branch to publish the prerelease.
37 | 1. When the release branch is finished and ready to go into main, we exit pre
38 | mode (yarn changeset pre exit) and we create a PR from the release branch
39 | into main.
40 | 1. If we forget to exit pre mode, the "Check pre-release" workflow will catch it
41 | and generate an error. We should be aware of this error, as we don't
42 | currently have anything blocking us from merging a prerelease into main.
43 |
--------------------------------------------------------------------------------
/tests/stress/tests/intro.spec.js:
--------------------------------------------------------------------------------
1 | // @ts-check
2 | ///
31 |
53 |
32 |
45 |
46 |
47 |
52 | {title}
48 |
49 | {children}
50 |
51 |
15 |
64 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/player/scopes.ts:
--------------------------------------------------------------------------------
1 | import { Observable } from "rxjs";
2 | import { Attributes } from "../shared/attributes";
3 | import {
4 | Scope as SharedScope,
5 | ScopeConstructor,
6 | ScopeIdent,
7 | Scopes as SharedScopes,
8 | ScopeUpdate,
9 | } from "../shared/scopes";
10 | import { Steps } from "./steps";
11 |
12 | export class Scopes<
13 | Context,
14 | Kinds extends { [key: string]: ScopeConstructor
18 |
59 |
60 |
19 |
46 | 22 | {title} 23 |
24 |
27 | {#each labels as label}
28 |
45 |
29 |
38 |
39 | {label.title}
40 |
41 | {/each}
42 |
43 |
47 | {#each actions as action}
48 |
56 | {/each}
57 |
58 |
61 |
63 |
7 |
61 |
62 | );
63 | }
64 |
--------------------------------------------------------------------------------
/internal/export/csv.go:
--------------------------------------------------------------------------------
1 | package export
2 |
3 | import (
4 | "archive/zip"
5 | "encoding/csv"
6 | "os"
7 | "strings"
8 |
9 | "github.com/pkg/errors"
10 | "github.com/rs/zerolog/log"
11 | )
12 |
13 | const fileDefaultPerms = 0o644
14 |
15 | func ExportCSV(tajfile, filename string) error {
16 | kinds, err := prepare(tajfile)
17 | if err != nil {
18 | return errors.Wrap(err, "prepare export")
19 | }
20 |
21 | file, err := os.OpenFile(filename, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, fileDefaultPerms)
22 | if err != nil {
23 | return errors.Wrap(err, "open file")
24 | }
25 | defer file.Close()
26 |
27 | z := zip.NewWriter(file)
28 |
29 | for _, kind := range kinds {
30 | log.Info().
31 | Int("count", len(kind.Scopes)).
32 | Int("keys", len(kind.Keys)).
33 | Msgf("Exporting %s", kind.Name)
34 |
35 | zf, err := z.Create(camelCase(kind.Name) + ".csv")
36 | if err != nil {
37 | return errors.Wrap(err, "create file in zip")
38 | }
39 |
40 | w := csv.NewWriter(zf)
41 |
42 | fields := []string{"id"}
43 |
44 | for _, key := range kind.Keys {
45 | fields = append(fields, key, key+"LastChangedAt")
46 | }
47 |
48 | if err := w.Write(fields); err != nil {
49 | return errors.Wrap(err, "write csv")
50 | }
51 |
52 | for _, scope := range kind.Scopes {
53 | fields := []string{scope.ID}
54 |
55 | for _, key := range kind.Keys {
56 | attribute, ok := scope.Attributes[key]
57 | if !ok {
58 | fields = append(fields, "", "")
59 |
60 | continue
61 | }
62 |
63 | if attribute.IsVector {
64 | b := "[" + strings.Join(attribute.Values, ",") + "]"
65 |
66 | fields = append(fields, b)
67 | } else {
68 | fields = append(fields, attribute.Value)
69 | }
70 |
71 | fields = append(fields, attribute.Last)
72 | }
73 |
74 | if err := w.Write(fields); err != nil {
75 | return errors.Wrap(err, "write csv")
76 | }
77 | }
78 |
79 | w.Flush()
80 |
81 | if err := w.Error(); err != nil {
82 | return errors.Wrap(err, "write csv")
83 | }
84 | }
85 |
86 | if err := z.Close(); err != nil {
87 | return errors.Wrap(err, "close zip")
88 | }
89 |
90 | return nil
91 | }
92 |
--------------------------------------------------------------------------------
/cmds/empirica/cmd/version.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "fmt"
5 | "strings"
6 |
7 | "github.com/empiricaly/empirica/internal/build"
8 | "github.com/empiricaly/empirica/internal/experiment"
9 | jsoniter "github.com/json-iterator/go"
10 | "github.com/pkg/errors"
11 | "github.com/spf13/cobra"
12 | "github.com/spf13/viper"
13 | )
14 |
15 | var json = jsoniter.ConfigCompatibleWithStandardLibrary
16 |
17 | type simpleVersionOut struct {
18 | Build *build.Build `json:"build,omitempty" yaml:"build,omitempty"`
19 | Components []*experiment.SimpleComponent `json:"components,omitempty" yaml:"components,omitempty"`
20 | }
21 |
22 | func (s *simpleVersionOut) String() string {
23 | var b strings.Builder
24 | if s.Build != nil {
25 | b.WriteString(s.Build.String())
26 | }
27 |
28 | if len(s.Components) > 0 {
29 | if s.Build != nil {
30 | b.WriteString("\n")
31 | }
32 |
33 | for _, comp := range s.Components {
34 | b.WriteString(comp.String())
35 | b.WriteString("\n")
36 | }
37 | }
38 |
39 | return b.String()
40 | }
41 |
42 | func addVersionCommand(parent *cobra.Command) error {
43 | cmd := &cobra.Command{
44 | Use: "version",
45 | Short: "Print empirica version",
46 | SilenceUsage: true,
47 | SilenceErrors: true,
48 | Args: cobra.NoArgs,
49 | RunE: func(cmd *cobra.Command, _ []string) error {
50 | outputJSON, err := cmd.Flags().GetBool("json")
51 | if err != nil {
52 | return errors.Wrap(err, "parse json flag")
53 | }
54 |
55 | out := &simpleVersionOut{
56 | Build: build.Current(),
57 | Components: experiment.GetSimpleComponent(false),
58 | }
59 | if outputJSON {
60 | b, err := json.Marshal(out)
61 | if err != nil {
62 | return errors.Wrap(err, "serialize version info")
63 | }
64 |
65 | fmt.Println(string(b))
66 | } else {
67 | fmt.Print(out.String())
68 | }
69 |
70 | return nil
71 | },
72 | }
73 |
74 | cmd.Flags().Bool("json", false, "output as json")
75 |
76 | err := viper.BindPFlags(cmd.Flags())
77 | if err != nil {
78 | return errors.Wrap(err, "bind version flags")
79 | }
80 |
81 | parent.AddCommand(cmd)
82 |
83 | return nil
84 | }
85 |
--------------------------------------------------------------------------------
/lib/@empirica/core/src/shared/tajriba_connection.ts:
--------------------------------------------------------------------------------
1 | import { ParticipantIdent, Tajriba } from "@empirica/tajriba";
2 | import { BehaviorSubject } from "rxjs";
3 | import { error } from "../utils/console";
4 | import { bs } from "../utils/object";
5 |
6 | export const ErrNotConnected = new Error("not connected");
7 |
8 | export class TajribaConnection {
9 | readonly tajriba: Tajriba;
10 | private _connected = bs(false);
11 | private _connecting: BehaviorSubjectMissing attribute
;
58 | }
59 |
60 | // Are we already done
61 | if (obj.get(doneKey)) {
62 | return <>{children};
63 | }
64 |
65 | const index = (obj.get(progressKey) as number) || 0;
66 |
67 | const next = () => {
68 | if (index + 1 >= stps.length) {
69 | obj.set(doneKey, true);
70 | } else {
71 | obj.set(progressKey, index + 1);
72 | }
73 | };
74 |
75 | const previous = () => {
76 | if (index > 0) {
77 | obj.set(progressKey, index - 1);
78 | }
79 | };
80 |
81 | const Step = stps[index];
82 | if (!Step) {
83 | return <>;
84 | }
85 |
86 | return
23 |
69 | );
70 | }
71 |
--------------------------------------------------------------------------------
24 |
68 |