LibAsync : Libraries : Elder Scrolls Online AddOns

(5 Kb)

Download

Updated: 01/16/21 09:02 AM

Add Favorite

Install Help

Pictures

File Info

Compatibility:	Markarth (6.2.5)
Updated:	01/16/21 09:02 AM
Created:	09/02/18 10:37 AM
Monthly downloads:	45,082
Total downloads:	904,866
Favorites:	549
MD5:

6.2.5

LibAsync

Version: 2.3.2

by: votan [More]

Description
Read this article of the Wiki.

API
local async = LibAsync
local task = async:Create(name)

The signature of FuncOfTask is:

Code:

local function(task)
end

-- Get the current context, if you are within a FuncOfTask or nil.

Code:

function async:GetCurrent()

-- Create an interruptible task context.

Code:

function async:Create(name)

-- Resume the execution context.

Code:

task:Resume()

-- Suspend the execution context and allow to resume anytime later.

Code:

function task:Suspend()

-- Interupt and fully stop the execution context. Can be called from outside to stop everything.

Code:

function task:Cancel()

-- Run the given FuncOfTask in your task context execution.

Code:

function task:Call(funcOfTask)

-- Continue your task context execution with the given FuncOfTask after the previous as finished.

Code:

function task:Then(funcOfTask)

-- Start an interruptible for-loop.

Code:

function task:For(from, to, step)
function task:For(pairs(tbl))
function task:For(ipairs(tbl))

-- Execute the async-for with the given step-function. The parameters of the step-function are those you would use in your for body.

Code:

function task:Do(func)

The signature if func is function(index) or function(key, value)
If you return async.BREAK within func, it will break the loop.

-- Start an interruptible while-loop.

Code:

function task:While(func):Do(doFunc)

As long as func returns true, doFunc and func will be called again.

-- Start an once per frame wait loop.

Code:

function task:WaitUntil(func)

Until func returns true, the function will be called again in the next frame. Keep the check condition simple. For example, checking a flag variable set by an event.

-- Suspend the execution of your task context for the given delay in milliseconds and then call the given FuncOfTask to continue.

Code:

function task:Delay(delay, funcOfTask)

Delay will suspend the exceution immediately, no matter there in the chain it is used. For delaying at chain position use:

Code:

function task:ThenDelay(delay, funcOfTask)

-- Stop the delay created by Delay

Code:

function task:StopTimer()

-- Set a FuncOfTask as a final handler. Called even if something went wrong in your context.

Code:

function task:Finally(funcOfTask)

-- Set a FuncOfTask as an error handler. Called if something went wrong in your context.

Code:

function task:OnError(funcOfTask)

Example 1

Lua Code:

local async = LibAsync
 
local task = async:Create("example1")
 
local i=1
local function Hello() d("Hello") end
local function World() d("World") end
 
task:Call(function(task)
 d(i)
 task:Call(Hello):Then(World)
 i = i + 1
 return i<1000
end):Then(function() d("end") end)

Example 2

Lua Code:

local async = LibAsync
 
local task = async:Create("example2")
 
local start = GetGameTimeMilliseconds()
 
task:For (1,1000):Do(function(index) d(index) end):Then(
function()
  task:For (pairs({"a", "b"})):Do(function(key, value) d(key,value)
    task:For (ipairs({"c", "d"})):Do(function(key, value) d(key,value)  end)
 end)
end):For(1001,1010):Do(function(index) d(index) end):Then(function(task)
  df("%ims", GetGameTimeMilliseconds() - start)
end)

Example 3

Lua Code:

local async = LibAsync
 
local i = 0
async:While(function() return i<100 end):Do(function()
  d(i)
  i = i+1
end)

Example 4

Lua Code:

local async = LibAsync
local time = GetGameTimeSeconds()+10
async:WaitUntil(function()
  return GetGameTimeSeconds()>=time
end):Then(function()
  d("end")
end)

Example 5: Nested calls.

Lua Code:

local async = LibAsync
 
async:Call(function(task)
  d("a")
  task:Call(function(task)
    d("b")
    task:Call(function(task)
      d("c")
    end)
  end)
end):Then(function(task)
  d("d")
  task:Call(function(task)
    d("e")
    task:Call(function(task)
      d("f")
    end)
  end)
end)

