Allow `CapacityLimiter` to have `total_tokens=0`

[Zac-HD]

Sometimes, there are use-cases where you want to entirely pause processing of some tasks, and then later scale back up. CapacityLimiter is basically perfect for this kind of thing, except that it currently raises an error if you pass total_tokens=0:

trio/src/trio/_sync.py

Lines 254 to 255 in d988edd

	if new_total_tokens < 1:
	raise ValueError("total_tokens must be >= 1")

It's already possible to get the desired effect just by deliberately "leaking" one of the tokens, but it would be much nicer to simply allow zero as the intended capacity, by editing the numbers in the setter above.

[TeamSpen210]

Might need to make sure this is tested too, since zero is rather susceptible to edge cases. Looks safe though.

[kachida]

@Zac-HD , I'm interested, could you kindly assign me this task

[A5rocks]

Hi @kachida any progress? If not, would you mind un-assigning yourself?

You should be able to re-assign yourself whenever you have the time and want to fix this issue.