Skip to main content

Python convenient utilities for personal usage

Project description

Python Package: markkk

Convenient Python utilities for personal usage


pip install --upgrade markkk


Sub-module: logger

This is a pre-configured logger using python's built-in logging module and a formatter colorlog. It is easy to use, simplest setup on earth, suitable for personal day-to-day debugging, personal small-scale projects.

The logger has three logging handlers:

  1. log to file logs/debug.log which captures all logs with timestamp.
  2. log to file logs/error.log which captures error & critical logs with timestamp.
  3. log to console with colors for different logging levels.


  • A new folder named logs will be created at the current working directory if not already exist.
  • debug.log & error.log file will also be created if not already present under logs.


from markkk.logger import logger

logger.debug("This is a debug message")"This is a message for your information")
logger.warning("This is a warning message")
logger.error("This is an error message")
logger.critical("This is a critical error message")


Sub-module: time

  • timeit (this is a decorator for your function)
  • timeitprint (this is a decorator for your function)


from markkk.time import timeitprint

def tictok():
    a = 1000000
    for i in range(10000000):
        a -= 1
        b = a

if __name__ == "__main__":

Console output:

====== Func 'tictok' finished in 0.3280000000 secs ======

Sub-module: file

  • safe_rename
  • safe_copy
  • safe_move

Sub-module: encoding

  • is_ascii
  • check_non_ascii_index
  • is_ascii_only_file
  • check_file_by_line
  • ensure_no_zh_punctuation
  • replace_punc_for_file


from markkk.encoding import replace_punc_for_file, is_ascii

is_ascii("。") # this returns false


Install package using local version

clone this repo

git clone

go to project root

cd markkk

create virtual env for this project

python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip setuptools  wheel
pip install -r requirements.txt

install this package in editable mode

pip install -e .[dev]

Run Unittest

at project root



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

markkk-0.0.16.tar.gz (6.6 kB view hashes)

Uploaded Source

Built Distribution

markkk-0.0.16-py3-none-any.whl (8.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page