Compare commits

...

88 Commits

Author SHA1 Message Date
Nathan Schneider
13eb58a3ee Removed child org from parent children list 2022-08-26 15:59:38 -07:00
Nathan Schneider
ec0e4aa9c1 Small fix on policy_change variables 2022-08-23 17:11:00 -06:00
Nathan Schneider
b09a7a24b4 Improvement on error catching in process 2022-08-23 17:04:04 -06:00
Nathan Schneider
9d759530e6 Fixes on process logic 2022-08-23 16:55:57 -06:00
Nathan Schneider
838a017f14 Various bugfixes on defer and processes 2022-08-17 17:24:53 -06:00
Nathan Schneider
df20cc835b Small bugfixes 2022-08-17 15:39:11 -06:00
Nathan Schneider
0c13e6b084 Revert on CLI interactions pending process list 2022-08-17 15:09:12 -06:00
ntnsndr
d24262d494 small documentation fixes 2022-08-17 19:57:52 +00:00
23cf6abacd Merge branch 'bug-fixes' into 'master'
fixed process counter and a other small bugs

See merge request medlabboulder/modpol!37
2022-08-16 15:33:09 +00:00
Luke Miller
daa6d95bd6 merged changes, using standardized lazy table length function instead of for loop in interactions module 2022-08-16 11:12:07 -04:00
Luke Miller
52334f409e fixed process count, added lazy table length function, removed orgs now decrement org counter, orgs loaded message should now be accurate 2022-08-16 11:10:40 -04:00
56adaba7d6 Simplified README, reference to modpol.net 2022-08-16 04:49:40 +00:00
06e7bb9d2d Replaced image on README 2022-08-16 02:40:20 +00:00
Nathan Schneider
46dc48ffcc Fixed processes display in core except modules/display_processes.lua 2022-08-13 21:59:09 -06:00
Nathan Schneider
45347e2ac7 Merge branch 'master' of https://gitlab.com/medlabboulder/modpol 2022-08-13 17:02:58 -06:00
Nathan Schneider
1ff94b65fb Fixes on defer and remove_process 2022-08-13 17:02:30 -06:00
Nathan Schneider
4337e5511b Made approval on remove_process configurable 2022-08-13 16:34:03 -06:00
a26d2714d9 Merge branch 'remove-mkdir' into 'master'
Factored out Unix dependent os call

See merge request medlabboulder/modpol!36
2022-08-12 03:38:02 +00:00
Luke Miller
8d3428653c Merge branch 'master' of https://gitlab.com/medlabboulder/modpol 2022-08-11 14:57:42 -04:00
Luke Miller
6977614a7d Merge branch 'master' of https://gitlab.com/medlabboulder/modpol 2022-08-11 14:50:39 -04:00
Luke Miller
919194c995 added a placeholder file to keep data directory in git, removed now unnecessary unix mkdir call 2022-08-11 14:50:10 -04:00
Nathan Schneider
0532b084b7 Small correction on README 2022-08-11 10:49:03 -06:00
9b27ac145c Merge branch 'generic_approval' into 'master'
Major improvements on policy configuration

