Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

orpheric73/matheric

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

5 Commits

Repository files navigation

Matheric

A modular Python library designed to simplify secure and flexible user input.

Matheric provides advanced console input utilities with built-in validation, retry systems, type checking and optional confirmation protocols.

βœ… Features

  • Secure and validated user input
  • Automatic retry on invalid input
  • Built-in type verification
  • Integer and float range control
  • String length validation
  • Optional input confirmation system
  • Custom exception messages
  • Modular architecture

πŸ“¦ Installation

Bash
pip install matheric

πŸ’‘ Quick Example

Python
from matheric import secureinput
age = secureinput(
 "Enter your age: ",
 type="int",
 min=0,
 except_msg = Please enter a valid age
)
print(age)

Supported Types

Matheric currently supports:

  • "string"
  • "int"
  • "float"

String Validation

Python
name = secureinput(
 "Enter your name : ",
 type="string",
 str_min=3,
 str_max=20
)

The msg can be ommitted if it is placed first

Integer Validation

Python
number = secureinput(
 "Enter a number : ",
 type="int",
 min=1,
 max=10
)

Float Validation

Python
price = secureinput(
 msg="Enter the price : ",
 type="float",
 min=0
)

Input Confirmation System

Python
password = secureinput(
 msg="Enter password : ",
 type="string",
 validation=True
)

The validation system allows the user to confirm the entered value before final submission.

βš™οΈ Parameters

Parameter type Description Default Value
msg string Message displayed before input ""
type string / int / float Expected input type (string, int, float) string
max int / float Maximum allowed numeric value NotDefined
min int / float Minimum allowed numeric value NotDefined
str_length int Exact required string length Any
str_max int Maximum allowed string length NotDefined
str_min int Minimum allowed string length NotDefined
except_msg string Message displayed on invalid input Type ERROR
validation bool Enables validation protocol False
validation_msg string Validation confirmation message Enter 1 to confirm the input
validation_caractere string / int / float Value required to validation input 1
language EN / FR Output language used for automatic responses EN

πŸ’‘ Example With Validation

Python
from matheric import secureinput
code = secureinput(
 msg="Enter access code : ",
 type="string",
 str_length=6,
 validation=True,
 validation_msg="Confirm the code [y/N] "
 validation_caractere="y"
)

Project Structure

matheric/
β”‚
β”œβ”€β”€ pyproject.toml
β”œβ”€β”€ README.md
β”œβ”€β”€ LICENSE
β”‚
└── src/
 └── matheric/
 β”œβ”€β”€ __init__.py
 β”‚
 β”œβ”€β”€ secure_input/
 β”‚ β”œβ”€β”€ __init__.py
 β”‚ └── input.py
 β”‚
 └── utils/
 β”œβ”€β”€ __init__.py
 └── helpers.py

πŸ–₯️ Command Line

After installation:

Bash
matheric

Displays general information about the library.

πŸ“œ License

This project is licensed under the License

πŸ‘¨β€πŸ’» Author

OrphΓ©ric SANGNIDJO

About

A modular Python library for secure and flexible user input validation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /