ChoreCore is a multi-language utility library built to make every developer's life easier.
It is made up of a plethora of modules and this documentation will assume that you import all definitions from each module
Import Explanation
Obviously this method of importing is not required, but is simply used in this documentation to save time and space.
from chorecore.alphabet import *
from chorecore.conditionals import *
from chorecore.fraction import *
from chorecore.math import *
from chorecore.strings import *
from chorecore.symbols import *
from chorecore.time import *
Contains the alphabet in an abundance of variants in Array form.
Name | Value |
---|---|
LOWERCASE | ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z"] |
UPPERCASE | ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z"] |
LOWERCASE_VOWELS | ["a", "e", "i", "o", "u", "y"] |
UPPERCASE_VOWELS | ["A", "E", "I", "O", "U", "Y"] |
LOWERCASE_NON_VOWELS | ["b", "c", "d", "f", "g", "h", "j", "k", "l", "m", "n", "p", "q", "r", "s", "t", "v", "w", "x", "z"] |
UPPERCASE_NON_VOWELS | ["B", "C", "D", "F", "G", "H", "J", "K", "L", "M", "N", "P", "Q", "R", "S", "T", "V", "W", "X", "Z"] |
Contains the alphabet in an abundance of variants in String form.
Name | Value |
---|---|
LOWERCASE | "abcdefghijklmnopqrstuvwxyz" |
UPPERCASE | "ABCDEFGHIJKLMNOPQRSTUVWXYZ" |
LOWERCASE_VOWELS | "aeiouy" |
UPPERCASE_VOWELS | "AEIOUY" |
LOWERCASE_NON_VOWELS | "bcdfghjklmnpqrstvwxz" |
UPPERCASE_NON_VOWELS | "BCDFGHJKLMNPQRSTVWXZ" |
All constants have an accompanying method that will simply return the character at the index passed to it
Conditional functions were mainly made to simplify ternary operations and provide one-sided cases.
They are specialized for string interpolation, but are certainly not limited to this.
It should be noted that Conditionals
extensively leverages the Internal
module.
If the test_val
is even, the return_val
is returned, otherwise it will return else_val
.
If the original_val
and test_val
are equal, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is false
, the return_val
is returned, otherwise it will return else_val
.
If the original_val
is greater than the test_val
, the return_val
is returned, otherwise it will return else_val
.
If the original_val
is greater than or equal to the test_val
, the return_val
is returned, otherwise it will return else_val
.
If the original_val
is less than the test_val
, the return_val
is returned, otherwise it will return else_val
.
If the original_val
is less than or equal to the test_val
, the return_val
is returned, otherwise it will return else_val
.
If the original_val
and test_val
are not equal, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is not None
, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is not undefined
, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is None
, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is odd, the return_val
is returned, otherwise it will return else_val
.
If the test_val
is true
, the return_val
is returned, otherwise it will return else_val
.
If the testVal
is undefined
, the returnVal
is returned, otherwise it will return elseVal
.
Contains all Unicode fraction symbols
Name | Value |
---|---|
ONE_HALF | ½ |
ONE_THIRD | ⅓ |
ONE_QUARTER | ¼ |
ONE_FIFTH | ⅕ |
ONE_SIXTH | ⅙ |
ONE_SEVENTH | ⅐ |
ONE_EIGHTH | ⅛ |
ONE_NINTH | ⅑ |
ONE_TENTH | ⅒ |
TWO_THIRDS | ⅔ |
TWO_FIFTHS | ⅖ |
THREE_QUARTERS | ¾ |
THREE_FIFTHS | ⅗ |
THREE_EIGHTHS | ⅜ |
FOUR_FIFTHS | ⅘ |
FIVE_SIXTHS | ⅚ |
FIVE_EIGHTHS | ⅝ |
SEVEN_EIGHTHS | ⅞ |
This module was created for the sole purpose of expanding on Python's default parameter abilities.
As it stands, Python allows for default parameters of specified values, but does not allow you to set them to the value of another parameter.
Combining the class and method below allows us to replicate the following JavaScript code:
function func(x, y=x) {
// If y is not defined, y will default to the value of x
}
in Python by doing this:
def func(x, y=Default.PARAMETER):
y = is_default_parameter(y, x)
# If y is not defined, y will default to the value of x
Default is an Enum which contains only a single member value: PARAMETER. (It's value is None
, but that's irrelevant)
If the test_val
is Default.PARAMETER
, the method returns return_val
. Otherwise, that means the test_val
was defined and is therefore returned.
This method will return the closest value in the array to the needle
Example:
closest(8, [1, 7, 3, 10, 5])
# returns 7
This method parses a function written in out in a string and returns the number as a decimal
This method is used to shrink multiple replace
calls in a row. By passing in the string, as well as a dictionary of key (string in the original) value (string to replace with) pairs, you will receive back a string with all occurrences of the keys, replaced with their corresponding partner.
It should be noted that the order of keys does matter when keys overlap. (FIFO)
Contains all time constants in milliseconds (Units such as months and up are not included as they are not constant).
Unit | Value |
---|---|
MILLISECOND | 1 |
SECOND | 1000 |
MINUTE | 60000 |
HOUR | 3600000 |
DAY | 86400000 |
WEEK | 604800000 |
All constants have an accompanying method that will simply return that unit in milliseconds multiplied by the argument you pass in.
This method accepts a fraction (either as a number or a string) and returns the closest value from the list of symbols above
Throws an error if the provided value is less than or equal to -1, or greater than or equal to 1