AveyTense

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.exceptions (≥ 0.3.44)

Provides custom exception classes

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; < 0.3.47)

Submodule for entertainment. Most declarations were affiliated with class Games, which is featured in this submodule. Removed to be in separate, projected PyPi project aveytense_games.

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 aveytense 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. 0.3.50: this constant may occur as ~.Math.JS_MAX_SAFE_INTEGER rather than in current form.

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. 0.3.50: this constant may occur as ~.Math.JS_MAX_VALUE rather than in current form.

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. 0.3.50: this constant may occur as ~.Math.JS_MIN_SAFE_INTEGER rather than in current form.

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. 0.3.50: this constant may occur as ~.Math.JS_MIN_VALUE rather than in current form.

aveytense.constants.MC_DURABILITY (≥ 0.3.26b3; < 0.3.41)

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

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. 0.3.41: renamed this constant to ~.games.Minecraft.durability. aveytense.games submodule has been revoked in 0.3.47 to be in separate project aveytense_games. 0.3.41

aveytense.constants.MC_ENCHANTS (≥ 0.3.26b3; < 0.3.41)

Returns 42 (amount of enchantments in Minecraft as for version 1.21.5). 0.3.41: renamed this constant to ~.games.Minecraft.enchantments. aveytense.games submodule has been revoked in 0.3.47 to be in separate project aveytense_games. 0.3.41

aveytense.constants.SMASH_HIT_CHECKPOINTS (≥ 0.3.26b3; < 0.3.47)

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

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; < 0.3.47)

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 0.3.47: Instead use aveytense.Tense.version.

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; < 0.3.47)

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. 0.3.47: Instead use aveytense.Tense.versionInfo.

type aveytense.constants.VERSION_INFO_TYPE (≥ 0.3.36; < 0.3.47)

Type of aveytense.constants.VERSION_INFO. Probable intend of this type was inspecting ~.constants.VERSION_INFO with isinstance() inbuilt function. It is worth noticing ~.constants.VERSION_INFO_TYPE refers to internal abstract class (~.constants._VERSION_INFO), and the class itself is abstract to disallow custom versioning via its constructor. 0.3.47: Instead use type(~.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.

This class is different to abc.ABC. abc.ABC class marks subclass abstract only when there are methods decorated with decorator @abc.abstractmethod. In case of ~.Abstract, class is always marked abstract, no matter if there are abstract methods or not (reference to abstract classes in JavaScript and PHP with abstract class keywords). The class doesn't inherit and isn't the same as abc.ABC, what means issubclass(~.Abstract, abc.ABC) returns False. Example how to create an abstract class:

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.

Abstract-final classes are only restricted to modify fields. Errors thrown by subclassing and initializing class object are the same as in ~.Abstract and ~.Final. ~.AbstractFinal is the same as: from .util import Abstract, Final class Test(Abstract, Final): 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.

aveytense.ChangeVar.__init__(initialValue = 0)
aveytense.ChangeVar.__neg__()
Decreases sentinel's value by 1. That's mere decrementation operation known from several programming languages as --. Behavior can be changed with method ~.setModifier(). Method itself doesn't return anything.
aveytense.ChangeVar.__pos__()
Increases sentinel's value by 1. That's mere incrementation operation known from several programming languages as ++. Behavior can be changed with method ~.setModifier(). Method itself doesn't return anything.

class aveytense.Color (≥ 0.3.26rc1)

Deputy of aveytense.extensions.ANSIColor. This class allows to modify style for 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; < 0.3.48)
aveytense.Color.__neg__()(≥ 0.3.26rc1; < 0.3.48)
aveytense.Color.__invert__()(≥ 0.3.26rc1; < 0.3.48)
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 0.3.47: Methods __pos__(), __neg__() and __invert__() are deprecated and will be removed in 0.3.48. Use str(self) instead. 0.3.48: Methods __pos__(), __neg__() and __invert__() have been removed.
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.

abstract-final class aveytense.Colors (≥ 0.3.41)

Provides color palette from HTML. All members of this class are objects of class ~.RGB. All names are from this page. Attributes prefixed with mode256_ refer to 8-bit colors table from ANSI escape code article.

class aveytense.util.Final (≥ 0.3.26b3)

Creates a final class via inheritance. This class isn't clearly the same as local class typing._Final, because it doesn't use the _root passed in inheritance section.

Example how to create a final class: from .util import Final class Test(Final): class Test2(Test): SubclassedError: attempt to subclass a final class 'Test' 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.

Math constants

