Rate Limit
Simple utility for only executing code every so often.
This will only execute the block passed for a given name if the last time it was called is greater than limit or it has never been called.
This is really handy for refreshing stuff in viewDidAppear: but preventing it from happening a ton if it was just refreshed.
Rate Limit is fully thread-safe. Released under the MIT license.
Usage
We’ll start out with a TimedLimiter:
// Initialize with a limit of 5, so you can only use this once every 5 seconds.
let refreshTimeline = TimedLimiter(limit: 5)
// Call the work you want to limit by passing a block to the execute method.
refreshTimeline.execute {
// Do some work that runs a maximum of once per 5 seconds.
}
Limiters aren’t persisted across application launches.
Synchronous Limiters
TimedLimiter conforms to the SyncLimiter protocol. This means that the block you pass to execute will be called synchronously on the queue you called it from if it should fire. TimedLimiter uses time to limit.
CountedLimiter is also included. This works by taking a limit as a UInt for the maximum number of times to run the block.
The SyncLimiter protocol has a really neat extension that let’s you do things like this:
let funFactLimiter = CountedLimiter(limit: 2)
let funFact = funFactLimiter.execute { () -> String in
// Do real things to get a fun fact from a list
return "Hi"
}
Now funFact is a String?. It’s just an optional of whatever you return from the block. The returned value will be nil if the block didn’t run.
You can of course make your own SyncLimiters too!
Asynchronous Limiter
One AsyncLimiter is included. You can make your own too. The included async limiter is DebouncedLimiter. This is perfect for making network requests as a user types or other tasks that respond to very frequent events.
The interface is slightly different:
let searchLimiter = DebouncedLimiter(limit: 1, block: performSearch)
func textDidChange() {
searchLimiter.execute()
}
You would have to setup the limiter in an initializer since it references an instance method, but you get the idea. The block will be called at most once per second in this configuration.
Pretty easy!
Open up the included Xcode project for an example app and tests.
Installation
Carthage
Carthage is the recommended way to install Rate Limit. Add the following to your Cartfile:
github "soffes/RateLimit"
CocoaPods
Add the following to your Podfile:
pod "RateLimit"
Then run pod install.
382 Sep 23, 2022
8 Aug 17, 2022
2 May 28, 2022
876 Jan 5, 2023
2 Sep 28, 2021
11 Aug 26, 2022
2 Dec 3, 2022
289 Dec 12, 2022
261 Dec 15, 2022
312 Dec 22, 2022
29 Nov 14, 2022
2 Mar 13, 2022
0 Dec 14, 2021
129 May 2, 2022
113 Sep 9, 2022
132 Jan 6, 2023
349 Dec 10, 2022
529 Dec 25, 2022
20 Sep 27, 2022