AveyTense Declarations

Submodules

aveytense.constants (≥ 0.3.26rc3)

Math constants (since 0.3.35 also contains enum members to shorten code when providing these to specific functions)

aveytense.databases (≥ 0.3.27a4)

Connection with SQL. Extant in code but not in use until 0.3.42.

aveytense.extensions (≥ 0.3.24; < 0.3.26rc1)

Extensions of AveyTense, removed as it was useless and possibly unrelated. It was the submodule where tests on ANSIColor occurred, before class aveytense.Color replaced that class utterly.

aveytense.games (≥ 0.3.31)

Submodule for entertainment. Most declarations are affiliated with class Games, which is featured in this submodule.

aveytense.operators (≥ 0.3.27a3)

Extension of operator Python standard library.

aveytense.primary (≥ 0.3.24; < 0.3.26rc3)

The submodule where abroad() and reckon() functions were defined; name changed so the submodule will be never imported. This allows to shorten the import statement (since only tense module import is required).

aveytense.tcs (≥ 0.3.25?; < 0.3.26rc3)

This submodule featured constants and types collection (also the meaning of this alias). It has been replaced by 2 different submodules: aveytense.constants and aveytense.types_collection.

aveytense.types_collection (≥ 0.3.27a4)

Features types from various Python libraries (including typing and enum) and abstract classes.

aveytense.util (≥ 0.3.34)

Contains utility classes to create abstract, final and frozen classes, abstract and final methods, as well as final variables.

Constants

Most constants since 0.3.35 are located in submodule aveytense.constants.

aveytense.constants.JS_MAX_SAFE_INTEGER (≥ 0.3.26b3)

Returns the greatest safe integer in JavaScript, thats 9007199254740991 (2⁵³ - 1). See also Number.MAX_SAFE_INTEGER.

aveytense.constants.JS_MAX_VALUE (≥ 0.3.26b3)

Returns the greatest number value that can be represented in JavaScript before evaluation hits Infinity, thats 2¹⁰²⁴ - 2⁹⁷¹ (1.797693... * 10³⁰⁸; exact value). See also Number.MAX_VALUE.

aveytense.constants.JS_MIN_SAFE_INTEGER (≥ 0.3.26b3)

Returns the least safe integer in JavaScript, thats -9007199254740991 (-2⁵³ - 1). See also Number.MIN_SAFE_INTEGER.

aveytense.constants.JS_MIN_VALUE (≥ 0.3.26b3)

Returns the least number value that can be represented in JavaScript before evaluation hits 0, thats 2^-1074 (4.940656... * 10^-324; exact value). See also Number.MIN_VALUE.

aveytense.constants.MATH_BILLION (≥ 0.3.26b3)

Returns 10⁹.

0.3.35: renamed from BILLION to MATH_BILLION.

aveytense.constants.MATH_CENTILLION (≥ 0.3.26b3)

Returns 10³⁰³.

0.3.35: renamed from CENTILLION to MATH_CENTILLION.

aveytense.constants.MATH_DECILLION (≥ 0.3.26b3)

Returns 10³³.

0.3.35: renamed from DECILLION to MATH_DECILLION.

aveytense.constants.MATH_DUODECILLION (≥ 0.3.26b3)

Returns 10³⁹.

0.3.35: renamed from DUODECILLION to MATH_DUODECILLION.

aveytense.constants.MATH_E (≥ 0.3.26b3)

Returns value of irrational constant e. See also math.e.

0.3.35: renamed from E to MATH_E.

aveytense.constants.MATH_GOOGOL (≥ 0.3.26b3)

Returns 10¹⁰⁰.

0.3.35: renamed from GOOGOL to MATH_GOOGOL.

aveytense.constants.MATH_INF (≥ 0.3.26b3)

Returns infinity. See also math.inf.

0.3.35: renamed from INF to MATH_INF.

aveytense.constants.MATH_MILLION (≥ 0.3.26b3)

Returns 10⁶.

0.3.35: renamed from MILLION to MATH_MILLION.

aveytense.constants.MATH_NAN (≥ 0.3.26b3)

Returns not a number. See also math.nan.

0.3.35: renamed from NAN to MATH_NAN.

aveytense.constants.MATH_NONILLION (≥ 0.3.26b3)

Returns 10³⁰.

0.3.35: renamed from NONILLION to MATH_NONILLION.

aveytense.constants.MATH_NOVEMDECILLION (≥ 0.3.26b3)

Returns 10⁶⁰.

0.3.35: renamed from NOVEMDECILLION to MATH_NOVEMDECILLION.

aveytense.constants.MATH_OCTILLION (≥ 0.3.26b3)

Returns 10²⁷.

0.3.35: renamed from OCTILLION to MATH_OCTILLION.

aveytense.constants.MATH_OCTODECILLION (≥ 0.3.26b3)

Returns 10⁵⁷.

0.3.35: renamed from OCTODECILLION to MATH_OCTODECILLION.

aveytense.constants.MATH_PI (≥ 0.3.26b3)

Returns value of irrational constant π. See also math.pi.

0.3.35: renamed from PI to MATH_PI.

aveytense.constants.MATH_QUADRILLION (≥ 0.3.26b3)

Returns 10¹⁵.

0.3.35: renamed from QUADRILLION to MATH_QUADRILLION.

aveytense.constants.MATH_QUATTUOR_DECILLION (≥ 0.3.26b3)

Returns 10⁴⁵.

0.3.35: renamed from QUATTUOR_DECILLION to MATH_QUATTUOR_DECILLION.

aveytense.constants.MATH_QUINDECILLION (≥ 0.3.26b3)

Returns 10⁴⁸.

0.3.35: renamed from QUINDECILLION to MATH_SEPTEN_QUINDECILLION.

aveytense.constants.MATH_QUINTILLION (≥ 0.3.26b3)

Returns 10¹⁸.

0.3.35: renamed from QUINTILLION to MATH_QUINTILLION.

aveytense.constants.MATH_SEPTEN_DECILLION (≥ 0.3.26b3)

Returns 10⁵⁴.

0.3.35: renamed from SEPTEN_DECILLION to MATH_SEPTEN_DECILLION.

aveytense.constants.MATH_SEPTILLION (≥ 0.3.26b3)

Returns 10²⁴.

0.3.35: renamed from SEPTILLION to MATH_SEPTILLION.

aveytense.constants.MATH_SEXDECILLION (≥ 0.3.26b3)

Returns 10⁵¹.

0.3.35: renamed from SEXDECILLION to MATH_SEXDECILLION.

aveytense.constants.MATH_SEXTILLION (≥ 0.3.26b3)

Returns 10²¹.

0.3.35: renamed from SEXTILLION to MATH_SEXTILLION.

aveytense.constants.MATH_SQRT2 (≥ 0.3.26b3)

Returns square root of 2; equivalent to math.sqrt() with 2 as the value. Reference to Math.SQRT2 constant from JavaScript.

0.3.35: renamed from SQRT2 to MATH_SQRT2.

aveytense.constants.MATH_TAU (≥ 0.3.26b3)

Returns value of irrational constant τ. See also math.tau.

0.3.35: renamed from TAU to MATH_TAU.

aveytense.constants.MATH_THOUSAND (≥ 0.3.26b3)

Returns 10⁴. Not advisable to use this constant since it can be simply replaced with value 1000.

0.3.35: renamed from THOUSAND to MATH_THOUSAND.

aveytense.constants.MATH_TREDECILLION (≥ 0.3.26b3)

Returns 10⁴².

0.3.35: renamed from TREDECILLION to MATH_TREDECILLION.

aveytense.constants.MATH_TRILLION (≥ 0.3.26b3)

Returns 10¹².

0.3.35: renamed from TRILLION to MATH_TRILLION.

aveytense.constants.MATH_UNDECILLION (≥ 0.3.26b3)

Returns 10³⁶.

0.3.35: renamed from UNDECILLION to MATH_UNDECILLION.

aveytense.constants.MATH_VIGINTILLION (≥ 0.3.26b3)

Returns 10⁶³.

0.3.35: renamed from VIGINTILLION to MATH_VIGINTILLION.

aveytense.constants.MC_DURABILITY (≥ 0.3.26b3)

Returns duralibility of all tools in Minecraft as for version 1.21.3.

0.3.37: this constant is now instance of local class holding final properties representing items.
Earlier, it was a string-key-integer-value dictionary.

aveytense.constants.MC_ENCHANTS (≥ 0.3.26b3)

Returns 42 (amount of enchantments in Minecraft as for version 1.21.3).

aveytense.constants.SMASH_HIT_CHECKPOINTS (≥ 0.3.26b3)

Returns 13 (Smash Hit has 12 checkpoints + 1 endless).

aveytense.constants.STRING_BINARY (≥ 0.3.36)

Returns 0-1 in a string.

aveytense.constants.STRING_DIGITS (≥ 0.3.36)

Returns 0-9 in a string.

aveytense.constants.STRING_HEXADECIMAL (≥ 0.3.36)

Returns 0-9a-fA-F in a string.

aveytense.constants.STRING_LETTERS (≥ 0.3.36)

Returns a-zA-Z in a string.

aveytense.constants.STRING_LOWER (≥ 0.3.36)

Returns a-z in a string.

aveytense.constants.STRING_OCTAL (≥ 0.3.36)

Returns 0-7 in a string.

aveytense.constants.STRING_SPECIAL (≥ 0.3.36)

Returns all characters not being a letter nor digit, in a string.

aveytense.constants.STRING_UPPER (≥ 0.3.36)

Returns A-Z in a string.

aveytense.constants.VERSION (≥ 0.3.26b3)

Returns currently used version of AveyTense in a string. E.g. for 0.3.34 it will be "0.3.34". It is identical value as from PyPi.

0.3.36

aveytense.constants.VERSION_ID (≥ 0.3.26b3?; < 0.3.36)

Returns integer value being identifier of current version (counted via length of VERSION_LIST minus 1). This is helper constant along with VERSION_INFO; easier to inspect with if statements. For 0.3.34 it returns 70.