Constant	Approximate value / Value without fraction	Lifetime
~.Math.CENTILLION	- / 10303	≥ 0.3.25 (19th July 2024)
~.Math.E	2.71828 / 3	≥ 0.3.25 (4th July 2024)
~.Math.INF	- / -	≥ 0.3.25 (5th July 2024)
~.Math.NAN	- / -	≥ 0.3.25 (5th July 2024)
~.Math.PI	3.14159 / 3	≥ 0.3.25 (4th July 2024)
~.Math.SQRT2	1.41421 / 1	≥ 0.3.25 (5th July 2024)
~.Math.TAU	6.28318 / 6	≥ 0.3.25 (5th July 2024)

Trigonemetric functions

Normal
Class method name	Equivalent to	Lifetime	Domain	Possible values
~.Math.sin(x, /)	-	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨-1; 1⟩
~.Math.cos(x, /)	-	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨-1; 1⟩
~.Math.tan(x, /)	sin xcos x	≥ 0.3.25 (4th July 2024)	x ∈ R \ {k: k + 90 ∤ 90n} (where n ∈ N \ {0})	R
~.Math.cot(x, /)	1tan x	≥ 0.3.25 (4th July 2024)	x ∈ R \ {k: k ∤ 90}	R
~.Math.sec(x, /)	1cos x	≥ 0.3.25 (4th July 2024)	x ∈ R \ {k: k + 90 ∤ 90n} (where n ∈ N \ {0})	R \ (-1; 1)
~.Math.cosec(x, /)	1sin x	≥ 0.3.25 (4th July 2024)	x ∈ R \ {k: k ∤ 180}	R \ (-1; 1)

Extended
Class method name	Equivalent to	Lifetime	Domain	Possible values
~.Math.versin(x, /)	1 - cos x	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 2⟩
~.Math.vercos(x, /)	1 + cos x	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 2⟩
~.Math.coversin(x, /)	1 - sin x	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 2⟩
~.Math.covercos(x, /)	1 + sin x	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 2⟩
~.Math.haversin(x, /)	1 - cos x2	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 1⟩
~.Math.havercos(x, /)	1 - sin x2	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 1⟩
~.Math.hacoversin(x, /)	1 + cos x2	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 1⟩
~.Math.hacovercos(x, /)	1 + sin x2	≥ 0.3.25 (4th July 2024)	x ∈ R	⟨0; 1⟩
~.Math.exsec(x, /)	sec x - 1	≥ 0.3.25 (5th July 2024)	x ∈ R \ {k: k + 90 ∤ 90n} (where n ∈ N \ {0})	⟨-2; 0⟩
~.Math.excosec(x, /)	cosec x - 1	≥ 0.3.25 (5th July 2024)	x ∈ R \ {k: k ∤ 180}	⟨-2; 0⟩

Hyperbolic
Class method name	Equivalent to	Lifetime	Domain	Possible values
~.Math.sinh(x, /)	ex - e-x2	≥ 0.3.25 (4th July 2024)	x ∈ R	R
~.Math.cosh(x, /)	ex + e-x2	≥ 0.3.25 (4th July 2024)	x ∈ R	R
~.Math.tanh(x, /)	sinh xcosh x	≥ 0.3.25 (4th July 2024)	x ∈ R	R
~.Math.coth(x, /)	1tanh x	≥ 0.3.46 (23rd May 2025)	x ≠ 0	R
~.Math.sech(x, /)	1cosh x	≥ 0.3.46 (23rd May 2025)	x ∈ R	R
~.Math.cosech(x, /)	1sinh x	≥ 0.3.46 (23rd May 2025)	x ≠ 0	R

Inverse
Class method name	Equivalent to	Lifetime	Domain	Possible values
~.Math.asin(x, /)	sin-1 x	≥ 0.3.25 (4th July 2024)	|x| ≤ 1
~.Math.acos(x, /)	cos-1 x	≥ 0.3.25 (4th July 2024)	|x| ≤ 1
~.Math.atan(x, /)	tan-1 x	≥ 0.3.25 (4th July 2024)	x ∈ R
~.Math.acot(x, /)	cot-1 x	≥ 0.3.46 (23rd May 2025)	x ∈ R
~.Math.asec(x, /)	acos(1 ÷ x)	≥ 0.3.25 (4th July 2024)	|x| > 1
~.Math.acosec(x, /)	asin(1 ÷ x)	≥ 0.3.25 (4th July 2024)	|x| > 1
~.Math.aversin(x, /)	acos(1 - x)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 2⟩
~.Math.avercos(x, /)	asin(1 - x)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 2⟩
~.Math.acoversin(x, /)	acos(x - 1)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 2⟩
~.Math.acovercos(x, /)	acos(x - 1)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 2⟩
~.Math.ahaversin(x, /)	acos(1 - 2x)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 1⟩
~.Math.ahavercos(x, /)	acos(2x - 1)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 1⟩
~.Math.ahacoversin(x, /)	asin(1 - 2x)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 1⟩
~.Math.ahacovercos(x, /)	asin(2x - 1)	≥ 0.3.25 (4th July 2024)	x ∈ ⟨0; 1⟩
~.Math.aexsec(x, /)	asec(x + 1)	≥ 0.3.25 (5th July 2024)	x ∉ (-2; 0)
~.Math.aexcosec(x, /)	acosec(x + 1)	≥ 0.3.25 (5th July 2024)	x ∉ (-2; 0)

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 ~.asin(x - 1).
Domain equals x ∈ ⟨0; 2⟩ (basing on arc sine domain).
0.3.39: Renamed from ~.acovercosin(); improved domain and type checking
aveytense.Math.acoversin(x, /) (≥ 0.3.25)
Returns inverse coversed sine of x. Equals ~.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 ~.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 ~.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 ~.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 ~.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 ~.acos(2x - 1).

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

