<commit_before>/*
Package tribool implements a tri-state boolean where the extra state is indeterminate.

Maybe

A tri-state boolean has the values False, True, and Maybe. Maybe represents a
value that is neither true or false but it is inderminate. For example, you
don't know if an http POST was successful if the connection is dropped after
the request was made but before the response came back. This can be modeled
with the indeterminate Maybe value.

Tribool provides tri-state logical operators that act like their boolean
counterparts. The logic tables are documented below and on each method. There
are also methods for mixed Tribool and bool operations.

Parsing

The tribool package is especially useful for parsing flags that may need a
default value. For example:

	var x string // from somehere
	var flag bool = tribool.FromString(x).WithMaybeAsFalse()

Parsing is case sensitive. The following table shows what will be parsed to
true and false values, anything else (including the empty string) results in
the indeterminate value.

	case insensitive | result
	-----------------+-------
	               t | Yes
	               y | Yes
	               1 | Yes<commit_msg>Update documentation wrt. case sensitivity<commit_after>/*
Package tribool implements a tri-state boolean where the extra state is indeterminate.

Maybe

A tri-state boolean has the values False, True, and Maybe. Maybe represents a
value that is neither true or false but it is inderminate. For example, you
don't know if an http POST was successful if the connection is dropped after
the request was made but before the response came back. This can be modeled
with the indeterminate Maybe value.

Tribool provides tri-state logical operators that act like their boolean
counterparts. The logic tables are documented below and on each method. There
are also methods for mixed Tribool and bool operations.

Parsing

The tribool package is especially useful for parsing flags that may need a
default value. For example:

	var x string // from somehere
	var flag bool = tribool.FromString(x).WithMaybeAsFalse()

Parsing is case insensitive. The following table shows what will be parsed to
true and false values, anything else (including the empty string) results in
the indeterminate value.

	case insensitive | result
	-----------------+-------
	               t | Yes
	               y | Yes
	               1 | Yes
{'fraction_non_alphanumeric': 0.05460608586911213, 'fraction_numerical': 0.0008336807002917883, 'mean_word_length': 3.2704626334519573, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2787271', 'n_tokens_mistral': 590, 'n_tokens_neox': 551, 'n_words': 341}