0.3.35: consider using VERSION_INFO instead. This constant is weak even, if it based on length of VERSION_LIST tuple.

0.3.36

aveytense.constants.VERSION_LIST (≥ 0.3.26b3; < 0.3.36)

Returns tuple of versions uploaded since version 0.2.1 (19th November 2022), including this version itself.

0.3.35: consider using VERSION_INFO instead. This constant seems to be enforced since not all versions are required to be included in a sequence, because they all appear on this page. It is also more difficult to inspect these versions via this constant anyway.

0.3.36

aveytense.constants.VERSION_INFO (≥ 0.3.26b3)

Returns tuple containing all version components concerning current version of AveyTense. This sequence consists of following segments: major, minor, micro, release level. If release level doesn't have value "final", then additional integer item known as serial is added. Sometimes, even if release is final, it may have value 0. E.g. for 0.3.34 it will be (0, 3, 34, "final"), meanwhile for 0.3.27rc1 it would be (0, 3, 27, "candidate", 1). Purpose of this constant is the same as inspection of sys.version_info with if statements.

0.3.35: renamed from VERSION_TUPLE to VERSION_INFO.

0.3.36

0.3.40: this constant is now instance of local class, which features more detailed information concerning currently used version of AveyTense.

aveytense.constants.VERSION_INFO_TYPE (≥ 0.3.36)

Type of aveytense.constants.VERSION_INFO.

Classes and type aliases

Classes are scattered around AveyTense library.

class aveytense.util.Abstract (≥ 0.3.26b3)

Creates an abstract class via inheritance.

Perhaps this class can be used with isinstance() inbuilt function, it will always return False. Instead use issubclass(Test, ~.Abstract) to determine, if specific class inherits this class.

This class doesn't inherit and isn't the same as abc.ABC, so issubclass(~.Abstract, abc.ABC) returns False.

from .util import Abstract class Test(Abstract): testTest() InitializedError: attempt to initialize an abstract class Test 0.3.27rc1: the class is no longer experimental. Earlier, this class required following notation: class Test(~.Abstract, abstract = True). That notation came from local class typing._Final, and it isn't supported now. 0.3.34: moved this class from aveytense.types_collection to aveytense.util submodule. 0.3.40: this class is no longer a protocol class

class aveytense.util.AbstractFinal (≥ 0.3.27rc1)

Blend of classes ~.Abstract and ~.Final defined in the same submodule. This class creates abstract-final class via inheritance.

0.3.34: moved this class from aveytense.types_collection to aveytense.util submodule.

class aveytense.extensions.ANSIColor (≥ 0.3.24; < 0.3.26rc1)

Class based on ANSI escape code for colorizing purposes. Removed since formula ended after handover of class aveytense.Color.

0.3.26rc1

class aveytense.ChangeVar (≥ 0.3.26rc1)

Auxiliary class for creating sentinels inside loops, especially while.

class aveytense.Color (≥ 0.3.26rc1)

Deputy of aveytense.extensions.ANSIColor. This class allows to colorize output.

aveytense.Color.__all__ (≥ 0.3.26rc2)
Returns list of all non-underscored members of the class.
aveytense.Color.__constants__ (≥ 0.3.26rc2)
Returns list of all constants being variables of the class. They are sorted in ANSI ascending order, see here to learn more.
aveytense.Color.__init__(text, /, bits = 8, foregroundColor = None, backgroundColor = None) (≥ 0.3.26rc1)
Creates a new Color class instance.
text will be a string, which will be colorized, bits represents bits for colors as in ANSI (possible values: 3, 4, 8, 24), foregroundColor is color for text, which may be a string (if it has hexadecimal, decimal, octal or binary integer), integer and aveytense.RGB class instances (if value for bits is 24). Finally, backgroundColor is color for background, which will encase the text. Accepted values same as in foregroundColor. These values can be greater than desired amount of bits (3 - 10, 4 - 20, 8 - 255, 24 - 16777215). Check this page for more information.
To 0.3.27 signature was the following: __init__(text, /, bits = 8, foregroundColor = None, backgroundColor = None, underlineColor = None). underlineColor was responsible to colorize underline (accepted values same as in foregroundColor and backgroundColor). Nothing really happened during these experiments (expected underline to be factually colored as desired), hence this feature has been excluded.
aveytense.Color.__mod__(other) (≥ 0.3.26rc1)
Allows to include styles to colored text, and returns styled, colored version of text. This method equals self % other, where other must be an appriopriate constant value from this table:
Constant	Lifetime	Description
Single styles
~.Color.NORMAL	≥ 0.3.26rc1	Provides normal text. Nothing changes with this constant
~.Color.BOLD	≥ 0.3.26rc1	Text becomes bold
~.Color.ITALIC	≥ 0.3.26rc1	Text becomes oblique
~.Color.UNDERLINE	≥ 0.3.26rc1	Adds a line under the text
~.Color.SLOW_BLINK	≥ 0.3.26rc1	Sets blinking to less than 150 times per minute
~.Color.RAPID_BLINK	≥ 0.3.26rc1	Sets blinking to more than 150 times per minute
~.Color.REVERSE	≥ 0.3.26rc1	Swap foreground and background colors
~.Color.HIDE	≥ 0.3.26rc1	Text isn't visible on the output
~.Color.STRIKE	≥ 0.3.26rc1	Text becomes crossed out
~.Color.DOUBLE_UNDERLINE	≥ 0.3.26rc1	Adds 2 lines under the text
~.Color.PROPORTIONAL	≥ 0.3.26rc1; < 0.3.26rc2	Proportional spacing, consider using str.rpartition() instead 0.3.26rc2
~.Color.FRAME	≥ 0.3.26rc1	?
~.Color.ENCIRCLE	≥ 0.3.26rc1	It is probably border encasing entire text.
~.Color.OVERLINE	≥ 0.3.26rc1	Adds a line over the text
~.Color.SUPERSCRIPT	≥ 0.3.26rc1	Superscripts the text
~.Color.SUBSCRIPT	≥ 0.3.26rc1	Subscripts the text
Advanced styles
~.Color.BOLD_ITALIC	≥ 0.3.26rc2	Text becomes bold and oblique
~.Color.BOLD_UNDERLINE	≥ 0.3.26rc2	Text becomes bold and underlined
~.Color.BOLD_STRIKE	≥ 0.3.26rc2	Text becomes bold and crossed out
~.Color.BOLD_OVERLINE	≥ 0.3.26rc2	Text becomes bold and overlined
~.Color.ITALIC_UNDERLINE	≥ 0.3.26rc2	Text becomes oblique and underlined
~.Color.ITALIC_STRIKE	≥ 0.3.26rc2	Text becomes oblique and crossed out
~.Color.ITALIC_OVERLINE	≥ 0.3.26rc2	Text becomes oblique and overlined
~.Color.UNDERLINE_STRIKE	≥ 0.3.26rc2	Text becomes underlined and crossed out
~.Color.UOLINE	≥ 0.3.26rc2	Adds lines under and over the text
~.Color.STRIKE_OVERLINE	≥ 0.3.26rc2	Text becomes crossed out and overlined
~.Color.BOLD_ITALIC_UNDERLINE	≥ 0.3.26rc2	Text becomes bold, oblique and underlined
~.Color.BOLD_ITALIC_STRIKE	≥ 0.3.26rc2	Text becomes bold, oblique and crossed out
~.Color.BOLD_ITALIC_OVERLINE	≥ 0.3.26rc2	Text becomes bold, oblique and overlined
~.Color.BOLD_UNDERLINE_STRIKE	≥ 0.3.26rc2	Text becomes bold, underlined and crossed out
~.Color.BOLD_UOLINE	≥ 0.3.26rc2	Text becomes bold, underlined and overlined
~.Color.ITALIC_UNDERLINE_STRIKE	≥ 0.3.26rc2	Text becomes italic, underlined and crossed out
~.Color.ITALIC_UOLINE	≥ 0.3.26rc2	Text becomes italic, underlined and overlined
~.Color.ITALIC_STRIKE_OVERLINE	≥ 0.3.26rc2	Text becomes bold, crossed out and overlined
~.Color.STRIKE_UOLINE	≥ 0.3.26rc2	Text becomes crossed out, underlined and overlined
All of these constants are actually enum members. These categorized as single styles have their enum values the same as in this article (there n), e.g. for ~.Color.BOLD it is 0. Styles 2 in 1, which start category advanced styles, start with value 1000. For styles 3 in 1 beginning is 1100. Not all of these styles are guaranteed to work. For some terminals these may have different meaning. Superscript, subscript, overline, encircle and frame are only implemented in mintty, but e.g. Visual Studio Code supports overline on the terminal. Bold can also mean increased intensity, faint - decreased intensity or dim, double underline - not bold. See entire article here. The following example prints text I will be blue and italic colored blue and oblique: from import .print(Color(I will be blue and italic, 8, 69) Color.ITALIC)
aveytense.Color.__pos__()(≥ 0.3.26rc1)
aveytense.Color.__neg__()(≥ 0.3.26rc1)
aveytense.Color.__invert__()(≥ 0.3.26rc1)
aveytense.Color.__str__() (≥ 0.3.34)
All of these equal the notations, respectively: unary + and -, binary inversion ~ operators, and invocation of str(). All of these return colored text.
from import .print(Color(I will be blue, 8, 69)) .print(Color(I will be blue, 8, 69)) .print(Color(I will be blue, 8, 69))
.print(str(Color(I will be blue, 8, 69))) .print({!s}.format(Color(I will be blue, 8, 69))) .print(Color(I will be blue, 8, 69)) print() will convert the instance to string
aveytense.Color.__repr__() (≥ 0.3.35)
Equals invocation of repr(), and returns more representative version about object.
from aveytense import .print(repr(Color(Hello))) <tense.Color object: Color("Hello")> .print({!r}.format(Color(Hello))) <tense.Color object: Color("Hello")>
aveytense.Color.clear() (≥ 0.3.26rc1)
Resets all values (except text), those are: bits to 8, foreground and background color to None.
This method since 0.3.37 is also invoked when used with ~.Tense.clear().
aveytense.Color.setBackgroundColor(color, /) (≥ 0.3.26rc1)
Sets color for background. Make sure value is least than desired amount of bits (3 - 10, 4 - 20, 8 - 255, 24 - 16777215), otherwise you can meet an error.
aveytense.Color.setBits(bits, /) (≥ 0.3.26rc1)
Sets bits amount. Make sure decreasing the amount won't catch an error. Possible values: 3, 4, 8, 24.
from aveytense import coloredColor(I will be blue, 3, 4) colored.setBits(8) colored.setForegroundColor(69) .print(Color(I will be blue, 8, 69))
aveytense.Color.setForegroundColor(color, /) (≥ 0.3.26rc1)
Sets color for text. Make sure value is least than desired amount of bits (3 - 10, 4 - 20, 8 - 255, 24 - 16777215), otherwise you can meet an error.
aveytense.Color.setUnderlineColor(color, /) (≥ 0.3.26rc1; < 0.3.27)
Sets color for underline. Make sure value is least than desired amount of bits (3 - 10, 4 - 20, 8 - 255, 24 - 16777215), otherwise you can meet an error. Removed since console doesn't display underline with demanded color.

