epicknex/multi
1
0
Fork 0
Code Issues 5 Pull Requests 1 Actions Packages Projects Releases 13 Wiki Activity

still working on the doc, soon

Browse Source
This commit is contained in:
Ryan Ward 2019-01-04 13:59:38 -05:00
parent 9b5acbd23e
commit 0abd8183b5
3 changed files with 60 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -6,3 +6,4 @@ lanestestclient.lua
lanestest.lua lanestest.lua
sample-node.lua sample-node.lua
sample-master.lua sample-master.lua
Ayn Rand - The Virtue of Selfishness-Mg4QJheclsQ.m4a

60
Documentation.md
View File

@ -794,9 +794,65 @@ multi:mainloop()
``` ```
Same example as above, but notice how this works opposed to the non hyper version Same example as above, but notice how this works opposed to the non hyper version
System Threads - Multi-Integration System Threads (ST) - Multi-Integration Getting Started
---------------------------------- -------------------------------------------------------
The system threads need to be required seperatly.
```lua
local GLOBAL, THREAD = require("multi.integration.lanesManager").init() -- We will talk about the global and thread interface that is returned
GLOBAL, THREAD = require("multi.integration.loveManager").init()
GLOBAL, THREAD = require("luvitManager")-- There is a catch to this*
```
Using this integration modifies some methods that the multi library has.
`multi:canSystemThread()` -- Returns true is system threading is possible
`multi:getPlatform()` -- Returns (for now) either "lanes", "love2d" and "luvit"
This variable is created on the main thread only inside of the multi namespace: multi.isMainThread = true
This is used to know which thread is the main thread. When network threads are being discussed there is a gotcha that needs to be addressed.
*** GLOBAL and THREAD do not work currently when using the luvit integration
ST - THREAD namespace
---------------------
`THREAD.set(STRING name, VALUE val)` -- Sets a value in GLOBAL
`THREAD.get(STRING name)` -- Gets a value in GLOBAL
`THREAD.waitFor(STRING name)` -- Waits for a value in GLOBAL to exist
`THREAD.testFor(STRING name, VALUE val, STRING sym)` -- **NOT YET IMPLEMENTED**
`THREAD.getCores()` -- Returns the number of actual system threads/cores
`THREAD.kill()` -- Kills the thread
`THREAD.getName()` -- Returns the name of the working thread
`THREAD.sleep(NUMBER n)` -- Sleeps for an amount of time stopping the current thread
`THREAD.hold(FUNCTION func)` -- Holds the current thread until a condition is met
ST - GLOBAL namespace
---------------------
Treat global like a table.
```lua
GLOBAL["name"] = "Ryan"
print(GLOBAL["name"])
```
Removes the need to use THREAD.set() and THREAD.get()
ST - System Threads
-------------------
ST - SystemThreadedQueue
------------------------
ST - SystemThreadedConnection
-----------------------------
ST - SystemThreadedBenchmark
----------------------------
ST - SystemThreadedConsole
--------------------------
ST - SystemThreadedTable
------------------------
ST - SystemThreadedJobQueue
---------------------------
ST - SystemThreadedExecute
--------------------------
Network Threads - Multi-Integration Network Threads - Multi-Integration
----------------------------------- -----------------------------------

2
multi/integration/shared.lua
View File

@ -193,7 +193,7 @@ function multi:newSystemThreadedConnection(name,protect)
GLOBAL[name]=c GLOBAL[name]=c
return c return c
end end
function multi:systemThreadedBenchmark(n) function multi:SystemThreadedBenchmark(n)
n=n or 1 n=n or 1
local cores=multi.integration.THREAD.getCores() local cores=multi.integration.THREAD.getCores()
local queue=multi:newSystemThreadedQueue("THREAD_BENCH_QUEUE"):init() local queue=multi:newSystemThreadedQueue("THREAD_BENCH_QUEUE"):init()