0.3.39: Renamed from ~.ahavercosin(); improved domain and type checking
aveytense.Math.ahaversin(x, /) (≥ 0.3.25)
Returns inverse haversed cosine of x. Equals ~.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 ~.acos(x - 1).

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

0.3.39: Renamed from ~.avercosin(); improved domain and type checking
aveytense.Math.aversin(x, /) (≥ 0.3.25)
Returns inverse versed cosine of x. Equals ~.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 + ~.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 - ~.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 = aveytense.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; < 0.3.47)

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. 0.3.47: To be used in separate project aveytense_games.

aveytense.games.Minesweeper.__init__(height = 16, width = 30, mines = 99) (≥ 0.3.41; < 0.3.47)
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; < 0.3.47	(16, 30, 99)	~.Minesweeper(~[0], ~[1], ~[2])
~.Minesweeper.BEGINNER	≥ 0.3.41; < 0.3.47	(9, 9, 10)
~.Minesweeper.INTERMEDIATE	≥ 0.3.41; < 0.3.47	(16, 16, 40)
0.3.47: To be used in separate project aveytense_games.
final-property aveytense.games.Minesweeper.board (≥ 0.3.41; < 0.3.47)
Returns the board as a nested string list. Possible values are for "0" to "8", or "X", which is a mine indicator. It is also possible to occur as parameter-less ~.getBoard() method. 0.3.47: To be used in separate project aveytense_games.
aveytense.games.Minesweeper.displayBoard(colorize = False) (≥ 0.3.41; < 0.3.47)
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. 0.3.47: To be used in separate project aveytense_games.
final-property aveytense.games.Minesweeper.height (≥ 0.3.41; < 0.3.47)
Returns amount of rows specified in the constructor. It is also possible to occur as parameter-less ~.getHeight() method. 0.3.47: To be used in separate project aveytense_games.
final-property aveytense.games.Minesweeper.mines (≥ 0.3.41; < 0.3.47)
Returns amount of mines specified in the constructor. It is also possible to occur as parameter-less ~.getMines() method. 0.3.47: To be used in separate project aveytense_games.
final-property aveytense.games.Minesweeper.width (≥ 0.3.41; < 0.3.47)
Returns amount of columns specified in the constructor. It is also possible to occur as parameter-less ~.getWidth() method. 0.3.47: To be used in separate project aveytense_games.

class aveytense.util.ParamVar (≥ 0.3.42)

Extension of function inspect.getfullargspec(). Except looking for variable and non-variable parameters, it is also possible to receive type annotations of desired callable object, and overload pointer is included.