Output:
a
b
c
d
e
f

Remarks

Yes, using LibAsync increases the total duration of the process for a better framerate.
Lua code can cause hiccups and (micro-)freezes, but has nothing to do the lag.
Lua can cause crash to bug report, if too much memory is allocated within one frame. (e.g. string operations) => Spread you code over time.
Lua can cause kick to login, if too much server request are done within a time range. (e.g. map pings/buy/sell/ignore, etc.) => Spread you code over time.

version 2.3.2:
- Fixed issue with nested "WaitUntil".

version 2.3.1:
- Forgot to remove return in "ThenDelay".

version 2.3.0:
- Fixed execution order issue, if operation are added ourside a running task.
- Add new operation "ThenDelay".

version 2.2.1:
- Update to API 100033 "Markarth".

version 2.2.0:
- Update to API 100032 "Stonethorn".
- New async functions: While and WaitUntil.

version 2.1.0: Register scheduler as late as possible to take count to all actions not using LibAsync.

version 2.0.2:
- Update to API 100029 "Dragonhold".

version 2.0.1:
- Update to API 100028 "Scalebreaker".

version 2.0.0:
- API bump 100027 "Elsweyr".
- Need to go to 2.0 because of the version check of LibStub.

version 1.10.0:
- API bump 100027 "Elsweyr".
- Use of LibStub is optional.

version 1.9.0:
- Update to API 100026 "Wrathstone".
- For V-Sync off/G-Sync the minimum target framerate is 80.

version 1.8.1:
- Work without LibStub as well.

version 1.8.0:
- API update "Murkmire".
- Adjustment to scheduler calculation: Reduce allowed-time after a burst even if loops still running.
- Change from GetGameTimeMilliseconds to GetGameTimeSeconds, which has in fact more precision. Thanks to @zsban.

Optional Files (0)

Archived Files (13)

File Name	Version	Size	Uploader	Date
LibAsync	2.3.1	5kB	votan	12/19/20 12:13 PM
LibAsync	2.3.0	5kB	votan	12/19/20 09:41 AM
LibAsync	2.2.1	5kB	votan	11/01/20 08:58 AM
LibAsync	2.2.0	5kB	votan	07/31/20 01:48 PM
LibAsync	2.1.0	5kB	votan	12/13/19 02:49 PM
LibAsync	2.0.2	5kB	votan	10/03/19 04:39 AM
LibAsync	2.0.1	5kB	votan	07/29/19 02:17 PM
LibAsync	2.0.0	5kB	votan	05/15/19 01:16 PM
LibAsync	1.10.0	5kB	votan	05/04/19 01:36 PM
LibAsync	1.9.0	4kB	votan	02/23/19 10:15 AM
LibAsync	1.8.1	4kB	votan	11/09/18 01:07 PM
LibAsync	1.8.0	6kB	votan	10/06/18 02:10 PM
LibAsync	1.7	6kB	votan	09/02/18 10:37 AM

Comment Options

Page 1 of 2

02/07/21, 04:54 AM

votan

Forum posts: 542

File comments: 1398

Uploads: 37

Originally Posted by ChrisK

Thanks Votan - love all your AddOns!

Thank You @ChrisK.

__________________
@votan73 (EU - megaserver)

02/06/21, 07:11 PM
ChrisK Forum posts: 0 File comments: 81 Uploads: 0	Thanks Votan - love all your AddOns!

08/05/20, 08:03 AM
Marazota Forum posts: 221 File comments: 1339 Uploads: 0	rolling back to old vesion fixed this issue but need to find a way to get rid of libstub anyway

08/04/20, 03:18 PM
Marazota Forum posts: 221 File comments: 1339 Uploads: 0	hey what i need to fix to make this addon work its not working with new version of library... also this addon isnt presented on esoui