class aveytense.util.Final (≥ 0.3.26b3)

Creates a final class via inheritance.

0.3.27rc1: the class is no longer experimental.

0.3.34: moved this class from aveytense.types_collection to aveytense.util submodule.

class aveytense.util.FinalVar (≥ 0.3.26rc1)

Creates a final variable. It's main job is to supersede typing.Final class, since it doesn't work as intended.

0.3.34: moved this class from aveytense.types_collection to aveytense.util submodule.

0.3.35: the class is no longer experimental.

0.3.38: objects of this class can now be inspected via aveytense.Tense.isFinalVar().

type aveytense.util.FinalVarType (≥ 0.3.38)

Type of aveytense.util.FinalVar; used in aveytense.Tense.isFinalVar() for type hinting.
Once instantiated, it will behave as initializing aveytense.util.FinalVar, what means example expression
FinalVar(2) == FinalVarType(2) returns True.

class aveytense.Math (≥ 0.3.25)

A class containing math methods and constants. Inherited by class aveytense.Tense.

Comparing to math module in Python, this class features polygonal number counting,
more trigonometrical methods, number verification methods and sequence checking.
In overall, this class is its extension.

All methods in the class are class methods.

aveytense.Math.__all__ (≥ 0.3.26rc2)
Returns sorted list of all non-underscored members of the class.
aveytense.Math.abs(x, /)
Returns absolute value of a number. Equals math notation |x| defined as:

• return -x, if x < 0
• return x, if x ≥ 0
This class method was defined before 0.3.24, but it remains hard to assume since when it was defined on old Tense08 class. It is believed that it was defined when Tense08 class was defined (0.2.16) or between 0.3.6 - 0.3.8. There was lacking docstring in this class method. Currently, Aveyzan has archives since version 0.2.6 (up to 0.3.29; last version with zip archive version).
0.3.39: Added type checking. To not catch TypeError, integer, floating-point number or object of class implementing __abs__() method must be passed. In the last one, method __abs__() must return either integer or floating-point number. Unfortunately, for negative numbers it doesn't seem logical, when using the inbuilt function abs():
from aveytense import
class r:
def __abs__(self):
return -76
.print(abs(r())) -76
So on this version correction has been applied:
.print(Math.abs(r())) 76
This first example comes from fact that method __abs__() can return anything, so its also seen in function abs(), as self.__abs__() method
is the same as invocation of abs(self).
aveytense.Math.acos(x, /) (≥ 0.3.25)
Returns arc cosine of x.
Domain equals x ∈ ⟨-1; 1⟩. Result will be in range ⟨0; π⟩.
0.3.38: Improved domain checking
0.3.39: Improved type checking
aveytense.Math.acosec(x, /) (≥ 0.3.25)
Returns arc cosecant of x.
Domain equals x ∈ (-∞ -1⟩ ∪ ⟨1; ∞), or, simplier: |x| ≥ 1.
0.3.38: Improved domain checking
0.3.39: Improved type checking
aveytense.Math.acosh(x, /) (≥ 0.3.25)
Returns inverse hyperbolic cosine of x.
Domain equals x ≥ 1.
0.3.39: Improved domain and type checking
aveytense.Math.acovercos(x, /) (≥ 0.3.25)
Returns inverse coversed cosine of x. Equals aveytense.Math.asin(x - 1).
Domain equals x ∈ ⟨0; 2⟩ (basing on arc sine domain).
0.3.39: Renamed from aveytense.Math.acovercosin(); improved domain and type checking
aveytense.Math.acoversin(x, /) (≥ 0.3.25)
Returns inverse coversed sine of x. Equals aveytense.Math.asin(1 - x).

Domain equals x ∈ ⟨0; 2⟩ (basing on arc sine domain).
0.3.39: Improved domain and type checking
aveytense.Math.aexcosec(x, /) (≥ 0.3.25)
Returns inverse excosecant of x. Equals aveytense.Math.acosec(x + 1).

Domain equals x ∈ (-∞ -2⟩ ∪ ⟨0; ∞) (basing on arc cosecant domain).

0.3.39: Renamed from aveytense.Math.aexcsc(); improved domain and type checking
aveytense.Math.aexsec(x, /) (≥ 0.3.25)
Returns inverse exsecant of x. Equals aveytense.Math.asec(x + 1).

Domain equals x ∈ (-∞ -2⟩ ∪ ⟨0; ∞) (basing on arc secant domain).

0.3.39: Improved domain and type checking
aveytense.Math.ahacovercos(x, /) (≥ 0.3.25)
Returns inverse hacoversed cosine of x. Equals aveytense.Math.asin(2x - 1).

Domain equals x ∈ ⟨0; 1⟩ (basing on arc sine domain).

0.3.39: Renamed from aveytense.Math.ahacovercosin(); improved domain and type checking
aveytense.Math.ahacoversin(x, /) (≥ 0.3.25)
Returns inverse hacoversed sine of x. Equals aveytense.Math.asin(1 - 2x).

Domain equals x ∈ ⟨0; 1⟩ (basing on arc sine domain).

0.3.39: Improved domain and type checking
aveytense.Math.ahavercos(x, /) (≥ 0.3.25)
Returns inverse haversed cosine of x. Equals aveytense.Math.acos(2x - 1).

Domain equals x ∈ ⟨0; 1⟩ (basing on arc cosine domain).

0.3.39: Renamed from aveytense.Math.ahavercosin(); improved domain and type checking
aveytense.Math.ahaversin(x, /) (≥ 0.3.25)
Returns inverse haversed cosine of x. Equals aveytense.Math.acos(1 - 2x).

Domain equals x ∈ ⟨0; 1⟩ (basing on arc cosine domain).

0.3.39: Improved domain and type checking
aveytense.Math.asec(x, /) (≥ 0.3.25)
Returns arc secant of x.

Domain equals x ∈ (-∞ -1⟩ ∪ ⟨1; ∞), or, simplier: |x| ≥ 1.
0.3.38: Improved domain checking
0.3.39: Improved type checking
aveytense.Math.asin(x, /) (≥ 0.3.25)
Returns arc sine of x.
Domain equals x ∈ ⟨-1; 1⟩. Result will be in range ⟨-^π/₂; ^π/₂⟩.
0.3.38: Improved domain checking
0.3.39: Improved type checking
aveytense.Math.asinh(x, /) (≥ 0.3.25)
Returns inverse hyperbolic sine of x.
Domain equals x ∈ R.
0.3.39: Improved type checking
aveytense.Math.atan(x, /) (≥ 0.3.25)
Returns arc tangent of x.
Domain equals x ∈ R.
0.3.39: Improved type checking
aveytense.Math.atanh(x, /) (≥ 0.3.25)
Returns inverse hyperbolic tangent of x.
Domain equals x ∈ ⟨-1; 1⟩.
0.3.39: Improved domain and type checking
aveytense.Math.avercos(x, /) (≥ 0.3.25)
Returns inverse versed cosine of x. Equals aveytense.Math.acos(x - 1).

Domain equals x ∈ ⟨0; 2⟩ (basing on arc cosine domain).

0.3.39: Renamed from aveytense.Math.avercosin(); improved domain and type checking
aveytense.Math.aversin(x, /) (≥ 0.3.25)
Returns inverse versed cosine of x. Equals aveytense.Math.acos(1 - x).

Domain equals x ∈ ⟨0; 2⟩ (basing on arc cosine domain).

0.3.39: Improved domain and type checking
aveytense.Math.cbrt(x, /) (≥ 0.3.25)
Returns ³√x (cube root of x)