aveytense.util.ParamVar.__init__(f, i = 0, /) (≥ 0.3.42)
Parameter f must be a callable object, meanwhile parameter i points to a specific overload, if provided callable object in parameter f has overloads. May be only in range ⟨0; overloads_amount - 1⟩. If f is an instance method accessed via reference, then first parameter (usually named self) is excluded. f can be an instance of functools.partial class too.
final-property aveytense.util.ParamVar.all (≥ 0.3.42)
Returns a tuple with all parameters in the callable object. from import def f(p1, p2, , p3, p4, , p572, p6, p7): .print(util.ParamVar(f).all) ("p1", "p2", "p3", "p4", "p5", "p6", "p7")
final-property aveytense.util.ParamVar.allCount (≥ 0.3.44)
Equivalent to len(~.all).
final-property aveytense.util.ParamVar.allDefaults (≥ 0.3.42)
Returns a tuple holding 2-item tuples with parameters and their default values. Created to be convertible to dict. from import def f(p1, p2, , p3, p4, , p572, p6, p7): .print(util.ParamVar(f).allDefaults) (("p5", 72),)
final-property aveytense.util.ParamVar.allDefaultsCount (≥ 0.3.44)
Equivalent to len(~.allDefaults).
final-property aveytense.util.ParamVar.allNoDefaults (≥ 0.3.44)
Returns a tuple with parameters that have no default value. from import def f(p1, p2, , p3, p4, , p572, p6, p7): .print(util.ParamVar(f).allNoDefaults) ("p1", "p2", "p3", "p4", "p6", "p7")
final-property aveytense.util.ParamVar.allNoDefaultsCount (≥ 0.3.44)
Equivalent to len(~.allNoDefaults).
final-property aveytense.util.ParamVar.annotated (≥ 0.3.42)
Returns a tuple of parameters that have a type annotated. For type annotation details see PEP 484. from import def f(p1: int, p2, , p3, p4: strc, , p572, p6, p7): .print(util.ParamVar(f).annotated) ("p1", "p2")
final-property aveytense.util.ParamVar.annotatedCount (≥ 0.3.44)
Equivalent to len(~.annotated).
final-property aveytense.util.ParamVar.annotatedDefaults (≥ 0.3.44)
Returns a tuple of parameters that have a type annotated and default value. Created to be convertible to dict. from import def f(p1: int, p2, , p3, p4: strc, , p572, p6, p7): .print(util.ParamVar(f).annotatedDefaults) ≥ 0.3.47: (("p4", (str, "c")),) / < 0.3.47: (("p4", "c"),) 0.3.47: Annotated type is now returned along with default value in separate tuple.
final-property aveytense.util.ParamVar.annotatedDefaultsCount (≥ 0.3.44)
Equivalent to len(~.annotatedDefaults). ... rest of final properties to be added soon.

final-class aveytense.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.__bin__() (≥ 0.3.41)
final-property aveytense.RGB.bin (≥ 0.3.44)
Convert the RGB tuple to binary notation. Normally, it isn't possible to convert the ~.RGB class instance to binary via bin(), because this inbuilt function can only accept integer values or instances of classes implementing the __index__() method, which should return int. Both members return binary number with 0b preceding, as a string.
aveytense.RGB.__bool__() (≥ 0.3.41)
Always returns True.
aveytense.RGB.__bytes__() (≥ 0.3.41)
Convert the RGB tuple to bytes object.
aveytense.RGB.__hash__() (≥ 0.3.41)
Receive hash from RGB tuple.
aveytense.RGB.__hex__() (≥ 0.3.28)
final-property aveytense.RGB.hex (≥ 0.3.38)
final-property aveytense.RGB.cssHex (≥ 0.3.49)
Convert the RGB tuple to hexadecimal notation. Normally, it isn't possible to convert the ~.RGB class instance to hexadecimal via hex(), because this inbuilt function can only accept integer values or instances of classes implementing the __index__() method, which should return int. Both members return hexadecimal number with 0x preceding, as a string. Final property ~.cssHex returns the string with prefix # instead of 0x to be used in CSS.
from import
.print(RGB(0, 0, 85).__hex__()) 0x000055
.print(RGB(0, 0, 85).hex) 0x000055
.print(RGB(0, 0, 85).cssHex) #000055

aveytense.RGB.__int__() (≥ 0.3.28)
Convert the RGB tuple to int object. Formula: RGB(r, g, b) = #rrggbb => int(#rrggbb).
from 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)
final-property aveytense.RGB.oct (≥ 0.3.44)
Convert the RGB tuple to octal notation. Normally, it isn't possible to convert the ~.RGB class instance to octal via oct(), because this inbuilt function can only accept integer values or instances of classes implementing the __index__() method, which should return int. Both members return hexadecimal number with 0o preceding, as a string.
from aveytense import
.print((RGB(0, 0, 85).__oct__())) 0o125

aveytense.RGB.__pos__() (≥ 0.3.28; < 0.3.49)
aveytense.RGB.__neg__() (≥ 0.3.28; < 0.3.49)
aveytense.RGB.__invert__() (≥ 0.3.28; < 0.3.49)
final-property tense.RGB.tuple (≥ 0.3.38)

Returns RGB tuple as a tuple.
from 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)
0.3.41: Methods __pos__(), __neg__() and __invert__() are deprecated and will be removed in 0.3.48. Use tuple final property instead. 0.3.49: Methods __pos__(), __neg__() and __invert__() have been removed. Suprisingly these existed in code for version 0.3.48.
aveytense.RGB.__repr__() (≥ 0.3.28)
Equals invocation of repr(self), and returns more representative version about the object.
from import
.print(repr(RGB(0, 0, 85))) <aveytense.RGB object: RGB(0, 0, 85)>