See merge request medlabboulder/modpol!35
2022-08-09 23:04:54 +00:00
Nathan Schneider
22a2048d5a Major improvements on policy configuration
- Bugfixes on change_policy
- Replaced _consent modules with configurable modules
2022-08-09 17:00:24 -06:00
Nathan Schneider
78ea89559f Simplier way of doing generic calls with call_module 2022-08-05 16:41:13 -06:00
Nathan Schneider
0ec287fa57 Reverting 2022-08-05 16:34:24 -06:00
Nathan Schneider
1f33232394 First shot at a generic approve() function for modules, testing on change_policy 2022-08-05 16:10:56 -06:00
Nathan Schneider
99c75861b0 small bugfix on display_processes 2022-05-25 12:30:59 -06:00
Nathan Schneider
26df04445d Small fix on CLI interactions on pending actions. 2022-05-25 12:19:34 -06:00
Nathan Schneider
2028f1ee85 Refactored policy structure
Previously, all modules in an org were fully copied into that
org. Now, the only copy of the modules is at modpol.modules, and orgs
have a policy table at [org].policies, which overrides the config
table in any given module.
2022-02-09 22:14:26 -07:00
Nathan Schneider
f950b5b94c More basic functionality for policy change
Created change_policy module (though it still does not have an
approval flow; improved display_policies and display_processes modules.
2022-02-06 22:04:07 -07:00
Nathan Schneider
9d4ad377e6 Created display_policies module to show existing module.config data across an org 2022-02-06 14:05:12 -07:00
Nathan Schneider
8086b18879 Removed org.policies table; policies are now handled in the org.modules[module].config table. 2022-02-06 13:45:31 -07:00
Nathan Schneider
b92272afa2 Added basic policy backend for modules. Also added confirmation in CLI to call a module. At that confirmation, the relevant policies are shown. Still need to create a module for changing policies and to add more configuration options to existing policies. 2022-02-05 23:49:23 -07:00
Nathan Schneider
fc8cd20e7f Updated screenshot for README 2022-01-28 14:29:29 -07:00
Nathan Schneider
509d2781f7 Created no-consent add_child_org module and a bugfix 2022-01-27 13:32:12 -07:00
cdb8e44099 Merge branch 'DocComments' into 'master'
Doc comments

See merge request medlabboulder/modpol!34
2022-01-24 03:38:12 +00:00
SkylarHew
79b548f9a0 Added LDoc comments for new files, ready to merge pt. 2 2022-01-23 18:21:23 -07:00
SkylarHew
e72911c67c Added LDoc comments for new files, ready to merge 2022-01-23 18:19:24 -07:00
SkylarHew
7cb200ab04 Resolved merge conflicts with master 2022-01-23 16:01:44 -07:00
Nathan Schneider
55d1c2c446 Updated documentation section of README 2022-01-22 11:34:25 -07:00
Nathan Schneider
807ef6a150 Slight tweaks to ldoc docs 2022-01-22 11:28:38 -07:00
SkylarHew
c8e911640e Edited README to include section on Documentation 2022-01-20 11:42:19 -07:00
SkylarHew
da7b996a8b Added ldoc comments for all lua modules and generated docs in documentation index.html 2022-01-20 11:04:44 -07:00
SkylarHew
5085d87f68 Added Ldoc comments for interactions and orgs.process.lua 2022-01-10 17:27:27 -07:00
SkylarHew
4052fa4b55 Ldoc comments for orgs.base and edited comments for template_module 2022-01-09 22:15:54 -07:00
ba65b471b3 Merge branch 'process-delete' into 'master'
Process delete

See merge request medlabboulder/modpol!33
2022-01-07 21:24:58 +00:00
Luke Miller
0f479da5ff calling self:call_module instead of self.org:call_module, this should fix process deletion issues 2022-01-07 15:05:45 -05:00
Luke Miller
a835799e11 added delete process tree function, updated remove process module 2022-01-06 20:17:38 -05:00
Nathan Schneider
65bb1aa532 Added failsafes to interactions against 'deleted' processes 2022-01-06 09:58:15 -07:00
bdf4d86593 Removing a possibly unnecessary table copy on remove_process 2022-01-05 23:28:15 +00:00
81fcd9e3c1 Merge branch 'module-changes' into 'master'
added parent/children ids to processes, modified delete process to be...

See merge request medlabboulder/modpol!32
2022-01-05 23:15:38 +00:00
Luke Miller
5788ce199a added parent/children ids to processes, modified delete process to be recursive, modules now have access to self:call_module 2022-01-05 18:10:38 -05:00
544edddb21 Small bugfixes on testing 2022-01-05 22:40:41 +00:00
Nathan Schneider
2989bd34bd Completed checkbox_query and rewrite of change_modules module with checkboxes 2022-01-02 23:13:56 -07:00
Nathan Schneider
28a05c584c Minetest checkbox_query now working; checkbox-based change_modules module still needs debugging 2022-01-01 23:54:57 -07:00
Nathan Schneider
c8d527dba8 Have basic checkbox_query working in CLI core interactions, not yet attempted in Minetest 2021-12-31 00:50:32 -07:00
Nathan Schneider
62d4c0518f Edits to README for readability 2021-12-30 11:38:43 -07:00
Nathan Schneider
1a6f27f2f6 More bugfixes on displays and interactions, mainly fixing damage done two commits ago 2021-12-29 22:25:28 -07:00
Nathan Schneider
6c9353d389 Last commit also changed titles on Minetest dashboards to much more flexible [hypertext] 2021-12-29 22:10:57 -07:00
Nathan Schneider
7ef0626357 Added modpol.interactions.display and display_processes module, as well as a bunch of bugfixes 2021-12-29 22:07:53 -07:00
Luke Miller
5a2e6277e5 added a module version of call_module which automatically handles parent ids in the backend 2021-12-29 21:10:00 -05:00
Nathan Schneider
6558b7a026 Created remove_process module---mostly works, but there are still some issues with processes and pending actions not being removed properly 2021-12-28 16:51:12 -07:00
Nathan Schneider
1b0335c069 Bugfix on copy_table and added refresh command to CLI 2021-12-28 14:39:34 -07:00
Nathan Schneider
18a29d674c Added user_dashboard and message_user to modpol_minetest 2021-12-27 23:13:10 -07:00
Nathan Schneider
de8ad25b2f Added user_dashboard and message_user in modpol_core, still have to add to modpol_minetest 2021-12-27 22:34:22 -07:00
Nathan Schneider
286d131839 Got first token modules working, and a bunch of bugfixes throughout 2021-12-26 23:03:57 -07:00
Nathan Schneider
0c59767ef7 Filled out tokenomics functions; still not tested 2021-12-26 00:01:59 -07:00
Nathan Schneider
12a49ab66d Added record() function to tokenomics module functions 2021-12-25 18:14:38 -07:00
Nathan Schneider
c017b80063 Added recording of main process events to persistent storage 2021-12-25 18:01:37 -07:00
Nathan Schneider
6d81bd7bd8 Started working on tokenomics module (but not yet activated) 2021-12-23 22:25:51 -07:00
Nathan Schneider
44c3e41b81 Created defer_consent module 2021-12-22 22:22:17 -07:00
Nathan Schneider
fa50a59938 Added randomizer utility module 2021-12-22 16:28:28 -07:00
Nathan Schneider
9a2c72c6a1 Bugfixes after test with Skylar! 2021-12-21 18:12:59 -07:00
956f9a2635 Update misc.lua to initialize the modpol.util table 2021-12-21 23:45:25 +00:00
Nathan Schneider
1e81b830c4 Fix on the mod.conf before submission to ContentDB 2021-12-21 15:38:57 -07:00
db57313165 Update README.md with some additional details about changing modules 2021-12-21 05:17:35 +00:00
Nathan Schneider
cfef9b29b0 Bugfixes on CLI interactions 2021-12-20 21:28:54 -07:00
Nathan Schneider
fe2d5fdb2a Added message_org module 2021-12-20 20:34:11 -07:00
Nathan Schneider
75f3a80d31 Changed name back to Modpol from Modular Politics 2021-12-20 20:14:43 -07:00
Nathan Schneider
645cc6f690 Changed Minetest module listing to remove slugs, retain only names 2021-12-20 20:06:17 -07:00
Nathan Schneider
b9317490fb Added section on gameplay usage in README 2021-12-20 19:58:57 -07:00
Nathan Schneider
85e9916e27 Added pending actions list to main dashboard 2021-12-20 19:45:30 -07:00
Nathan Schneider
18d63485c2 Fixed interaction glitch on privs_to_org 2021-12-20 19:05:03 -07:00
Nathan Schneider
046fad7f57 Added refresh button to Minetest dashboards 2021-12-20 18:55:08 -07:00
6aa09f9fdd Merge branch 'modules-as-actions' into 'master'
Merge modules-as-action refactor to main!

See merge request medlabboulder/modpol!31
2021-12-20 06:27:42 +00:00
efd363daef Merge branch 'master' into 'modules-as-actions'
# Conflicts:
#   LICENSE
2021-12-20 06:27:01 +00:00
51ed8d41e2 Update LICENSE 2021-11-29 23:42:44 +00:00
72 changed files with 7781 additions and 703 deletions

3
.gitignore vendored
View File

@ -1 +1,2 @@
*/data */data/*
!*/data/placeholder

View File

@ -1,38 +1,25 @@
# Modular Politics for Minetest # Modpol for Minetest
Modular Politics is an extension that enables diverse governance processes on multi-user platforms. It offers a library that enables users to create or adapt their own modules that add specific governance functionalities. ![](lib/empire-modpol.png)
This implementation is a mod for [Minetest](https://minetest.net), a free/open-source voxel game. It is designed to be easily adapted to other multi-user platforms that also employ Lua as an extension language. Modpol, short for "modular politics," enables diverse governance processes on multi-user platforms. It offers a library with which users can choose, modify, and create modules that add specific governance functionalities.
## Design philosophy This implementation is a mod for [Minetest](https://minetest.net), a free/open-source voxel game. It is designed to be adapted to other multi-user platforms that also employ Lua as an extension language.
Modular Politics seeks to implement a theoretical framework, also called "[modular politics](https://metagov.org/modpol)," which proposes these design goals: **Learn more at [modpol.net](https://modpol.net).**
* *Modularity*: Platform operators and community members should have the ability to construct systems by creating, importing, and arranging composable parts together as a coherent whole.
* *Expressiveness*: The governance layer should be able to implement as wide a range of processes as possible.
* *Portability*: Governance tools developed for one platform should be portable to another platform for reuse and adaptation.
* *Interoperability*: Governance systems operating on different platforms and protocols should have the ability to interact with each other, sharing data and influencing each other's processes.
Additionally, Modular Politics seeks to counteract the tendency for "[implicit feudalism](https://ntnsndr.in/ImplicitFeudalism)," according to which rigid, top-down power structures are the norm in online spaces. To this end, some design patterns include:
* *Groups, not roles*: While most platforms assign powers through particular permissions given to individuals, in Modular Politics, power lies in groups (which Modular Politics calls "orgs").
* *Consent, not oligarchy*: Rather than assuming that decisions will be made by a few power-holders, the software assumes that consent by all affected users is the norm.
* *Inheritance, not blank slates*: When a new group is formed, it inherits the patterns of what preceded it, rather than imagining that it is starting from scratch.
It is certainly possible to use Modular Politics to replicate practices of implicit feudalism, such as all-powerful admins, but doing so requires extra work to overcome these defaults.
## Installation in Minetest ## Installation in Minetest
To use this in Minetest, simply install it in your `mods/` or `worldmods/` folder. Minetest will load `init.lua`. To use this in Minetest, simply install it in your `mods/` or `worldmods/` folder. Minetest will load `init.lua`.
In the game, open the Modular Politics dashboard with the command `/mp`. In the game, open the Modpol dashboard with the command `/mp`.
For testing purposes, players with the `privs` privilege (generally admins) can use the `/mp` command, which resets all the orgs and opens a dashboard. For testing purposes, players with the `privs` privilege (generally admins) can use the `/mptest` command, which resets all the orgs and opens a dashboard.\
## Standalone Version on the Command Line ## Standalone Version on the Command Line
Modular Politics can also be used independently of Minetest as a command-line tool. Currently command-line use of modpol requires a Unix-style system, but it is intended to become more fully platform independent. Modpol can also be used independently of Minetest as a command-line tool. Currently command-line use of modpol requires a Unix-style system, but it is intended to become more fully platform independent.
The command-line version is in the `modpol` subdirectory. To run the program on Unix systems in CLI mode, install lua or luajit and execute the following in this directory: The command-line version is in the `modpol` subdirectory. To run the program on Unix systems in CLI mode, install lua or luajit and execute the following in this directory:
@ -40,21 +27,32 @@ The command-line version is in the `modpol` subdirectory. To run the program on
$ lua[jit] login.lua $ lua[jit] login.lua
``` ```
You can also interact with the interpreter by starting it this way: Alternatively, to test arbitrary functions in the interpreter outside of the interactive dashboards, load Modpol's library with:
``` ```
$ lua[jit] $ lua[jit]
> dofile("login.lua") > dofile("modpol_core/modpol.lua")
``` ```
In the interpreter, for a list of global functions and tables, use `modpol.menu()`. In the interpreter, for a list of global functions and tables, use `modpol.menu()`.
## Storage ## Storage
By default, a data directory named "data" will be created in this directory. `/data` will contain a log file and serialized program data files. The persistent storage method may be chosen in `modpol.lua`. If available, Modpol uses Minetest's built-in StorageRef system for Minetest 5.*. If that is not available, or in CLI mode, data will be stored in a data directory at `modpol_core/data/`. This will contain a log file and serialized program data files.
Another storage method may be chosen in `modpol.lua`. A StorageRef-based method for Minetest 5.* is included: `storage-mod_storage.lua`.
## Documentation
Various guides are available at the [GitLab wiki](https://gitlab.com/medlabboulder/modpol/-/wikis/home).
Read documentation of functions and modules at `docs/doc/index.html`. Documentation was generated using [LDoc](https://stevedonovan.github.io/ldoc/). To generate basic documentation for every page, download `ldoc` and use the following command:
```
$ cd docs/
$ ldoc ..
```
This will not generate the same index page and sidebar as the documentation provided; the appropriate structure needs to be added manually.
## Credits ## Credits
@ -72,7 +70,7 @@ We are grateful for initial support for this project from a residency with [The
## Contributing ## Contributing
We'd love to welcome more contributors. Please join the conversation in the [Issues](https://gitlab.com/medlabboulder/modpol/-/issues), our [Matrix.org channel](https://matrix.to/#/#minetest-modpol:matrix.org), and the [Minetest.net forum](https://forum.minetest.net/viewtopic.php?f=47&t=26037). We'd love to welcome more contributors. Please join the conversation in the [Issues](https://gitlab.com/medlabboulder/modpol/-/issues), the \#modpol channel at the [Metagovernance Project](https://metagov.org) Slack, and the [Minetest.net forum](https://forum.minetest.net/viewtopic.php?f=47&t=26037).
Learn more about the project and how to develop your own modules in [the wiki](https://gitlab.com/medlabboulder/modpol/-/wikis/home). Learn more about the project and how to develop your own modules in [the wiki](https://gitlab.com/medlabboulder/modpol/-/wikis/home).

2
docs/config.ld Normal file
View File

@ -0,0 +1,2 @@
project = 'Modpol'
description = 'modpol core'

201
docs/doc/index.html Normal file
View File

@ -0,0 +1,201 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="modules/change_modules.html">change_modules</a></li>
<li><a href="modules/change_modules.html">change_modules</a></li>
<li><a href="modules/consent.html">consent</a></li>
<li><a href="modules/create_token.html">create_token</a></li>
<li><a href="modules/defer_consent.html">defer_consent</a></li>
<li><a href="modules/display_processes.html">display_processes</a></li>
<li><a href="modules/join_org.html">join_org</a></li>
<li><a href="modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="modules/leave_org.html">leave_org</a></li>
<li><a href="modules/message_org.html">message_org</a></li>
<li><a href="modules/randomizer.html">randomizer</a></li>
<li><a href="modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="modules/remove_org.html">remove_org</a></li>
<li><a href="modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="modules/remove_process.html">remove_process</a></li>
<li><a href="modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="modules/send_token.html">send_token</a></li>
<li><a href="modules/module_template.html">module_template</a></li>
<li><a href="modules/tokenomics.html">tokenomics</a></li>
<li><a href="modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h2>modpol core</h2>
<h2>Modules</h2>
<table class="module_list">
<tr>
<td class="name" nowrap><a href="modules/modpol.interactions.html">modpol.interactions</a></td>
<td class="summary">INTERACTIONS.LUA (CLI).</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/add_child_org_consent.html">add_child_org_consent</a></td>
<td class="summary">Adds a child org.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/change_modules.html">change_modules</a></td>
<td class="summary">change_modules</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/change_modules.html">change_modules</a></td>
<td class="summary">change_modules
Depends on consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/consent.html">consent</a></td>
<td class="summary">A utility module for checking consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/create_token.html">create_token</a></td>
<td class="summary">Create token.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/defer_consent.html">defer_consent</a></td>
<td class="summary">Defer consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/display_processes.html">display_processes</a></td>
<td class="summary">Display processes</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/join_org.html">join_org</a></td>
<td class="summary">Adds a user to org</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/join_org_consent.html">join_org_consent</a></td>
<td class="summary">Join org (consent).</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/leave_org.html">leave_org</a></td>
<td class="summary">Removes initiator from org</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/message_org.html">message_org</a></td>
<td class="summary">Messages all org members</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/randomizer.html">randomizer</a></td>
<td class="summary">A utility module that outputs a random result from a set of options</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/remove_child_consent.html">remove_child_consent</a></td>
<td class="summary">Remove child (consent).</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/remove_member_consent.html">remove_member_consent</a></td>
<td class="summary">Calls consent to remove member from org</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/remove_org.html">remove_org</a></td>
<td class="summary">A simple module that removes an org.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/remove_org_consent.html">remove_org_consent</a></td>
<td class="summary">Remove org (consent)
A simple module that calls a consent process on an org to remove it.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/remove_process.html">remove_process</a></td>
<td class="summary">Remove a process</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/rename_org_consent.html">rename_org_consent</a></td>
<td class="summary">Rename org (consent)
A simple module that calls a consent process on an org to rename it.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/send_token.html">send_token</a></td>
<td class="summary">Send token.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/module_template.html">module_template</a></td>
<td class="summary">Template for module writers.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/tokenomics.html">tokenomics</a></td>
<td class="summary">Tokenomics.</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/modpol.orgs.base.html">modpol.orgs.base</a></td>
<td class="summary">Basic function for orgs</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/modpol.orgs.process.html">modpol.orgs.process</a></td>
<td class="summary">Process functions for orgs</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/modpol.util.misc.html">modpol.util.misc</a></td>
<td class="summary">Miscellaneous functions</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/modpol_minetest.api.html">modpol_minetest.api</a></td>
<td class="summary">Script for loading Minetest files</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/priv_to_org.html">priv_to_org</a></td>
<td class="summary">Set privilege to org members
Allows initiator to grant a priv they have to all members of an org</td>
</tr>
<tr>
<td class="name" nowrap><a href="modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></td>
<td class="summary">INTERACTIONS.LUA (for Minetest)
CONTEXTUAL STUFF
================</td>
</tr>
</table>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

303
docs/doc/ldoc.css Normal file
View File

@ -0,0 +1,303 @@
/* BEGIN RESET
Copyright (c) 2010, Yahoo! Inc. All rights reserved.
Code licensed under the BSD License:
http://developer.yahoo.com/yui/license.html
version: 2.8.2r1
*/
html {
color: #000;
background: #FFF;
}
body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,code,form,fieldset,legend,input,button,textarea,p,blockquote,th,td {
margin: 0;
padding: 0;
}
table {
border-collapse: collapse;
border-spacing: 0;
}
fieldset,img {
border: 0;
}
address,caption,cite,code,dfn,em,strong,th,var,optgroup {
font-style: inherit;
font-weight: inherit;
}
del,ins {
text-decoration: none;
}
li {
margin-left: 20px;
}
caption,th {
text-align: left;
}
h1,h2,h3,h4,h5,h6 {
font-size: 100%;
font-weight: bold;
}
q:before,q:after {
content: '';
}
abbr,acronym {
border: 0;
font-variant: normal;
}
sup {
vertical-align: baseline;
}
sub {
vertical-align: baseline;
}
legend {
color: #000;
}
input,button,textarea,select,optgroup,option {
font-family: inherit;
font-size: inherit;
font-style: inherit;
font-weight: inherit;
}
input,button,textarea,select {*font-size:100%;
}
/* END RESET */
body {
margin-left: 1em;
margin-right: 1em;
font-family: arial, helvetica, geneva, sans-serif;
background-color: #ffffff; margin: 0px;
}
code, tt { font-family: monospace; font-size: 1.1em; }
span.parameter { font-family:monospace; }
span.parameter:after { content:":"; }
span.types:before { content:"("; }
span.types:after { content:")"; }
.type { font-weight: bold; font-style:italic }
body, p, td, th { font-size: .95em; line-height: 1.2em;}
p, ul { margin: 10px 0 0 0px;}
strong { font-weight: bold;}
em { font-style: italic;}
h1 {
font-size: 1.5em;
margin: 20px 0 20px 0;
}
h2, h3, h4 { margin: 15px 0 10px 0; }
h2 { font-size: 1.25em; }
h3 { font-size: 1.15em; }
h4 { font-size: 1.06em; }
a:link { font-weight: bold; color: #004080; text-decoration: none; }
a:visited { font-weight: bold; color: #006699; text-decoration: none; }
a:link:hover { text-decoration: underline; }
hr {
color:#cccccc;
background: #00007f;
height: 1px;
}
blockquote { margin-left: 3em; }
ul { list-style-type: disc; }
p.name {
font-family: "Andale Mono", monospace;
padding-top: 1em;
}
pre {
background-color: rgb(245, 245, 245);
border: 1px solid #C0C0C0; /* silver */
padding: 10px;
margin: 10px 0 10px 0;
overflow: auto;
font-family: "Andale Mono", monospace;
}
pre.example {
font-size: .85em;
}
table.index { border: 1px #00007f; }
table.index td { text-align: left; vertical-align: top; }
#container {
margin-left: 1em;
margin-right: 1em;
background-color: #f0f0f0;
}
#product {
text-align: center;
border-bottom: 1px solid #cccccc;
background-color: #ffffff;
}
#product big {
font-size: 2em;
}
#main {
background-color: #f0f0f0;
border-left: 2px solid #cccccc;
}
#navigation {
float: left;
width: 14em;
vertical-align: top;
background-color: #f0f0f0;
overflow: visible;
}
#navigation h2 {
background-color:#e7e7e7;
font-size:1.1em;
color:#000000;
text-align: left;
padding:0.2em;
border-top:1px solid #dddddd;
border-bottom:1px solid #dddddd;
}
#navigation ul
{
font-size:1em;
list-style-type: none;
margin: 1px 1px 10px 1px;
}
#navigation li {
text-indent: -1em;
display: block;
margin: 3px 0px 0px 22px;
}
#navigation li li a {
margin: 0px 3px 0px -1em;
}
#content {
margin-left: 14em;
padding: 1em;
width: 700px;
border-left: 2px solid #cccccc;
border-right: 2px solid #cccccc;
background-color: #ffffff;
}
#about {
clear: both;
padding: 5px;
border-top: 2px solid #cccccc;
background-color: #ffffff;
}
@media print {
body {
font: 12pt "Times New Roman", "TimeNR", Times, serif;
}
a { font-weight: bold; color: #004080; text-decoration: underline; }
#main {
background-color: #ffffff;
border-left: 0px;
}
#container {
margin-left: 2%;
margin-right: 2%;
background-color: #ffffff;
}
#content {
padding: 1em;
background-color: #ffffff;
}
#navigation {
display: none;
}
pre.example {
font-family: "Andale Mono", monospace;
font-size: 10pt;
page-break-inside: avoid;
}
}
table.module_list {
border-width: 1px;
border-style: solid;
border-color: #cccccc;
border-collapse: collapse;
}
table.module_list td {
border-width: 1px;
padding: 3px;
border-style: solid;
border-color: #cccccc;
}
table.module_list td.name { background-color: #f0f0f0; min-width: 200px; }
table.module_list td.summary { width: 100%; }
table.function_list {
border-width: 1px;
border-style: solid;
border-color: #cccccc;
border-collapse: collapse;
}
table.function_list td {
border-width: 1px;
padding: 3px;
border-style: solid;
border-color: #cccccc;
}
table.function_list td.name { background-color: #f0f0f0; min-width: 200px; }
table.function_list td.summary { width: 100%; }
ul.nowrap {
overflow:auto;
white-space:nowrap;
}
dl.table dt, dl.function dt {border-top: 1px solid #ccc; padding-top: 1em;}
dl.table dd, dl.function dd {padding-bottom: 1em; margin: 10px 0 0 20px;}
dl.table h3, dl.function h3 {font-size: .95em;}
/* stop sublists from having initial vertical space */
ul ul { margin-top: 0px; }
ol ul { margin-top: 0px; }
ol ol { margin-top: 0px; }
ul ol { margin-top: 0px; }
/* make the target distinct; helps when we're navigating to a function */
a:target + * {
background-color: #FF9;
}
/* styles for prettification of source */
pre .comment { color: #558817; }
pre .constant { color: #a8660d; }
pre .escape { color: #844631; }
pre .keyword { color: #aa5050; font-weight: bold; }
pre .library { color: #0e7c6b; }
pre .marker { color: #512b1e; background: #fedc56; font-weight: bold; }
pre .string { color: #8080ff; }
pre .number { color: #f8660d; }
pre .operator { color: #2239a8; font-weight: bold; }
pre .preprocessor, pre .prepro { color: #a33243; }
pre .global { color: #800080; }
pre .user-keyword { color: #800080; }
pre .prompt { color: #558817; }
pre .url { color: #272fc2; text-decoration: underline; }

View File

@ -0,0 +1,145 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><strong>add_child_org_consent</strong></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>add_child_org_consent</code></h1>
<p>Adds a child org.</p>
<p>
Depends on `consent`</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate consent for new child org</td>
</tr>
<tr>
<td class="name" nowrap><a href="#create_child_org">create_child_org ()</a></td>
<td class="summary">Create a new child orgg</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate consent for new child org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "create_child_org"></a>
<strong>create_child_org ()</strong>
</dt>
<dd>
Create a new child orgg
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,128 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><strong>change_modules</strong></li>
<li><strong>change_modules</strong></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>change_modules</code></h1>
<p>change_modules
Depends on consent</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate change in modules.</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate change in modules.
Either adds or removes module depending on user input
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,150 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><strong>consent</strong></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>consent</code></h1>
<p>A utility module for checking consent</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="#callback">callback (member)</a></td>
<td class="summary">Callback</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate consent
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "callback"></a>
<strong>callback (member)</strong>
</dt>
<dd>
Callback
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">member</span>
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,127 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><strong>create_token</strong></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>create_token</code></h1>
<p>Create token.</p>
<p>
Depends on tokenomics</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#create_toke:initiate">create_toke:initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "create_toke:initiate"></a>
<strong>create_toke:initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,190 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
<li><a href="#Tables">Tables</a></li>
<li><a href="#Fields">Fields</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><strong>defer_consent</strong></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>defer_consent</code></h1>
<p>Defer consent</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
</table>
<h2><a href="#Tables">Tables</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#config">config</a></td>
<td class="summary">Config for module</td>
</tr>
</table>
<h2><a href="#Fields">Fields</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.modules.defer_consent">modpol.modules.defer_consent</a></td>
<td class="summary">(Required) Add to module table</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Tables"></a>Tables</h2>
<dl class="function">
<dt>
<a name = "config"></a>
<strong>config</strong>
</dt>
<dd>
Config for module
<h3>Fields:</h3>
<ul>
<li><span class="parameter">defer_org</span>
Name or ID of target org
</li>
<li><span class="parameter">votes_required</span>
Threshold passed on to `consent`
</li>
<li><span class="parameter">prompt</span>
String passed on to `consent`
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Fields"></a>Fields</h2>
<dl class="function">
<dt>
<a name = "modpol.modules.defer_consent"></a>
<strong>modpol.modules.defer_consent</strong>
</dt>
<dd>
(Required) Add to module table
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><strong>display_processes</strong></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>display_processes</code></h1>
<p>Display processes</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><strong>join_org</strong></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>join_org</code></h1>
<p>Adds a user to org</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Adds the user to the org</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Adds the user to the org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,146 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><strong>join_org_consent</strong></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>join_org_consent</code></h1>
<p>Join org (consent).</p>
<p>
A simple module that calls a consent process on an org to add a member.
Depends on the Consent module.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate join org with consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="#complete">complete ()</a></td>
<td class="summary">Adds member to org, notifies org, and deletes process</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate join org with consent
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "complete"></a>
<strong>complete ()</strong>
</dt>
<dd>
Adds member to org, notifies org, and deletes process
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><strong>leave_org</strong></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>leave_org</code></h1>
<p>Removes initiator from org</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Removes user from org</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Removes user from org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><strong>message_org</strong></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>message_org</code></h1>
<p>Messages all org members</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Allows user to send input message to all org members</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Allows user to send input message to all org members
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,434 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><strong>modpol.interactions</strong></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol.interactions</code></h1>
<p>INTERACTIONS.LUA (CLI).</p>
<p>
User interaction functions for Modular Politics
Called by modpol.lua</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.interactions.dashboard">modpol.interactions.dashboard (user)</a></td>
<td class="summary">Output: Display a menu of commands to the user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.org_dashboard">modpol.interactions.org_dashboard (user, org_string)</a></td>
<td class="summary">Output: Displays a menu of org-specific commands to the user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.user_dashboard">modpol.interactions.user_dashboard (viewer, user, completion)</a></td>
<td class="summary">Function: modpol.interactions.user_dashboard
Displays a dashboard about a particular user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.message">modpol.interactions.message (user, message)</a></td>
<td class="summary">Prints message to CLI.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.message_user">modpol.interactions.message_user (sender, recipient)</a></td>
<td class="summary">Gets and sends a message from one user to another</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.display">modpol.interactions.display (user, title, message, done)</a></td>
<td class="summary">Displays complex data to a user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.text_query">modpol.interactions.text_query (User, Query, func)</a></td>
<td class="summary">Applies "func" to user input.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.dropdown_query">modpol.interactions.dropdown_query (user, label, options, func)</a></td>
<td class="summary">Output: Calls func on choice.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.checkbox_query">modpol.interactions.checkbox_query (user, label, options, func)</a></td>
<td class="summary">Allows user to select from a set of options</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.binary_poll_user">modpol.interactions.binary_poll_user (user, question, func)</a></td>
<td class="summary">Output: Applies "func" to user input.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.interactions.message_org">modpol.interactions.message_org (initiator, org, message)</a></td>
<td class="summary">Output: broadcasts message to all org members</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "modpol.interactions.dashboard"></a>
<strong>modpol.interactions.dashboard (user)</strong>
</dt>
<dd>
Output: Display a menu of commands to the user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
(string)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.org_dashboard"></a>
<strong>modpol.interactions.org_dashboard (user, org_string)</strong>
</dt>
<dd>
Output: Displays a menu of org-specific commands to the user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
(string)
</li>
<li><span class="parameter">org_string</span>
(string or id)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.user_dashboard"></a>
<strong>modpol.interactions.user_dashboard (viewer, user, completion)</strong>
</dt>
<dd>
Function: modpol.interactions.user_dashboard
Displays a dashboard about a particular user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">viewer</span>
Name of user viewing the dashboard (string)
</li>
<li><span class="parameter">user</span>
Name of user being viewed (string)
</li>
<li><span class="parameter">completion</span>
Optional function to call on Done button
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.message"></a>
<strong>modpol.interactions.message (user, message)</strong>
</dt>
<dd>
Prints message to CLI.
Buttons: message, done
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
(string)
</li>
<li><span class="parameter">message</span>
(string)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.message_user"></a>
<strong>modpol.interactions.message_user (sender, recipient)</strong>
</dt>
<dd>
Gets and sends a message from one user to another
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">sender</span>
Name of user sending (string)
</li>
<li><span class="parameter">recipient</span>
Name of user receiving (string)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.display"></a>
<strong>modpol.interactions.display (user, title, message, done)</strong>
</dt>
<dd>
Displays complex data to a user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
Name of target user (string)
</li>
<li><span class="parameter">title</span>
Title of display (string)
</li>
<li><span class="parameter">message</span>
Content of message (string or table of strings)
</li>
<li><span class="parameter">done</span>
Optional function for what happens when user is done
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.text_query"></a>
<strong>modpol.interactions.text_query (User, Query, func)</strong>
</dt>
<dd>
Applies "func" to user input.
Func input: user input (string)
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">User</span>
(string)
</li>
<li><span class="parameter">Query</span>
(string)
</li>
<li><span class="parameter">func</span>
(function)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.dropdown_query"></a>
<strong>modpol.interactions.dropdown_query (user, label, options, func)</strong>
</dt>
<dd>
Output: Calls func on choice.
Func input: choice (string)
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
(string)
</li>
<li><span class="parameter">label</span>
(string)
</li>
<li><span class="parameter">options</span>
(table of strings)
</li>
<li><span class="parameter">func</span>
(choice) (function)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.checkbox_query"></a>
<strong>modpol.interactions.checkbox_query (user, label, options, func)</strong>
</dt>
<dd>
Allows user to select from a set of options
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
Name of user (string)
</li>
<li><span class="parameter">label</span>
Query for user before options (string)
</li>
<li><span class="parameter">options</span>
Table of options and their checked status in the form {{"option_1_string", true}, {"option_2_string", false}}
</li>
<li><span class="parameter">func</span>
Function to be called with param "input", made up of the corrected table in the same format as the param options
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.binary_poll_user"></a>
<strong>modpol.interactions.binary_poll_user (user, question, func)</strong>
</dt>
<dd>
Output: Applies "func" to user input.
Func input: user input (string: y/n)
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
(string)
</li>
<li><span class="parameter">question</span>
(string)
</li>
<li><span class="parameter">func</span>
(function)
</li>
</ul>
</dd>
<dt>
<a name = "modpol.interactions.message_org"></a>
<strong>modpol.interactions.message_org (initiator, org, message)</strong>
</dt>
<dd>
Output: broadcasts message to all org members
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">initiator</span>
(string)
</li>
<li><span class="parameter">org</span>
(number or string)
</li>
<li><span class="parameter">message</span>
(string)
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,476 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><strong>modpol.orgs.base</strong></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol.orgs.base</code></h1>
<p>Basic function for orgs</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.orgs.get_org">modpol.orgs.get_org (arg)</a></td>
<td class="summary">Return org when given its id or name</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.list_all">modpol.orgs.list_all ()</a></td>
<td class="summary">Return a table list of all org names</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.user_orgs">modpol.orgs.user_orgs (user)</a></td>
<td class="summary">Return the orgs of a user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.reset">modpol.orgs.reset ()</a></td>
<td class="summary">Deletes all orgs except for the</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.init_instance">modpol.orgs.init_instance ()</a></td>
<td class="summary">Initializes the instance (root org)
can only be run once, as only one instance can exist</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:record">modpol.orgs:record ()</a></td>
<td class="summary">Records a log message to the modpol ledger</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:add_org">modpol.orgs:add_org (name, user)</a></td>
<td class="summary">Adds a new sub org to the org it is called on.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:delete">modpol.orgs:delete ()</a></td>
<td class="summary">Recursively deletes an org and its suborgs
Leaves entry in modpol.orgs.array as a string "removed".</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:get_member_index">modpol.orgs:get_member_index (member)</a></td>
<td class="summary">Internal function to get the index of a member name</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:add_member">modpol.orgs:add_member (user)</a></td>
<td class="summary">Adds a user to an org</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:remove_member">modpol.orgs:remove_member (user)</a></td>
<td class="summary">Removes a user from an org</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:has_member">modpol.orgs:has_member (user)</a></td>
<td class="summary">Boolean check whether user is an org</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:list_members">modpol.orgs:list_members ()</a></td>
<td class="summary"></td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:get_member_count">modpol.orgs:get_member_count ()</a></td>
<td class="summary">Because member list uses lazy deletion, using #org.members will not show an accurate number</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:set_policy">modpol.orgs:set_policy (policy_type, process_type, must_be_member)</a></td>
<td class="summary">Adds a new policy to the policy table.</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "modpol.orgs.get_org"></a>
<strong>modpol.orgs.get_org (arg)</strong>
</dt>
<dd>
Return org when given its id or name
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">arg</span>
string for name of org or id of org
</li>
</ul>
<h3>Returns:</h3>
<ol>
org specified by id or name
</ol>
</dd>
<dt>
<a name = "modpol.orgs.list_all"></a>
<strong>modpol.orgs.list_all ()</strong>
</dt>
<dd>
Return a table list of all org names
<h3>Returns:</h3>
<ol>
a table list of all org names
</ol>
</dd>
<dt>
<a name = "modpol.orgs.user_orgs"></a>
<strong>modpol.orgs.user_orgs (user)</strong>
</dt>
<dd>
Return the orgs of a user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
string of user name
</li>
</ul>
<h3>Returns:</h3>
<ol>
table of strings of org names
</ol>
</dd>
<dt>
<a name = "modpol.orgs.reset"></a>
<strong>modpol.orgs.reset ()</strong>
</dt>
<dd>
Deletes all orgs except for the
</dd>
<dt>
<a name = "modpol.orgs.init_instance"></a>
<strong>modpol.orgs.init_instance ()</strong>
</dt>
<dd>
Initializes the instance (root org)
can only be run once, as only one instance can exist
</dd>
<dt>
<a name = "modpol.orgs:record"></a>
<strong>modpol.orgs:record ()</strong>
</dt>
<dd>
Records a log message to the modpol ledger
</dd>
<dt>
<a name = "modpol.orgs:add_org"></a>
<strong>modpol.orgs:add_org (name, user)</strong>
</dt>
<dd>
Adds a new sub org to the org it is called on.
Ex: instance:add_org('town hall')
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">name</span>
(string) name of new org
</li>
<li><span class="parameter">user</span>
(string)
</li>
</ul>
<h3>Returns:</h3>
<ol>
child org created
</ol>
</dd>
<dt>
<a name = "modpol.orgs:delete"></a>
<strong>modpol.orgs:delete ()</strong>
</dt>
<dd>
Recursively deletes an org and its suborgs
Leaves entry in modpol.orgs.array as a string "removed".
Note: "reason" param was removed, can be added back
</dd>
<dt>
<a name = "modpol.orgs:get_member_index"></a>
<strong>modpol.orgs:get_member_index (member)</strong>
</dt>
<dd>
Internal function to get the index of a member name
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">member</span>
</li>
</ul>
<h3>Returns:</h3>
<ol>
index of given member
</ol>
</dd>
<dt>
<a name = "modpol.orgs:add_member"></a>
<strong>modpol.orgs:add_member (user)</strong>
</dt>
<dd>
Adds a user to an org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:remove_member"></a>
<strong>modpol.orgs:remove_member (user)</strong>
</dt>
<dd>
Removes a user from an org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:has_member"></a>
<strong>modpol.orgs:has_member (user)</strong>
</dt>
<dd>
Boolean check whether user is an org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
</li>
</ul>
<h3>Returns:</h3>
<ol>
true if user is in org, false if not
</ol>
</dd>
<dt>
<a name = "modpol.orgs:list_members"></a>
<strong>modpol.orgs:list_members ()</strong>
</dt>
<dd>
<h3>Returns:</h3>
<ol>
a table of the names (string) of members
</ol>
</dd>
<dt>
<a name = "modpol.orgs:get_member_count"></a>
<strong>modpol.orgs:get_member_count ()</strong>
</dt>
<dd>
Because member list uses lazy deletion, using #org.members will not show an accurate number
<h3>Returns:</h3>
<ol>
numbers of members
</ol>
</dd>
<dt>
<a name = "modpol.orgs:set_policy"></a>
<strong>modpol.orgs:set_policy (policy_type, process_type, must_be_member)</strong>
</dt>
<dd>
Adds a new policy to the policy table.
Must define the policy type, process associated with it, and whether the request must be made by an org member
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">policy_type</span>
</li>
<li><span class="parameter">process_type</span>
</li>
<li><span class="parameter">must_be_member</span>
Boolean
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,349 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><strong>modpol.orgs.process</strong></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol.orgs.process</code></h1>
<p>Process functions for orgs</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.orgs.call_module">modpol.orgs.call_module (module_slug, intiator, config, result)</a></td>
<td class="summary">Call modules</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.get_root_process">modpol.orgs.get_root_process (id)</a></td>
<td class="summary">Get the root process of the given id</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs.delete_process">modpol.orgs.delete_process (id)</a></td>
<td class="summary">Delete the process given id</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:delete_process_tree">modpol.orgs:delete_process_tree (id)</a></td>
<td class="summary">Delete process tree by id</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:add_pending_action">modpol.orgs:add_pending_action (process_id, user, callback)</a></td>
<td class="summary">Add a new pending action</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:remove_pending_action">modpol.orgs:remove_pending_action (process_id, user)</a></td>
<td class="summary">Remove a pending action</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:wipe_pending_actions">modpol.orgs:wipe_pending_actions (process_id)</a></td>
<td class="summary">Wipe all pending actions for process</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:has_pending_actions">modpol.orgs:has_pending_actions (user)</a></td>
<td class="summary">Check if there are pending actions for user</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.orgs:interact">modpol.orgs:interact (process_id, user)</a></td>
<td class="summary">Interact a user with given process</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "modpol.orgs.call_module"></a>
<strong>modpol.orgs.call_module (module_slug, intiator, config, result)</strong>
</dt>
<dd>
Call modules
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">module_slug</span>
Same as module name
</li>
<li><span class="parameter">intiator</span>
Initiator for module
</li>
<li><span class="parameter">config</span>
Config for module
</li>
<li><span class="parameter">result</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs.get_root_process"></a>
<strong>modpol.orgs.get_root_process (id)</strong>
</dt>
<dd>
Get the root process of the given id
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">id</span>
</li>
</ul>
<h3>Returns:</h3>
<ol>
root process
</ol>
</dd>
<dt>
<a name = "modpol.orgs.delete_process"></a>
<strong>modpol.orgs.delete_process (id)</strong>
</dt>
<dd>
Delete the process given id
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">id</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:delete_process_tree"></a>
<strong>modpol.orgs:delete_process_tree (id)</strong>
</dt>
<dd>
Delete process tree by id
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">id</span>
Id of process tree
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:add_pending_action"></a>
<strong>modpol.orgs:add_pending_action (process_id, user, callback)</strong>
</dt>
<dd>
Add a new pending action
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">process_id</span>
Process id
</li>
<li><span class="parameter">user</span>
User adding the action
</li>
<li><span class="parameter">callback</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:remove_pending_action"></a>
<strong>modpol.orgs:remove_pending_action (process_id, user)</strong>
</dt>
<dd>
Remove a pending action
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">process_id</span>
Process id to be removed
</li>
<li><span class="parameter">user</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:wipe_pending_actions"></a>
<strong>modpol.orgs:wipe_pending_actions (process_id)</strong>
</dt>
<dd>
Wipe all pending actions for process
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">process_id</span>
</li>
</ul>
</dd>
<dt>
<a name = "modpol.orgs:has_pending_actions"></a>
<strong>modpol.orgs:has_pending_actions (user)</strong>
</dt>
<dd>
Check if there are pending actions for user
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">user</span>
User
</li>
</ul>
<h3>Returns:</h3>
<ol>
True if there are pending actions for a user, false if not
</ol>
</dd>
<dt>
<a name = "modpol.orgs:interact"></a>
<strong>modpol.orgs:interact (process_id, user)</strong>
</dt>
<dd>
Interact a user with given process
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">process_id</span>
</li>
<li><span class="parameter">user</span>
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,160 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><strong>modpol.util.misc</strong></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol.util.misc</code></h1>
<p>Miscellaneous functions</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.util.copy_table">modpol.util.copy_table (t)</a></td>
<td class="summary">Returns a copy of the table inputted</td>
</tr>
<tr>
<td class="name" nowrap><a href="#modpol.util.num_pairs">modpol.util.num_pairs (t)</a></td>
<td class="summary">Returns the number of elements in a pairs table</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "modpol.util.copy_table"></a>
<strong>modpol.util.copy_table (t)</strong>
</dt>
<dd>
Returns a copy of the table inputted
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">t</span>
table to copy
</li>
</ul>
<h3>Returns:</h3>
<ol>
copy of table
</ol>
</dd>
<dt>
<a name = "modpol.util.num_pairs"></a>
<strong>modpol.util.num_pairs (t)</strong>
</dt>
<dd>
Returns the number of elements in a pairs table
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">t</span>
pairs table
</li>
</ul>
<h3>Returns:</h3>
<ol>
number of elements in pairs table
</ol>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,91 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><strong>modpol_minetest.api</strong></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol_minetest.api</code></h1>
<p>Script for loading Minetest files</p>
<p></p>
<br/>
<br/>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,93 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><strong>modpol_minetest.overrides.interactions</strong></li>
</ul>
</div>
<div id="content">
<h1>Module <code>modpol_minetest.overrides.interactions</code></h1>
<p>INTERACTIONS.LUA (for Minetest)
CONTEXTUAL STUFF
================</p>
<p></p>
<br/>
<br/>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,223 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
<li><a href="#Tables">Tables</a></li>
<li><a href="#Fields">Fields</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><strong>module_template</strong></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>module_template</code></h1>
<p>Template for module writers.</p>
<p>
Short description goes here.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">(Required): Initiate function
Modules have access to the following instance variables:
<li><code>self.org</code> (the org the module was called in),</li>
<li><code>self.initiator</code> (the user that callced the module),</li>
<li><code>self.id</code> (the process id of the module instance)</li></td>
</tr>
</table>
<h2><a href="#Tables">Tables</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#data">data</a></td>
<td class="summary">(Required) Data for module
Variables that module uses during the course of a process.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#config">config</a></td>
<td class="summary">(Required): Config for module
Defines the input parameters to the module initiate function.</td>
</tr>
</table>
<h2><a href="#Fields">Fields</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#modpol.modules.module_template">modpol.modules.module_template</a></td>
<td class="summary">(Required) Add to module table</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
(Required): Initiate function
Modules have access to the following instance variables:
<li><code>self.org</code> (the org the module was called in),</li>
<li><code>self.initiator</code> (the user that callced the module),</li>
<li><code>self.id</code> (the process id of the module instance)</li>
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
(optional) Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Tables"></a>Tables</h2>
<dl class="function">
<dt>
<a name = "data"></a>
<strong>data</strong>
</dt>
<dd>
(Required) Data for module
Variables that module uses during the course of a process.
Can be blank
</dd>
<dt>
<a name = "config"></a>
<strong>config</strong>
</dt>
<dd>
(Required): Config for module
Defines the input parameters to the module initiate function.
Can be blank
When calling a module from within another module,
variables not defined in config will be ignored.
Default values set in config can be overridden
<h3>Fields:</h3>
<ul>
<li><span class="parameter">field_1</span>
ex: votes_required, default = 5
</li>
<li><span class="parameter">field_2</span>
ex: voting_type, default = "majority"
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Fields"></a>Fields</h2>
<dl class="function">
<dt>
<a name = "modpol.modules.module_template"></a>
<strong>modpol.modules.module_template</strong>
</dt>
<dd>
(Required) Add to module table
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,127 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><strong>priv_to_org</strong></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>priv_to_org</code></h1>
<p>Set privilege to org members
Allows initiator to grant a priv they have to all members of an org</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,144 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><strong>randomizer</strong></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>randomizer</code></h1>
<p>A utility module that outputs a random result from a set of options</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
<tr>
<td class="name" nowrap><a href="#random_loop">random_loop ()</a></td>
<td class="summary">Returns result_table</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "random_loop"></a>
<strong>random_loop ()</strong>
</dt>
<dd>
Returns result_table
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,146 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><strong>remove_child_consent</strong></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>remove_child_consent</code></h1>
<p>Remove child (consent).</p>
<p>
A simple module that calls a consent process on an org to remove its child.
Depends on the Consent module.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Removes a child org with consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="#complete">complete ()</a></td>
<td class="summary">Complete the remove process</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Removes a child org with consent
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "complete"></a>
<strong>complete ()</strong>
</dt>
<dd>
Complete the remove process
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,144 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><strong>remove_member_consent</strong></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>remove_member_consent</code></h1>
<p>Calls consent to remove member from org</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Removes given member from org</td>
</tr>
<tr>
<td class="name" nowrap><a href="#complete">complete ()</a></td>
<td class="summary">Complete after consent</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Removes given member from org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "complete"></a>
<strong>complete ()</strong>
</dt>
<dd>
Complete after consent
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><strong>remove_org</strong></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>remove_org</code></h1>
<p>A simple module that removes an org.</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Removes org</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Removes org
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,146 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><strong>remove_org_consent</strong></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>remove_org_consent</code></h1>
<p>Remove org (consent)
A simple module that calls a consent process on an org to remove it.</p>
<p>
Depends on the Consent module.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Remove org if all members consent</td>
</tr>
<tr>
<td class="name" nowrap><a href="#complete">complete ()</a></td>
<td class="summary">Complete after consent</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Remove org if all members consent
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "complete"></a>
<strong>complete ()</strong>
</dt>
<dd>
Complete after consent
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,126 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><strong>remove_process</strong></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>remove_process</code></h1>
<p>Remove a process</p>
<p></p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,146 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><strong>rename_org_consent</strong></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>rename_org_consent</code></h1>
<p>Rename org (consent)
A simple module that calls a consent process on an org to rename it.</p>
<p>
Depends on the Consent module.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Renames the org after consent is reached</td>
</tr>
<tr>
<td class="name" nowrap><a href="#complete">complete ()</a></td>
<td class="summary">Changes the name of the org after consent is reached</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Renames the org after consent is reached
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "complete"></a>
<strong>complete ()</strong>
</dt>
<dd>
Changes the name of the org after consent is reached
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,157 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
<li><a href="#Tables">Tables</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><strong>send_token</strong></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><a href="../modules/tokenomics.html">tokenomics</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>send_token</code></h1>
<p>Send token.</p>
<p>
Depends on tokenomics</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">initiate function</td>
</tr>
</table>
<h2><a href="#Tables">Tables</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#data">data</a></td>
<td class="summary">(Required) Data for module
Variables that module uses during the course of a process
Can be blank</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
initiate function
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
Callback if this module is embedded in other modules
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Tables"></a>Tables</h2>
<dl class="function">
<dt>
<a name = "data"></a>
<strong>data</strong>
</dt>
<dd>
(Required) Data for module
Variables that module uses during the course of a process
Can be blank
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,357 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>Reference</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>Modpol</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
<li><a href="#Tables">Tables</a></li>
</ul>
<h2>Modules</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/create_token.html">create_token</a></li>
<li><a href="../modules/defer_consent.html">defer_consent</a></li>
<li><a href="../modules/display_processes.html">display_processes</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/randomizer.html">randomizer</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/remove_process.html">remove_process</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/send_token.html">send_token</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
<li><strong>tokenomics</strong></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
<li><a href="../modules/modpol_minetest.overrides.interactions.html">modpol_minetest.overrides.interactions</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>tokenomics</code></h1>
<p>Tokenomics.</p>
<p>
Depends on consent</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#initiate">initiate (result)</a></td>
<td class="summary">Initiate function: creates a token in an org.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#create_token">create_token ()</a></td>
<td class="summary">Create token</td>
</tr>
<tr>
<td class="name" nowrap><a href="#balance">balance (org, token, user)</a></td>
<td class="summary">Returns balance.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#change_balance">change_balance (org, token, user, amount)</a></td>
<td class="summary">Change balance</td>
</tr>
<tr>
<td class="name" nowrap><a href="#transfer">transfer (org, token, sender, recipient, amount)</a></td>
<td class="summary">Transfer tokens from a sender to recipient</td>
</tr>
<tr>
<td class="name" nowrap><a href="#treasury_transfer">treasury_transfer (org, token, recipient, amount)</a></td>
<td class="summary">Transfer from treasury</td>
</tr>
<tr>
<td class="name" nowrap><a href="#issue">issue (org, token, amount)</a></td>
<td class="summary">Creates new tokens in the org treasury</td>
</tr>
</table>
<h2><a href="#Tables">Tables</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#config">config</a></td>
<td class="summary">Config for module</td>
</tr>
</table>
<br/>
<br/>
<h2 class="section-header "><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "initiate"></a>
<strong>initiate (result)</strong>
</dt>
<dd>
Initiate function: creates a token in an org.
Set up the token data structure.
Create an org treasury
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">result</span>
(optional) Callback if this module is embedded in other modules
</li>
</ul>
</dd>
<dt>
<a name = "create_token"></a>
<strong>create_token ()</strong>
</dt>
<dd>
Create token
</dd>
<dt>
<a name = "balance"></a>
<strong>balance (org, token, user)</strong>
</dt>
<dd>
Returns balance.
If no user, get treasury balance
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">org</span>
Name (string) or id (num)
</li>
<li><span class="parameter">token</span>
Slug (string)
</li>
<li><span class="parameter">user</span>
Name (string)
</li>
</ul>
</dd>
<dt>
<a name = "change_balance"></a>
<strong>change_balance (org, token, user, amount)</strong>
</dt>
<dd>
Change balance
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">org</span>
Org name (string) or id (number)
</li>
<li><span class="parameter">token</span>
Token slug (string)
</li>
<li><span class="parameter">user</span>
</li>
<li><span class="parameter">amount</span>
</li>
</ul>
</dd>
<dt>
<a name = "transfer"></a>
<strong>transfer (org, token, sender, recipient, amount)</strong>
</dt>
<dd>
Transfer tokens from a sender to recipient
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">org</span>
</li>
<li><span class="parameter">token</span>
</li>
<li><span class="parameter">sender</span>
</li>
<li><span class="parameter">recipient</span>
</li>
<li><span class="parameter">amount</span>
Positive number
</li>
</ul>
</dd>
<dt>
<a name = "treasury_transfer"></a>
<strong>treasury_transfer (org, token, recipient, amount)</strong>
</dt>
<dd>
Transfer from treasury
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">org</span>
</li>
<li><span class="parameter">token</span>
</li>
<li><span class="parameter">recipient</span>
</li>
<li><span class="parameter">amount</span>
Can be positive or negative, assumes flow from treasury to recipient
</li>
</ul>
</dd>
<dt>
<a name = "issue"></a>
<strong>issue (org, token, amount)</strong>
</dt>
<dd>
Creates new tokens in the org treasury
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">org</span>
</li>
<li><span class="parameter">token</span>
</li>
<li><span class="parameter">amount</span>
</li>
</ul>
</dd>
</dl>
<h2 class="section-header "><a name="Tables"></a>Tables</h2>
<dl class="function">
<dt>
<a name = "config"></a>
<strong>config</strong>
</dt>
<dd>
Config for module
<h3>Fields:</h3>
<ul>
<li><span class="parameter">consent</span>
Require consent to create?
</li>
<li><span class="parameter">token_variables</span>
the data that goes into the token
</li>
<li><span class="parameter">token_slug</span>
A no-spaces slug for the token
</li>
<li><span class="parameter">initial_treasury</span>
Quantity in org treasury
</li>
<li><span class="parameter">negative_spend</span>
Boolean: can users spend negative tokens? (for mutual credit)
</li>
<li><span class="parameter">balances</span>
Table of user balances
</li>
</ul>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
<i style="float:right;">Last updated 2022-01-23 18:18:51 </i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>

View File

@ -0,0 +1,63 @@
<h2>Basic Functions</h2>
<ul class="nowrap">
<li><a href="modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
</ul>
<h2>Core Modules</h2>
<ul class="nowrap">
<li><a href="modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="modules/change_modules.html">change_modules</a></li>
<li><a href="modules/consent.html">consent</a></li>
<li><a href="modules/join_org.html">join_org</a></li>
<li><a href="modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="modules/leave_org.html">leave_org</a></li>
<li><a href="modules/message_org.html">message_org</a></li>
<li><a href="modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="modules/remove_org.html">remove_org</a></li>
<li><a href="modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="modules/module_template.html">module_template</a></li>
</ul>
<h2>Minetest Modules</h2>
<ul class="nowrap">
<li><a href="modules/priv_to_org.html">priv_to_org</a></li>
</ul>
<h2>Basic Functions</h2>
<ul class="nowrap">
<li><a href="../modules/modpol.interactions.html">modpol.interactions</a></li>
<li><a href="../modules/modpol.orgs.base.html">modpol.orgs.base</a></li>
<li><a href="../modules/modpol.orgs.process.html">modpol.orgs.process</a></li>
<li><a href="../modules/modpol.util.misc.html">modpol.util.misc</a></li>
<li><a href="../modules/modpol_minetest.api.html">modpol_minetest.api</a></li>
</ul>
<h2>Core Modules</h2>
<ul class="nowrap">
<li><a href="../modules/add_child_org_consent.html">add_child_org_consent</a></li>
<li><a href="../modules/change_modules.html">change_modules</a></li>
<li><a href="../modules/consent.html">consent</a></li>
<li><a href="../modules/join_org.html">join_org</a></li>
<li><a href="../modules/join_org_consent.html">join_org_consent</a></li>
<li><a href="../modules/leave_org.html">leave_org</a></li>
<li><a href="../modules/message_org.html">message_org</a></li>
<li><a href="../modules/remove_child_consent.html">remove_child_consent</a></li>
<li><a href="../modules/remove_member_consent.html">remove_member_consent</a></li>
<li><a href="../modules/remove_org.html">remove_org</a></li>
<li><a href="../modules/remove_org_consent.html">remove_org_consent</a></li>
<li><a href="../modules/rename_org_consent.html">rename_org_consent</a></li>
<li><a href="../modules/module_template.html">module_template</a></li>
</ul>
<h2>Minetest Modules</h2>
<ul class="nowrap">
<li><a href="../modules/priv_to_org.html">priv_to_org</a></li>
</ul>

BIN
lib/empire-modpol.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 588 KiB

BIN
lib/module_list.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 200 KiB

View File

@ -1,8 +1,7 @@
name = modpol name = modpol
title = Modular Politics title = Modpol
author = ntnsndr <n@nathanschneider.info> author = ntnsndr <n@nathanschneider.info>
description = A governance layer framework in Lua description = A framework that enables diverse governance processes
license = Hippocratic License license = MIT
forum = TBA forum = https://forum.minetest.net/viewtopic.php?f=9&t=27598
version = 0.1 version = 0.1
release = 0

View File

@ -5,19 +5,29 @@ local localdir = modpol.topdir
--orgs --orgs
dofile (localdir .. "/orgs/base.lua") dofile (localdir .. "/orgs/base.lua")
dofile (localdir .. "/orgs/process.lua") dofile (localdir .. "/orgs/process.lua")
dofile (localdir .. "/orgs/users.lua")
--interactions --interactions
dofile (localdir .. "/interactions/interactions.lua") dofile (localdir .. "/interactions/interactions.lua")
--modules --modules
--TODO make this automatic and directory-based --TODO make this automatic and directory-based
dofile (localdir .. "/modules/add_child_org_consent.lua") dofile (localdir .. "/modules/add_child_org.lua")
dofile (localdir .. "/modules/change_modules.lua") dofile (localdir .. "/modules/change_modules.lua")
dofile (localdir .. "/modules/change_policy.lua")
dofile (localdir .. "/modules/consent.lua") dofile (localdir .. "/modules/consent.lua")
dofile (localdir .. "/modules/join_org_consent.lua") dofile (localdir .. "/modules/create_token.lua")
dofile (localdir .. "/modules/defer.lua")
dofile (localdir .. "/modules/display_policies.lua")
dofile (localdir .. "/modules/display_processes.lua")
dofile (localdir .. "/modules/join_org.lua")
dofile (localdir .. "/modules/leave_org.lua") dofile (localdir .. "/modules/leave_org.lua")
dofile (localdir .. "/modules/remove_child_consent.lua") dofile (localdir .. "/modules/message_org.lua")
dofile (localdir .. "/modules/remove_member_consent.lua") dofile (localdir .. "/modules/randomizer.lua")
dofile (localdir .. "/modules/remove_org_consent.lua") dofile (localdir .. "/modules/remove_child_org.lua")
dofile (localdir .. "/modules/remove_member.lua")
dofile (localdir .. "/modules/remove_org.lua") dofile (localdir .. "/modules/remove_org.lua")
dofile (localdir .. "/modules/rename_org_consent.lua") dofile (localdir .. "/modules/remove_process.lua")
dofile (localdir .. "/modules/rename_org.lua")
dofile (localdir .. "/modules/send_token.lua")
dofile (localdir .. "/modules/tokenomics.lua")

View File

View File

@ -1,18 +1,54 @@
-- INTERACTIONS.LUA (CLI) --- INTERACTIONS.LUA (CLI).
-- User interaction functions for Modular Politics -- User interaction functions for Modular Politics
-- Called by modpol.lua -- Called by modpol.lua
-- @module modpol.interactions
modpol.interactions = {} modpol.interactions = {}
-- UTILITIES
-- =========
--- Output: returns a string listing a module's policies
-- @function modpol.interactions.get_policy_string
-- @param org (string or number) name or id for the org
-- @param module_slug (string)
-- @param sep (string) separator string
function modpol.interactions.get_policy_string(
org, module_slug, sep)
local this_org = modpol.orgs.get_org(org)
local this_module = modpol.modules[module_slug]
local output = {}
if not this_org.policies[module_slug] then
return "Module not in org"
elseif modpol.util.num_pairs(this_module.config) > 0 then
for k, v in pairs(this_module.config) do
local this_policy = "[Policy error]"
if this_org.policies[module_slug][k] then
this_policy =
tostring(this_org.policies[module_slug][k])
else
if not v then
this_policy = "none"
else
this_policy = tostring(v)
end
end
table.insert(output, k.." - "..this_policy)
end
return "Policies:\n" .. table.concat(output, sep)
else
return "No policies"
end
end
-- DASHBOARDS -- DASHBOARDS
-- ========== -- ==========
-- Function: modpol.interactions.dashboard(user) --- Output: Display a menu of commands to the user
-- Params: user (string) -- @function modpol.interactions.dashboard
-- @param user (string)
-- Q: Should this return a menu of commands relevant to the specific user? -- Q: Should this return a menu of commands relevant to the specific user?
-- Output: Displays a menu of commands to the user
-- TKTK currently just prints all of modpol---needs major improvement -- TKTK currently just prints all of modpol---needs major improvement
function modpol.interactions.dashboard(user) function modpol.interactions.dashboard(user)
-- adds user to root org if not already in it -- adds user to root org if not already in it
@ -22,6 +58,7 @@ function modpol.interactions.dashboard(user)
local all_users = modpol.instance:list_members() local all_users = modpol.instance:list_members()
print('\n-=< MODPOL DASHBOARD >=-')
print('All orgs: (user orgs indicated by *)') print('All orgs: (user orgs indicated by *)')
for id, org in ipairs(modpol.orgs.array) do for id, org in ipairs(modpol.orgs.array) do
if type(org) == "table" then if type(org) == "table" then
@ -31,25 +68,74 @@ function modpol.interactions.dashboard(user)
end end
end end
-- pending list
local user_pending = {}
local user_pending_count = 0
for k,v in ipairs(modpol.orgs.array) do
if v.pending and v.pending[user] then
if modpol.util.num_pairs(v.pending[user]) ~= 0 then
table.insert(user_pending, v.name)
user_pending_count = user_pending_count + 1
end
end
end
print('Pending actions in: '..table.concat(user_pending,', '))
print('All users: ' .. table.concat(all_users, ', ')) print('All users: ' .. table.concat(all_users, ', '))
print() print()
print('Access which org id?') print("Commands: (O)rg, (U)ser, (R)eset, (Q)uit")
local sel = io.read()
print()
local sel = io.read()
if sel == "O" or sel == "o" then
print('Access which org id?')
sel = io.read()
print()
if modpol.orgs.array[tonumber(sel)] then if modpol.orgs.array[tonumber(sel)] then
local sel_org = modpol.orgs.array[tonumber(sel)].name local sel_org = modpol.orgs.array[tonumber(sel)].name
modpol.interactions.org_dashboard(user, sel_org) modpol.interactions.org_dashboard(user, sel_org)
else else
print("Org id not found.") print("Org id not found")
modpol.interactions.dashboard(user)
end
elseif sel == "U" or sel == "u" then
print("Access which user?")
sel = io.read()
print()
if modpol.instance:has_member(sel) then
modpol.interactions.user_dashboard(
user, sel,
function()
modpol.interactions.dashboard(user)
end
)
else
print("User name not found")
modpol.interactions.dashboard(user)
end
elseif sel == "R" or sel == "r" then
modpol.instance.members = {}
modpol.orgs.reset()
print("Orgs and users reset")
modpol.interactions.dashboard(user)
elseif sel == "Q" or sel == "q" then
return
else
print("Invalid input, try again")
modpol.interactions.dashboard(user)
end end
end end
--- Output: Displays a menu of org-specific commands to the user
-- Function: modpol.interactions.org_dashboard -- @function modpol.interactions.org_dashboard
-- Params: user (string), org_string (string or id) -- @param user (string)
-- Output: Displays a menu of org-specific commands to the user -- @param org_string (string or id)
function modpol.interactions.org_dashboard(user, org_string) function modpol.interactions.org_dashboard(user, org_string)
local org = modpol.orgs.get_org(org_string) local org = modpol.orgs.get_org(org_string)
if not org then return nil end if not org then return nil end
@ -66,34 +152,49 @@ function modpol.interactions.org_dashboard(user, org_string)
local children = {} local children = {}
for k,v in ipairs(org.children) do for k,v in ipairs(org.children) do
local this_child = modpol.orgs.get_org(v) local this_child = modpol.orgs.get_org(v)
if this_child then
table.insert(children, this_child.name) table.insert(children, this_child.name)
end end
end
-- list available modules -- prepare modules menu
local org_modules = {} local modules = {}
for k,v in pairs(org.modules) do if modpol.modules then
if not v.hide then for k,v in pairs(modpol.modules) do
table.insert(org_modules, v.slug) if not v.hide and -- hide utility modules
org.policies[k] then -- org includes it
local module_entry = v.slug
table.insert(modules, module_entry)
end end
end end
end
table.sort(modules)
-- list pending -- list pending
local process_msg = #org.processes .. " total processes" local processes = {}
for i,v in ipairs(org.processes) do
if v ~= "deleted" then
processes[i] = org.processes[i]
end
end
local process_msg = #processes .. " total processes"
if org.pending[user] then if org.pending[user] then
process_msg = process_msg .. " (" .. #org.pending[user] .. " pending)" process_msg = process_msg .. " (" ..
modpol.util.num_pairs(org.pending[user]) .. " pending)"
else else
process_msg = process_msg .. " (0 pending)" process_msg = process_msg .. " (0 pending)"
end end
-- set up output -- set up output
print('\n-=< ORG DASHBOARD >=-')
print("Org: " .. org.name) print("Org: " .. org.name)
print("Parent: " .. parent) print("Parent: " .. parent)
print("Members: " .. table.concat(org.members, ", ")) print("Members: " .. table.concat(org.members, ", "))
print("Children: " .. table.concat(children, ", ")) print("Child orgs: " .. table.concat(children, ", "))
print("Modules: " .. table.concat(org_modules, ", ")) print("Modules: " .. table.concat(modules, ", "))
print("Pending: " .. process_msg) print("Pending: " .. process_msg)
print() print()
print("Commands: (M)odules, (P)ending") print("Commands: (M)odules, (P)ending, (B)ack")
local sel = io.read() local sel = io.read()
print() print()
@ -103,72 +204,181 @@ function modpol.interactions.org_dashboard(user, org_string)
local module_sel = io.read() local module_sel = io.read()
print() print()
local module_result = false local module_result = false
for k,v in ipairs(org_modules) do for k,v in ipairs(modules) do
if v == module_sel then if v == module_sel then
module_result = true module_result = true
end end
end end
local module = modpol.modules[module_sel]
if module_result then if module_result then
modpol.interactions.binary_poll_user(
user,
module.name..":\n"..
module.desc.."\n"..
modpol.interactions.get_policy_string(
org.name, module.slug, "\n")..
"\n".."Proceed?",
function(input)
print("\n")
if input == "Yes" then
org:call_module(module_sel, user) org:call_module(module_sel, user)
elseif input == "No" then
modpol.interactions.org_dashboard(
pname, org.id)
end
end)
else else
print("Error: Module not found.") print("Error: Module not found.")
modpol.interactions.org_dashboard(user, org.id)
end end
elseif sel == 'a' or sel == 'A' then elseif sel == 'p' or sel == 'P' then -- Pending processes
local processes = {}
print("All processes: (* indicates pending)") print("All processes: (* indicates pending)")
for k,v in ipairs(org.processes) do for i,v in ipairs(processes) do
local active = '' local active = ''
if org.pending[user] then if org.pending[user] then
if org.pending[user][v.id] then if org.pending[user][v.id] then
active = '*' active = '*'
end end
end end
print("["..v.id.."] "..v.slug..active)
end end
print() print()
print("Interact with which one?") print("Interact with which one (use [id] number)?")
local to_interact = io.read() local to_interact = io.read()
local process = org.processes[tonumber(to_interact)] local process = org.processes[tonumber(to_interact)]
if not process then return end if not process then
modpol.interactions.message(
user, "Not a pending process")
modpol.interactions.org_dashboard(user, org.id)
return
end
if org:has_pending_actions(user) then if org:has_pending_actions(user) then
if org.pending[user][process.id] then if org.pending[user][process.id] then
org:interact(process.id, user) org:interact(process.id, user)
end end
modpol.interactions.org_dashboard(user, org.id)
end end
elseif sel == 'b' or sel == 'B' then
modpol.interactions.dashboard(user)
else else
print("Command not found") print("Command not found")
modpol.interactions.org_dashboard(user, org.name) modpol.interactions.org_dashboard(user, org.name)
end end
end end
-- Function: modpol.interactions.policy_dashboard --- Function: modpol.interactions.user_dashboard
-- input: user (string), org_id (int), policy (string) -- Displays a dashboard about a particular user
-- if policy is nil, enables creating a new policy -- @param viewer Name of user viewing the dashboard (string)
-- output: opens a dashboard for viewing/editing policy details -- @param user Name of user being viewed (string)
-- TODO -- @param completion Optional function to call on Done button
function modpol.interactions.user_dashboard(viewer, user, completion)
local user_orgs = {}
local user_modules = {}
print("\n-=< USER DASHBOARD: "..user.." >=-")
print("User's orgs:")
for id, org in ipairs(modpol.orgs.array) do
if type(org) == "table" then
if org:has_member(user) then
print(org.name)
end
end
end
print()
print("Commands: (M)essage user, Enter when done")
local sel = io.read()
if sel == "M" or sel == "m" then
modpol.interactions.message_user(
viewer, user)
completion()
else
completion()
end
end
-- Function: modpol.interactions.message
-- input: user (string), message (string)
-- output: prints message to CLI -- INTERACTION PRIMITIVES
-- ======================
--- Prints message to CLI.
-- Buttons: message, done
-- @function modpol.interactions.message
-- @param user (string)
-- @param message (string)
function modpol.interactions.message(user, message) function modpol.interactions.message(user, message)
print(user .. ": " .. message) print(user .. ": " .. message)
end end
-- Function: modpol.interactions.text_query --- Gets and sends a message from one user to another
-- input: User (string), Query (string), func (function) -- @function modpol.interactions.message_user
-- func input: user input (string) -- @param sender Name of user sending (string)
-- output: Applies "func" to user input -- @param recipient Name of user receiving (string)
function modpol.interactions.message_user(sender, recipient)
print("Enter your message for "..recipient..":")
local sel = io.read()
modpol.interactions.message(
recipient,
sel.." [from "..sender.."]")
end
--- Displays complex data to a user
-- @function modpol.interactions.display
-- @param user Name of target user (string)
-- @param title Title of display (string)
-- @param message Content of message (string or table of strings)
-- @param done Optional function for what happens when user is done
function modpol.interactions.display(user, title, message, completion)
local output = ""
output = "\n-=< "..title.." >=-\n\n"
if type(message) == "table" then
output = table.concat(message,"\n")
elseif type(message) == "string" then
output = message
elseif type(message) == "number" then
output = message
else
modpol.interactions.message(
self.initiator, "Error: message not typed for display")
modpol.interactions.message(
self.initiator, "Error: input not typed for display")
if completion then completion() else
modpol.interactions.dashboard(user)
end
end
print(message)
print("\nEnter to continue")
io.read()
if completion then completion() else
modpol.interactions.dashboard(user)
end
end
--- Applies "func" to user input.
-- Func input: user input (string)
-- @function modpol.interactions.text_query
-- @param User (string)
-- @param Query (string)
-- @param func (function)
function modpol.interactions.text_query(user, query, func) function modpol.interactions.text_query(user, query, func)
print(user .. ": " .. query) print(user .. ": " .. query)
answer = io.read() answer = io.read()
func(answer) func(answer)
end end
-- Function: dropdown_query --- Output: Calls func on choice.
-- input: user (string), label (string), options (table of strings), func(choice) (function) -- Func input: choice (string)
-- func input: choice (string) -- @function modpol.interactions.dropdown_query
-- output: calls func on choice -- @param user (string)
-- @param label (string)
-- @param options (table of strings)
-- @param func (choice) (function)
function modpol.interactions.dropdown_query(user, label, options, func) function modpol.interactions.dropdown_query(user, label, options, func)
-- set up options -- set up options
local options_display = "" local options_display = ""
@ -204,10 +414,62 @@ function modpol.interactions.dropdown_query(user, label, options, func)
end end
end end
-- Function: modpol.binary_poll_user(user, question)
-- Params: user (string), question (string), func (function) --- Allows user to select from a set of options
-- func input: user input (string: y/n) -- @function modpol.interactions.checkbox_query
-- Output: Applies "func" to user input -- @param user Name of user (string)
-- @param label Query for user before options (string)
-- @param options Table of options and their checked status in the form {{"option_1_string", true}, {"option_2_string", false}}
-- @param func Function to be called with param "input", made up of the corrected table in the same format as the param options
function modpol.interactions.checkbox_query(
user, label, options, func)
-- set up options
local options_display = ""
local options_number = 0
for i,v in ipairs(options) do
local checked = false
if v[2] then checked = true end
if checked then
checked = "x"
else
checked = " "
end
options_display = options_display..i..". ["..
checked.."] "..v[1].."\n"
options_number = options_number + 1
end
if options_number == 0 then
print("Error: No options given for dropdown")
return nil
end
options_display = options_display..
"List comma-separated options to flip (e.g., 1,2,5):"
-- begin displaying
print(user .. ": " .. label)
print(options_display)
-- read input and produce output
local answer = io.read()
local answer_table = {}
for match in (answer..","):gmatch("(.-)"..",") do
table.insert(answer_table, tonumber(match))
end
local result_table = modpol.util.copy_table(options)
for i,v in ipairs(answer_table) do
if result_table[v] then
-- flip the boolean on selected options
result_table[v][2] = not result_table[v][2]
end
end
func(result_table)
end
--- Output: Applies "func" to user input.
-- Func input: user input (string: y/n)
-- @function modpol.interactions.binary_poll_user
-- @param user (string)
-- @param question (string)
-- @param func (function)
function modpol.interactions.binary_poll_user(user, question, func) function modpol.interactions.binary_poll_user(user, question, func)
local query = "Poll for " .. user .. " (y/n): ".. question local query = "Poll for " .. user .. " (y/n): ".. question
local answer local answer
@ -216,10 +478,8 @@ function modpol.interactions.binary_poll_user(user, question, func)
answer = io.read() answer = io.read()
until answer == "y" or answer == "n" until answer == "y" or answer == "n"
if answer == "y" then if answer == "y" then
modpol.interactions.message(user, "Response recorded")
func("Yes") func("Yes")
elseif answer == "n" then elseif answer == "n" then
modpol.interactions.message(user, "Response recorded")
func("No") func("No")
else else
modpol.interactions.message(user, "Error: invalid response") modpol.interactions.message(user, "Error: invalid response")
@ -229,9 +489,11 @@ end
-- COMPLEX INTERACTIONS -- COMPLEX INTERACTIONS
-- ==================== -- ====================
-- Function: modpol.interactions.message_org --- Output: broadcasts message to all org members
-- input: initiator (string), org (number or string), message (string) -- @function modpol.interactions.message_org
-- output: broadcasts message to all org members -- @param initiator (string)
-- @param org (number or string)
-- @param message (string)
function modpol.interactions.message_org(initiator, org, message) function modpol.interactions.message_org(initiator, org, message)
local this_org = modpol.orgs.get_org(org) local this_org = modpol.orgs.get_org(org)
local users = this_org:list_members() local users = this_org:list_members()
@ -245,3 +507,9 @@ end
-- output: gets question from initiator, asks all org members, broadcasts answers -- output: gets question from initiator, asks all org members, broadcasts answers
-- TESTING
--testing command
function modpol.msg(text)
modpol.interactions.message("TEST MSG",text)
end

View File

@ -1,21 +1,23 @@
--- @module add_child_org_consent --- Adds a child org
-- Adds a child org -- @module add_child_org
-- Depends on `consent`
local add_child_org_consent = { local add_child_org = {
name = "Add child org (consent)", name = "Add child org",
slug = "add_child_org_consent", slug = "add_child_org",
desc = "Create a child org in the current one with member consent" desc = "Create a child org in the current one"
} }
add_child_org_consent.data = { add_child_org.data = {
child_name = "", child_name = "",
result = nil result = false
} }
add_child_org_consent.config = { add_child_org.config = {
approval_module = false
} }
-- @function initiate --- Initiate consent for new child org
function add_child_org_consent:initiate(result) -- @function add_child_org:initiate(result)
-- @param result Callback if this module is embedded in other modules
function add_child_org:initiate(result)
modpol.interactions.text_query( modpol.interactions.text_query(
self.initiator,"Child org name: ", self.initiator,"Child org name: ",
function(input) function(input)
@ -26,7 +28,6 @@ function add_child_org_consent:initiate(result)
modpol.interactions.org_dashboard( modpol.interactions.org_dashboard(
self.initiator, self.org.name) self.initiator, self.org.name)
self.org:delete_process(self.id) self.org:delete_process(self.id)
if result then result() end
return return
elseif modpol.orgs.get_org(input) then elseif modpol.orgs.get_org(input) then
modpol.interactions.message( modpol.interactions.message(
@ -43,8 +44,9 @@ function add_child_org_consent:initiate(result)
self.initiator, self.initiator,
"Proposed child org: " .. input) "Proposed child org: " .. input)
-- initiate consent process -- initiate consent process
self.org:call_module( self.data.result = result
"consent", self:call_module(
self.config.approval_module,
self.initiator, self.initiator,
{ {
prompt = "Create child org " .. prompt = "Create child org " ..
@ -61,15 +63,17 @@ function add_child_org_consent:initiate(result)
) )
end end
function add_child_org_consent:create_child_org() --- Create a new child org
-- @function add_child_org:create_child_org
function add_child_org:create_child_org()
self.org:add_org(self.data.child_name, self.initiator) self.org:add_org(self.data.child_name, self.initiator)
modpol.interactions.message_org( modpol.interactions.message_org(
self.initiator, self.initiator,
self.org.name, self.org.name,
"Child org created: "..self.data.child_name) "Created child org in " .. self.org.name .. ": "
.. self.data.child_name)
if self.data.result then self.data.result() end if self.data.result then self.data.result() end
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
--- (Required) Add to module table modpol.modules.add_child_org = add_child_org
modpol.modules.add_child_org_consent = add_child_org_consent

View File

@ -0,0 +1,178 @@
--- change_modules
-- @module change_modules
-- Depends on consent
local change_modules = {
name = "Change modules (consent)",
slug = "change_modules",
desc = "Add or remove modules from the org with member consent",
hide = false;
}
change_modules.data = {
result = nil
}
change_modules.config = {
}
--- Change modules initiate
-- @function change_modules:initiate
-- @param result Callback if this module is embedded in other modules
function change_modules:initiate(result)
self.data.result = result
-- Step 1: add or remove?
modpol.interactions.dropdown_query(
self.initiator, "Module change options:",
{"Add module","Remove module"},
function(input)
if input == "Add module" then
self:add_module()
elseif input == "Remove module" then
self:remove_module()
end
end
)
end
--- Add a new module
-- @function change_modules:add_module
function change_modules:add_module()
-- prepare module options
local available_modules = modpol.util.copy_table(modpol.modules)
for k,org_mod in pairs(self.org.modules) do
if available_modules[org_mod.slug] then
available_modules[org_mod.slug] = nil
end end
-- present module options
local modules_list = {}
for k,v in pairs(available_modules) do
table.insert(modules_list,v.name)
end
if #modules_list == 0 then
modpol.interactions.message(
self.initiator, "Org has all modules")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
return
end
table.sort(modules_list)
-- now ask which to add
modpol.interactions.dropdown_query(
self.initiator, "Choose a module to add:",
modules_list,
function(mod_choice)
-- confirm choice
modpol.interactions.binary_poll_user(
self.initiator,
"Confirm: propose to add module \"" ..
mod_choice .. "\"?",
function(input)
if input == "Yes" then
self:propose_change("add",mod_choice)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
else
self:add_module()
end
end
)
end
)
end
--- Remove a module
-- @function change_modules:remove_module
function change_modules:remove_module()
-- prepare module options
local available_modules = {}
for k,org_mod in pairs(self.org.modules) do
if not org_mod.hide then
available_modules[org_mod.slug] = modpol.util.copy_table(org_mod)
end end
local modules_list = {}
local modules_count = 0
for k,v in pairs(available_modules) do
table.insert(modules_list,v.name)
modules_count = modules_count + 1
end
-- abort if no modules to remove
if modules_count == 0 then
modpol.interactions.message(
self.initiator, "Org has no modules")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
return
end
table.sort(modules_list)
-- now ask which to remove
modpol.interactions.dropdown_query(
self.initiator, "Choose a module to remove:",
modules_list,
function(mod_choice)
-- confirm choice
modpol.interactions.binary_poll_user(
self.initiator,
"Confirm: propose to remove module \"" .. mod_choice .. "\"?",
function(input)
if input == "Yes" then
self:propose_change("remove",mod_choice)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
else
self:remove_module()
end
end
)
end
)
end
--- Propose a change.
-- Type "add" or "remove"
-- @function change_modules:propose_change
-- @param type
-- @param mod_text
function change_modules:propose_change(type, mod_text)
self:call_module(
"consent",self.initiator,
{
prompt = "Do you consent to "..type..
" this module in org "..self.org.name..
":\n"..mod_text,
votes_required = #self.org.members
},
function()
if type == "add" then
for k,v in pairs(modpol.modules) do
if v.name == mod_text then
table.insert(self.org.modules,v)
end
end
modpol.interactions.message_org(
self.initiator,self.org.id,
"Consent reached:\nAdding \""
..mod_text.."\" to org "..self.org.name)
elseif type == "remove" then
local i = 0
for k,v in pairs(self.org.modules) do
i = i + 1
if v.name == mod_text then
self.org.modules[k] = nil
end
end
modpol.interactions.message_org(
self.initiator,self.org.id,
"Consent reached:\nRemoving \""
..mod_text.."\" from org "..self.org.name)
end
end)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
end
modpol.modules.change_modules = change_modules

View File

@ -1,171 +1,117 @@
--- change_modules --- change_modules
-- @module change_modules -- @module change_modules
-- Depends on consent
local change_modules = { local change_modules = {
name = "Change modules (consent)", name = "Change modules",
slug = "change_modules", slug = "change_modules",
desc = "Add or remove modules from the org with member consent", desc = "Add or remove modules from the org",
hide = false; hide = false;
} }
change_modules.data = { change_modules.data = {
result = nil result = nil,
modules_before = {},
modules_after = {},
summary = "",
} }
change_modules.config = { change_modules.config = {
approval_module = false
} }
--- Initiate change in modules.
-- Either adds or removes module depending on user input
-- @function change_modules:initiate
-- @param result Callback if this module is embedded in other modules
function change_modules:initiate(result) function change_modules:initiate(result)
self.data.result = result self.data.result = result
-- Step 1: add or remove? self.data.add_modules = {}
modpol.interactions.dropdown_query( self.data.remove_modules = {}
self.initiator, "Module change options:", local modules_before = {}
{"Add module","Remove module"}, local modules_after = {}
-- generate self.config.modules table
for k, module in pairs(modpol.modules) do
if not modpol.modules[module.slug].hide then
local in_org = false
if self.org.policies[module.slug] then
in_org = true
end
table.insert(
modules_before,
{module.name.." ["..module.slug.."]", in_org})
end
end
-- send query to user
modpol.interactions.checkbox_query(
self.initiator,
"Check the modules to activate in this org:",
modules_before,
function(input) function(input)
if input == "Add module" then -- identify changes
self:add_module() modules_after = input
elseif input == "Remove module" then for i,v in ipairs(modules_after) do
self:remove_module() if v[2] ~= modules_before[i][2] then
if v[2] then
table.insert(self.data.add_modules, v[1])
else
table.insert(self.data.remove_modules, v[1])
end end
end end
)
end
function change_modules:add_module()
-- prepare module options
local available_modules = modpol.copy_table(modpol.modules)
for k,org_mod in pairs(self.org.modules) do
if available_modules[org_mod.slug] then
available_modules[org_mod.slug] = nil
end end
-- present module options
local modules_list = {}
for k,v in pairs(available_modules) do
table.insert(modules_list,v.name)
end end
if #modules_list == 0 then -- abort if no changes
if #self.data.add_modules == 0
and #self.data.remove_modules == 0 then
modpol.interactions.message( modpol.interactions.message(
self.initiator, "Org has all modules") self.initiator, "No module changes proposed")
modpol.interactions.org_dashboard( modpol.interactions.org_dashboard(
self.initiator, self.org.id) self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id) self.org:delete_process(self.id)
return return
end end
table.sort(modules_list) -- proceed with approval
-- now ask which to add local query = "Accept module changes in org "..
modpol.interactions.dropdown_query( self.org.name.."?"
self.initiator, "Choose a module to add:", self.data.summary = ""
modules_list, if #self.data.add_modules > 0 then
function(mod_choice) self.data.summary = self.data.summary.."\nAdd: "..
-- confirm choice table.concat(self.data.add_modules,", ")
modpol.interactions.binary_poll_user( elseif #self.data.remove_modules > 0 then
self.data.summary = "\nRemove: "..
table.concat(self.data.remove_modules,", ")
end
self:call_module(
self.config.approval_module,
self.initiator, self.initiator,
"Confirm: propose to add module \"" ..
mod_choice .. "\"?",
function(input)
if input == "Yes" then
self:propose_change("add",mod_choice)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
else
self:add_module()
end
end
)
end
)
end
function change_modules:remove_module()
-- prepare module options
local available_modules = {}
for k,org_mod in pairs(self.org.modules) do
if not org_mod.hide then
available_modules[org_mod.slug] = modpol.copy_table(org_mod)
end end
local modules_list = {}
local modules_count = 0
for k,v in pairs(available_modules) do
table.insert(modules_list,v.name)
modules_count = modules_count + 1
end
-- abort if no modules to remove
if modules_count == 0 then
modpol.interactions.message(
self.initiator, "Org has no modules")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
return
end
table.sort(modules_list)
-- now ask which to remove
modpol.interactions.dropdown_query(
self.initiator, "Choose a module to remove:",
modules_list,
function(mod_choice)
-- confirm choice
modpol.interactions.binary_poll_user(
self.initiator,
"Confirm: propose to remove module \"" .. mod_choice .. "\"?",
function(input)
if input == "Yes" then
self:propose_change("remove",mod_choice)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
else
self:remove_module()
end
end
)
end
)
end
--- propose_change
-- @field type "add" or "remove"
function change_modules:propose_change(type, mod_text)
self.org:call_module(
"consent",self.initiator,
{ {
prompt = "Do you consent to "..type.. prompt = query..self.data.summary
" this module in org "..self.org.name..
":\n"..mod_text,
votes_required = #self.org.members
}, },
function() function()
if type == "add" then self:implement_change()
for k,v in pairs(modpol.modules) do
if v.name == mod_text then
table.insert(self.org.modules,v)
end
end
modpol.interactions.message_org(
self.initiator,self.org.id,
"Consent reached:\nAdding \""
..mod_text.."\" to org "..self.org.name)
elseif type == "remove" then
modpol.msg("Removing!")
local i = 0
for k,v in pairs(self.org.modules) do
i = i + 1
if v.name == mod_text then
modpol.msg("got it!")
self.org.modules[k] = nil
end
end
modpol.interactions.message_org(
self.initiator,self.org.id,
"Consent reached:\nRemoving \""
..mod_text.."\" from org "..self.org.name)
end
end) end)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
end)
end
function change_modules:implement_change()
for i,v in ipairs(self.data.add_modules) do
local slug = string.match(v,"%[(.+)%]")
self.org.policies[slug] = {}
table.sort(self.org.policies)
end
for i,v in ipairs(self.data.remove_modules) do
local slug = string.match(v,"%[(.+)%]")
self.org.policies[slug] = nil
table.sort(self.org.policies)
end
-- announce and shut down
modpol.interactions.message_org(
self.initiator,
self.org.id,
"Module changes applied to org "..self.org.name..":"..
self.data.summary)
if self.data.result then self.data.result() end if self.data.result then self.data.result() end
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
--- (Required) Add to module table
modpol.modules.change_modules = change_modules modpol.modules.change_modules = change_modules

View File

@ -0,0 +1,124 @@
--- change_policy
-- @module change_policy
local change_policy = {
name = "Change policy",
slug = "change_policy",
desc = "Change a policy in a module",
hide = false;
}
change_policy.data = {
result = false
}
change_policy.config = {
approval_module = false
}
--- Change modules initiate
-- @function change_policy:initiate
-- @param result Callback if this module is embedded in other modules
function change_policy:initiate(result)
-- prepare module options
local available_modules = {}
for k,org_mod in pairs(modpol.modules) do
if self.org.policies[k] then
available_modules[org_mod.slug] = modpol.util.copy_table(org_mod)
end end
local modules_list = {}
local modules_count = 0
for k,v in pairs(available_modules) do
table.insert(modules_list,v.slug)
modules_count = modules_count + 1
end
-- abort if no modules to remove
if modules_count == 0 then
modpol.interactions.message(
self.initiator, "Org has no modules")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
return
end
table.sort(modules_list)
-- now ask which to remove
modpol.interactions.dropdown_query(
self.initiator, "Choose a module to change policies for:",
modules_list,
function(mod_choice)
local this_module = modpol.modules[mod_choice]
local module_policies = this_module.config
local policy_list = {}
for k,v in pairs(module_policies) do
table.insert(policy_list, k)
end
if #policy_list == 0 then
-- No policies; abort
modpol.interactions.message(
self.initiator, "Module has no policy options")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
return
end
modpol.interactions.dropdown_query(
self.initiator, "Choose a policy to change:",
policy_list,
function(policy_choice)
local readable_value =
tostring(modpol.modules[mod_choice][policy_choice])
if readable_value == "nil" then
readable_value = "none"
end
modpol.interactions.text_query(
self.initiator,
"Current " .. policy_choice .. " value: "
.. readable_value
.. "\nChange value to (or leave blank):",
function(policy_input)
if policy_input == "" then
policy_input = false
end
self:approve_change(
mod_choice,
policy_choice,
policy_input)
end
)
end
)
end
)
end
--- Propose a change.
-- Type "add" or "remove"
-- @function change_policy:approve_change
-- @param module (string) slug of module
-- @param policy (string) policy slug
-- @param input (string) input content
function change_policy:approve_change(module_slug, policy, input)
self.org:call_module(
self.config.approval_module,
self.initiator,
{prompt = "Update " .. policy .. " policy on module " ..
module_slug .. " with: " .. input .. " ?"},
function()
modpol.interactions.message(
self.initiator,
"In ".. self.org.name .. " updating " .. policy ..
" policy on module " .. module_slug .. " with: " .. input)
self.org.policies[module_slug][policy] = input
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
end,
self.id
)
end
modpol.modules.change_policy = change_policy

View File

@ -1,10 +1,10 @@
--- @module consent --- A utility module for checking consent
-- A utility module for checking consent -- @module consent
local consent = { local consent = {
name = "Consent process utility", name = "Consent process",
slug = "consent", slug = "consent",
desc = "A module other modules use for consent decisions", desc = "A utility module other modules use for consent decisions",
hide = true hide = true
} }
@ -14,24 +14,39 @@ consent.data = {
consent.config = { consent.config = {
prompt = "Do you consent?", prompt = "Do you consent?",
votes_required = 1 votes_required = false
} }
--- Initiate consent
-- @function consent:initiate
-- @param result Callback if this module is embedded in other modules
function consent:initiate(result) function consent:initiate(result)
self.data.result = result self.data.result = result
-- if org is empty, consent is given automatically -- if org is empty or no votes required, consent given
if self.org:get_member_count() == 0 then if self.org:get_member_count() == 0
or self.config.votes_required == 0 then
modpol.interactions.message_org(
self.initiator,
self.org.name,
"Consent reached: " .. self.config.prompt)
if self.data.result then if self.data.result then
self.data.result() end self.data.result() end
self.org:wipe_pending_actions(self.id) self.org:delete_process(self.id)
else else
-- otherwise, create poll -- otherwise, create poll
-- set default votes_required
if not self.config.votes_required then
self.config.votes_required = self.org:get_member_count()
end
for id, member in pairs(self.org.members) do for id, member in pairs(self.org.members) do
self.org:add_pending_action(self.id, member, "callback") self.org:add_pending_action(self.id, member, "callback")
end end
end end
end end
--- Callback
-- @function consent:callback
-- @param member
function consent:callback(member) function consent:callback(member)
modpol.interactions.binary_poll_user( modpol.interactions.binary_poll_user(
member, member,
@ -41,14 +56,23 @@ function consent:callback(member)
if resp == "Yes" then if resp == "Yes" then
self.data.votes = self.data.votes + 1 self.data.votes = self.data.votes + 1
end end
modpol.interactions.message_org(
"consent", self.org.id,
member.." decided "..resp.." on: "..
self.config.prompt.." ("..self.data.votes..
"/"..self.config.votes_required..")"
)
if self.data.votes >= self.config.votes_required then if self.data.votes >= self.config.votes_required then
modpol.interactions.message_org(
self.initiator,
self.org.name,
"Consent reached: " .. self.config.prompt)
if self.data.result then if self.data.result then
self.data.result() end self.data.result() end
self.org:wipe_pending_actions(self.id)
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
modpol.interactions.org_dashboard( modpol.interactions.org_dashboard(
member, self.org.name) member, self.org.id)
end end
) )
end end

View File

@ -0,0 +1,50 @@
--- Create token.
-- Depends on tokenomics
-- @module create_token
local create_token = {
name = "Create a token",
slug = "create_token",
desc = "Creates an org token",
hide = false;
}
create_token.data = {
}
create_token.config = {
token_name = "token",
approval_module = false
}
--- Initiate function
-- @function create_toke:initiate
-- @param result Callback if this module is embedded in other modules
function create_token:initiate(result)
modpol.interactions.text_query(
self.initiator,
"Token name (alpha-numeric, no spaces):",
function(input)
self.config.token_name = input
self:call_module(
"tokenomics",
self.initiator,
{
approval_module = self.config.approval_module,
token_slug = self.config.token_name
},
function(input2)
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
if result then result() end
-- call this wherever process might end:
self.org:delete_process(self.id)
end
)
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
end
)
end
modpol.modules.create_token = create_token

View File

@ -0,0 +1,52 @@
--- Defer
-- @module defer
local defer = {
name = "Defer ",
slug = "defer",
desc = "Defers a decision to another org",
hide = true;
}
defer.data = {
}
--- Config for module
-- @field defer_org Name or ID of target org
-- @field approval_module module to use in target org
-- @field prompt String passed on to approval_module
defer.config = {
approval_module = "consent",
defer_org = "Root",
prompt = ""
}
--- Initiate function
-- @param result Callback if this module is embedded in other modules
-- @function defer:initiate
function defer:initiate(result)
local defer_org = modpol.orgs.get_org(self.config.defer_org)
if not defer_org then
modpol.interactions.message(
self.initiator, "Target org not found, aborting")
self.org:delete_process(self.id)
else
defer_org:call_module(
self.config.approval_module,
self.initiator,
{
prompt = self.config.prompt
},
function()
if result then result() end
end)
modpol.interactions.message(
self.initiator, "Defer: action sent to " .. defer_org.name)
end
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
self.org:delete_process(self.id)
end
--- (Required) Add to module table
modpol.modules.defer = defer

View File

@ -0,0 +1,68 @@
--- Display policies
-- @module display_policies
local display_policies = {
name = "Display policies",
slug = "display_policies",
desc = "Presents a detailed list of org policies",
hide = false;
}
display_policies.data = {
}
display_policies.config = {
}
--- Initiate function
-- @function display_policies:initiate
-- @param result Callback if this module is embedded in other modules
function display_policies:initiate(result)
local display_table = {}
for k,v in pairs(self.org.policies) do
if v then -- check the module is allowed
local input = modpol.modules[k].name
table.insert(display_table, input)
if modpol.modules[k].config then
for k2,v2 in pairs(modpol.modules[k].config) do
if self.org.policies[k][k2] then
v2 = self.org.policies[k][k2]
end
local v2_string = ""
if not v2 then
v2_string = "none"
elseif type(v2) == "string" then
v2_string = v2
elseif type(v2) == "table"
or type(v2) == "number" then
v2_string = tostring(v2)
elseif type(v2) == "boolean" then
v2_string = tostring(v2)
else
v2_string = "Could not render"
end
input = k2..": "..v2_string
table.insert(display_table, input)
end
end
table.insert(display_table, "---")
end
end
local output = table.concat(display_table,"\n")
if #display_table == 0 then
output = "No modules found"
end
modpol.interactions.display(
self.initiator,
"Policies in org "..self.org.name,
output,
function()
self.org:delete_process(self.id)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
end
)
end
modpol.modules.display_policies = display_policies

View File

@ -0,0 +1,66 @@
--- Display processes
-- @module display_processes
local display_processes = {
name = "Display processes",
slug = "display_processes",
desc = "Presents a detailed list of org processes",
hide = false;
}
display_processes.data = {
}
display_processes.config = {
}
--- Initiate function
-- @function display_processes:initiate
-- @param result Callback if this module is embedded in other modules
function display_processes:initiate(result)
local display_table = {}
for k,v in ipairs(self.org.processes) do
if v ~= "deleted" then
local input = v.id..": "..v.slug
table.insert(display_table, input)
input = "Org: "..v.org.name..
", initiator: "..v.initiator
table.insert(display_table, input)
if v.config
and modpol.util.num_pairs(v.config) > 0 then
table.insert(display_table, "Policies:")
for k2,v2 in pairs(v.config) do
local v2_string = ""
if type(v2) == "string" then
v2_string = v2
elseif type(v2) == "table"
or type(v2) == "number" then
v2_string = tostring(v2)
else
v2_string = "Could not render"
end
input = k2..": "..v2_string
table.insert(display_table, input)
end
end
table.insert(display_table, "---")
end
end
local output = table.concat(display_table,"\n")
if #display_table == 0 then
output = "No processes found"
end
modpol.interactions.display(
self.initiator,
"Processes in org "..self.org.name,
output,
function()
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
self.org:delete_process(self.id)
end
)
end
modpol.modules.display_processes = display_processes

View File

@ -1,39 +1,55 @@
--- Join org
-- Adds initiator to an org
-- @module join_org
join_org = {} local join_org = {
name = "Join this org",
join_org.setup = {
name = "Join Org",
slug = "join_org", slug = "join_org",
desc = "If consent process is passed, initiator joins this org." desc = "Allows initiator to join this org"
} }
function join_org.initiate(result) join_org.data = {
modpol.interactions.binary_poll_user( result = nil
initiator, }
"Would you like to join " .. org.name,
function (resp)
if resp == "Yes" then
self.org:add_member(self.initiator)
end
end
)
for i, member in ipairs(self.org.members) do join_org.config = {
self.org:add_pending_action( approval_module = false
member, }
function ()
modpol.interactions.binary_poll_user(
member,
"Let " .. initiator .. " join " .. org.name .. "?",
function (resp)
end
)
end
)
end
--- Initiate join org with consent
-- @function join_org:initiate
-- @param result Callback if this module is embedded in other modules
function join_org:initiate(result)
if self.org:has_member(self.initiator) then
modpol.interactions.message(
self.initiator,
"You are already a member of this org")
if result then result() end if result then result() end
self.org:delete_process(self.id)
else
self.data.result = result
self:call_module(
self.config.approval_module,
self.initiator,
{
prompt = "Allow " .. self.initiator .. " to join?"
},
function ()
self:complete()
end
)
end
end
--- Adds member to org, notifies org, and deletes process
-- @function join_org:complete
function join_org:complete()
self.org:add_member(self.initiator)
modpol.interactions.message_org(
self.initiator,self.org.name,
self.initiator .. " joined org " .. self.org.name)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
end end
modpol.modules.join_org = join_org modpol.modules.join_org = join_org

View File

@ -1,51 +0,0 @@
--- Join org (consent)
-- A simple module that calls a consent process on an org to add a member.
-- Depends on the Consent module.
local join_org_consent = {
name = "Join this org (consent)",
slug = "join_org_consent",
desc = "Adds member with consent of all members"
}
join_org_consent.data = {
result = nil
}
join_org_consent.config = {
}
function join_org_consent:initiate(result)
if self.org:has_member(self.initiator) then
modpol.interactions.message(
self.initiator,
"You are already a member of this org")
if result then result() end
self.org:delete_process(self.id)
else
self.data.result = result
self.org:call_module(
"consent",
self.initiator,
{
prompt = "Allow " .. self.initiator .. " to join?",
votes_required = #self.org.members
},
function ()
self:complete()
end
)
end
end
function join_org_consent:complete()
self.org:add_member(self.initiator)
modpol.interactions.message_org(
self.initiator,self.org.name,
"Consent reached: " .. self.initiator ..
" joined org " .. self.org.name)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
end
modpol.modules.join_org_consent = join_org_consent

View File

@ -1,4 +1,4 @@
--- leave_org --- Removes initiator from org
-- @module leave_org -- @module leave_org
local leave_org = { local leave_org = {
@ -13,10 +13,9 @@ leave_org.data = {
leave_org.config = { leave_org.config = {
} }
--- (Required): initiate function --- Removes user from org
-- Modules have access to the following instance variables: -- @function leave_org:initiate
-- @param result (optional) Callback if this module is embedded in other modules -- @param result Callback if this module is embedded in other modules
-- @function initiate
function leave_org:initiate(result) function leave_org:initiate(result)
if self.org == modpol.instance then if self.org == modpol.instance then
modpol.interactions.message( modpol.interactions.message(
@ -35,5 +34,4 @@ function leave_org:initiate(result)
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
--- (Required) Add to module table
modpol.modules.leave_org = leave_org modpol.modules.leave_org = leave_org

View File

@ -0,0 +1,39 @@
--- Messages all org members
-- @module message_org
local message_org = {
name = "Message org",
slug = "message_org",
desc = "Send a message to all members of the org",
hide = false;
}
message_org.data = {
}
message_org.config = {
}
--- Allows user to send input message to all org members
-- @function initiate
-- @param result Callback if this module is embedded in other modules
function message_org:initiate(result)
modpol.interactions.text_query(
self.initiator, "Message to all org members: ",
function(input)
local message = self.initiator.." to org "..
self.org.name..": "..input
if input and input ~= "" then
modpol.interactions.message_org(
self.initiator, self.org.id, message)
end
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
end
)
if result then result() end
self.org:delete_process(self.id)
end
modpol.modules.message_org = message_org

View File

@ -0,0 +1,53 @@
--- A utility module that outputs a random result from a set of options
-- @module randomizer
local randomizer = {
name = "Randomizer",
slug = "randomizer",
desc = "A utility module other modules use for random decisions",
hide = true
}
randomizer.data = {
}
-- options_table should be a table of strings
randomizer.config = {
options_table = {},
num_results = 1,
result_table = {}
}
--- Initiate function
-- @function randomizer:initiate
-- @param result Callback if this module is embedded in other modules
function randomizer:initiate(result)
self.data.result = result
self.data.options_table = modpol.util.copy_table(self.config.options_table)
-- if options table is empty, randomizer returns that
if #self.data.options_table == 0 or self.config.num_results == 0 then
if self.data.result then
self.data.result({}) end
self.org:delete_process(self.id)
else
-- otherwise, choose a random result
self.random_loop()
end
end
--- Returns result_table
-- @function randomizer:random_loop
function randomizer:random_loop()
self.data.results = 0
if results == self.config.num_results then
self.data.result(self.data.result_table)
else
math.randomseed(os.time())
local index = math.random(self.data.options_table)
table.insert(self.data.result_table, self.data.options_table[index])
table.remove(self.data.options_table, index)
self.data.results = self.data.results + 1
end
end
modpol.modules.randomizer = randomizer

View File

@ -1,22 +1,26 @@
--- Remove child (consent) --- Remove child org
-- A simple module that calls a consent process on an org to remove its child -- A simple module that calls a process on an org to remove its child.
-- Depends on the Consent module. -- @module remove_child_org
local remove_child_consent = { local remove_child_org = {
name = "Remove child (consent)", name = "Remove child org",
slug = "remove_child_consent", slug = "remove_child_org",
desc = "Removes a child org if all members of this org consent." desc = "Removes a child org."
} }
remove_child_consent.data = { remove_child_org.data = {
result = nil, result = nil,
child_to_remove = nil child_to_remove = nil
} }
remove_child_consent.config = { remove_child_org.config = {
approval_module = false
} }
function remove_child_consent:initiate(result) --- Removes a child org with consent
-- @function remove_child_org:initiate
-- @param result Callback if this module is embedded in other modules
function remove_child_org:initiate(result)
local children = {} local children = {}
for i,v in ipairs(self.org.children) do for i,v in ipairs(self.org.children) do
local child = modpol.orgs.get_org(v) local child = modpol.orgs.get_org(v)
@ -38,12 +42,11 @@ function remove_child_consent:initiate(result)
children, children,
function(input) function(input)
self.data.child_to_remove = modpol.orgs.get_org(input) self.data.child_to_remove = modpol.orgs.get_org(input)
self.org:call_module( self:call_module(
"consent", self.config.approval_module,
self.initiator, self.initiator,
{ {
prompt = "Remove child org "..input.."?", prompt = "Remove child org "..input.."?"
votes_required = #self.org.members
}, },
function() function()
self:complete() self:complete()
@ -54,18 +57,19 @@ function remove_child_consent:initiate(result)
end end
end end
function remove_child_consent:complete() --- Complete the remove process
-- @function remove_child_org:complete
function remove_child_org:complete()
modpol.interactions.message_org( modpol.interactions.message_org(
self.initiator, self.data.child_to_remove.id, self.initiator, self.data.child_to_remove.id,
"Removing org " .. self.data.child_to_remove.name .. "Removing this org: " .. self.data.child_to_remove.name)
" by parent org consent")
modpol.interactions.message_org( modpol.interactions.message_org(
self.initiator, self.org.id, self.initiator, self.org.id,
"Consent reached: removing org " .. "Removing child org of " .. self.org.name .. ": " ..
self.data.child_to_remove.name) self.data.child_to_remove.name)
self.data.child_to_remove:delete() self.data.child_to_remove:delete()
if self.data.result then self.data.result() end if self.data.result then self.data.result() end
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
modpol.modules.remove_child_consent = remove_child_consent modpol.modules.remove_child_org = remove_child_org

View File

@ -1,26 +1,32 @@
--- remove_member_consent --- Removes member from org
-- @module remove_member_consent -- @module remove_member
local remove_member_consent = { local remove_member = {
name = "Remove a member (consent)", name = "Remove a member",
slug = "remove_member_consent", slug = "remove_member",
desc = "Removes org member with consent of other members" desc = "Removes org member"
} }
remove_member_consent.data = { remove_member.data = {
member_to_remove = "", member_to_remove = "",
result = nil result = nil
} }
remove_member_consent.config = { remove_member.config = {
approval_module = false
} }
function remove_member_consent:initiate(result) --- Removes given member from org
-- @function remove_member:initiate
-- @param result Callback if this module is embedded in other modules
function remove_member:initiate(result)
-- Abort if in root org -- Abort if in root org
if self.org == modpol.instance then if self.org == modpol.instance then
modpol.interactions.message( modpol.interactions.message(
self.initiator, self.initiator,
"Members cannot be removed from the root org") "Members cannot be removed from the root org")
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
if result then result() end if result then result() end
self.org:delete_process(self.id) self.org:delete_process(self.id)
else -- proceed if not root else -- proceed if not root
@ -32,13 +38,12 @@ function remove_member_consent:initiate(result)
self.org.members, self.org.members,
function(input) function(input)
self.data.member_to_remove = input self.data.member_to_remove = input
self.org:call_module( self:call_module(
"consent", self.config.approval_module,
self.initiator, self.initiator,
{ {
prompt = "Remove "..input.. prompt = "Remove "..input..
" from org "..self.org.name.."?", " from org "..self.org.name.."?"
votes_required = #self.org.members - 1
}, },
function() function()
self:complete() self:complete()
@ -49,10 +54,12 @@ function remove_member_consent:initiate(result)
end end
end end
function remove_member_consent:complete() --- Complete after consent
-- @function remove_member:complete
function remove_member:complete()
modpol.interactions.message_org( modpol.interactions.message_org(
self.initiator, self.org.id, self.initiator, self.org.id,
"Consent reached: removing ".. "Removing "..
self.data.member_to_remove.. self.data.member_to_remove..
" from org "..self.org.name) " from org "..self.org.name)
self.org:remove_member(self.data.member_to_remove) self.org:remove_member(self.data.member_to_remove)
@ -60,5 +67,4 @@ function remove_member_consent:complete()
if self.data.result then self.data.result() end if self.data.result then self.data.result() end
end end
--- (Required) Add to module table modpol.modules.remove_member = remove_member
modpol.modules.remove_member_consent = remove_member_consent

View File

@ -1,33 +1,57 @@
--- @module Remove Org --- Remove org
-- A simple module that removes an org. -- Removes the current org
-- @module remove_org
local remove_org = {
--- Main module table
remove_org = {
name = "Remove this org", name = "Remove this org",
slug = "remove_org", slug = "remove_org",
desc = "Eliminates the org and all child orgs." desc = "Removes this org."
} }
remove_org.config = {} remove_org.data = {
remove_org.data = {} result = nil
}
--- Initiate function remove_org.config = {
-- @function initiate approval_module = false
}
--- Remove org if all members consent
-- @function remove_org:initiate
-- @param result Callback if this module is embedded in other modules
function remove_org:initiate(result) function remove_org:initiate(result)
if self.org == modpol.instance then if self.org == modpol.instance then
modpol.interactions.message( modpol.interactions.message(
self.initiator, self.initiator,
"Cannot remove the root org") "Cannot remove root org")
else
modpol.interactions.message_org(
self.initiator,self.org.id,
"Removing org: "..self.org.name)
self.org:delete()
modpol.interactions.dashboard(self.initiator)
-- call result function
end
if result then result() end if result then result() end
self.org:delete_process(self.id)
else
self.data.result = result
self:call_module(
self.config.approval_module,
self.initiator,
{
prompt = "Remove org " .. self.org.name .. "?"
},
function()
self:complete()
end
)
modpol.interactions.org_dashboard(
self.initiator, modpol.orgs.get_org(self.org.parent).name)
end
end
--- Complete after approval
-- @function remove_org:complete
function remove_org:complete()
modpol.interactions.message_org(
self.initiator, self.org.id,
"Removing org " .. self.org.name)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
self.org:delete()
end end
modpol.modules.remove_org = remove_org modpol.modules.remove_org = remove_org

View File

@ -1,52 +0,0 @@
--- Remove org (consent)
-- A simple module that calls a consent process on an org to remove it.
-- Depends on the Consent module.
local remove_org_consent = {
name = "Remove this org (consent)",
slug = "remove_org_consent",
desc = "Removes an org if all members consent."
}
remove_org_consent.data = {
result = nil
}
remove_org_consent.config = {
}
function remove_org_consent:initiate(result)
if self.org == modpol.instance then
modpol.interactions.message(
self.initiator,
"Cannot remove root org")
if result then result() end
self.org:delete_process(self.id)
else
self.data.result = result
self.org:call_module(
"consent",
self.initiator,
{
prompt = "Remove org " .. self.org.name .. "?",
votes_required = #self.org.members
},
function ()
self:complete()
end
)
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
end
end
function remove_org_consent:complete()
modpol.interactions.message_org(
self.initiator, self.org.id,
"Consent reached: removing org " .. self.org.name)
if self.data.result then self.data.result() end
self.org:delete_process(self.id)
self.org:delete()
end
modpol.modules.remove_org_consent = remove_org_consent

View File

@ -0,0 +1,110 @@
--- Remove a process
-- @module remove_process
local remove_process = {
name = "Remove process",
slug = "remove_process",
desc = "User can remove own processes, approval required for those of others",
hide = false;
}
remove_process.data = {
}
remove_process.config = {
approval_module = "consent"
}
--- Initiate function
-- @function remove_process:initiate
-- @param result Callback if this module is embedded in other modules
function remove_process:initiate(result)
-- prepare process options
local available_processes = {}
for k,process in pairs(self.org.processes) do
if process ~= "deleted" then
available_processes[process.id] = process
end
end
local process_list = {}
local process_count = 0
for k,v in pairs(available_processes) do
local mine = ""
if v.initiator == self.initiator then mine = "*" end
table.insert(process_list,"["..v.id.."] "..v.slug..mine)
process_count = process_count + 1
end
-- abort if no processes to remove
if process_count == 0 then
modpol.interactions.message(
self.initiator, "Org has no modules")
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
self.org:delete_process(self.id)
return
end
table.sort(process_list)
-- now ask which to remove
modpol.interactions.dropdown_query(
self.initiator, "Choose a process to remove (* marks yours, no consent required):",
process_list,
function(process_choice)
-- confirm choice
local process_id = tonumber(
string.match(process_choice, "%d+"))
local process_mine = string.match(process_choice,
"%*")
modpol.interactions.binary_poll_user(
self.initiator,
"Confirm: Remove process \""..
process_choice .. "\"?",
function(input)
if input == "Yes" then
if process_mine then
self.org:delete_process_tree(process_id)
modpol.interactions.message(
self.initiator,
"Removed process: "..process_choice)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
self.org:delete_process(self.id)
else
self:call_module(
self.config.approval_module,
self.initiator,
{
prompt =
"Approve removal of process "
..process_choice.."?"
},
function(input)
modpol.interactions.message_org(
self.initiator,
self.org.id,
"Removing process: "..
process_choice)
self.org:delete_process_tree(process_id)
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
self.org:delete_process(self.id)
end
)
end
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
else
modpol.interactions.org_dashboard(
self.initiator, self.org.id)
if result then result() end
self.org:delete_process(self.id)
end
end
)
end
)
end
modpol.modules.remove_process = remove_process

View File

@ -1,22 +1,26 @@
--- Rename org (consent) --- Rename org
-- A simple module that calls a consent process on an org to rename it. -- Calls a process on an org to rename it.
-- Depends on the Consent module. -- @module rename_org
local rename_org_consent = { local rename_org = {
name = "Rename this org (consent)", name = "Rename this org",
slug = "rename_org_consent", slug = "rename_org",
desc = "Renames an org if all members consent." desc = "Renames an org."
} }
rename_org_consent.data = { rename_org.data = {
result = nil, result = nil,
new_name = nil new_name = nil
} }
rename_org_consent.config = { rename_org.config = {
approval_module = false
} }
function rename_org_consent:initiate(result) --- Renames the org after consent is reached
-- @function rename_org:initiate
-- @param result Callback if this module is embedded in other modules
function rename_org:initiate(result)
modpol.interactions.text_query( modpol.interactions.text_query(
self.initiator,"New org name: ", self.initiator,"New org name: ",
function(input) function(input)
@ -45,13 +49,12 @@ function rename_org_consent:initiate(result)
"Proposed to change name of org " .. "Proposed to change name of org " ..
self.org.name .. " to " .. input) self.org.name .. " to " .. input)
-- initiate consent process -- initiate consent process
self.org:call_module( self:call_module(
"consent", self.config.approval_module,
self.initiator, self.initiator,
{ {
prompt = "Change name of org " .. prompt = "Change name of org " ..
self.org.name .. " to " .. input .. "?", self.org.name .. " to " .. input .. "?"
votes_required = #self.org.members
}, },
function() function()
self:complete() self:complete()
@ -63,7 +66,9 @@ function rename_org_consent:initiate(result)
) )
end end
function rename_org_consent:complete() --- Changes the name of the org
-- @funciton rename_org
function rename_org:complete()
modpol.interactions.message_org( modpol.interactions.message_org(
self.initiator, self.initiator,
self.org.name, self.org.name,
@ -74,4 +79,4 @@ function rename_org_consent:complete()
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end
modpol.modules.rename_org_consent = rename_org_consent modpol.modules.rename_org = rename_org

View File

@ -0,0 +1,76 @@
--- Send token.
-- Depends on tokenomics
-- @module send_token
local send_token = {
name = "Send tokens",
slug = "send_token",
desc = "Send tokens to another user",
hide = false;
}
--- (Required) Data for module
-- Variables that module uses during the course of a process
-- Can be blank
send_token.data = {
}
send_token.config = {
token_name = nil -- hidden configuration
}
--- initiate function
-- @function send_token:initiate
-- @param result Callback if this module is embedded in other modules
function send_token:initiate(result)
local token_list = {}
if self.org.tokens then
for k,v in pairs(self.org.tokens) do
table.insert(token_list, k)
end
end
if #token_list == 0 then
modpol.interactions.message(
self.initiator,
"No tokens in org")
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
self.org:delete_process(self.id)
return
else
modpol.interactions.dropdown_query(
self.initiator,
"Which token do you want to send?",
token_list,
function(input_token)
modpol.interactions.dropdown_query(
self.initiator,
"Who do you want to send to?",
modpol.util.copy_table(self.org.members),
function(input_recipient)
modpol.interactions.text_query(
self.initiator,
"How much do you want to give (a number)?",
function(input_amount)
modpol.modules.tokenomics.transfer(
self.org.id,
input_token,
self.initiator,
input_recipient,
input_amount
)
modpol.interactions.org_dashboard(
self.initiator, self.org.name)
-- close process
if result then result() end
self.org:delete_process(self.id)
end
)
end
)
end
)
end
end
modpol.modules.send_token = send_token

View File

@ -1,52 +1,59 @@
--- module_template --- Template for module writers.
-- Short description goes here.
-- @module module_template -- @module module_template
--- (Required): data table containing name and description of the module --- (Required): Data table containing name and description of the module
-- @field name "Human-readable name (parens OK, no brackets)" -- @field name "Human-readable name (parens OK, no brackets)"
-- @field slug "Same as module class name" -- @field slug "Same as module class name"
-- @field desc "Description of the module" -- @field desc "Description of the module"
-- @field hide "Whether this is a hidden utility module" -- @field hide Whether this is a hidden utility module
local module_template = { local module_template = {
name = "Module Human-Readable Name", name = "Module Human-Readable Name",
slug = "template", slug = "module_template",
desc = "Description of the module", desc = "Description of the module",
hide = false; hide = false;
} }
--- (Required) Data for module --- (Required) Data for module
-- Variables that module uses during the course of a process -- Variables that module uses during the course of a process.
-- Can be blank -- Can be blank
module_template.data = { module_template.data = {
} }
--- (Required): config for module --- (Required): Config for module
-- Defines the input parameters to the module initiate function. -- Defines the input parameters to the module initiate function.
-- Can be blank -- Can be blank
-- When calling a module from within another module, -- When calling a module from within another module,
-- variables not defined in config will be ignored. -- variables not defined in config will be ignored.
-- Default values set in config can be overridden -- Default values set in config can be overridden
-- @field approval_module names a module that must pass before approval; defaults to false
-- @field field_1 ex: votes_required, default = 5 -- @field field_1 ex: votes_required, default = 5
-- @field field_2 ex: voting_type, default = "majority" -- @field field_2 ex: voting_type, default = "majority"
module_template.config = { module_template.config = {
approval_module = false -- visible but empty
hidden_config = nil -- not visible to users unless used
field_1 = 5 field_1 = 5
field_2 = "majority" field_2 = "majority"
} }
--- (Required): initiate function --- (Required): Initiate function
-- Modules have access to the following instance variables: -- Modules have access to the following instance variables:
-- <li><code>self.org</code> (the org the module was called in),</li> -- <li><code>self.org</code> (the org the module was called in),</li>
-- <li><code>self.initiator</code> (the user that callced the module),</li> -- <li><code>self.initiator</code> (the user that callced the module),</li>
-- <li><code>self.id</code> (the process id of the module instance)</li> -- <li><code>self.id</code> (the process id of the module instance)</li>
-- @function module_template:initiate
-- @param result (optional) Callback if this module is embedded in other modules -- @param result (optional) Callback if this module is embedded in other modules
-- @function initiate
function module_template:initiate(result) function module_template:initiate(result)
-- call interaction functions here! -- call interaction functions here!
-- concluding functions: -- concluding functions:
-- call these wherever process might end; -- first, where appropriate, return users to dashboards.
-- second, result:
-- may need to put result in self.data.result -- may need to put result in self.data.result
-- if process ends in another function -- call this when module is successful (not for abort):
if result then result() end if result then result() end
-- third, delete the process
-- call this wherever process might end:
self.org:delete_process(self.id) self.org:delete_process(self.id)
end end

View File

@ -0,0 +1,225 @@
--- Tokenomics.
-- @module tokenomics
local tokenomics = {
name = "Tokenomics",
slug = "tokenomics",
desc = "A simple library for token economics",
hide = true;
}
tokenomics.data = {
result = nil
}
--- Config for module
-- @field token_variables the data that goes into the token
-- @field token_slug A no-spaces slug for the token
-- @field initial_treasury Quantity in org treasury
-- @field negative_spend Boolean: can users spend negative tokens? (for mutual credit)
-- @field balances Table of user balances
tokenomics.config = {
approval_module = false,
token_slug = "token",
token_variables = {
treasury = 0,
negative_spend = true,
balances = {}
}
}
--- Initiate function: creates a token in an org.
-- Set up the token data structure.
-- Create an org treasury
-- @function tokenomics:initiate
-- @param result (optional) Callback if this module is embedded in other modules
function tokenomics:initiate(result)
-- TODO need to create a series of interactions to get the info from users
self.data.result = result
if self.org.tokens and self.org.tokens[slug] then
modpol.interactions.message(
self.initiator, "Token slug taken, aborting")
self.org:delete_process(self.id)
else
self:call_module(
self.config.approval_module,
self.initiator,
{
prompt = "Create token " ..
self.config.token_slug .. "?"
},
function()
modpol.interactions.message_org(
self.initiator, self.org.id,
"Creating token " ..
self.config.token_slug)
self:create_token()
end
)
end
end
--- Create token
-- @function tokenomics:create_token
function tokenomics:create_token()
if not self.org.tokens then self.org.tokens = {} end
self.org.tokens[self.config.token_slug] =
self.config.token_variables
self.org:record("Created token "..self.config.token_slug,
self.slug)
modpol.interactions.message_org(
self.initiator, self.org.id,
"Created token "..self.config.token_slug)
if self.data.result then self.data.result() end
-- call this wherever process might end:
self.org:delete_process(self.id)
end
-----------------------------------------
-- Utility functions
-- all need to account for the fact that some users may not yet have balances
-- all need to write to persistent data
-- amount can be positive or negative (except transfer)
--- Returns balance.
-- If no user, get treasury balance
-- @function tokenomics.balance
-- @param org Name (string) or id (num)
-- @param token Slug (string)
-- @param user Name (string)
function tokenomics.balance(org, token, user)
local this_org = modpol.orgs.get_org(org)
if not this_org[token] then return nil, "Token not found" end
if not user then
return this_org[token].treasury
end
if not this_org[user] then
return nil, "User not found"
else
local user_balance = this_org[token].balances[user]
if user_balance then
return user_balance
else
return 0
end
end
end
--- Change balance
-- @function tokenomics.change_balance
-- @param org Org name (string) or id (number)
-- @param token Token slug (string)
-- @param user
-- @param amount
function tokenomics.change_balance(org, token, user, amount)
local this_org = modpol.orgs.get_org(org)
if not this_org then
return nil, "Cannot change balance: Org not found"
elseif not this_org.tokens then
return nil, "Cannot change balance: no tokens found"
elseif not this_org.tokens[token] then
return nil, "Cannot change balance: token not found"
elseif not this_org.members[user] then
return nil, "Cannot change balance: user not in org"
elseif not tonumber(amount) then
return nil, "Cannot change balance: invalid amount"
else
local old_balance = this_org.tokens[token].balances[user]
if not old_balance then old_balance = 0 end
local new_balance = old_balance + amount
this_org.tokens[token].balances[user] = new_balance
local msg = "Your balance of token "..token..
" changed from "..old_balance.." to "..new_balance
modpol.interactions.message(user, msg)
self.org:record(
"Changed token balance for "..user,self.slug)
end
end
--- Transfer tokens from a sender to recipient
-- @function tokenomics.transfer
-- @param org
-- @param token
-- @param sender
-- @param recipient
-- @param amount Positive number
function tokenomics.transfer(org, token, sender, recipient, amount)
local sender_balance = tokenomics.balance(org, token, sender)
local recipient_balance = tokenomics.balance(org, token, recipient)
if not sender_balance or recipient_balance then
return nil, "Transfer failed, user not found"
else
sender_balance = sender_balance - amount
recipient_balance = recipient_balance + amount
local neg_spend = modpol.orgs.get_org(org).tokens[token].negative_spend
if sender_balance < 0 and not neg_spend then
return nil, "Transfer failed, negative spend not allowed"
else
tokenomics.change_balance(
org, token, sender, sender_balance)
tokenomics.change_balance(
org, token, recipient, recipient_balance)
return "Transfer complete"
end
end
end
--- Transfer from treasury
-- @function tokenomics.treasury_transfer
-- @param org
-- @param token
-- @param recipient
-- @param amount Can be positive or negative, assumes flow from treasury to recipient
function tokenomics.treasury_transfer(org, token, recipient, amount)
local this_org = modpol.orgs.get_org(org)
if not this_org then
return nil, "Cannot transfer treasury: Org not found"
elseif not this_org.tokens then
return nil, "Cannot transfer treasury: no tokens found"
elseif not this_org.tokens[token] then
return nil, "Cannot transfer treasury: token not found"
elseif not this_org.members[user] then
return nil, "Cannot transfer treasury: user not in org"
elseif not tonumber(amount) then
return nil, "Cannot change balance: invalid amount"
else
local new_treasury = this_org.tokens[token].treasury - amount
local new_recipient_balance = tokenomics.balance(org, token, recipient) + amount
if new_treasury < 0 and not this_org.tokens[token].negative_spend then
return nil, "Transfer failed, negative spend not allowed"
elseif new_recipient_balance < 0 and not this_org.tokens[token].negative_spend then
return nil, "Transfer failed, negative spend not allowed"
else
this_org.tokens[token].treasury = new_treasury
self.org:record("Treasury payment",self.slug)
tokenomics.change_balance(org, token, recipient, amount)
end
end
end
--- Creates new tokens in the org treasury
-- @function tokenomics.issue
-- @param org
-- @param token
-- @param amount
function tokenomics.issue(org, token, amount)
local this_org = modpol.orgs.get_org(org)
if not this_org then
return nil, "Cannot transfer treasury: Org not found"
elseif not this_org.tokens then
return nil, "Cannot transfer treasury: no tokens found"
elseif not this_org.tokens[token] then
return nil, "Cannot transfer treasury: token not found"
elseif not tonumber(amount) then
return nil, "Cannot change balance: invalid amount"
else
this_org.tokens[token].treasury =
this_org.tokens[token].treasury + amount
self.org:record("Issued tokes to treasury","tokenomics")
end
end
------------------------------------------
modpol.modules.tokenomics = tokenomics

View File

@ -1,5 +1,5 @@
--- Orgs: Base --- Basic function for orgs
-- Basic functions for orgs -- @module modpol.orgs.base
modpol.orgs = modpol.orgs or modpol.orgs = modpol.orgs or
{ {
@ -14,32 +14,40 @@ function temp_org()
return { return {
id = nil, id = nil,
name = nil, name = nil,
modules = modpol.copy_table(modpol.modules), policies = {},
processes = {}, processes = {},
pending = {}, pending = {},
members = {}, members = {},
parent = nil, parent = nil,
children = {} children = {},
} }
end end
-- ================================================== --- Return org when given its id or name
-- returns org when given its id or name -- @function modpol.orgs.get_org
-- @param arg string for name of org or id of org, or nil if no org
-- @return org specified by id or name
function modpol.orgs.get_org(arg) function modpol.orgs.get_org(arg)
local output = nil
if type(arg) == 'string' then if type(arg) == 'string' then
for id, org in ipairs(modpol.orgs.array) do for id, org in ipairs(modpol.orgs.array) do
if org ~= "deleted" then
if org.name == arg then if org.name == arg then
return org output = org
end
end end
end end
elseif type(arg) == 'number' then elseif type(arg) == 'number' then
return modpol.orgs.array[arg] if modpol.orgs.array[arg] ~= "deleted" then
output = modpol.orgs.array[arg]
end end
return nil end
return output
end end
-- =============================================== --- Return a table list of all org names
-- returns a table list of all org names -- @function modpol.orgs.list_all
-- @return a table list of all org names
function modpol.orgs.list_all() function modpol.orgs.list_all()
local org_table local org_table
for k, v in ipairs(modpol.orgs.array) do for k, v in ipairs(modpol.orgs.array) do
@ -54,9 +62,10 @@ function modpol.orgs.list_all()
return org_table return org_table
end end
-- Function: modpol.orgs.user_orgs(user) --- Return the orgs of a user
-- input: user (string) -- @function modpol.orgs.user_orgs
-- output: table of strings of org names -- @param user string of user name
-- @return table of strings of org names
function modpol.orgs.user_orgs(user) function modpol.orgs.user_orgs(user)
local all_orgs = modpol.orgs.list_all() local all_orgs = modpol.orgs.list_all()
local user_orgs = {} local user_orgs = {}
@ -69,26 +78,28 @@ function modpol.orgs.user_orgs(user)
return user_orgs return user_orgs
end end
-- =========================================== --- Deletes all orgs except for the
-- deletes all orgs except for the instance -- @function modpol.orgs.reset
function modpol.orgs.reset() function modpol.orgs.reset()
local instance_members =
modpol.util.copy_table(modpol.instance.members)
for id, org in ipairs(modpol.orgs.array) do for id, org in ipairs(modpol.orgs.array) do
if id > 1 then if id > 1 then
modpol.orgs.array[id] = "removed" modpol.orgs.array[id] = "deleted"
end end
end end
modpol.orgs.array[1] = nil modpol.orgs.array[1] = nil
modpol.instance = modpol.orgs.init_instance() modpol.instance = modpol.orgs.init_instance()
modpol.instance.members = instance_members
modpol.ocutil.log('All orgs reset')
modpol.ocutil.log('Reset all orgs')
modpol.orgs:record('Resetting all orgs', 'org_reset') modpol.orgs:record('Resetting all orgs', 'org_reset')
end end
-- =================================================== --- Initializes the instance (root org)
-- initializes the instance (root org)
-- can only be run once, as only one instance can exist -- can only be run once, as only one instance can exist
-- @function modpol.orgs.init_instance
function modpol.orgs.init_instance() function modpol.orgs.init_instance()
local error_msg local error_msg
if modpol.orgs.array[1] then if modpol.orgs.array[1] then
@ -98,7 +109,10 @@ function modpol.orgs.init_instance()
local instance = temp_org() local instance = temp_org()
instance.id = 1 instance.id = 1
instance.name = "root" instance.name = "Root"
for i,v in pairs(modpol.modules) do
instance.policies[i] = {}
end
setmetatable(instance, modpol.orgs) setmetatable(instance, modpol.orgs)
@ -114,8 +128,8 @@ end
-- FUNCTIONS BEYOND HERE OPERATE ON ORG OBJECTS -- FUNCTIONS BEYOND HERE OPERATE ON ORG OBJECTS
-- ======================================================= --- Records a log message to the modpol ledger
-- records a log message to the modpol ledger -- @function modpol.orgs:record
function modpol.orgs:record(msg, entry_type) function modpol.orgs:record(msg, entry_type)
local entry = { local entry = {
timestamp = '', timestamp = '',
@ -148,10 +162,12 @@ function modpol.orgs:record(msg, entry_type)
modpol.store_data() modpol.store_data()
end end
-- ================================================== --- Adds a new sub org to the org it is called on.
-- adds a new sub org to the org it is called on -- Ex: instance:add_org('town hall')
-- input: name (string), user (string) -- @function modpol.orgs:add_org
-- ex: instance:add_org('town hall') -- @param name (string) name of new org
-- @param user (string)
-- @return child org created
function modpol.orgs:add_org(name, user) function modpol.orgs:add_org(name, user)
if self.id == nil then if self.id == nil then
modpol.ocutil.log('Error in ' .. self.name .. ':add_org -> add_org can only be called by another org') modpol.ocutil.log('Error in ' .. self.name .. ':add_org -> add_org can only be called by another org')
@ -175,7 +191,7 @@ function modpol.orgs:add_org(name, user)
child_org.name = name child_org.name = name
child_org.parent = self.id child_org.parent = self.id
child_org.processes = {} child_org.processes = {}
child_org.modules = self.modules child_org.policies = modpol.util.copy_table(self.policies)
setmetatable(child_org, modpol.orgs) setmetatable(child_org, modpol.orgs)
@ -194,34 +210,47 @@ function modpol.orgs:add_org(name, user)
return child_org return child_org
end end
-- ======================================== --- Recursively deletes an org and its suborgs
-- recursively deletes an org and its suborgs -- Leaves entry in modpol.orgs.array as a string "removed".
-- leaves entry in modpol.orgs.array as a string "removed" -- Note: "reason" param was removed, can be added back
-- note: "reason" param was removed, can be added back -- @function modpol.orgs:delete
function modpol.orgs:delete() function modpol.orgs:delete()
if self.id == 1 then if self.id == 1 then
modpol.ocutil.log('Error in ' .. self.name .. ':delete -> cannot delete instance') modpol.ocutil.log('Error in ' .. self.name .. ':delete -> cannot delete instance')
return false return false
end end
-- remove from parent's list
local parent = modpol.orgs.get_org(self.id)
if parent then
for k,v in ipairs(parent.children) do
if v == self.id then
v = "deleted"
end
end
end
-- remove children
if #self.children > 0 then if #self.children > 0 then
for i, child_id in pairs(self.children) do for i, child_id in pairs(self.children) do
local child = modpol.orgs.get_org(child_id) local child = modpol.orgs.get_org(child_id)
modpol.ocutil.log(child_id, child) modpol.ocutil.log("Deleting child org...")
child:delete() child:delete()
end end
end end
modpol.orgs.array[self.id] = 'removed' modpol.orgs.array[self.id] = 'deleted'
modpol.orgs.count = modpol.orgs.count - 1
modpol.ocutil.log('Deleted org ' .. self.name .. ': ' .. self.id) modpol.ocutil.log('Deleted org ' .. self.name .. ': ' .. self.id)
self:record('Deleted ' .. self.name .. ' and all child orgs', 'del_org') self:record('Deleted ' .. self.name .. ' and all child orgs', 'del_org')
end end
--- Internal function to get the index of a member name
-- =========================================== -- @function modpol.orgs:get_member_index
-- internal function to get the index of a member name -- @param member
-- @return index of given member
function modpol.orgs:get_member_index(member) function modpol.orgs:get_member_index(member)
for k, v in ipairs(self.members) do for k, v in ipairs(self.members) do
if v == member then if v == member then
@ -230,8 +259,9 @@ function modpol.orgs:get_member_index(member)
end end
end end
-- =========================================== --- Adds a user to an org
-- adds a user to an org -- @function modpol.orgs:add_member
-- @param user
function modpol.orgs:add_member(user) function modpol.orgs:add_member(user)
for id, name in ipairs(self.members) do for id, name in ipairs(self.members) do
if user == name then if user == name then
@ -253,8 +283,9 @@ function modpol.orgs:add_member(user)
end end
-- ======================================= --- Removes a user from an org
-- removes a user from an org -- @function modpol.orgs:remove_member
-- @param user
function modpol.orgs:remove_member(user) function modpol.orgs:remove_member(user)
-- sets the array index to an empty string so that consecutive list is preserved -- sets the array index to an empty string so that consecutive list is preserved
-- empty spots will get filled in by new members -- empty spots will get filled in by new members
@ -268,8 +299,10 @@ function modpol.orgs:remove_member(user)
self:record('Removed member ' .. user, 'del_member') self:record('Removed member ' .. user, 'del_member')
end end
-- =========================================== --- Boolean check whether user is an org
-- boolean check whether user is an org -- @function modpol.orgs:has_member
-- @param user
-- @return true if user is in org, false if not
function modpol.orgs:has_member(user) function modpol.orgs:has_member(user)
local user_index = self:get_member_index(user) local user_index = self:get_member_index(user)
if user_index then if user_index then
@ -279,9 +312,9 @@ function modpol.orgs:has_member(user)
end end
end end
-- ================================== ---
-- Function: modpol.orgs:list_members() -- @function modpol.orgs:list_members()
-- output: a table of the names (string) of members -- @return a table of the names (string) of members
function modpol.orgs:list_members() function modpol.orgs:list_members()
local members = {} local members = {}
for k, v in ipairs(self.members) do for k, v in ipairs(self.members) do
@ -290,8 +323,9 @@ function modpol.orgs:list_members()
return members return members
end end
-- ============================== --- Because member list uses lazy deletion, using #org.members will not show an accurate number
-- because member list uses lazy deletion, using #org.members will not show an accurate number -- @function modpol.orgs:get_member_count
-- @return numbers of members
function modpol.orgs:get_member_count() function modpol.orgs:get_member_count()
local count = 0 local count = 0
for k, v in ipairs(self.members) do for k, v in ipairs(self.members) do
@ -302,17 +336,3 @@ function modpol.orgs:get_member_count()
end end
return count return count
end end
-- ====================================
-- adds a new policy to the policy table
-- must define the policy type, process associated with it, and whether the request must be made by an org member
function modpol.orgs:set_policy(policy_type, process_type, must_be_member)
local new_policy = {
process_type = process_type,
must_be_member = must_be_member
}
self.policies[policy_type] = new_policy
modpol.ocutil.log('Added policy for ' .. policy_type .. ' in ' .. self.name)
self:record('Added policy for ' .. policy_type, 'set_policy')
end

View File

@ -1,35 +1,45 @@
--- Process functions for orgs --- Process functions for orgs
-- @module modpol.orgs.process
function modpol.orgs:call_module(module_slug, initiator, config, result) --- Call modules
if not modpol.modules[module_slug] then -- @function modpol.orgs.call_module
modpol.ocutil.log('Error in ' .. self.name .. ':call_module -> module "' .. module_slug .. '" not found') -- @param module_slug Same as module name (or false to run result)
-- @param intiator Initiator for module
-- @param config Config for module
-- @param result
function modpol.orgs:call_module(module_slug, initiator, config, result, parent_id)
-- first, if no slug, just run result
-- may not be necessary if we use false as default approval_module
if not module_slug then
if result() then
result()
end
return
-- if module doesn't exist, abort
elseif not modpol.modules[module_slug] then
modpol.ocutil.log('Error in ' .. self.name .. ':call_module -> module "' .. tostring(module_slug) .. '" not found')
return return
end end
local empty_index = nil local index = #self.processes + 1
-- linear search for empty process slots (lazy deletion)
for k, v in ipairs(self.processes) do
if v == 'deleted' then
empty_index = k
break
end
end
local index
-- attempts to fill empty spots in list, otherwise appends to end
if empty_index then
index = empty_index
else
index = #self.processes + 1
end
local module = modpol.modules[module_slug] local module = modpol.modules[module_slug]
-- sets default values for undeclared config variables -- first applies any relevant org policies
if #module.config > 0 then -- then overrides with the config values given on input
local new_config = {}
if modpol.util.num_pairs(module.config) > 0 then
for k, v in pairs(module.config) do for k, v in pairs(module.config) do
if config[k] == nil then new_config[k] = v
config[k] = v -- overrides with org policies
if self.policies[module_slug]
and self.policies[module_slug][k] then
new_config[k] = self.policies[module_slug][k]
end
-- overrides with input settings
if config and config[k] then
new_config[k] = config[k]
end end
end end
end end
@ -40,23 +50,77 @@ function modpol.orgs:call_module(module_slug, initiator, config, result)
initiator = initiator, initiator = initiator,
org = self, org = self,
id = index, id = index,
config = config, parent_id = parent_id,
data = module.data, children = {},
config = modpol.util.copy_table(new_config),
data = modpol.util.copy_table(module.data),
slug = module_slug slug = module_slug
} }
-- call module wrapper for modules, passes its id to child process when called
function new_process:call_module(module_slug, initiator, config, result)
local child_id = self.org:call_module(module_slug, initiator, config, result, self.id)
table.insert(self.children, child_id)
end
setmetatable(new_process, new_process.metatable) setmetatable(new_process, new_process.metatable)
self.processes[index] = new_process self.processes[index] = new_process
self.processes[index]:initiate(result) self.processes[index]:initiate(result)
local msg = "Initiating "..module_slug..
" process id "..index.." in org "..self.name
return index return index
end end
function modpol.orgs:delete_process(id)
self.processes[id] = 'deleted'
--- Get the root process of the given id
-- @function modpol.orgs.get_root_process
-- @param id
-- @return root process
function modpol.orgs:get_root_process(id)
local process = self.processes[id]
while (process.parent_id) do
process = self.processes[process.parent_id]
end
return process
end end
--- Delete the process given id, return to dashboard
-- @function modpol.orgs.delete_process
-- @param id
function modpol.orgs:delete_process(id)
local process = self.processes[id]
if process and process ~= "deleted" then
-- recursively deletes any children
if #process.children > 0 then
for i, child_id in pairs(process.children) do
self:delete_process(child_id)
end
end
local msg = "Deleting " .. self.processes[id].slug .. " process id "..id.." in org "..self.name
modpol.ocutil.log(msg)
self:record(msg, self.processes[id].slug)
self:wipe_pending_actions(id)
-- sets process to 'deleted' in process table
self.processes[id] = 'deleted'
end
end
--- Delete process tree by id
-- @function modpol.orgs:delete_process_tree
-- @param id Id of process tree
function modpol.orgs:delete_process_tree(id)
self:delete_process(self:get_root_process(id).id)
end
--- Add a new pending action
-- @function modpol.orgs:add_pending_action
-- @param process_id Process id
-- @param user User adding the action
-- @param callback
function modpol.orgs:add_pending_action(process_id, user, callback) function modpol.orgs:add_pending_action(process_id, user, callback)
self.pending[user] = self.pending[user] or {} self.pending[user] = self.pending[user] or {}
self.pending[user][process_id] = callback self.pending[user][process_id] = callback
@ -64,18 +128,29 @@ function modpol.orgs:add_pending_action(process_id, user, callback)
user, "New pending action in org "..self.name) user, "New pending action in org "..self.name)
end end
--- Remove a pending action
-- @function modpol.orgs:remove_pending_action
-- @param process_id Process id to be removed
-- @param user
function modpol.orgs:remove_pending_action(process_id, user) function modpol.orgs:remove_pending_action(process_id, user)
if self.pending[user] then if self.pending[user] then
self.pending[user][process_id] = nil self.pending[user][process_id] = "deleted"
end end
end end
--- Wipe all pending actions for process
-- @function modpol.orgs:wipe_pending_actions
-- @param process_id
function modpol.orgs:wipe_pending_actions(process_id) function modpol.orgs:wipe_pending_actions(process_id)
for user in pairs(self.pending) do for user in pairs(self.pending) do
self.pending[user][process_id] = nil self.pending[user][process_id] = "deleted"
end end
end end
--- Check if there are pending actions for user
-- @function modpol.orgs:has_pending_actions
-- @param user User
-- @return True if there are pending actions for a user, false if not
function modpol.orgs:has_pending_actions(user) function modpol.orgs:has_pending_actions(user)
-- next() will return the next pair in a table -- next() will return the next pair in a table
-- if next() returns nil, the table is empty -- if next() returns nil, the table is empty
@ -90,12 +165,23 @@ function modpol.orgs:has_pending_actions(user)
end end
end end
--- Create user interaction with given process
-- @function modpol.orgs:interact
-- @param process_id
-- @param user
function modpol.orgs:interact(process_id, user) function modpol.orgs:interact(process_id, user)
local process = self.processes[process_id] local process = self.processes[process_id]
if self.pending[user] then if self.pending[user] then
local callback = self.pending[user][process_id] local callback = self.pending[user][process_id]
if callback then if callback and process ~= "deleted" then
-- get data in case callback ends process
local slug = self.processes[process_id].slug
-- run callback
process[callback](process, user) process[callback](process, user)
-- record org data
local msg = "Updating "..slug..
" process id "..process_id.." in org "..self.name
self:record(msg, slug)
end end
end end
end end

View File

@ -0,0 +1,27 @@
-- /users.lua
-- User-related functions for Modular Politics
-- ===================================================================
-- Function: modpol.list_users
-- Params: org
-- Outputs: Table of user names
--
-- This may be overwritten by the platform-specific interface
modpol.list_users = function(org)
local users = {}
if (org == nil) then -- no specified org; all players
if modpol.orgs["instance"]
and modpol.orgs["instance"]["members"] then
-- if instance exists and has membership
users = modpol.orgs["instance"]["members"]
else
users = {}
end
else -- if an org is specified
if (modpol.orgs[org] ~= nil) then -- org exists
users = modpol.orgs[org]["members"]
end
end
return users
end

View File

@ -11,8 +11,6 @@ modpol.file_ledger = modpol.datadir .. "/ledger.dat"
modpol.file_orgs = modpol.datadir .. "/orgs.dat" modpol.file_orgs = modpol.datadir .. "/orgs.dat"
modpol.file_old_ledgers = modpol.datadir .. "/old_ledgers.dat" modpol.file_old_ledgers = modpol.datadir .. "/old_ledgers.dat"
os.execute ("mkdir -p " .. modpol.datadir)
modpol.ocutil.setlogdir (modpol.datadir) modpol.ocutil.setlogdir (modpol.datadir)
modpol.ocutil.setlogname ("modpol.log") modpol.ocutil.setlogname ("modpol.log")
@ -101,7 +99,7 @@ local load_orgs = function()
-- setmetatable(org, modpol.orgs) -- setmetatable(org, modpol.orgs)
-- end -- end
local nn = modpol.ocutil.table_length (modpol.orgs.array) local nn = modpol.orgs.count
local str = "entries" local str = "entries"
if nn == 1 then str = "entry" end if nn == 1 then str = "entry" end
modpol.ocutil.log (nn .. " orgs loaded from disk") modpol.ocutil.log (nn .. " orgs loaded from disk")

View File

@ -1,9 +1,44 @@
--- @function modpol.copy_table --- Miscellaneous functions
-- Returns a copy of the table inputted -- @module modpol.util.misc
function modpol.copy_table(t)
modpol.util = {}
--- Returns a copy of the table inputted
-- @function modpol.util.copy_table
-- @param t table to copy
-- @return copy of table
function modpol.util.copy_table(t)
local t2 = {} local t2 = {}
if pairs(t) then
for k,v in pairs(t) do for k,v in pairs(t) do
if type(v) == "table" then
t2[k] = modpol.util.copy_table(v)
else
t2[k] = v t2[k] = v
end end
end
end
return t2 return t2
end end
--- Returns the number of elements in a pairs table
-- @function modpol.util.num_pairs
-- @param t pairs table
-- @return number of elements in pairs table
function modpol.util.num_pairs(t)
local i = 0
for k,v in pairs(t) do
i = i + 1
end
return i
end
function modpol.util.lazy_table_length(tbl, lazy_val)
local count = 0
for k, v in ipairs(tbl) do
if v ~= lazy_val then
count = count + 1
end
end
return count
end

View File

@ -9,11 +9,7 @@ local localdir = minetest.get_modpath("modpol") .. "/modpol_minetest"
--overrides --overrides
dofile (localdir .. "/overrides/interactions.lua") dofile (localdir .. "/overrides/interactions.lua")
dofile (localdir .. "/overrides/users.lua")
--testing command for "singleplayer"
function modpol.msg(text)
modpol.interactions.message("singleplayer",text)
end
-- =================================================================== -- ===================================================================
-- Minetest Chatcommands -- Minetest Chatcommands

View File

@ -34,8 +34,8 @@ regchat(
"mptest", { "mptest", {
privs = {privs=true}, privs = {privs=true},
func = function(user) func = function(user)
modpol.instance.members = modpol.list_users()
modpol.orgs.reset() modpol.orgs.reset()
modpol.instance:add_member(user)
modpol.interactions.dashboard(user) modpol.interactions.dashboard(user)
return true, "Reset orgs" return true, "Reset orgs"
end, end,

View File

@ -1,6 +1,6 @@
--- Set privilege to org members --- Set privilege to org members
-- @module priv_to_org
-- Allows initiator to grant a priv they have to all members of an org -- Allows initiator to grant a priv they have to all members of an org
-- @module priv_to_org
local priv_to_org = { local priv_to_org = {
name = "Set privilege to org members", name = "Set privilege to org members",
@ -14,13 +14,13 @@ priv_to_org.data = {
priv_to_org.config = { priv_to_org.config = {
} }
--- (Required): initiate function --- Initiate function
-- @param result (optional) Callback if this module is embedded in other modules -- @function priv_to_org:initiate
-- @function initiate -- @param result
function priv_to_org:initiate(result) function priv_to_org:initiate(result)
local player_privs = minetest.get_player_privs(self.initiator) local player_privs = minetest.get_player_privs(self.initiator)
-- construct table for display -- construct table for display
local player_privs_table = {"View..."} local player_privs_table = {}
for k,v in pairs(player_privs) do for k,v in pairs(player_privs) do
if player_privs[k] then if player_privs[k] then
table.insert(player_privs_table,k) table.insert(player_privs_table,k)
@ -31,6 +31,7 @@ function priv_to_org:initiate(result)
"Which privilege do you want to share with members of "..self.org.name.."?", "Which privilege do you want to share with members of "..self.org.name.."?",
player_privs_table, player_privs_table,
function(input) function(input)
modpol.interactions.org_dashboard(self.initiator,self.org.id)
for i,member in ipairs(self.org.members) do for i,member in ipairs(self.org.members) do
local member_privs = minetest.get_player_privs(member) local member_privs = minetest.get_player_privs(member)
member_privs[input] = true member_privs[input] = true
@ -44,5 +45,4 @@ function priv_to_org:initiate(result)
if result then result() end if result then result() end
end end
--- (Required) Add to module table
modpol.modules.priv_to_org = priv_to_org modpol.modules.priv_to_org = priv_to_org

View File

@ -1,5 +1,4 @@
-- INTERACTIONS.LUA (for Minetest) --- INTERACTIONS.LUA (for Minetest)
-- CONTEXTUAL STUFF -- CONTEXTUAL STUFF
-- ================ -- ================
@ -48,18 +47,33 @@ function modpol.interactions.dashboard(user)
local all_orgs = modpol.orgs.list_all() local all_orgs = modpol.orgs.list_all()
local user_orgs = modpol.orgs.user_orgs(user) local user_orgs = modpol.orgs.user_orgs(user)
local all_users = modpol.instance:list_members() local all_users = modpol.instance:list_members()
-- pending list
local user_pending_count = 0
local user_pending = {}
for k,v in ipairs(modpol.orgs.array) do
if v.pending and v.pending[user] then
if modpol.util.num_pairs(v.pending[user]) ~= 0 then
table.insert(user_pending, v.name)
user_pending_count = user_pending_count + 1
end
end
end
-- set up formspec -- set up formspec
local formspec = { local formspec = {
"formspec_version[4]", "formspec_version[4]",
"size[10,6]", "size[10,8]",
"label[0.5,0.5;M O D U L A R P O L I T I C S]", "hypertext[0.5,0.5;9,1;title;<big>Org dashboard</big>]",
"label[0.5,2;All orgs:]", "label[0.5,2;All orgs:]",
"dropdown[2,1.5;7,0.8;all_orgs;"..formspec_list(all_orgs)..";;]", "dropdown[2.5,1.5;7,0.8;all_orgs;View...,"..formspec_list(all_orgs)..";;]",
"label[0.5,3;Your orgs:]", "label[0.5,3;Your orgs:]",
"dropdown[2,2.5;7,0.8;user_orgs;"..formspec_list(user_orgs)..";;]", "dropdown[2.5,2.5;7,0.8;user_orgs;View...,"..formspec_list(user_orgs)..";;]",
"label[0.5,4;All users:]", "label[0.5,4;All users:]",
"dropdown[2,3.5;7,0.8;all_users;"..formspec_list(all_users)..";;]", "dropdown[2.5,3.5;7,0.8;all_users;View...,"..formspec_list(all_users)..";;]",
"button_exit[8.5,5;1,0.8;close;Close]", "label[0.5,5;Pending ("..user_pending_count.."):]",
"dropdown[2.5,4.5;7,0.8;pending;View...,"..formspec_list(user_pending)..";;]",
"button[0.5,7;1,0.8;refresh;Refresh]",
"button_exit[8.5,7;1,0.8;close;Close]",
} }
local formspec_string = table.concat(formspec, "") local formspec_string = table.concat(formspec, "")
-- present to player -- present to player
@ -70,15 +84,26 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
if formname == "modpol:dashboard" then if formname == "modpol:dashboard" then
local pname = player:get_player_name() local pname = player:get_player_name()
if nil then if nil then
-- buttons first
-- none here right now!
-- Put all dropdowns at the end
elseif fields.close then elseif fields.close then
minetest.close_formspec(pname, formname) minetest.close_formspec(pname, formname)
elseif fields.all_orgs or fields.user_orgs then elseif fields.refresh then
local org_name = fields.all_orgs or fields.user_orgs modpol.interactions.dashboard(pname)
modpol.interactions.org_dashboard(pname, org_name) -- Put all dropdowns at the end
elseif fields.all_users
and fields.all_users ~= "View..." then
modpol.interactions.user_dashboard(
pname,
fields.all_users,
function()
modpol.interactions.dashboard(pname)
end
)
elseif fields.all_orgs or fields.user_orgs or fields.pending then
local org_name = fields.all_orgs or fields.user_orgs or fields.pending
if org_name ~= "View..." then
modpol.interactions.org_dashboard(
pname, org_name)
end
end end
end end
end) end)
@ -107,42 +132,48 @@ function modpol.interactions.org_dashboard(user, org_string)
if parent then parent = parent.name if parent then parent = parent.name
else parent = "none" end else parent = "none" end
-- prepare members menu
local members = org.members
-- prepare children menu -- prepare children menu
local children = {} local children = {}
if org.children then
for k,v in ipairs(org.children) do for k,v in ipairs(org.children) do
local this_child = modpol.orgs.get_org(v) local this_child = modpol.orgs.get_org(v)
if this_child then
table.insert(children, this_child.name) table.insert(children, this_child.name)
end end
end
table.sort(children) table.sort(children)
table.insert(children,1,"View...") end
-- prepare modules menu -- prepare modules menu
local modules = {} local modules = {}
if org.modules then if modpol.modules then
for k,v in pairs(org.modules) do for k,v in pairs(modpol.modules) do
if not v.hide then -- hide utility modules if not v.hide and -- hide utility modules
local module_entry = v.name.. org.policies[k] then -- org includes it
" ["..v.slug.."]" local module_entry = v.name
table.insert(modules, module_entry) table.insert(modules, module_entry)
end end
end end
end end
table.sort(modules) table.sort(modules)
table.insert(modules,1,"View...")
-- prepare pending menu -- prepare pending menu
local pending = {} local pending = {}
local num_pending = 0 local num_pending = 0
if org.pending[user] then if org.pending[user] then
for k,v in pairs(org.pending[user]) do for k,v in pairs(org.pending[user]) do
if org.processes[k] ~= "deleted" then
local pending_string = org.processes[k].name local pending_string = org.processes[k].name
.." ["..k.."]" .." ["..k.."]"
table.insert(pending, pending_string) table.insert(pending, pending_string)
num_pending = num_pending + 1 num_pending = num_pending + 1
end end
end end
end
table.sort(pending) table.sort(pending)
table.insert(pending,1,"View...")
-- set player context -- set player context
local user_context = {} local user_context = {}
@ -152,17 +183,18 @@ function modpol.interactions.org_dashboard(user, org_string)
local formspec = { local formspec = {
"formspec_version[4]", "formspec_version[4]",
"size[10,8]", "size[10,8]",
"label[0.5,0.5;Org: ".. "hypertext[0.5,0.5;9,1;title;<big>Org: <b>"..
minetest.formspec_escape(org.name)..membership_toggle(org.name).."]", minetest.formspec_escape(org.name).."</b>"..membership_toggle(org.name).."</big>]",
"label[0.5,1;Parent: "..parent..membership_toggle(parent).."]", "label[0.5,1.25;Parent: "..parent..membership_toggle(parent).."]",
"label[0.5,2;Members:]", "label[0.5,2;Members:]",
"dropdown[2,1.5;7,0.8;user_orgs;"..formspec_list(org.members)..";;]", "dropdown[2.5,1.5;7,0.8;members;View...,"..formspec_list(members)..";;]",
"label[0.5,3;Children:]", "label[0.5,3;Child orgs:]",
"dropdown[2,2.5;7,0.8;children;"..formspec_list(children)..";;]", "dropdown[2.5,2.5;7,0.8;children;View...,"..formspec_list(children)..";;]",
"label[0.5,4;Modules:]", "label[0.5,4;Modules:]",
"dropdown[2,3.5;7,0.8;modules;"..formspec_list(modules)..";;]", "dropdown[2.5,3.5;7,0.8;modules;View...,"..formspec_list(modules)..";;]",
"label[0.5,5;Pending ("..num_pending.."):]", "label[0.5,5;Pending ("..num_pending.."):]",
"dropdown[2,4.5;7,0.8;pending;"..formspec_list(pending)..";;]", "dropdown[2.5,4.5;7,0.8;pending;View...,"..formspec_list(pending)..";;]",
"button[0.5,7;1,0.8;refresh;Refresh]",
"button[8.5,7;1,0.8;back;Back]", "button[8.5,7;1,0.8;back;Back]",
} }
local formspec_string = table.concat(formspec, "") local formspec_string = table.concat(formspec, "")
@ -183,23 +215,46 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
if nil then if nil then
elseif fields.back then elseif fields.back then
modpol.interactions.dashboard(pname) modpol.interactions.dashboard(pname)
elseif fields.refresh then
modpol.interactions.org_dashboard(pname, org.name)
-- Put all dropdowns at the end -- Put all dropdowns at the end
-- Receiving modules -- Receiving modules
elseif fields.members
and fields.members ~= "View..." then
modpol.interactions.user_dashboard(
pname,
fields.members,
function()
modpol.interactions.org_dashboard(
pname, org.name)
end
)
elseif fields.modules elseif fields.modules
and fields.modules ~= "View..." then and fields.modules ~= "View..." then
local module = string.match( local module = nil
fields.modules,"%[(.*)%]") for k,v in pairs(modpol.modules) do
if fields.modules == v.name
and org.policies[v.slug] then
module = v
end end
if module then
modpol.interactions.binary_poll_user( modpol.interactions.binary_poll_user(
pname, pname,
modpol.modules[module].name..":\n".. module.name..":\n"..
modpol.modules[module].desc.."\n".. module.desc.."\n"..
"Proceed?", modpol.interactions.get_policy_string(
org.name, module.slug, ", ")..
"\n".."Proceed?",
function(input) function(input)
if input == "Yes" then if input == "Yes" then
org:call_module(module, pname) org:call_module(module.slug, pname)
elseif input == "No" then
modpol.interactions.org_dashboard(
pname, org.id)
end end
end) end)
end
-- Receiving pending -- Receiving pending
elseif fields.pending elseif fields.pending
@ -220,23 +275,66 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
end end
end) end)
--- Function: modpol.interactions.user_dashboard
-- Displays a dashboard about a particular user
-- @param viewer Name of user viewing the dashboard (string)
-- @param user Name of user being viewed (string)
-- @param completion Optional function to call on Done button
function modpol.interactions.user_dashboard(viewer, user, completion)
local user_orgs = modpol.orgs.user_orgs(user)
-- Function: modpol.interactions.policy_dashboard -- set player context
-- input: user (string), org_id (int), policy (string) local user_context = {}
-- output: opens a dashboard for viewing/editing policy details user_context["viewer"] = viewer
-- TODO user_context["user"] = user
function modpol.interactions.policy_dashboard( user_context["completion"] = completion
user, org_id, policy) _contexts[viewer] = user_context
modpol.interactions.message( -- set up formspec
user, local formspec = {
"Not yet implemented: " .. policy) "formspec_version[4]",
"size[10,8]",
"hypertext[0.5,0.5;9,1;title;<big>User: <b>"..user.."</b></big>]",
"label[0.5,2;User's orgs:]",
"dropdown[2.5,1.5;7,0.8;user_orgs;View...,"..formspec_list(user_orgs)..";;]",
"button[0.5,7;1.5,0.8;message;Message]",
"button_exit[8.5,7;1,0.8;close;Close]",
}
local formspec_string = table.concat(formspec, "")
-- present to player
minetest.show_formspec(viewer, "modpol:user_dashboard", formspec_string)
end end
-- receive input
minetest.register_on_player_receive_fields(function (player, formname, fields)
if formname == "modpol:user_dashboard" then
local contexts = _contexts[player:get_player_name()]
-- check fields
if nil then
elseif fields.message then
modpol.interactions.message_user(
contexts.viewer, contexts.user
)
elseif fields.back then
if contexts.completion then
completion()
else
modpol.interactions.dashboard(
contexts.viewer)
end
-- dropdown fields
elseif fields.user_orgs
and fields.user_orgs ~= "View..." then
modpol.interactions.org_dashboard(
contexts.viewer, fields.user_orgs)
end
end
end)
-- INTERACTION FUNCTIONS -- INTERACTION PRIMITIVES
-- ===================== -- ======================
-- Function: modpol.interactions.message -- Function: modpol.interactions.message
-- Produces a brief message to a user
-- input: user (string), message (string) -- input: user (string), message (string)
-- output: displays message to specified user -- output: displays message to specified user
function modpol.interactions.message(user, message) function modpol.interactions.message(user, message)
@ -245,6 +343,72 @@ function modpol.interactions.message(user, message)
end end
end end
--- Function: modpol.interactions.message_user
-- Gets and sends a message from one user to another
-- @param sender Name of user sending (string)
-- @param recipient Name of user receiving (string)
function modpol.interactions.message_user(sender, recipient)
modpol.interactions.text_query(
sender,
"Message for "..recipient..":",
function(input)
modpol.interactions.message(
recipient,
input.." [from "..sender.."]")
end
)
end
--- Function: modpol.interactions.display
-- Displays complex data to a user
-- @param user Name of target user (string)
-- @param title Title of display (string)
-- @param message Content of message (string or table of strings)
-- @param completion Optional function for what happens when user is done
function modpol.interactions.display(
user, title, message, completion)
-- set up contexts
_contexts[user]["completion"] = completion
-- set up output
local output = ""
if type(message) == "table" then
output = table.concat(message,"\n")
elseif type(message) == "string" then
output = message
elseif type(message) == "number" then
output = message
else
modpol.interactions.message(
self.initiator, "Error: message not typed for display")
if completion then completion() else
modpol.intereactions.dashboard(user)
end
return
end
-- set up formspec
local formspec = {
"formspec_version[4]",
"size[10,8]",
"label[0.5,0.5;"..title.."]",
"hypertext[0.5,1;9,5.5;display;<global background=black margin=10>"..output.."]",
"button_exit[8.5,7;1,0.8;done;Done]",
}
local formspec_string = table.concat(formspec, "")
-- present to player
minetest.show_formspec(user, "modpol:display", formspec_string)
end
-- receive fields
minetest.register_on_player_receive_fields(function (player, formname, fields)
local pname = player:get_player_name()
if formname == "modpol:display" then
if fields.done and _contexts[pname].completion then
minetest.close_formspec(pname, formname)
_contexts[pname].completion()
end
end
end)
-- Function: modpol.interactions.text_query -- Function: modpol.interactions.text_query
-- Overrides function at modpol/interactions.lua -- Overrides function at modpol/interactions.lua
-- input: user (string), query (string), func (function) -- input: user (string), query (string), func (function)
@ -253,10 +417,10 @@ function modpol.interactions.text_query(user, query, func)
-- set up formspec -- set up formspec
local formspec = { local formspec = {
"formspec_version[4]", "formspec_version[4]",
"size[10,4]", "size[10,6]",
"label[0.5,1;", minetest.formspec_escape(query), "]", "label[0.5,1;", minetest.formspec_escape(query), "]",
"field[0.5,1.25;9,0.8;input;;]", "field[0.5,3.25;9,0.8;input;;]",
"button[0.5,2.5;1,0.8;yes;OK]", "button[0.5,4.5;1,0.8;yes;OK]",
} }
local formspec_string = table.concat(formspec, "") local formspec_string = table.concat(formspec, "")
-- present to player -- present to player
@ -289,14 +453,12 @@ end)
-- func input: choice (string) -- func input: choice (string)
-- output: calls func on user choice -- output: calls func on user choice
function modpol.interactions.dropdown_query(user, label, options, func) function modpol.interactions.dropdown_query(user, label, options, func)
-- Add "View..." to the top of the list
table.insert(options,1,"View...")
-- set up formspec -- set up formspec
local formspec = { local formspec = {
"formspec_version[4]", "formspec_version[4]",
"size[10,4]", "size[10,4]",
"label[0.5,1;"..minetest.formspec_escape(label).."]", "label[0.5,1;"..minetest.formspec_escape(label).."]",
"dropdown[0.5,1.25;9,0.8;input;"..formspec_list(options)..";;]", "dropdown[0.5,1.25;9,0.8;input;View...,"..formspec_list(options)..";;]",
"button[0.5,2.5;1,0.8;cancel;Cancel]", "button[0.5,2.5;1,0.8;cancel;Cancel]",
} }
local formspec_string = table.concat(formspec, "") local formspec_string = table.concat(formspec, "")
@ -320,8 +482,7 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
if not choice then if not choice then
-- empty, do nothing -- empty, do nothing
elseif func then elseif func then
--not sure if we should close --causes issues with sequential dropdowns
--breaks sequential dropdown_queries:
--minetest.close_formspec(pname, formname) --minetest.close_formspec(pname, formname)
func(choice) func(choice)
else else
@ -332,6 +493,82 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
end end
end) end)
--- Function: modpol.interactions.checkbox_query
-- Allows user to select from a set of options
-- @param user Name of user (string)
-- @param label Query for user before options (string)
-- @param options table of options and their checked status in the form {{"option_1_string", true}, {"option_2_string", false}}
-- @param func function to be called with param "input", made up of the corrected table in the same format as the param options
function modpol.interactions.checkbox_query(
user, label, options, func)
-- set up formspec
-- prepare options
local vertical = 0
local checkbox_options = {}
for i,v in ipairs(options) do
local fs_line = ""
vertical = i * .5
fs_line = "checkbox[0,"..vertical..";checkbox_"..i..";"..
minetest.formspec_escape(v[1])..";"..
tostring(v[2]).."]"
table.insert(checkbox_options, fs_line)
end
local max = vertical * 4
local bar_height = vertical / 2
local formspec = {
"formspec_version[4]",
"size[10,8]",
"label[0.5,0.5;"..label.."]",
"scrollbaroptions[arrows=default;max="..max..";smallstep=10;largestep=100;thumbsize="..bar_height.."]",
"scrollbar[9,1;0.3,5.5;vertical;scroller;0]",
"scroll_container[0.5,1;9,5.5;scroller;vertical]",
}
-- insert options
for i,v in ipairs(checkbox_options) do
table.insert(formspec, v)
end
table.insert(formspec,"scroll_container_end[]")
table.insert(formspec,"button[0.5,7;1.5,0.8;submit;Submit]")
table.insert(
formspec,"button_exit[8,7;1.5,0.8;cancel;Cancel]")
local formspec_string = table.concat(formspec, "")
-- present to players
minetest.show_formspec(user, "modpol:checkbox_query", formspec_string)
-- put func in _contexts
if _contexts[user] == nil then _contexts[user] = {} end
_contexts[user]["checkbox_query_func"] = func
_contexts[user]["checkbox_query_result"] =
modpol.util.copy_table(options)
end
-- receive fields
minetest.register_on_player_receive_fields(function (player, formname, fields)
if formname == "modpol:checkbox_query" then
local pname = player:get_player_name()
-- start checking fields
if fields.cancel then
minetest.close_formspec(pname, formname)
elseif fields.submit then
-- send in result
minetest.close_formspec(pname, formname)
_contexts[pname].checkbox_query_func(
_contexts[pname].checkbox_query_result)
else
for k,v in pairs(fields) do
-- identify checkbox actions and flip bool
if string.find(k,"checkbox_") then
local index = tonumber(
string.match(k,"%d+"))
_contexts[pname].checkbox_query_result[index][2] =
not _contexts[pname].checkbox_query_result[index][2]
end
end
end
end
end)
-- Function: modpol.binary_poll_user(user, question, function) -- Function: modpol.binary_poll_user(user, question, function)
-- Overrides function at modpol/interactions.lua -- Overrides function at modpol/interactions.lua
-- Params: user (string), question (string), func (function) -- Params: user (string), question (string), func (function)
@ -341,10 +578,10 @@ function modpol.interactions.binary_poll_user(user, question, func)
-- set up formspec -- set up formspec
local formspec = { local formspec = {
"formspec_version[4]", "formspec_version[4]",
"size[8,4]", "size[8,6]",
"label[0.375,0.5;",minetest.formspec_escape(question), "]", "label[0.375,0.5;",minetest.formspec_escape(question), "]",
"button[1,2.5;1,0.8;yes;Yes]", "button[1,5;1,0.8;yes;Yes]",
"button[2,2.5;1,0.8;no;No]", "button[2,5;1,0.8;no;No]",
--TODO can we enable text wrapping? --TODO can we enable text wrapping?
--TODO we could use scroll boxes to contain the text --TODO we could use scroll boxes to contain the text
} }
@ -369,3 +606,10 @@ minetest.register_on_player_receive_fields(function (player, formname, fields)
minetest.close_formspec(pname, formname) minetest.close_formspec(pname, formname)
end end
end) end)
-- TESTING
--testing command for "singleplayer"
function modpol.msg(text)
modpol.interactions.message("singleplayer",text)
end

View File

@ -0,0 +1,20 @@
-- ===================================================================
--- Overwrites function at /users.lua.
-- if nil, lists instance members; if an org name, lists its members
-- @function modpol.list_users
-- @param org
-- @return a table with names of players currently in the game
modpol.list_users = function(org)
local users = {}
if (org == nil) then -- no specified org; all players
for _,player in ipairs(minetest.get_connected_players()) do
local name = player:get_player_name()
table.insert(users,name)
end
else -- if an org is specified
if (modpol.orgs[org] ~= nil) then -- org exists
users = modpol.orgs[org]["members"]
end
end
return users
end