0.3.26rc2: provided support before Python 3.11 (function math.cbrt() didn't exist to this version).
0.3.39: Improved type checking
aveytense.Math.cos(x, /) (≥ 0.3.25)
Returns cosine of x.

Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.cosec(x, /) (≥ 0.3.25)
Returns cosecant of x.

Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.cosh(x, /) (≥ 0.3.25)
Returns hyperbolic cosine of x.

Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.cot(x, /) (≥ 0.3.25)
Returns cotangent of x (inverse of tangent).

Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.covercos(x, /) (≥ 0.3.25)
Returns coversed cosine of x. Equals 1 + tense.Math.sin(x).

Domain equals x ∈ R.

0.3.39: Renamed from ~.covercosin(); improved type checking
aveytense.Math.coversin(x, /) (≥ 0.3.25)
Returns coversed sine of x. Equals 1 - tense.Math.sin(x).

Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.decagonal(n, /) (≥ 0.3.27a4)
Returns decagonal number from following formula: 4n² - 3n. This method is the same as ~.polygonal(n, 10). Example results:
• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 10
• for n = 3 returned is 27
• for n = 4 returned is 52
...
See this article to see more results.
0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.excosec(x, /) (≥ 0.3.25)
Returns excosecent of x. Equals ~.cosec(x) - 1.
Domain equals x ∈ R.

0.3.39: improved type checking
0.3.40: renamed from ~.excsc()
aveytense.Math.exsec(x, /) (≥ 0.3.25)
Returns excosecent of x. Equals ~.sec(x) - 1.
Domain equals x ∈ R.

0.3.39: Improved type checking
aveytense.Math.fact(n, /) (≥ 0.3.26rc3)
Returns factorial of n, given by formula: n! = n ∙ (n - 1) ∙ (n - 2) ∙ ... ∙ 3 ∙ 2 ∙ 1. For n ∈ {0; 1} (n is equal 0 or 1) returned is 1.
0.3.39: Improved type checking. In case there wasn't math.factorial() function, implementation is since now included.
aveytense.Math.gcd(*i) (≥ 0.3.31)
Returns greatest common divisor of all integers given. Unlike for common notation with 2 values gcd(a, b), this
method supports variable amount of integers.

Before Python 3.9, math.gcd() function operated on 2 values only.
0.3.39: Improved type checking. Added support for variable amount of values before Python 3.9.
aveytense.Math.heptagonal(n, /) (≥ 0.3.27a4)
Returns heptagonal number from following formula: 5n² - 3n2. This method is the same as ~.polygonal(n, 7). Example results:
• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 7
• for n = 3 returned is 18
• for n = 4 returned is 34
...
See this article to see more results.
0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.hexagonal(n, /) (≥ 0.3.27a4)

Returns hexagonal number from following formula: 2n² - n. This method is the same as ~.polygonal(n, 6). Example results:

• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 6
• for n = 3 returned is 15
• for n = 4 returned is 28
...

See this article to see more results.

0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.isInRange(x, a, b, /, mode = "c") (≥ 0.3.36)
Returns True, if x ∈ ⟨a; b⟩. If a is greater than b, then range will occur as ⟨b; a⟩.
If x is a sequence of numbers, then all numbers from that sequence must be in range created by a and b. In case of empty sequences False is returned.
0.3.39: added parameter mode to modify the range. c means closed and o means open bracket:
~.isInRange()
mode value	Equivalent to
"c" "cc"	x ∈ ⟨a; b⟩ a ≤ x ≤ b
"co"	x ∈ ⟨a; b) a ≤ x < b
"o" "oo"	x ∈ (a; b) a < x < b
"oc"	x ∈ (a; b⟩ a < x ≤ b
not ~.isInRange()
mode value	Equivalent to
"c" "cc"	x ∈ (-∞; a) ∪ (b; ∞) x < a || x > b
"co"	x ∈ (-∞; a) ∪ ⟨b; ∞) x < a || x ≥ b
"o" "oo"	x ∈ (-∞; a⟩ ∪ ⟨b; ∞) x ≤ a || x ≥ b
"oc"	x ∈ (-∞; a⟩ ∪ (b; ∞) x ≤ a || x > b
Case for mode is insensitive.
In case of maths, ranges are also called intervals, as visible in this article.
aveytense.Math.lcm(*i) (≥ 0.3.31)
Returns least common multiple of all integers given. Math interpretation: lcm(i₁, i₂, i₃, ..., i_n). This can be also achieved with functools.reduce() function used along with math.gcd(), as the following piece of code:
from import from functools import reduce ≥ 2.6 from math import gcd ≥ 3.5 math.gcd(): before Python 3.9, this function operated on 2 parameters, but we can manually implement it def lcm(i): return reduce(lambda a, b: (a b)gcd(a, b), i) The ~.lcm() class method provides support before Python 3.9. Before Python 3.9, math.lcm() wasn't defined yet.
0.3.39: Improved type checking and added support before Python 3.9.
aveytense.Math.log(x, /, base = tense.constants.MATH_E) (≥ 0.3.25)
Returns log_b x (where b = base).
0.3.39: x is now positional-only parameter
aveytense.Math.lwdp(n, /) (≥ 0.3.39)
Returns number least with digit product of n. Multiply operation on certain digits need to have the same result as n, and first smallest one will be returned. If there are no digits that multiplied together equal n, method will return -1. Examples: for n = 18 returned is 29, for n = 36 returned is 49, and for n = 120 returned is 358. Notice results are greater than n.
This class method was defined on 0.3.31 as aveytense.Math.ltp() (least to product). However, it was never handed over, mainly due to issue of generating the result too long. It still existed in code, just wasn't available publicly due to if False statement preceding the method definition as an alternative for inspecting sys.version_info.
This method was defined back during IT trial mature exams on 22nd November 2024, and since then that method had this issue.
The issue was patched on 12th February 2025.
aveytense.Math.maxDigit(n, /) (≥ 0.3.39)
Returns largest digit in an integer. Sign isn't counted.
aveytense.Math.mean(*a, mode = "a") (≥ 0.3.40)
Returns arithmetic, geometric or quadratic mean of given integers. Result may be either float or integer. Throws TypeError whether there were no integer values passed or not all values are integers.
The type of mean is addicted to parameter mode:
• "a" - returns arithmetic mean. Formula: a₁ + a₂ + ... + a_nn
• "g" - returns geometric mean. Formula: (a₁ ∙ a₂ ∙ ... ∙ a_n)^n-1 = ⁿ√(a₁ ∙ a₂ ∙ ... ∙ a_n)
• "q" - returns quadratic mean (root mean square). Formula: √(a₁² + a₂² + ... + a_n²n)
Case for mode is insenstive.
In case geometric mean is deduced, ValueError is raised when there is at least one negative integer passed.
aveytense.Math.minDigit(n, /) (≥ 0.3.39)
Returns smallest digit in an integer. Sign isn't counted.
aveytense.Math.nonagonal(n, /) (≥ 0.3.27a4)
Returns nonagonal number from following formula: 7n² - 5n2.
This method is the same as aveytense.Math.polygonal(n, 9). Example results:
• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 9
• for n = 3 returned is 24
• for n = 4 returned is 46
...
See this article to see more results.
0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.octagonal(n, /) (≥ 0.3.27a4)

Returns octagonal number from following formula: 3n² - 2n.
This method is the same as aveytense.Math.polygonal(n, 8). Example results:

• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 8
• for n = 3 returned is 21
• for n = 4 returned is 40
...

See this article to see more results.

0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.pentagonal(n, /) (≥ 0.3.27a4)
Returns pentagonal number from following formula: 3n² - n2.
This method is the same as aveytense.Math.polygonal(n, 5). Example results:
• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 5
• for n = 3 returned is 12
• for n = 4 returned is 22
...
See this article to see more results.
0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.
aveytense.Math.perm(n, k = ..., /) (≥ 0.3.39)
Returns variation without repetitions given by formula n!(n - k)!. In binomial coefficent notation it would look like $\left(\genfrac{}{}{0ex}{}{n}{k}\right)$∙ k!
If k is ellipsis, returns n! (variation with repetitions or permutations).
Scheme for variation without repetitions is took from this PDF file.
0.3.40: fixed to current scheme, earlier it was n!(n - k)! ∙ k!. Removed support for None.
aveytense.Math.polygonal(n, s, /) (≥ 0.3.27a4)
Returns s-gonal number from following formula: (s - 2)n² - (s - 4)n2.
s is amount of sides in a polygon, and it cannot be negative, not even equal 0 (see note below for update).
0.3.39: Number 0 in first parameter is now allowed. Earlier, numbers from 1 above
were able to be passed to that parameter. However, second parameter must now comply with s ≥ 3,
because at least 3 sides can create a polygon (starting from triangle).
aveytense.Math.sin(x, /) (≥ 0.3.25)
Returns sine of x. Formula is sin x = $\underset{n=0}{\overset{\infty }{\Sigma }}\frac{{\mathrm{(-1)}}^{\mathrm{n}}}{\mathrm{(2n}+\mathrm{1)!}}{x}^{\mathrm{2n\; +\; 1}}$ (note n is sentinel in a loop, which will never end due to ∞).

0.3.39: Improved type checking
aveytense.Math.sqrt(x, /) (≥ 0.3.25)
Returns √x (square root of x)
0.3.39: Improved type checking
aveytense.Math.toDigits(n, /) (≥ 0.3.39)
Splits an integer into a list of digits building the integer. Sign isn't counted.
aveytense.Math.triangular(n, /) (≥ 0.3.27a4)
Returns triangular number from following formula: n² + n2.
This method is the same as aveytense.Math.polygonal(n, 3). Example results:
• for n = 0 returned is 0
• for n = 1 returned is 1
• for n = 2 returned is 3
• for n = 3 returned is 6
• for n = 4 returned is 10
...
See this article to see more results.
0.3.39: Number 0 is now allowed. Earlier, numbers from 1 above were able to be passed.

class aveytense.games.Minesweeper (≥ 0.3.41)

Provides components for minesweeper game. Referred from Windows 7 Minesweeper. These components can be used with tkinter, from which AveyTense project resigned back on 0.3.36.

aveytense.games.Minesweeper.__init__(height = 16, width = 30, mines = 99) (≥ 0.3.41)
Creates a new ~.Minesweeper class object. height is amount of rows for the board. Allowed values for 9 to 24.
width is amount of columns for the board. Allowed values for 9 to 30.
mines is amount of mines scattered on the board. Allowed values for 10 to 668. As values, you can use consecutive items in following tuples:

Variable	Lifetime	Tuple content	Usage
~.Minesweeper.ADVANCED	≥ 0.3.41	(16, 30, 99)	~.Minesweeper(~[0], ~[1], ~[2])
~.Minesweeper.BEGINNER	≥ 0.3.41	(9, 9, 10)
~.Minesweeper.INTERMEDIATE	≥ 0.3.41	(16, 16, 40)

final-property aveytense.games.Minesweeper.board (≥ 0.3.41)
Returns the board as a nested string list. Possible values are for "0" to "8", or "X", which is a mine indicator.
aveytense.games.Minesweeper.displayBoard(colorize = False) (≥ 0.3.41)
Prints the minesweeper board, and returns reference to the class object. Normally, board isn't colored. If colorize is set to True, board will be colored, but it will take longer to print. It usually takes 2-3 seconds.
final-property aveytense.games.Minesweeper.height (≥ 0.3.41)
Returns amount of rows specified in the constructor.
final-property aveytense.games.Minesweeper.mines (≥ 0.3.41)
Returns amount of mines specified in the constructor.
final-property aveytense.games.Minesweeper.width (≥ 0.3.41)
Returns amount of columns specified in the constructor.

final-class tense.RGB (≥ 0.3.28)

Creates a RGB (red-green-blue) tuple.

aveytense.RGB.__init__(red = 0, green = 0, blue = 0) (≥ 0.3.28)
Creates a new RGB class instance.
Parameters represent colors as in mere RGB color picker.
aveytense.RGB.__hex__() (≥ 0.3.28)
property tense.RGB.hex (≥ 0.3.38)
Returns hexadecimal version of RGB tuple, with 0x preceding to comply with hex() inbuilt function.
Note it cannot be used as hex(self), because it throws an error (self is not an integer).
To use it with hex() you need to use int(self) first.
from aveytense import
.print(RGB(0, 0, 85).__hex__()) 0x000055
.print(RGB(0, 0, 85).hex) 0x000055

aveytense.RGB.__int__() (≥ 0.3.28)
Converts RGB tuple into its corresponding integer representation.
from aveytense import
.print(int(RGB(0, 0, 85))) 85

aveytense.RGB.__lt__() (≥ 0.3.28)
aveytense.RGB.__gt__() (≥ 0.3.28)
aveytense.RGB.__le__() (≥ 0.3.28)
aveytense.RGB.__ge__() (≥ 0.3.28)
aveytense.RGB.__eq__() (≥ 0.3.28)
aveytense.RGB.__ne__() (≥ 0.3.28)

Inspect 2 RGB class instances.
from aveytense import
.print(RGB(0, 0, 85)RGB(0, 0, 102)) True
.print(RGB(0, 0, 85)RGB(0, 0, 102)) False
.print(RGB(0, 0, 85)RGB(0, 0, 102)) True
.print(RGB(0, 0, 85)RGB(0, 0, 102)) False
.print(RGB(0, 0, 85)RGB(0, 0, 102)) False
.print(RGB(0, 0, 85)RGB(0, 0, 102)) True

aveytense.RGB.__oct__() (≥ 0.3.41)
Converts RGB tuple into its corresponding octal number representation, with 0o preceding to comply with oct() inbuilt function. To use it with oct() you need to use int(self) first.
from aveytense import
.print((RGB(0, 0, 85).__oct__())) 0o125

aveytense.RGB.__pos__() (≥ 0.3.28)
aveytense.RGB.__neg__() (≥ 0.3.28)
aveytense.RGB.__invert__() (≥ 0.3.28)
property tense.RGB.tuple (≥ 0.3.38)

Returns RGB tuple as a tuple.
from aveytense import
.print(RGB(0, 0, 85)) (0, 0, 85)
.print(RGB(0, 0, 85)) (0, 0, 85)
.print(RGB(0, 0, 85)) (0, 0, 85)
.print(RGB(0, 0, 85).tuple) (0, 0, 85)

aveytense.RGB.__repr__() (≥ 0.3.28)
Equals invocation of repr(), and returns more representative version about object.
from aveytense import
.print(repr(RGB(0, 0, 85))) <tense.RGB object: RGB(0, 0, 85)>

aveytense.RGB.__str__() (≥ 0.3.28)
Returns RGB tuple in a string.
from aveytense import
.print(RGB(0, 0, 85)) RGB(0, 0, 85)

static tense.RGB.fromValue(n, /) (≥ 0.3.36)

Creates a new aveytense.RGB class object using an integer or numeric string in range [0; 2²⁴ - 1]. Right side of range equals 16777215.
from aveytense import
.print(RGB.fromValue(85)) RGB(0, 0, 85)
.print(RGB.fromValue(0o257)) RGB(0, 0, 175)
.print(RGB.fromValue(0xc0ffee)) RGB(12, 15, 238)
.print(RGB.fromValue(0x1278)) RGB(0, 18, 120)

0.3.38: Improved checking in aveytense.Color constructor.
0.3.39: Improved string inspection; less strict checkery and it is now allowed to precede the numeric string with 0x, 0o and 0b.

final-class tense.RGBA (≥ 0.3.37)

Creates a RGBA (red-green-blue-alpha) tuple.

class aveytense.Tense (≥ 0.3.24)

Heart of AveyTense project. Contains many methods, including for math, time, checking types and utility.

All methods, except dunder ones, are class methods. If used via reference, dunder methods aren't
accessible, and will require the class instance. Instead, it is required to create an instance of this class
in order to access them.

0.3.26b3: this class is no longer final (can be subclassed).

0.3.24

aveytense.Tense.__all__ (≥ 0.3.26rc2)
Returns sorted list of all non-underscored members of the class.
aveytense.Tense.abroadBinary(value1, /, value2 = None, modifier = None, include_0b = True) (≥ 0.3.25)
Variation of abroad() function, which converts every integer to their binary equivalents.
Parameter include_0b allows to include 0b prefix in every returned binary integer in a string.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadConvect(*values) (≥ 0.3.25)
Variation of abroad() function, which returns sequence depending by arguments passed.
Every value can be an integer, float, complex and sizeable objects. Method uses following formula:
• for integers, their values are added to result
• for floats, their values are truncated and added to result
• for complexes, their real and imaginary parts are truncated and added to result
• for sizeable objects, their lengths are used
If resulted integer in-code is positive, then returned is iterable as [0; n], if negative, then [n; -1].
from aveytense import
.print(.Convect(35, joyride, 7.2, 2312j, (reckon, abroad)))
35 + 7 + 23 + 12 + 2 = 86 => [0, 1, 2, 3, ..., 83, 84, 85]
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadEach(value1, /, value2 = None, modifier = None, *, each = None) (≥ 0.3.25)
Variation of abroad() function, which can modify iterable via parameter each before it will be returned.
That parameter may be only a callable returning an integer or float, and have one parameter,
either required or optional, but all other - optional. This variation returns a list (factually not abroad() object).
Examples:
from aveytense import
.print(.Each(1, 7, eachlambda x: xx))
[1, 4, 9, 16, 25, 36]
.print(.Each(100, 0, eachlambda x: x(1/2)))
[10, sqrt(99), sqrt(98), ..., sqrt(3), sqrt(2), 1]
.print(.Each(6, 13, eachlambda x: x(1/x)))
[1, 1, 1, 1, 1, 1]
0.3.26a4: this method is no longer experimental.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
0.3.35: all objects except integer and floats are now allowed to be returned in a list.
Due to this change each is keyword-only parameter.
aveytense.Tense.abroadExclude(value1, /, value2 = None, modifier = None, *excludedIntegers) (≥ 0.3.25)
Variation of abroad() function, which excludes desired integers in parameter excludedIntegers.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadFloaty(value1, /, value2 = None, modifier = None, div = 10) (≥ 0.3.25)
Variation of abroad() function, which divides every integer by div.
Roughly equal to aveytense.Tense.abroadEach(value1, value2, modifier, each = lambda x: x / div).
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadHex(value1, /, value2 = None, modifier = None, include_0x = ABROAD_HEX_INCLUDE) (≥ 0.3.25)
Variation of abroad() function, which returns every integer in hexadecimal format as strings.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadImmutable(value1, /, value2 = None, modifier = None) (≥ 0.3.25; < 0.3.34)
Variation of abroad() function, which returns immutable version of the sequence. Alias to tuple(abroad()).
0.3.34 due to shortened notation with unary -: -abroad().
aveytense.Tense.abroadInside(value1, /, value2 = None, modifier = None, string = None) (≥ 0.3.25)
Variation of abroad() function, which places every integer in curly brackets in parameter string.
It will not work with keyword-named parameters.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadLive(*values) (≥ 0.3.25)
Variation of abroad() function referring to graph; every next value is next endpoint.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadNegative(value1, /, value2 = None, modifier = None) (≥ 0.3.24)
Variation of abroad() function, which transforms every integer to negative.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadNegativeFlip(value1, /, value2 = None, modifier = None) (≥ 0.3.24)
Variation of abroad() function, which transforms every integer to negative, and reverses returned sequence.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadOctal(value1, /, value2 = None, modifier = None) (≥ 0.3.25)

0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadPack(*values) (≥ 0.3.25)
Variation of abroad() function basing on inbuilt class zip.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadPositive(value1, /, value2 = None, modifier = None) (≥ 0.3.24)

0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadPositiveFlip(value1, /, value2 = None, modifier = None) (≥ 0.3.24)
Variation of abroad() function, which transforms every integer to positive.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadPrecede(value1, /, value2 = None, modifier = None, prefix = None) (≥ 0.3.25)
Variation of abroad() function, which transforms every integer to positive, and reverses returned sequence.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadSplit(value1, /, value2 = None, modifier = None, limit = 2) (≥ 0.3.25)

0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadSufcede(value1, /, value2 = None, modifier = None, suffix = None) (≥ 0.3.25)
Variation of abroad() function, which returns string sequence with every integer + specific string suffix.
0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.abroadVivid(*values) (≥ 0.3.25)

0.3.34: due to removal of class NennaiAbroads, method was moved to Tense class.
aveytense.Tense.all(i, /, condition = ...) (≥ 0.3.26rc2)
Extension of all() inbuilt function.
Returned is True, if all items satisfied condition.
If it is an ellipsis, returned is True if conversion of all items to boolean returns True.
from aveytense import
.print(.all([3, 9, 6, 12], lambda x: x30)) True
.print(.all([3, 9, 6, 12], lambda x: x20)) False

0.3.27a4: removed parameter default.
0.3.34: the method now returns boolean value instead of copy of the sequence.
0.3.36: if condition was a callable, it must return boolean value, otherwise will always return False.
0.3.39 0.3.40: condition now has default value ellipsis, support for None has been excised. Fixed internal code, as it was liable for errors
aveytense.Tense.any(i, /, condition = None) (≥ 0.3.26rc2)
Extension of any() inbuilt function.
Returned is True, if at least one item satisfied condition.
If it is an ellipsis, returned is True if conversion of at least one item to boolean returns True.
from aveytense import
.print(.any([3, 9, 6, 12], lambda x: x20)) True
.print(.any([3, 9, 6, 12], lambda x: x70)) False

0.3.27a4: removed parameter default.
0.3.34: the method now returns boolean value instead of copy of the sequence.
0.3.39 0.3.40: condition now has default value ellipsis, support for None has been excised. Fixed internal code, as it was liable for errors
aveytense.Tense.append(i, /, *items) (≥ 0.3.27a4)
Extension of list.append() instance method.
Appends items from parameter items (in order as they appear)
to a new list formalized from first parameter, and return this list.
0.3.34: because code normally converts sequence to a list builtin, the method now accepts any iterables.
0.3.39
aveytense.Tense.bisect(a, x, /, l = 0, h = None,
dir = BISECT_RIGHT, *, key = None) (≥ 0.3.26rc2)
Same as bisect.bisect() / bisect.bisect_left(), just dir parameter determines, which bisect function to invoke. Possible values:

Constant	Lifetime	Description
~.Tense.BISECT_LEFT / ~.constants.BISECT_LEFT	≥ 0.3.26rc2 ≥ 0.3.35	Invokes bisect.bisect_left().
~.Tense.BISECT_RIGHT / ~.constants.BISECT_RIGHT	≥ 0.3.26rc2 ≥ 0.3.35	Invokes bisect.bisect_right().

aveytense.Tense.cast(v, t, /) (≥ 0.3.36)
Same as typing.cast(), just parameters being in inverted places.
aveytense.Tense.clear(*v) (≥ 0.3.27a4)
Allows to clear many mutable sequences/sets/mappings at once. This method doesn't return anything, just like all of these methods: list.clear(), set.clear() and dict.clear().
0.3.27b1: strings are now allowed.
0.3.36: mutable sets are now allowed.
0.3.37: mutable mappings are now allowed, as well as instances of class ~.Color. In case of ~.Color class instances invoked is their instance method ~.Color.clear().
0.3.39
0.3.40: instances of types.FrameType are now allowed. Since this version strings are factually cleared; earlier, it was an unhandled issue despite it is normally supported. In general, objects of classes extending classes from collections.abc: MutableSequence, MutableSet or MutableMapping are allowed, so not only inbuilt solutions such as lists, sets or dictionaries. Tests on clearing strings took some time to configure. To 0.3.40 it was an unhandled problem, because there was certainty it actually worked. Reason it didn't comes from fact that strings are practically immutable, just like tuples.
aveytense.Tense.copy(x) (≥ 0.3.34)
Same as copy.copy().
type aveytense.Tense.count (≥ 0.3.34)
Type alias for itertools.count (as a method, it may not operate on all overloads because of an error saying this class isn't subscriptable).
aveytense.Tense.cycle(i, /) (≥ 0.3.34)
Equivalent to itertools.cycle.
aveytense.Tense.deepcopy(x, memo = None, _nil = []) (≥ 0.3.34)
Same as copy.deepcopy().
aveytense.Tense.difference(v1, v2, /, invert = False, value_check = True) (≥ 0.3.32)
Extension of set.difference() instance method.
Returns items of first sequence that don't belong to second sequence, or vice versa, if invert is set to True.
0.3.34: the method now also accepts types, mappings and instances of abroad() function.
aveytense.Tense.error(handler, message)(≥ 0.3.24; < 0.3.31)
Defines an error and raises it.
0.3.25
0.3.31
aveytense.Tense.eval(source, /)
aveytense.Tense.eval(source, /, globals = None, locals = None)
aveytense.Tense.eval(source, /, globals = None, locals = None,
flags = 0, dont_inherit = False, optimize = -1) (≥ 0.3.26rc2)
Extension of eval() inbuilt Python function.
aveytense.Tense.exclude(i, /, *items) (≥ 0.3.34)
Returns a new list without items specified in items. First parameter can be any iterable. This method is the same as [e for e in i if e not in items], omitting the fact there is no type checking. That means type of every element is ignored - code just hints type from iterable's type.
aveytense.Tense.expect(i, m = ">= 1", /, condition = ...) (≥ 0.3.40)
A class method working similarly as ~.any() and ~.all(), however, it is possible to enforce amount of items to satisfy condition in order to return True.
Parameter m (alias to matches) has the main role there. It has to be a special string literal, which will feature an integer (or keyword len) and comparison operator (from following: ==, !=, >=, <=, > and <), no matter in which order. len is shorthand keyword allowing to get literal iterables' sizes (not variables necessarily). This string determines about how many item matches need to be done to return True. Support for intervals will be added presumably on 0.3.48.
Default value for m is what it is. It equals following sentence: "equal or more than one item match", which is the same as invocation of ~.any(). Below table with example values for m:
m value	~.expect()	not ~.expect()
">= 3" "3 <="	item_matches ≥ 3	item_matches < 3
"< 19" "19 >"	item_matches < 19	item_matches ≥ 19
"== 14" "14 =="	item_matches = 14	item_matches ≠ 14
"!= 23" "23 !="	item_matches ≠ 23	item_matches = 23
"<= len" "len >="	item_matches ≤ iterable_length	item_matches > iterable_length
from import .expect([76, 66, 56, 46], >= 3, lambda x: Math.isComposite(x)) True; 4 matches satisfy ≥ 3 .expect([76, 66, 56, 46], < 2, lambda x: Math.isComposite(x)) False; 4 matches don't satisfy < 2 .expect([76, 66, 56, 46], > 3, lambda x: Math.isComposite(x)) TypeError: expected 'm' parameter to be a valid string literal, like "> 3" or 'None'; only integer + comparison operator (or vice versa) are permitted in the string .expect([76, 66, 56, 46], > 7, lambda x: Math.isComposite(x)) TypeError: expected an integer in range ⟨1; iterable_length⟩; passed 7 so it is bigger than iterable's length
If you want to append larger numbers, e.g. with scientific notation, you should modify it in following ways: .expect([76, 66, 56, 46], <= {}.format(int(2e+12)), lambda x: Math.isComposite(x)) .expect([76, 66, 56, 46], <= str(int(2e+12)), lambda x: Math.isComposite(x)) The len keyword allows to create ~.all() method using the following signature:
.expect(i, == len, condition) same as ~.all()
But for ~.any() method, signature doesn't use len keyword. Reason it doesn't is because "<= len" will be satisfied also for no matches overall.
.expect(i, >= 1, condition) same as ~.any()
Case for m is sensitive, so e.g. LEN will be invalid and will throw TypeError.
aveytense.Tense.explode(s, /, separator = None, max = -1, no_empty = False) (≥ 0.3.34)
Equivalent to str.split(), just factually without any empty items.
Name is reference to PHP inbuilt function explode().
aveytense.Tense.extend(i, /, *iters) (≥ 0.3.27a4)
Appends items from all iterables (in order as they appear) to a new list formalized from first parameter, and return this list.
0.3.34: because code normally converts sequence to a list builtin, the method now accepts any iterables.
0.3.39
aveytense.Tense.first(i, /, condition = None, default = None) (≥ 0.3.26rc2)
Returns first item from sequence, which satisfied condition or default, if none satisfied condition.
0.3.27a4: removed parameter default.
0.3.34: restored parameter default.
0.3.39
aveytense.Tense.group(*statements, mode = "and-or") (≥ 0.3.34)
Returns one boolean value combining all statements into one boolean value.
Parameter mode determines about used logical operators inside and outside provided sequences.
Those are, respectively: before and after the - sign. Every sequence must contain boolean values.
Allowed are following modes:
• "and-and"
• "and-or"
• "and-nand" (since 0.3.40)
• "and-nor"
• "or-and"
• "or-or"
• "or-nand"
• "or-nor" (since 0.3.40)
• "nand-and" (since 0.3.40)
• "nand-or"
• "nand-nand"
• "nand-nor"
• "nor-and"
• "nor-nand"
• "nor-or" (since 0.3.40)
• "nor-nor"
If you aren't familiar with nor and nand, those are actually equal to, respectively: not OR and not AND.
0.3.40: Case for mode parameter is now insensitive, and added lacking modes: and-nand, nand-and, or-nor and nor-or.
type aveytense.Tense.groupby (≥ 0.3.35)
Type alias for itertools.groupby (as a method, it may not operate on all overloads because of an error saying this class isn't subscriptable).
aveytense.Tense.hasattr(o, attr, /, mode = "or") (≥ 0.3.34)
Extension of inbuilt function hasattr(), used to detect many attributes at once via parameter attr.
Parameter mode only takes place whether attr is a string tuple.
from aveytense import
a{3: 3}
.print(.hasattr(a, values)) True
.print(.hasattr(a, (values, keys))) True
.print(.hasattr(a, (values, abroad))) True
.print(.hasattr(a, (values, abroad), modeand)) False

0.3.39
aveytense.Tense.insort(a, x, /, l = 0, h = None,
dir = INSORT_LEFT, *, key = None) (≥ 0.3.26rc2)
Same as bisect.insort() / bisect.insort_left(), just dir parameter determines, which insort function to invoke. Possible values:

Constant	Lifetime	Description
~.Tense.INSORT_LEFT / ~.constants.INSORT_LEFT	≥ 0.3.26rc2 ≥ 0.3.35	Invokes bisect.insort_left().
~.Tense.INSORT_RIGHT / ~.constants.INSORT_RIGHT	≥ 0.3.26rc2 ≥ 0.3.35	Invokes bisect.insort_right().

aveytense.Tense.intersection(v, /, *_) (≥ 0.3.34)
Returns boolean, integer or iterables intersection, depending, which one is passed to the first parameter.
For integers, returned is bitwise AND of all integers (v & _[0] & _[1] & ...).
For boolean values, returned is logical AND (v and _[0] and _[1] and ...).
For iterables, used is set(v).intersection(*_).
aveytense.Tense.isBool(v, /, *_, mode = MODE_AND)(≥ 0.3.26b3)
aveytense.Tense.isBoolean(v, /, *_, mode = MODE_AND)(≥ 0.3.26rc1)
Determine whether passed object is a bool object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isByteArray(v, /, *_, mode = MODE_AND)(≥ 0.3.35)
Determine whether passed object is a bytearray object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isBytes(v, /, *_, mode = MODE_AND)(≥ 0.3.35)
Determine whether passed object is a bytes object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isComplex(v, /, *_, mode = MODE_AND)(≥ 0.3.26b3)
Determine whether passed object is a complex object.
from aveytense import
a6572j
b68
.print(.isComplex(a)) True
.print(.isComplex(b)) False

since 0.3.36, see change note below
.print(.isComplex(a, b)) False
.print(.isComplex(a, b, modeand)) False
.print(.isComplex(a, b, modeor)) True

0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isDict(v, /, ktype = Any, vtype = Any) (≥ 0.3.31)
Determine whether passed object is a dict object.
from aveytense import
a{3: 3}
.print(.isDict(a)) True

since 0.3.34, see change note below
.print(.isDict(a, int)) True
.print(.isDict(a, int, str)) True
.print(.isDict(a, str, int)) False

since 0.3.35, see change note below
.print(.isDict(a, (int, str), int)) False
.print(.isDict(a, (int, str), (int, str))) True

0.3.34: added parameters ktype and vtype to enhance dict type checking.
ktype is demanded type for keys and vtype is demanded type for values.
0.3.35: ktype and vtype now support union types. In this case it is required to wrap these in a tuple.
Examples:
• isDict(v, ()) and isDict(v, (), ()) are the same as isDict(v)
• isDict(v, (int, str)) is the same as isDict(v, int) or isDict(v, str) (key must be of type either int or str)
• isDict(v, (int, str), str) means key must be of type either int or str, and value must be of type str
• isDict(v, (int, str), (int, str)) means key and value must be of types either int or str
0.3.36: ktype and vtype now support union types with typing.Union and since Python 3.10: X | Y | ....
This also patched an error when using these for version 0.3.35; instead of type(int | str) you can freely use int | str.
In the same version provided initial support for generic types, which may be extended in further versions. They cannot
be used in union types though.
For additional types, which aren't deduced, or lacking types, which are deduced in a dictionary, typing.Never is type hinted:
a{78: 32} dict[int, int]
if .isDict(a, (int, float), int):
a type hints typing.Never, but this statement will be invoked

else:
a type hints dict[int, int], but this statement won't be invoked
To avoid this behavior, it is recommended to use this class method in the following way: bool(Tense.isDict(a, ...))
aveytense.Tense.isEllipsis(v, /, *_, mode = MODE_AND)(≥ 0.3.26)
Determine whether passed object is an ellipsis (Ellipsis).
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isFinalVar(v, /, *_, mode = MODE_AND)(≥ 0.3.38)
Determine whether passed object is an instance of class aveytense.util.FinalVar.
aveytense.Tense.isFloat(v, /, *_, mode = MODE_AND) (≥ 0.3.26b3)
Determine whether passed object is a float object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isFrozenSet(v, /, type = Any) (≥ 0.3.35)
Determine whether passed object is a frozenset object.
Parameter type allows to enhance frozenset type checking. For union types, wrap types in a tuple. Examples:

• isFrozenSet(v, ()) is the same as isFrozenSet(v)
• isFrozenSet(v, (int, str)) is the same as isFrozenSet(v, int) or isFrozenSet(v, str) (either int or str)

0.3.36: type now supports union types with typing.Union and since Python 3.10: X | Y | ....
This also patched an error when using these for version 0.3.35; instead of type(int | str) you can freely use int | str.
In the same version provided initial support for generic types, which may be extended in further versions. They cannot
be used in union types though.

aveytense.Tense.isInt(v, /, *_, mode = MODE_AND)(≥ 0.3.26b3)
aveytense.Tense.isInteger(v, /, *_, mode = MODE_AND)(≥ 0.3.26rc1)
Determine whether passed object is an int object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isList(v, /, type = Any) (≥ 0.3.26rc1)
Determine whether passed object is a list object.
0.3.34: added parameter type to enhance list type checking.
0.3.35: parameter type now supports union types. In this case it is required to wrap these in a tuple.
Examples:
• isList(v, ()) is the same as isList(v)
• isList(v, (int, str)) is the same as isList(v, int) or isList(v, str) (either int or str)
0.3.36: type now supports union types with typing.Union and since Python 3.10: X | Y | ....
This also patched an error when using these for version 0.3.35; instead of type(int | str) you can freely use int | str.
In the same version provided initial support for generic types, which may be extended in further versions. They cannot
be used in union types though.
For additional types, which aren't deduced, or lacking types, which are deduced in a list, typing.Never is type hinted:
a[48] [45.2] list[int | float]
if .isList(a, (int, float, str)):
a type hints typing.Never, but this statement will be invoked

elif .isList(a, int):
a type hints typing.Never, and this statement won't be invoked

else:
a type hints list[int | float], but this statement won't be invoked
To avoid this behavior, it is recommended to use this class method in the following way: bool(Tense.isList(a, ...))
aveytense.Tense.isMemoryView(v, /, *_, mode = MODE_AND)(≥ 0.3.35)
Determine whether passed object is memoryview object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isNone(v, /, *_, mode = MODE_AND)(≥ 0.3.26b3)
Determine whether passed object is None.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isSet(v, /, type = Any) (≥ 0.3.35)
Determine whether passed object is a set object.
Parameter type allows to enhance set type checking. For union types, wrap types in a tuple. Examples:
• isSet(v, ()) is the same as isSet(v)
• isSet(v, (int, str)) is the same as isSet(v, int) or isSet(v, str) (either int or str)
0.3.36: type now supports union types with typing.Union and since Python 3.10: X | Y | ....
This also patched an error when using these for version 0.3.35; instead of type(int | str) you can freely use int | str.
In the same version provided initial support for generic types, which may be extended in further versions.
For additional types, which aren't deduced, or lacking types, which are deduced in a set, typing.Never is type hinted:
aset([48] [45.2]) set[int | float]
if .isSet(a, (int, float, str)):
a type hints typing.Never, but this statement will be invoked

elif .isSet(a, int):
a type hints typing.Never, and this statement won't be invoked

else:
a type hints set[int | float], but this statement won't be invoked
To avoid this behavior, it is recommended to use this class method in the following way: bool(Tense.isSet(a, ...))
aveytense.Tense.isStr(v, /, *_, mode = MODE_AND)(≥ 0.3.26b3)
aveytense.Tense.isString(v, /, *_, mode = MODE_AND)(≥ 0.3.26rc1)
Determine whether passed object is a str object.
0.3.36: many values may be now inspected. Previous signature (v, /) is now an overload.
aveytense.Tense.isTuple(v, /, type = Any) (≥ 0.3.26rc1)
Determine whether passed object is a tuple object.
0.3.34: added parameter type to enhance tuple type checking.
0.3.35: parameter type now supports union types. In this case it is required to wrap these in a tuple.
Examples:
• isTuple(v, ()) is the same as isTuple(v)
• isTuple(v, (int, str)) is the same as isTuple(v, int) or isTuple(v, str) (either int or str)
0.3.36: type now supports union types with typing.Union and since Python 3.10: X | Y | ....
This also patched an error when using these for version 0.3.35; instead of type(int | str) you can freely use int | str.
In the same version provided initial support for generic types, which may be extended in further versions.
Behavior how aveytense.isTuple() in case of type hinting works seems unclear, it is good to experiment though.
In this case you can use bool(Tense.isTuple(...)).
aveytense.Tense.last(i, /, condition = None, default = None) (≥ 0.3.26rc2)
Returns last item from sequence, which satisfied condition or default, if none satisfied condition.
0.3.27a4: removed parameter default.
0.3.34: restored parameter default.
aveytense.Tense.occurrences(v, *items, mode = ...) (≥ 0.3.32)
Returns amount of times whether item or items appear in specified sequence.
aveytense.Tense.pick(i, /, secure = False) (≥ 0.3.8)
Returns a random item from a sequence.
0.3.34: added support for mappings and new parameter secure to generate cryptographically safe result.
aveytense.Tense.probability(*vf, length = PROBABILITY_COMPUTE) (≥ 0.3.8)
Implementation of math probability definition; returns one of integer values passed to parameter vf (alias to values-frequencies). See more on here.
To faciliate understanding, how this class method works, it is basing on probability defintion: P(A) ∈ ⟨0; 1⟩. This is quite interesting that this class method itself doesn't belong to ~.Math.
In-code syntax would be: [v₁, f₁?], [v₂, f₂?], [v₃, f₃?], ..., [v_n, f_n?]
If f_n (alias to frequency, right-side integer in 2-item sequence) for any n wasn't defined, then f_n defaults to 1. Normally, length is computed, but it can be enforced via the length parameter. It isn't recommended, since it is more liable for errors. f_n takes a role as probability fraction nominator, as in: P(v_n) = f_nlength.
Below example for coin flip:
from import
.print(.probability([0, 2], [1, 5999], [2, 5999])) 0-2; coinflip, 0 means side

Support for all types except integers is planned and it is unknown when it will be provided. But let's deepen into this example: left-side integer in sequences is a value to drop, meanwhile right-side integer in sequences is value for nominator in fraction probability would return. Sum of all right-side integers create length. If there was only one item in a sequence, then that's considered addition by 1. That means length in this example is 12000, and so that means for each value:
• coin on side: P(0) = 212000 = 16000 = 0.01(6)%
• coin on heads: P(1) = 599912000 = 49.991(6)%
• coin on tails: P(2) = 599912000 = 49.991(6)%
These percents in-code determine about returned values (v_n as in P(v_n)) - with less percents, then it is less possible to return. Worth noticing, heads and tails can be used vice versa in comparisons, since they share same probability fraction. Probability of getting a coin land on side is actually really low and not that arbitrary as in the example; occurs with 0.01(6)% (1/6000) chance.
Parameter vf supports single integers, integer-typed: lists, tuples, sets, frozensets (all must comply with item size 1-2), dictionaries.
0.3.19: new signature (*valuesAndFrequencies, length = -1) (12th October 2023), and renamed method from complexity() to current name. Earlier, this method had signature (values, frequencies, length = -1), which was more liable for errors (expected values and frequencies to have same size).
0.3.24: added support for dictionairies, and constant PROBABILITY_COMPUTE (previous name was PROBABILITY_ALL) as default value for parameter length.
0.3.25: renamed parameter valuesAndFrequencies to vf (values-frequencies), added support for sets, frozensets. Also, added support for default values (normally 1 per each value): None and ellipsis.
0.3.26a3: first patch of ZeroDivisionError. It was in case of 2 values (tests from morning 19th July 2024).
0.3.26b3: added limit to sys.maxsize (earlier there wasn't one).
0.3.26rc1: added support for final variables initialized via aveytense.util.FinalVar.
0.3.26rc2: cancelled support for aveytense.util.FinalVar and added support for tkinter.IntVar.
0.3.31: cancelled support for tkinter.IntVar.
0.3.33: revamp in code; attempt shortening the code.
0.3.35: second (and probably final) patch of ZeroDivisionError (modulo operation was the cause).
aveytense.Tense.probability2(x = 1, y = 0, frequency = 1, length = 10000) (≥ 0.3.8; < 0.3.24; ≥ 0.3.25)
Simplier implementation of math probability; operates on 2 values. See more on here. This method is invoked whether ~.probability() gets 2 values. Probability of returning x and y is determined by both length and frequency: for x it will be P(x) = frequencylength, meanwhile for y it equals P(y) = 1 - P(x). By default, x has following probability: P(x) = 110000 = 0.01%, and for y it is 99.99%.
Comparing to ~.probability(), this method accepts all types (so not only int), but both x and y must return the same type. Code below is re-implementation of coin flip with same probability as in example in ~.probability(): from import .print(.probability2(side, .pick((heads, tails)), length6000)) If frequency is higher than length, x will be returned. If frequency equals zero, y will be returned. If x equals y, there is no doubt one of them will be returned. length cannot be greater than sys.maxsize, unless you set ~.TenseOptions.disableProbability2LengthLimit setting to True. This option allows to disqualify this limit. from import 1 << 86 equals 2 ** 86 there: 77371252455336267181195264 or 7.737125245533627e+25 .print(.probability2(length186) ValueError: integer passed to parameter 'length' is too high [...] Options.disableProbability2LengthLimitTrue .print(.probability2(length186) 0 The reason why limit is normally set to sys.maxsize is because internal code uses an internal list holding values to pick from later, and none of sequences' sizes can go above this number. It is better to know, which numeric value this variable returns - it all depends on system's architecture. If we are working with 32-bit systems, then value will be 2³² - 1, meanwhile for 64-bit systems that gap is much higher: 2⁶⁴ - 1. The only way to kill this restriction was knowledge that on Python 3 there is no integer value limit, which was assigned to variable sys.maxint. This solution has been initiated on 0.3.31 with option ~.TenseOptions.disableProbability2LengthLimit, but only since 0.3.33 it works as intended. It isn't recommended to use this class method with function functools.reduce(), unless you know what to do. The result may be just unpredictable. from import from functools import reduce def prob(seq, frequency1, length10000): return reduce(lambda x, y: .probability2(x, y, frequency, length), seq)) 0.3.19: new signature (rareValue = 1, usualValue = 0, frequency, length), and renamed method from probability() to current name.
Earlier, this method had signature (value = 1, frequency, value), and not many things were able to be done due to restricting returned values to 0 and value.
0.3.24. This happened unexpectedly while rewriting the code utterly.
0.3.25: restored method probability2() with same parameters, with some denomination changes: rareValue was renamed to x,
and usualValue was renamed to y. Default values of both were kept.
0.3.26a3: length now can have value -1 to refer to default value 10000.
0.3.31: added option aveytense.TenseOptions.disableProbability2LengthLimit to remove the limit related to sys.maxsize (default value False).
0.3.33: finished tests on this option.
aveytense.Tense.random(x, y = None, /) (≥ 0.3.24)
If y is None, returns random item from sequence or integer from range [0, x],
otherwise returns integer from range [x, y], depending which one is greater.
0.3.34: support for sequences and single integer.
aveytense.Tense.repeat(value, times = None, /) (≥ 0.3.25)
Repeats value specified amount of times, or endlessly, if it has value None. Equivalent to itertools.repeat
aveytense.Tense.reverse(v) (≥ 0.3.26rc2)
Returns reversed string or sequence, not modifying passed iterable.
0.3.34: added support for mappings and instances of abroad() function.
aveytense.Tense.shuffle(v) (≥ 0.3.26rc2)
Returns shuffled string or sequence, not modifying passed iterable.
0.3.34: added support for mappings and instances of abroad() function.
aveytense.Tense.sleep(seconds, /) (≥ 0.3.25)
Defines execution delay; equivalent to time.sleep().
aveytense.Tense.starmap(f, i, /) (≥ 0.3.35)
Same as itertools.starmap
aveytense.Tense.union(v, /, *_) (≥ 0.3.34)
Returns boolean, integer or iterables union, depending, which one is passed to the first parameter.
aveytense.Tense.until(desiredString, /, message = None, caseInsensitive = True) (≥ 0.3.25)
Console-specific method, creates a while loop and it ends until user writes desired string, or any from specified, if first parameter is a string sequence. message will be written as an argument of inbuilt input() function. caseInsensitive makes string matching less strict; allows any-cased string.
0.3.35: extended gamut of sequences that can be passed to parameter desiredString, and added string type hint.
aveytense.Tense.uuidMd5(namespace, name) (≥ 0.3.26a1)
Return an UUID from the MD5 (Message Digest) hash of a namespace UUID and a name
0.3.31: cancelled support for tkinter.StringVar

aveytense.Tense.uuidPrimary(node, clockSeq) (≥ 0.3.26a1)
Return an UUID from host ID, sequence number and the current time.
0.3.31: cancelled support for tkinter.IntVar

aveytense.Tense.uuidRandom() (≥ 0.3.26a1)
Return a random UUID
aveytense.Tense.uuidSha1(namespace, name) (≥ 0.3.26a1)
Return an UUID from the SHA-1 (Secure Hash Algorithm) hash of a namespace UUID and a name
0.3.31: cancelled support for tkinter.StringVar

aveytense.Tense.version (≥ 0.3.26?)
Returns current version of AveyTense. Equivalent to aveytense.constants.VERSION.
aveytense.Tense.versionId (≥ 0.3.26?; < 0.3.36)
Equivalent to aveytense.constants.VERSION_ID.
0.3.35
0.3.36
aveytense.Tense.versionInfo (≥ 0.3.26?)
Equivalent to aveytense.constants.VERSION_INFO.

abstract-final-class aveytense.TenseOptions (≥ 0.3.27a5)

Provides additional options influencing methods in class ~.Tense. All are variables, which can hold boolean values only.

Option name	Lifetime	Description
~.disableProbability2LengthLimit	≥ 0.3.31	Applies to ~.Tense.probability2(). Allows to remove the lengh limit related to sys.maxsize. This variable isn't warranted to stay, as internal code of ~.Tense.probability2() can use it one day, so be completely aware of it.
~.initializationMessage	≥ 0.3.27a5; < 0.3.40	It was applied to constructor of ~.Tense. 0.3.40
~.insertionMessage	≥ 0.3.27b1	Applies to ~.Tense.print().
~.probabilityExtendedLength	≥ 0.3.27rc1 (in code)	Has to apply to ~.Tense.probability(). This variable is bound with usage of nested list in order to extend number support, bypassing sys.maxsize.

Functions and decorators

Functions, and decorators in AveyTense. Methods are included in classes.

aveytense.abroad(value1, /, value2 = None, modifier = None) (≥ 0.3.9)

Overall extension of range() function. See entire article on there. The differences between range() and ~.abroad() functions are:

• ~.abroad() function doesn't have overloads
• ~.abroad() supports complex objects, iterables and file objects, doesn't support ellipsis though
• step (modifier) in function ~.abroad() has no sign sensitivity (can be negative or positive, code will always go towards endpoint)
• ~.abroad() supports floating-point numbers

Understanding this function might be more sophisticated than range(), but there are benefits:

• allows to refrain from using range(len()) and range(len(file.readlines())), no matter in which parameter
• last 2 parameters don't need to be passed by position
• first parameter can be negative and can count towards -1
...and more!

0.3.10

aveytense.games.aeify(s, /) (≥ 0.3.9; < 0.3.24; ≥ 0.3.26a4)

Converts all a and e letters occurrences into æ. Not recommended for terminals that don't read letters outside Latin-1 (ISO/IEC 8859-1 encoding).

@aveytense.util.final (≥ 0.3.26b3)

Creates a final class.

@aveytense.util.finalmethod (≥ 0.3.27rc2)

Creates a final method. Equivalent to @typing.final

@aveytense.util.finalproperty (≥ 0.3.37)

Creates a final property accessible via class instance. It does not work with decorators @classmethod (before Python 3.13) or @staticmethod, if any of them were used. Unlike for more @property decorator, returned value from this property is hidden via type hinting typing.Any, but should factually return desired value. Reason typing.Any is deduced is because property class isn't generic.

aveytense.games.oeify(s, /) (≥ 0.3.9; < 0.3.24; ≥ 0.3.26a4)

Converts all o and e letters occurrences into œ. Not recommended for terminals that don't read letters outside Latin-1 (ISO/IEC 8859-1 encoding).

aveytense.games.owoify(s, /) (≥ 0.3.9; < 0.3.24; ≥ 0.3.25)
aveytense.games.uwuify(s, /) (≥ 0.3.27b2)

This function is one big joke. Translates a string into furry talk. Happy? Source here