aveytense.RGB.__str__() (≥ 0.3.28)
final-property aveytense.RGB.cssRgb (≥ 0.3.49)
Returns RGB tuple as a string. Final property ~.cssRgb returns the lowercased version of the string to be used in CSS.
from import
.print(RGB(0, 0, 85)) RGB(0, 0, 85)

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

Creates a new ~.RGB class object (this static method is alternative constructor for ~.RGB) 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.
0.3.42: Caught anomaly in string integer values: internal code of this static method didn't correctly convert it to RGB tuple.

final-class aveytense.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)
Returns an abroad object depending on 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, not an 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 (in this case tuple). 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. 0.3.50
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)
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.abroadPositiveFlip(value1, /, value2 = None, modifier = None) (≥ 0.3.24)
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.abroadPrecede(value1, /, value2 = None, modifier = None, prefix = None) (≥ 0.3.25)
Variation of abroad() function, which returns string sequence with specific string prefix + every integer.
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. 0.3.50
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. This class method is paired with ~.Tense.any() class method.
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. This class method is paired with ~.Tense.all() class method.
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() method. Appends items from parameter items (in order as they appear) to a new list formalized from first parameter, and return this list. This class method is pure and paired with ~.Tense.extend() class method.
0.3.34: because code normally converts sequence to a list builtin, the method now accepts any iterables.
0.3.39 0.3.46: added support for mappings. In order as 2-item tuples appear in parameter items, these and the mapping will be returned in a new dictionary. If key (1st tuple item) already exists in a mapping or appear more times in provided tuples, its value is value from the key's last occurrence
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. from import from typing import cast abhello! cast(str, a) .cast(a, str)
aveytense.Tense.clear(*v) (≥ 0.3.27a4)
An impure class method that 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. 0.3.50: added support for instances of typing.IO (more specifically, every object returned from function open()). 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.equal(*v) (≥ 0.3.41)
Same as v[0] == v[1] and v[1] == v[2] and ... and v[n - 1] == v[n], where n is index for last item in v.
aveytense.Tense.endswith(target, suffix, /, mode = ~.constants.MODE_OR, start = ..., end = ...) (≥ 0.3.42)
aveytense.Tense.error(handler, message)(≥ 0.3.24; < 0.3.31)
Defines an error to throw.
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, filter = "keys") (≥ 0.3.34)
Inversion of ~.Tense.append(); this pure class method 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. from import .exclude([opened, ajar, closed], opened, closed) ['ajar'] 0.3.46: added support for mappings. In this case added optional parameter filter to indicate, what to exclude from pairs (keys or values). If target in a pair was found, this pair is excluded from returned dictionary. .exclude({ 12: 78, 15: 23, 12: 23 }, 12, filterkeys) {15: 23} .exclude({ 12: 78, 15: 23, 12: 23 }, 23, filtervalues) {12: 78}
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.
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. 0.3.45: added support for integer set, abroad and range objects in parameter m. Support was predicted for version 0.3.48.
aveytense.Tense.explode(s, /, separator = None, max = -1, no_empty = False) (≥ 0.3.34)
Name reference to PHP inbuilt function explode() and equivalent to inbuilt string method str.split().
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. This class method is pure and paired with ~.Tense.append() class method. Typically this class method is extension of inbuilt list method list.extend(). from import .extend([e], {f, g}, (h,)) ['e', 'f', 'g', 'h']
0.3.34: because code normally converts sequence to a list builtin, the method now accepts any iterables.
0.3.39 0.3.46: added support for mappings. In order as they appear in both parameters, these will be returned in a new dictionary. If key in 2 or more mappings are the same, its value is value from the key's last occurrence. Example: .extend({ 1: 87 }, { 2: 70, 3: 112 }, { 1: 96 }) {1: 96, 2: 70, 3: 112}
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. This class method is paired with ~.Tense.last() class method.
0.3.27a4: removed parameter default.
0.3.34: restored parameter default.
0.3.39
aveytense.Tense.flatten(i, /) (≥ 0.3.49)
A pure class method being a re-implementation of class method itertools.chain.from_iterable(). This class method returns a flattened version of a duo-dimensional iterable object. from import .flatten([[e], [f, g], [h]]) ≥ 0.3.50: <generator object Tense.flatten.<locals>.<genexpr> at 0x0000021214D16EC0> 0.3.49: ['e', 'f', 'g', 'h'] list(.flatten([[e], [f, g], [h]])) ['e', 'f', 'g', 'h'] 0.3.50: generator is returned instead of a list (list 0.3.49 exclusive).
aveytense.Tense.generator(i, /, condition = ...) (≥ 0.3.50)
A pure class method returning a generator using generator expression (item for item in i) and with specific condition if specified (as in (item for item in i if condition)). First parameter has to be an iterable object, and condition - if given - a callable object with one non-keyword parameter and that returns a boolean value. Intention of this class method creation is deviating from generator expression as it can be falsely interpreted as tuple expression by many. There is no other method, except generator expressions, to create generators - the yield keyword in a function can do it too. from import .generator([634, 53]) <generator object Tense.generator.<locals>.<genexpr> at 0x0000021214D16EC0> Use ~.Tense.generator() class method, if usage of generator expressions is misunderstandable. Generator objects are instances of a runtime protocol class collections.abc.Generator, and this class is one of the very few classes from library collections.abc to have instances gained normally and without type hinting. Almost every class from library itertools return a generator object, despite type hinting somehow camouflages this fact with the itertools.pyi file.
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 0.3.49: many objects can be inspected. In this case o parameter must be a tuple of objects to take place. However, class method permits check only one attribute at once.
aveytense.Tense.improvedBogoSort(i, /, key = ...) (≥ 0.3.42)
Returns accesses as an integer and sorted iterable as a list in a 2-item tuple. Bogosort uses constant shuffling until the sequence is sorted.
aveytense.Tense.inequal(*v) (≥ 0.3.41)
Same as v[0] != v[1] and v[1] != v[2] and ... and v[n - 1] != v[n], where n is index for last item in v.
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. Basically revamped version of isinstance(v, dict).
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.isFinalClass(v, /, *_, mode = MODE_AND)(≥ 0.3.41)
Returns True, if value is a final class.
aveytense.Tense.isFinalProperty(v, /, *_, mode = MODE_AND)(≥ 0.3.41)
Returns True, if value is instance of aveytense.util.finalproperty class.
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: Any, /, *_: Any, mode: _Mode = MODE_AND) -> bool(≥ 0.3.26b3)
aveytense.Tense.isString(v: Any, /, *_: Any, mode: _Mode = MODE_AND) -> bool(≥ 0.3.26rc1) (where _Mode = Literal["and", "or", MODE_AND, MODE_OR]) 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: Any, /, type: type = Any) -> bool (≥ 0.3.26rc1) 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 ~.isTuple() in case of type hinting works seems unclear, it is good to experiment though. In this case you can use bool(~.isTuple(...)).
aveytense.Tense.isTuple2(v1: tuple, v2: tuple[type, ...], /) -> bool (≥ 0.3.43) aveytense.Tense.isTuple2(v1, v2, /) (≥ 0.3.43)
Extension of ~.isTuple() class method and inbuilt function isinstance(). Returns True, if type requirement for all items in first parameter from second parameter are satisfied. This class method is the experimental concept with types parameter in method ~.isTuple(), which was finally revoked in version 0.3.34, to decrease strictness of this method and after conclusion it didn't work as intended. Both v1 and v2 must be tuples; in case of v2 a tuple of types only. Value assignment in v2 parameter is similar to type parameter in ~.isTuple() class method, however, types themselves must be encased in a tuple, as in examples below. Returned boolean value is addicted to both parameters v1 and v2. This class method uses the following rules:
• If v2 tuple has size least than v1 tuple, then v2 tuple last item has to satisfy the remaining items in v1 tuple.
• If v2 tuple has the same size as v1 tuple, each item in v1 tuple has its type requirement with same indexes as in v2 tuple.
• If v2 tuple has size greater than v1 tuple, then TypeError is thrown.
Examples: from import
.print(.isTuple2((), ())) True
.print(.isTuple2((), (util.Any,))) True
.print(.isTuple2((), (util.Any, util.Any))) False
.print(.isTuple2((), (util.Any, util.Any, util.Any))) False .print(.isTuple2((132, 432), (int,))) True; same as ~.isTuple((132, 432), int)
.print(.isTuple2((132, 432), (int, int))) True
.print(.isTuple2((132, 432), (int, int, int))) throws TypeError
.print(.isTuple2((132, 432), ((int, str),))) True; same as ~.isTuple((132, 432), (int, str))
.print(.isTuple2((132, 432), (int, str))) False; NOT same as ~.isTuple((132, 432), (int, str))
.print(.isTuple2((132, 432), (str,))) False; same as ~.isTuple((132, 432), str)
.print(.isTuple2((132, 432), ((int, str), int))) True
.print(.isTuple2((132, 432), ((int, str), str))) False
.print(.isTuple2((132, 432), ((int, str), (int, str)))) True

