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

13 Releases 14 Tags

RSS Feed
  • V15.x.x 2d239c65ea

    multi v15.0.x Stable

    rayaman released this 2021-04-30 10:48:58 -04:00 | 183 commits to master since this release

    Update 15.0.0 - The art of faking it

    Full Update Showcase

    package.path="?.lua;?/init.lua;?.lua;?/?/init.lua;"..package.path
multi,thread = require("multi"):init()
GLOBAL,THREAD = require("multi.integration.threading"):init() -- Auto detects your enviroment and uses what's available

jq = multi:newSystemThreadedJobQueue(4) -- Job queue with 4 worker threads
func = jq:newFunction("test",function(a,b)
    THREAD.sleep(2)
    return a+b
end)

for i = 1,10 do
    func(i,i*3).connect(function(data)
        print(data)
    end)
end

multi:newThread("Standard Thread 1",function()
    while true do
        thread.sleep(1)
        print("Testing 1 ...")
    end
end)

multi:newISOThread("ISO Thread 2",{test=true},function()
    while true do
        thread.sleep(1)
        print("Testing 2 ...")
    end
end)

multi:mainloop()

    Note:

    This was supposed to be released over a year ago, but work and other things got in my way. Pesudo Threading now works. The goal of this is so you can write modules that can be scaled up to utilize threading features when available.

    Added:

    • multi:newISOThread(name,func,env)
      • Creates an isolated thread that prevents both locals and globals from being accessed.
      • Was designed for the pesudoManager so it can emulate threads. You can use it as a super sandbox, but remember upvalues are also stripped which was intened for what I wanted them to do!
    • Added new integration: pesudoManager, functions just like lanesManager and loveManager, but it's actually single threaded
      • This was implemented because, you may want to build your code around being multi threaded, but some systems/implemetations of lua may not permit this. Since we now have a "single threaded" implementation of multi threading. We can actually create scalable code where things automatcally are threaded if built correctly. I am planning on adding more threadedOjbects.
    • In addition to adding pesudo Threading multi.integration.threading can now be used to autodetect which enviroment you are on and use the threading features. 
      GLOBAL,THREAD = require("multi.integration.threading"):init()
      If you are using love2d it will use that, if you have lanes avaialble then it will use lanes. Otherwise it will use pesudo threading. This allows module creators to implement scalable features without having to worry about which enviroment they are in. Can now require a consistant module: require("multi.integration.threading"):init()

    Changed:

    • Documentation to reflect the changes made

    Removed:

    • CBT (Coroutine Based threading) has lost a feature, one that hasn't been used much, but broke compatiblity with anything above lua 5.1. My goal is to make my library work with all versions of lua above 5.1, including 5.4. Lua 5.2+ changed how enviroments worked which means that you can no longer modify an enviroment of function without using the debug library. This isn't ideal for how things in my library worked, but it is what it is. The feature lost is the one that converted all functions within a threaded enviroment into a threadedfunction. This in hindsight wasn't the best pratice and if it is the desired state you as the user can manually do that anyway. This shouldn't affect anyones code in a massive way.

    Fixed:

    • pseudoThreading and threads had an issue where they weren't executing properly
    • lanesManager THREAD:get(STRING: name) not returning the value

    Todo:

    • Add more details to the documentation
    Downloads