I want to set Refill, Bandwidth capacity to 0.

I took below error stack.

java.lang.IllegalArgumentException: 0 is wrong value for period tokens, because tokens should be positive

at io.github.bucket4j.BucketExceptions.nonPositivePeriodTokens(BucketExceptions.java:106)
at io.github.bucket4j.Refill.<init>(Refill.java:46)
at io.github.bucket4j.Refill.greedy(Refill.java:95)

---

I read code related this issue. And find when capacity is set to 0, this library make exception.

public static Bandwidth classic(long capacity, Refill refill) {
        if (capacity <= 0) {
            throw BucketExceptions.nonPositiveCapacity(capacity);
        }
        if (refill == null) {
            throw BucketExceptions.nullBandwidthRefill();
        }
        return new Bandwidth(capacity, refill.periodNanos, refill.tokens, capacity, refill.refillIntervally, refill.timeOfFirstRefillMillis, refill.useAdaptiveInitialTokens);
    }

private Refill(long tokens, Duration period, boolean refillIntervally, long timeOfFirstRefillMillis, boolean useAdaptiveInitialTokens) {
        if (period == null) {
            throw BucketExceptions.nullRefillPeriod();
        }
        if (tokens <= 0) {
            throw BucketExceptions.nonPositivePeriodTokens(tokens);
        }
        this.periodNanos = period.toNanos();
        if (periodNanos <= 0) {
            throw BucketExceptions.nonPositivePeriod(periodNanos);
        }
...
}

Now I can set dynamically bucket size set. I sometimes want to stop to generate token.

How can I do this situation? Do you have any ideas?

[vladimir-bukhtoyarov]

Desired behaviour is already implemented, but it does not work because of bug.

[vladimir-bukhtoyarov]

According to this issue, I am going to fix it by myself, because it needs to be combined with another enhancement that was described in this thread https://github.com/vladimir-bukhtoyarov/bucket4j/issues/133

If you want to fix a documentation just fork and provide pull-request.