#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Timestamp: "2025-06-14 19:09:38 (ywatanabe)"
# File: /ssh:sp:/home/ywatanabe/proj/SciTeX-Code/src/scitex/str/_printc.py
# ----------------------------------------
import os
__FILE__ = __file__
__DIR__ = os.path.dirname(__FILE__)
# ----------------------------------------
# Time-stamp: "2024-11-24 17:01:23 (ywatanabe)"
THIS_FILE = "/home/ywatanabe/proj/scitex_repo/src/scitex/str/_printc.py"
# Time-stamp: "2024-11-03 03:47:51 (ywatanabe)"
from scitex_str._ansi import color_text
[docs]
def printc(message, c="blue", char="-", n=40):
"""Print a message surrounded by a character border.
This function prints a given message surrounded by a border made of
a specified character. The border can be colored if desired.
Parameters
----------
message : str
The message to be printed inside the border.
char : str, optional
The character used to create the border (default is "-").
n : int, optional
The width of the border (default is 40).
c : str, optional
The color of the border. Can be 'red', 'green', 'yellow', 'blue',
'magenta', 'cyan', 'white', or 'grey' (default is None, which means no color).
Returns
-------
None
Example
-------
>>> print_block("Hello, World!", char="*", n=20, c="blue")
********************
* Hello, World! *
********************
Note: The actual output will be in green color.
"""
if char is not None:
border = char * n
text = f"\n{border}\n{message}\n{border}\n"
else:
text = f"\n{message}\n"
if c is not None:
text = color_text(text, c)
print(text)
# EOF