08/03/20, 04:05 PM
orcashow Forum posts: 1 File comments: 15 Uploads: 0	Re: Re: Re: Re: Inventory Insight errors after today's LibAsync update We might want to keep in mind that many of the authors are prepping addon updates for Update 27 which is coming sometime here in August. It takes time & all the authors create & maintain their addons in their spare time... and for no pay. If you need to do the quick-fix/workaround for now then that's the best recommendation. Once Update 27 hits, most if not all of our favorite addons will be current to the new API changes. Most importatn, DO NOT rage on the addon authors. It can be a thankless job which none of the rest of us have stepped up to do. Try to be patient. They got this.

08/02/20, 07:19 PM

fgoron2000

Forum posts: 0

File comments: 120

Uploads: 0

Re: Re: Re: Re: Inventory Insight errors after today's LibAsync update

Originally Posted by DigitalHype

Originally Posted by fgoron2000

Originally Posted by DigitalHype

Appears I'm not the only one having issues with Inventory Insight after updating LibAsync to current.

Others are report that rolling back LibAsync to 2.1.0 solves the issue. See threads over in that addon:

https://www.esoui.com/downloads/info....html#comments

This recommended fix worked fine for me, the caveat is simply that when Inventory Insight gets updated that you do a fresh install, but until that time, the fix worked

Good to hear. But, this isn't a fix. This is a workaround. What needs to happen here? Does Inventory Insight need to so something to work with the new LibAsync? If so, what? I fear that InventoryInsight might be abandonware at this point. Do we need a fork, or is it still being maintained?

I understand that it was a temporary workaround. I didn't mean for the word fix to imply that the issue had been permanently resolved, sorry if I gave that impression. That's why I referenced others' recommendations to do a fresh reinstall of InventoryInsight after it was updated, because the workaround involved a modification to the Inventory Insight addon, not to LibAsync. By the way, to answer your question, it is not abandonware. It's also already been updated since your post, and it addressed the issue of its LibAsync dependency. And thus far, I'm having no issues with either LibAsync or Inventory Insight at this point, and I didn't even need to do a fresh reinstall.

08/01/20, 08:45 AM
Sharlikran Forum posts: 197 File comments: 961 Uploads: 9	Please maintain some kind of civility. My statement was direct and in response to statements that people have been making that are false and misleading about LibAsync, Votan's MiniMap, other mods, and now Inventory Insight. My last statement did not include specific version numbers because it is sufficient to say latest version. I should not have to state that users should be using LibAsync 2.2.0, and Inventory Insight 3.45. However, Inventory Insight 3.45 was only uploaded this morning. Mod authors should not have to argue with users when they are explaining that if all the mods a user is using were up to date that things would work properly. Mod authors expect users to be using the current version of everything because if you do not then we can not predict what other issues may occur. I do not test with older versions of any mod installed therefore I am not able to reproduce the errors reported. __________________ Admin for TES5Edit, occasional LOOT masterlist contributor, and Wrye Bash contributor. I also maintain special Fallout 3 and Fallout NV versions of Wrye Flash. Last edited by Sharlikran : 08/01/20 at 10:03 AM.

08/01/20, 06:22 AM

MaulkinTheGolden

Forum posts: 0

File comments: 1

Uploads: 0

Originally Posted by pandros1484

Originally Posted by Sharlikran

Originally Posted by TagCdog

Hi All,

I'd imagine it is good form to keep posts about another addon on that specific addon's comments page.

In this case I have a working solution which allows you to keep the newest version of LibAsync installed. See it by reading Inventory Insight's comments page.

