This package to replace content in the TRAI SMS template
Project description
TRAI SMS Template Replacer
Replace content in the TRAI SMS template with ease using this Python package. This library is designed to simplify the process of replacing placeholders in a TRAI SMS template with actual values. It's particularly useful for bulk SMS generation where you need to personalize messages based on dynamic data.
Installation
You can install the traisms
library using pip:
pip install traisms
Usage
To get started, import the library and create an instance of the SMSTemplate
class:
from traisms import SMSTemplate
template = 'Hi, %%|name^{"inputtype" : "text", "maxlength" : "8"}%% has checked out at %%|time^{"inputtype" : "number", "maxlength" : "6"}%% PM from %%|place^{"inputtype" : "text", "maxlength" : "64"}%%'
values = ["Alice", "2", "Taj Hotel"]
Then, simply replace the placeholders in the template with the provided values using the replace
method:
try:
result = SMSTemplate.replace(template, values)
print(result)
except Exception as e:
print(e)
The replace
method will return the updated template with the values substituted in place of the placeholders. If there are any validation errors, the library will raise relevant exceptions:
-
Invalid Template Error: This error is raised if a placeholder in the template is not valid.
-
Invalid Number Found: This error is raised if a placeholder expects a numeric value but a non-numeric value is provided.
-
Exceeded Max Length: This error is raised if a placeholder value exceeds its specified maximum length.
Example Error Handling:
# Output:
# Invalid Number Found: Can not replace "1233" expecting numeric value
# or
# Output:
# Exceeded Max Length: Can not replace "Alice" exceeding max length of 8
Template Syntax
The template follows a specific syntax for placeholders, which are enclosed within double percentage signs (e.g., %%
). Each placeholder should have the following format:
%%|name^{"inputtype" : "text", "maxlength" : "8"}%%
name
: Placeholder ID{"inputtype" : "text", "maxlength" : "8"}
: Placeholder attributes (optional)
You can customize the placeholder attributes as needed.
Features
- Easy replacement of placeholders in TRAI SMS templates.
- Support for dynamic values provided in a list.
- Customizable placeholder attributes for flexibility.
- Validation and error handling for template placeholders.
- Suitable for bulk SMS generation and personalization.
License
This library is provided under the Apache License 2.0.
Contributions
Contributions and feedback are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request.
Note: This library is not affiliated with TRAI (Telecom Regulatory Authority of India) but is designed to assist in formatting SMS messages according to TRAI guidelines.
Happy SMS templating! 📱✉️
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.