Behavior how ~.isTuple2() in case of type hinting works seems unclear, it is good to experiment though. In this case you can use bool(~.isTuple2(...)).
aveytense.Tense.last(i: Sequence[T] | AbstractSet[T], /, condition: ((T) -> bool) | None = None,
default: S = None) -> T|S (≥ 0.3.26rc2) 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. This class method is paired with ~.Tense.first() class method.
0.3.27a4: removed parameter default.
0.3.34: restored parameter default.
aveytense.Tense.occurrences(v: <mixed>, *items: <mixed>, mode: <mixed> = ...) -> int (≥ 0.3.32) 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: Sequence[T] | AbstractSet[T] | Mapping[Any, T], /,
secure: bool = False) -> T (≥ 0.3.8) aveytense.Tense.pick(i, /, secure = False) (≥ 0.3.8)
Returns a random item from a sequence; extension of random.choice().
0.3.34: added support for mappings and new parameter secure to generate cryptographically safe result. The secure parameter is actually a reference of re-implemented pseudo-random functions in inbuilt Python module secrets
aveytense.Tense.probability(*vf: T | Sequence[T | int | EllipsisType | None]
| AbstractSet[T | int | EllipsisType | None]
| Mapping[T, int | EllipsisType | None]) -> T (≥ 0.3.8) aveytense.Tense.probability(*vf) (≥ 0.3.8)
Implementation of math probability definition; returns one of values passed to parameter vf (alias to values-frequencies).
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?], for any sequences and mappings.
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

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 values or these put in a sequence/set/mapping as first item/key and second item/value being either integer, ellipsis or None.
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 patch of ZeroDivisionError (modulo operation was the cause). 0.3.46: third patch of ZeroDivisionError; shortened internal code and removed length parameter. Support for None will be retracted in the future. Moreover, removed necessity passing True to option ~.TenseOptions.disableProbability2LengthLimit to bypass sys.maxsize. If there is only one item, it must be a mapping to prevent throwing an error. Supported types is wider: to objects of classes extending one of following collections.abc ABCs: Sequence, AbstractSet or Mapping. Returned type is no longer restricted to integer too.
aveytense.Tense.probability2(x: T1 = 1, y: T2 = 0, frequency: int = 1,
length: int | Tense.PROBABILITY_COMPUTE = 10000) -> T1|T2 (≥ 0.3.8; < 0.3.24; ≥ 0.3.25) 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. 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. The reason why limit was normally set to sys.maxsize was because internal code used an internal list holding values to pick from later, and none of sequences' sizes can go above this number. It was 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. Limit has been disqualified in version 0.3.46. 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. 0.3.46: removed necessity passing True to option ~.TenseOptions.disableProbability2LengthLimit to bypass sys.maxsize.
aveytense.Tense.probability3(vf: Mapping[T, int | EllipsisType], /) -> T (≥ 0.3.46) aveytense.Tense.probability3(vf, /) (≥ 0.3.46)
Abridged version of ~.probability() class method. In contrast to ~.probability(), it also operates on many values, however, difference is that vf parameter only accepts a mapping with at least 2 pairs. Value (there f_n) in a pair key-value must be either positive integer or an ellipsis (interpreted as value 1). Math scheme is following: P(v_n) = f_nlength, where length is deduced from sum of all f_n numbers, and: from import .probability3({ <v1>: <f1>, <v2>: <f2>, [v3]: [f3], ..., [vN]: [fN] }) Coin flip example: from import .probability3({ side: 2, tails: 5999, heads: 5999 }) Because vf parameter isn't variable as in ~.probability(), and its internal code is shorter, ~.probability3() is circa 3 times faster than ~.probability().
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 and returns a generator
aveytense.Tense.reverse(v) (≥ 0.3.26rc2)
A pure class method returning reversed version of an iterable passed to the parameter. It is bound with use of slicing [::-1] and the reversed class. See changes below for type support. Primal supported types are sequences, including strings. This class method is paired with ~.Tense.shuffle() class method. from import ahello! .print(a, .reverse(a)) "hello!" "!olleh"
0.3.34: added support for mappings and abroad objects. 0.3.42: instances of classes inheriting collections.abc.AbstractSet (including set class) now return a shuffled set inbuilt class instance. Earlier, these returned shuffled list. Added support for generators (these return list). 0.3.43: added support for ~.util.MutableString instances. 0.3.45: sets return list (sets are always placed ascendingly)
aveytense.Tense.shuffle(v) (≥ 0.3.26rc2)
A pure class method returning shuffled version of an iterable passed to the parameter. It is bound with use of random.shuffle() impure function. See changes below for types support. Primal supported types are sequences, including strings. This class method is paired with ~.Tense.reverse() class method. from import ahello! .print(a, .shuffle(a)) "hello!" "ohl!el"
0.3.34: added support for mappings and abroad objects. 0.3.42: instances of classes inheriting collections.abc.AbstractSet (including set class) now return a reversed set inbuilt class instance. Earlier, these returned reversed list. Added support for generators (these return list) and instances of classes inheriting collections.abc.Reversible. 0.3.43: added support for ~.util.MutableString instances. 0.3.45: sets return list (sets are always placed ascendingly)
aveytense.Tense.sleep(seconds, /) (≥ 0.3.25)
Equivalent to time.sleep(). AveyTense owner's footnote: This might be equal to passing value of time.time() function to an internal variable, and using the while loop with statement while time.time() - <var> ≥ seconds: <var> = time.time().
aveytense.Tense.starmap(f, i, /) (≥ 0.3.35)
Equivalent to itertools.starmap.
aveytense.Tense.startswith(target, prefix, /, mode = constants.MODE_OR, start = ..., end = ...) (≥ 0.3.42)
aveytense.Tense.test(target, pattern, flags = 0) (≥ 0.3.42)
Equivalent to re.match(pattern, target, flags) is not None. Noteworthy that target and pattern parameters, unlike in re.match() function, have inverted positions. Name of this class method is reference to JavaScript method RegExp.test().
aveytense.Tense.timeit(statement, /) (≥ 0.3.26rc3)
Simplified version of timeit.timeit(). To invoke callable with arguments, use lambda: <func-name>(...).
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 removed constant aveytense.constants.VERSION 0.3.50
.
aveytense.Tense.versionId (≥ 0.3.26?; < 0.3.36)
This attribute was equivalent to aveytense.constants.VERSION_ID.
0.3.35
0.3.36
aveytense.Tense.versionInfo (≥ 0.3.26?)
Equivalent to removed constant aveytense.constants.VERSION_INFO. 0.3.50

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; < 0.3.46	It was applied to ~.Tense.probability2(). Allowed to remove the lengh limit related to sys.maxsize. This attribute was been removed in version 0.3.46, according to change occured in class methods ~.Tense.probability() and ~.Tense.probability2(). 0.3.46
~.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(). 0.3.50
~.probabilityExtendedLength	≥ unavailable (0.3.27rc1 in code)	Had to apply to ~.Tense.probability(). This variable was bound with usage of nested list in order to extend number support, bypassing sys.maxsize. This attribute was marked unrealized in version 0.3.46, according to change occured in class methods ~.Tense.probability2() and ~.Tense.probability().

