Ryan Ward
fff3601041
* Fixed spelling, started ideaing for 16.0.0 * Updated files * Updated readme * Updated version * Concat conns now properly transfer events * Testing types * Connections can be % with functions * Updated connections * Fixed issue with double thread activations (Looking for another solution) * Working on issue with love threaded functions not waiting when in a thread * Working on issue where threads created in threads don't work * Fixed broken threads for love * Fixed some issues with threads * removed test * Updated changes.md * Plan on testing parity between the threading modules * Writing tests for system threading * Added test cases for threading, fixed issues. Todo test love2d * Fixed love2d to succeed with tests * All tests working * Updated files for testing * Modified tests to make it more seamless * removed extra __cores in lanes/pseudo * Working on new priority scheme * Working on priority management * Working on custom prioritySchemes * Fixed issues with missing code * Threaded processors * THREAD.exposeENV(), thread:newProcessor() * Typo in changes.md * Fixed typo in pseudoManager * fixing * Trying to fix exposeENV with pseudoThreading * Changes to threads * updated changes.md * Working on systemthreadedprocess, and experimental newProxy for threading * newProxy and STP work * newProxy implemented * Proxies work with connections now :D * Added tstep to STP, updated changes.md * thread.hold(proxy.conn) * Clean up connection events when holding, working on scheduling tasks/threads to system threaded processors * Getting loads of processors implemented * Finished getLoad(type) * Fixed some bugs * Added an easy way to share a table, found some limitations with lanes threading. * THREAD_NAME set for main thread, connections break the rules for proxies * Testing * Really close to portable proxies, currently extreamly unstable! * Debugging what is going on... * Fixed critical issue with coroutine based threads * Removed extra bloat, proxies are portable now! * Started work on the debugManager * Testing actions, fixing bugs with lanes * Testing... * fixing actions * typo fixed * Throw an error when things break * fixing stuff * Fixed issue with errors not going through * Removed system threaded connections, soon to be replaced by proxies * Testing love2d tests * Test love2d * Use later love-build * Use ubuntu for build * Fixed path * Use appimage * use sudo * No window for love2d * Fixed love2d tests * Testing love2d * Use workspace * Moved other tests while testing * actually pull the repo * packagepath set * Fixed pull * Update multi * Removed link * Edited symlink * Added timeout to build * Rewriting loveManager, too much outdated code * Still implementing new love2d threading code * Rewriting love2d threading binding * Working on adding a Hold method to all objects. Will document how they all work when done. * jobqueues having isues with stp * new pack/unpack for tables, current issue is things being turned into strings * Fixed packing of values into threads, need to fix system proxies and system threaded processors * testing... * Not hard crashing when error is encountered * Should now push non 0 exit codes * Push error when an error happens * Closer to getting things working... * Working on new type system, planning out debugmanager * Fixed error code issue * Test for 5.1 * Planning out debugManager * Some work on the debug manager, proxies working on lanes, todo get pseudo manager and love2d working * Working on getting pseudoThreading tests to work * Added function / connection * Added boost method * Document new features to conns, todo fix newTask * Fixed newTask() * Updated changes.md and fixed some bugs * Added thread.defer(func) * Fixed tests on lanes and pseudo threading, todo fix love2d threading * Fixed paths * Working on paths * Testing paths * Add test for rockspec * Fixed issues * Fixed typo * Added test for defer * Threading working in love2d * Fixed, conf * lanes uses a threaded function like waitfor function * Cleaned up changes.md * added priorityManager to rockspec
102 lines
2.2 KiB
Markdown
102 lines
2.2 KiB
Markdown
# Multi Version: 16.0.0 - Connecting the dots
|
|
**Key Changes**
|
|
- Expanded connection logic
|
|
- New integration priorityManager
|
|
- Tests for threads
|
|
- Consistent behavior between the threading integrations
|
|
- Improved love2d threading
|
|
- Bug fixes
|
|
|
|
Found an issue? Please [submit it](https://github.com/rayaman/multi/issues) and someone will look into it!
|
|
|
|
My multitasking library for lua. It is a pure lua binding, with exceptions of the integrations.
|
|
|
|
</br>
|
|
|
|
Progress is being made in [v16.0.0](https://github.com/rayaman/multi/tree/v16.0.0)
|
|
---
|
|
|
|
</br>
|
|
|
|
INSTALLING
|
|
----------
|
|
Link to optional dependencies:
|
|
- [lanes](https://github.com/LuaLanes/lanes) `luarocks install lanes`
|
|
|
|
- [chronos](https://github.com/ldrumm/chronos) `luarocks install chronos`
|
|
|
|
- [love2d](https://love2d.org/)
|
|
|
|
When using love2d add multi:uManager() or any processor to love.update()
|
|
|
|
```lua
|
|
function love.update(dt)
|
|
multi:uManager()
|
|
end
|
|
```
|
|
|
|
To install copy the multi folder into your environment and you are good to go</br>
|
|
If you want to use the system threads, then you'll need to install lanes or love2d game engine!
|
|
|
|
```
|
|
luarocks install multi
|
|
```
|
|
|
|
Discord
|
|
-------
|
|
Have a question or need realtime assistance? Feel free to join the discord!</br>
|
|
https://discord.gg/U8UspuA
|
|
|
|
Planned features/TODO
|
|
---------------------
|
|
- [x] ~~Create test suite (In progress, mostly done)~~
|
|
- [ ] Network Parallelism rework
|
|
|
|
Usage: [Check out the documentation for more info](https://github.com/rayaman/multi/blob/master/Documentation.md)
|
|
-----
|
|
|
|
You can run tests in 2 ways:
|
|
```
|
|
lua tests/runtests.lua (Runs all tests, attempts to use lanes)
|
|
love tests (Runs all tests in love2d env)
|
|
```
|
|
|
|
```lua
|
|
local multi, thread = require("multi"):init()
|
|
GLOBAL, THREAD = require("multi.integration.threading"):init()
|
|
|
|
multi:newSystemThread("System Thread",function()
|
|
while true do
|
|
THREAD.sleep(.1)
|
|
io.write(" World")
|
|
THREAD.kill()
|
|
end
|
|
end)
|
|
|
|
multi:newThread("Coroutine Based Thread",function()
|
|
while true do
|
|
io.write("Hello")
|
|
thread.sleep(.1)
|
|
thread.kill()
|
|
end
|
|
end)
|
|
|
|
multi:newTLoop(function(loop)
|
|
print("!")
|
|
loop:Destroy()
|
|
os.exit()
|
|
end,.3)
|
|
|
|
multi:mainloop()
|
|
|
|
--[[
|
|
while true do
|
|
multi:uManager()
|
|
end
|
|
]]
|
|
```
|
|
|
|
Known Bugs/Issues
|
|
-----------------
|
|
Check the [Issues tab](https://github.com/rayaman/multi/issues) for issues
|