Added new Jinja helper functions flip_coin and pick_multiple

[Jaid]

I added two new helper functions for Jinja2 templates.

pick_multiple

Returns multiple values from an input list (a resolved wildcard for example). The number of items can be specified, otherwise it’s rolled between 1 and the maximum. If the specified amount is too high, it’s autocorrected instead of throwing an error.

Example

Between 1 and maximum

{% set separator = ' and ' %}
{% set characters = ['ash', 'misty', 'brock', 'professor_oak', 'gary'] %}
a hike with {{ pick_multiple(characters)|join(separator) }} in the mountains

Between 0 and maximum

{% set separator = ' and ' %}
a hike
{% set characters = ['ash', 'misty', 'brock', 'professor_oak', 'gary'] %}
{% set charactersAmount = randint(0, characters|length) %}
{% if charactersAmount > 0 %}
  with {{ pick_multiple(characters, charactersAmount)|join(separator) }}
{% endif %}
in the mountains

flip_coin

If no arguments are given, returns a random boolean. Otherwise randomly picks an argument.

Example

For branches

{% if flip_coin() %}
  1girl,
{% endif %}
laying on grass

For quick inline decisions

a {{ flip_coin('caught', 'fleeing') }} Pikachu

[akx]

Could you also add docs and/or tests for these?

[akx]

Suggested change

	def pick_multiple(items: Iterable[Any], returnLength: int | True = True) -> list[Any]:
	if returnLength is True:
	returnLength = random.randint(1, len(items))
	if returnLength == 0:
	return []
	if returnLength > len(items):
	return list(items)
	return random.sample(list(items), returnLength)
	def pick_multiple(items: Iterable[Any], return_length: int | True = True) -> list[Any]:
	if return_length is True:
	return_length = random.randint(1, len(items))
	if return_length == 0:
	return []
	if return_length > len(items):
	return list(items)
	return random.sample(list(items), return_length)