0.3.50

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. 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). This behavior is not preferred to use though
• ~.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; < 0.3.47)

This function converted all a and e letters occurrences into æ. Not recommended for terminals that don't read letters outside Latin-1 (ISO/IEC 8859-1 encoding). 0.3.47: To be used in separate project aveytense_games.

@aveytense.util.final (≥ 0.3.26b3)

Creates a final class. Equivalent to ~.Final, just used as decorator instead of base class.

@aveytense.util.finalmethod (≥ 0.3.27rc2)

Creates a final method. Equivalent to @typing.final.

class @aveytense.util.finalproperty (≥ 0.3.37)

Creates a final property accessible via class instance. This kind of properties cannot be modified nor deleted. To inspect these properties, it is advisable to use ~.Tense.isFinalProperty() class method. Usage with isinstance() Python function as isinstance(<class.attribute>, ~.util.finalproperty) works too. Using isinstance() as isinstance(<class.finalproperty>, property) returns False. Unlike for @property decorator, before 0.3.42, property created via ~.finalproperty decorator had typing.Any type hinted. Version 0.3.42 fixed this issue, but properties decorated with this class (~.finalproperty is actually a class) can have their values accessed via class reference too. Only in version 0.3.43 it has been fixed - and technique from 0.3.42 in method ~.Tense.isFinalProperty(), which required 2-item tuple with a type (class) and member name in a string is no longer required, however, will be kept for backward-compatibility. Since version 0.3.42 ~.finalproperty is generic class. Correct type hint was provided in 0.3.43.

class @aveytense.util.finalpropertycontainer(**properties) (≥ 0.3.43)

This class decorator creates class holding final properties, which values are assigned via variable keyword parameter properties to the affected class. If properties had keyword _static_ (with value True), affected class cannot be initialized, and can access all final properties via reference. If there are already attributes defined, and properties has the same names of attributes, these are overriden by these defined in properties. When _static_ has value True, internal code actually creates an object of the class, and in type hinting it isn't visible. 0.3.50: Marked experimental and not recommended to use; instead use @finalproperty.

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

This function converted all o and e letters occurrences into œ. Not recommended for terminals that don't read letters outside Latin-1 (ISO/IEC 8859-1 encoding). 0.3.47: To be used in separate project aveytense_games.

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

A joke function, which translated a string into a furry talk. Source here 0.3.47: To be used in separate project aveytense_games.