With that said, it is still a very buggy addon (maybe it just doesn't play well with others?) that needs to be updated/fixed. I don't think it is being maintained anymore which is sad. Disabling it resolved a whole bunch of problems I was experiencing so if anything is acting up try disabling Inventory Insight first.

Inventory Insight has no issues nor does LibAsync. There are too many people posting things that do not address any issues and making suggestions that make things worse.

I have the current version of LibAsync and while I do not use Votan's Minimap on a regular basis I test with it all the time because people post errors that can not be possible. So I test it and then share that I can not reproduce the error.

None of the claims are true, people are simply not updating their mods and continue to try and use older version of things. I have had three users provide me with their addons folder and all I did was open minion, right click and choose Reinstall on each mod. Then ask them what the error is and how they reproduce it. I never could get the error to happen. Send the folder back and they replace theirs with the updated versions, no errors.

Since I did that three times I no longer do it because users can do the same thing.

Putting your borderline rude tone aside, I have tried exactly what you said you did for the users and yet I still have the same error code;

user:/AddOns/IIfA/IIfA.lua:39: Cannot find a library instance of "LibAsync".
stack traceback:
user:/AddOns/LibStub/LibStub/LibStub.lua:87: in function 'LibStub:GetLibrary'
user:/AddOns/IIfA/IIfA.lua:39: in function '(main chunk)'

if you have any actual suggestions I'm all ears. Otherwise there is no need to throw a temper tantrum friend.

The problem there is with the IIfA (Inventory Insight) add-on that is not being updated.

If you download the previous version (2.1) of libasync you can put it in the libs subfolder of IIfa and explicitly reference it from the IIfA.txt file, just below the reference to LibCustomTitles (line 12).

Your IIfA will then use the old version while all other add-ons (like Votan Minimap) will use the new version which they require, and that will solve the problem of the stale IIfA add-on for now.

08/01/20, 03:10 AM

Sharlikran

Forum posts: 197

File comments: 961

Uploads: 9

Originally Posted by TagCdog

__________________
Admin for TES5Edit, occasional LOOT masterlist contributor, and Wrye Bash contributor. I also maintain special Fallout 3 and Fallout NV versions of Wrye Flash.

08/01/20, 02:35 AM
shnawkilla Forum posts: 0 File comments: 4 Uploads: 0	update Ty a lot

08/01/20, 01:03 AM
TagCdog Forum posts: 17 File comments: 33 Uploads: 0	Hi All, I'd imagine it is good form to keep posts about another addon on that specific addon's comments page. In this case I have a working solution which allows you to keep the newest version of LibAsync installed. See it by reading Inventory Insight's comments page. With that said, it is still a very buggy addon (maybe it just doesn't play well with others?) that needs to be updated/fixed. I don't think it is being maintained anymore which is sad. Disabling it resolved a whole bunch of problems I was experiencing so if anything is acting up try disabling Inventory Insight first.

07/31/20, 11:20 PM

DigitalHype

Forum posts: 1

File comments: 31

Uploads: 0

Re: Re: Re: Inventory Insight errors after today's LibAsync update

Originally Posted by fgoron2000

Originally Posted by DigitalHype

This recommended fix worked fine for me, the caveat is simply that when Inventory Insight gets updated that you do a fresh install, but until that time, the fix worked

07/31/20, 08:09 PM

fgoron2000

Forum posts: 0

File comments: 120

Uploads: 0

Re: Re: Inventory Insight errors after today's LibAsync update

Originally Posted by DigitalHype

This recommended fix worked fine for me, the caveat is simply that when Inventory Insight gets updated that you do a fresh install, but until that time, the fix worked

07/31/20, 05:12 PM
DigitalHype Forum posts: 1 File comments: 31 Uploads: 0	Re: Inventory Insight errors after today's LibAsync update Appears I'm not the only one having issues with Inventory Insight after updating LibAsync to current. Others are report that rolling back LibAsync to 2.1.0 solves the issue. See threads over in that addon: https://www.esoui.com/downloads/info....html#comments

07/31/20, 05:08 PM
DigitalHype Forum posts: 1 File comments: 31 Uploads: 0	Inventory Insight errors after today's LibAsync update [oops edit to add errors] Just updated LibAsync and Inventory Insight is throwing errors now. Any thoughts? user:/AddOns/IIfA/IIfA.lua:39: Cannot find a library instance of "LibAsync". stack traceback: user:/AddOns/LibStub/LibStub/LibStub.lua:87: in function 'LibStub:GetLibrary' \|caaaaaa<Locals> self = [table:1]{SILENT = T, minor = 7}, major = "LibAsync" </Locals>\|r user:/AddOns/IIfA/IIfA.lua:39: in function '(main chunk)' \|caaaaaa<Locals> BACKPACK = ud, BANK = ud, IIFA_COLOR_DEFAULT = [table:2]{a = 1, b = 1, g = 0.6, r = 0.2} </Locals>\|r Last edited by DigitalHype : 07/31/20 at 05:08 PM.

Page 1 of 2

Report this File