Fancy console logger and wise assistant within your python projects

Overview

prology

I present a clever logger and assistant for python.

Features

  • 📌 Simple & Powerful Standard Output with Notes
  • Traceback Call Trees of every Event
  • 📄 File Logging
  • ⌨️ Keylogging
  • 📨 Mail Delivery
  • Benchmark Testing
  • 💤 Sleeper
  • 🔊 Text-to-Speech
  • 🚨 Alerts
  • ⚙️ Customizable
  • 🧲 Attractive

Dependencies

  • python 3.x
  • python3-pip (comes with python3 installation)

Acknowledging

Comes automatically with installation:

Index

  1. Intro
  2. Getting Started
     2.1 Installation
     2.2 Hello World
     2.3 Logging
  3. Usage
     3.1 logger
      3.1.1 logger.note
      3.1.2 logger.mail
     3.2 KeyLogger

Forget print()

Say good bye to print and hello to prology! This package was build to serve not only as a fancy console logger but moreover as a wise assistant within your python project to save you tons of hours for common routines. The prology logging goes beyond python, and yet may log every input event system wide. Not convinced? Take a look:

print('common printing ...')
>>> common printing ...
from prology.log import logger
log = logger()

log.note('fancy printing!')
>>> [info][26.09.20 14:39:23]: fancy printing!

Getting Started

Installation

Install within the prology root directory prompt

~ prology/$ pip3 install .

then import prology into a custom python e.g. /project/

from prology.log import logger
log = logger()

If an import error occurs during above initialization, this is probably because espeak is not installed yet. This can be solved by installing the requirements

~$ sudo apt update && sudo apt install espeak ffmpeg libespeak1

Hello World in prology


log.note('Hello World!')
~ /project/$ [info][26.09.20 14:39:40]: Hello World!

Logging


Every call of logger.note dynamically creates a format string with plenty of methods appended. This note may yield several blocks which are substring functionals. By default, notes yields a timestamp and a logType block which indicates errors, warnings, just an info, or custom made types, and it can be printed, saved (if a filepath was provided), forwarded to other functions (if forwarder was provided), delivered with email containing the block or the raw input and much more!
Save your printing blocks using a new logger instance:

log = logger('./log.txt', overwrite=True)
logger.note('This will be appended in the log file')
logger.note('This will be appended as well')

Every note call called from this logger will be printed if detatch flag is False (default) and logged into the provided path. The root-directory is always the current working directory see os.getcwd() which is your /project/ directory.

~ /project/$ nano log.txt

[info][26.09.20 13:58:42]: This will be appended in the log file
[info][26.09.20 13:58:42]: This will be appended as well

You have a large project with many cross imports or confusing function calls? You are bored searching for bugs throughout a long chain of calls?
No worries! prology keeps track of the function branch from which the logger.note method was called.

def brokenFunction():

    try:

        raise ValueError('This Function has errors')

    except Exception as err:

        log.note(err, logType='error', fTree=True, wait=1)

def parentCaller():

    return brokenFunction()

def grandParentCaller():

    return parentCaller()

grandParentCaller()
[error][26.09.20 16:21:52][call tree: grandParentCaller > parentCaller > brokenFunction > error]: This Function has errors
        Traceback (most recent call last):
          File "test.py", line 9, in brokenFunction
            raise ValueError('This Function has errors')
        ValueError: This Function has errors

In the above example the note contains the function tree fTree block which allows you to see the calling branch and the original input. Note that by default the exception stdout is appended and logged into the log.txt accordingly.


Built-In Text to Speech Synthesis

Bring your logger to life by one single bool flag

log.note('I am alive!', speak=True)

and listen to the voice of your logger. A useful option for alerting, informing or speech synth. development.



Usage prology.log.

logger(filepath=None, overwrite=False) [object]

Main object for logging.

  • filepath [kwarg] (str)
    Default: None
    Log file path. Absolute and relative paths as well as custom file extensions are possible. The root path is the current working directory.
  • overwrite [kwarg] (bool)
    Default: False
    Overwrite the file. If disabled you can call several logger instances from plenty apps which will all append logs to the same file but make sure to give every logger instance a custom logType to distinguish them.

logger.note(input='', inputCol=None, logType='info', logTypeCol=None,showExcept=True, timestamp=True, fTree=False, benchMark=None, detatch=False, save=True, deliverTo=None, subject=None, wait=None, speak=False, forward=True, forwardBlock=False) [method]

Main method for logging. The options can be altered via arguments.The created note creates a block and may inject e.g. a logType block, sleep timer, or forward it to another object.

  • input [kwarg] (object)
    Default: str('')
    The object which should be outputted. The provided object will be formatted into a string and added to the block.

  • inputCol [kwarg] (str)
    Default: None
    Color in which the terminal should print your input. If None the output will be standard white. Otherwise provide a color code such as '\033[93m' which is red.

  • logType [kwarg] (str)
    Default: 'info'
    Creates the provided string within brackets [logType] at the beginning of the block. The provided strings info, warn, error set pre-defined colors green, yellow, red, respectively. If you provide a string different from those three you can customize the color by the logTypeCol argument.
    Example:

    log = logger()
    log.note('good', logType='info')
    log.note('warning', logType='warn')
    log.note('bad', logType='error')
    # custom type
    log.note('custom message', logType='custom', logTypeCol='\033[94m')

    Console
    The red error logType will show the last catched exception unless the showExcept is disabled.

  • logTypeCol [kwarg] (str)
    Default: None
    Same type as inputCol. Changes the logType color in the terminal. See example in logType for better description.

  • showExcept [kwarg] (bool)
    Default: True
    Enable/Disable python exceptions in your block. This can be switched to True everytime there is no real python error.

  • timeStamp [kwarg] (bool)
    Default: True
    Enable/Disable date and time block in your note. By default a time stamp is printed [26.09.20 17:52:22].

  • fTree [kwarg] (bool)
    Default: False
    Enable/Disable the call tree printing in your note. See the getting started for better instance. The following call tree will be added to your note [call tree: grandParentCaller > parentCaller > Function > logTypeCall]. If a grandParent or parent is not found (as it is not defined for example), then those will not be displayed in the block.

  • benchMark [kwarg] (callable object or function)
    Default: None
    Perform a runtime benchmark test on arbitrary object or function calls.
    Example

    log = logger()
    
    class testObject:
    
        def __init__(self):
            self.load()
    
        def load(self):
            log.note('loaded')
            
    log.note(benchMark=testObject)
    [info][26.09.20 18:39:57]: loaded
    [info][26.09.20 18:39:57][benchmark: 0.029802322387695312 ms]: 

    The initialization of this object took ~0.03 milliseconds. Per default, benchmark blocks are logged normally.

  • detatch [kwarg] (bool)
    Default: False
    If enabled stdout will not be printed in console. All other processes will work normally.

  • save [kwarg] (bool)
    Default: True
    If disabled this block will not be saved to the filepath. If the filepath is not provided, nothing will happen.

  • deliverTo [kwarg] (str or list)
    Default: None
    Works only if the logger.email method was called in advance. Provide a list with contact names or str with a single contact wo which to deliver the block via mail. Choose the subject for the mail via the argument subject. If 'all' is provided, the block is sent to all known contacts specified in logger.email.
    Example

    log = logger()
    log.mail('[email protected]', 'decrypted password', contacts={'friend':'[email protected]'}, smtpServer='provider smtp', port=587)
            
    log.note('This is an important message!', deliverTo='friend', subject='Important!')
  • subject [kwarg] (str)
    Default: None
    Provide a subject for the deliverTo argument. If None, the subject will be set automatically.

  • wait [kwarg] (int)
    Default: None
    If activated i.e. if an integer is provided, the note call will sleep for this amount in seconds. This makes import time.sleep unnecessary.

  • speak [kwarg] (bool)
    Default: False
    If enabled the input will be played via audio (male, british, medium velocity). Note that except the forwarding, all other processes were finished. The forwarding will continue after the speech playback is finished which may lead to wait times in your code.

  • forward [kwarg] (bool)
    Default: True
    If enabled the input is returned.
    Example
    One can basically pass through the input. For this call a detatched note call which only passes the input and a second which catches the return and logs it.

    def foo():
        return True
    
    value = log.note(foo(), detatch=True, save=False)
    log.note(value)

    If detatch is deactivated the value will be loged twice in the console. If save is True it will be saved twice.

  • forwardBlock [kwarg] (bool)
    Default: False
    Works only if forward is True. If enabled the block will be forwarded, otherwise only the input will be forwarded as return.


mail

logger.mail(address, password, contacts, smtpServer=None, port=587) [method]

Initializes the mail service. This method is mandatory for sending mails and should be called at the beginning of the script. For example see deliverTo.

  • address [arg] (str)
    Provide a sender email address.
  • password [arg] (str)
    Provide a corresponding password.
  • contact [arg] (dict)
    Provide a dict object filled with contacts by the scheme contact_name : contact_email both as string.
  • smtpServer[arg] (str)
    Smpt server of the sender's provider. Optional.
  • port[arg] (int)
    Provider port.

keyLogger

keyLogger(filepath=None, overwrite=False) [object]

Wrapped logger instance keyLogger(logger) which takes same kwargs. After calling method start() all key events will be logged to the file in filepath. The logger is by default detatched. To stop the logger, simply type killlogger.

Example

from prology.log import keyLogger
kl = keyLogger('/path/to/log.txt')
kl.start()
You might also like...
This open-source python3 script is a builder to the very popular token logger that is on my github that many people use.
This open-source python3 script is a builder to the very popular token logger that is on my github that many people use.

Discord-Logger-Builder This open-source python3 script is a builder to the very popular token logger that is on my github that many people use. This i

giving — the reactive logger

giving is a simple, magical library that lets you log or "give" arbitrary data throughout a program and then process it as an event stream.

Monitor creation, deletion and changes to LDAP objects live during your pentest or system administration!
Monitor creation, deletion and changes to LDAP objects live during your pentest or system administration!

LDAP Monitor Monitor creation, deletion and changes to LDAP objects live during your pentest or system administration! With this tool you can quickly

Pretty-print tabular data in Python, a library and a command-line utility. Repository migrated from bitbucket.org/astanin/python-tabulate.

python-tabulate Pretty-print tabular data in Python, a library and a command-line utility. The main use cases of the library are: printing small table

Progressbar 2 - A progress bar for Python 2 and Python 3 - "pip install progressbar2"

Text progress bar library for Python. Travis status: Coverage: Install The package can be installed through pip (this is the recommended method): pip

ClusterMonitor - a very simple python script which monitors and records the CPU and RAM consumption of submitted cluster jobs
ClusterMonitor - a very simple python script which monitors and records the CPU and RAM consumption of submitted cluster jobs

ClusterMonitor A very simple python script which monitors and records the CPU and RAM consumption of submitted cluster jobs. Usage To start recording

Robust and effective logging for Python 2 and 3.
Robust and effective logging for Python 2 and 3.

Robust and effective logging for Python 2 and 3.

A Fast, Extensible Progress Bar for Python and CLI
A Fast, Extensible Progress Bar for Python and CLI

tqdm tqdm derives from the Arabic word taqaddum (تقدّم) which can mean "progress," and is an abbreviation for "I love you so much" in Spanish (te quie

Rich is a Python library for rich text and beautiful formatting in the terminal.
Rich is a Python library for rich text and beautiful formatting in the terminal.

Rich 中文 readme • lengua española readme • Läs på svenska Rich is a Python library for rich text and beautiful formatting in the terminal. The Rich API

Owner
BoB
python after accidentally killing a programmer be like 'this mess was not indented' ssssssss
BoB
Discord-Image-Logger - Discord Image Logger With Python

Discord-Image-Logger A exploit I found in discord. Working as of now. Explanatio

null 111 Dec 31, 2022
A simple, transparent, open-source key logger, written in Python, for tracking your own key-usage statistics.

A simple, transparent, open-source key logger, written in Python, for tracking your own key-usage statistics, originally intended for keyboard layout optimization.

Ga68 56 Jan 3, 2023
Fuzzy-logger - Fuzzy project is here Log all your pc's actions Simple and free to use Security of datas !

Fuzzy-logger - ➡️⭐ Fuzzy ⭐ project is here ! ➡️ Log all your pc's actions ! ➡️ Simple and free to use ➡️ Security of datas !

natrix_dev 2 Oct 2, 2022
Json Formatter for the standard python logger

Overview This library is provided to allow standard python logging to output log data as json objects. With JSON we can make our logs more readable by

Zakaria Zajac 1.4k Jan 4, 2023
Json Formatter for the standard python logger

This library is provided to allow standard python logging to output log data as json objects. With JSON we can make our logs more readable by machines and we can stop writing custom parsers for syslog type records.

Zakaria Zajac 1k Jul 14, 2021
This is a key logger based in python which when executed records all the keystrokes of the system it has been executed on .

This is a key logger based in python which when executed records all the keystrokes of the system it has been executed on

Purbayan Majumder 0 Mar 28, 2022
Ultimate Logger - A Discord bot that logs lots of events in a channel written in python

Ultimate Logger - A Discord bot that logs lots of events in a channel written in python

Luca 2 Mar 27, 2022
Multi-processing capable print-like logger for Python

MPLogger Multi-processing capable print-like logger for Python Requirements and Installation Python 3.8+ is required Pip pip install mplogger Manual P

Eötvös Loránd University Department of Digital Humanities 1 Jan 28, 2022
Token Logger with python

Oxy Token Stealer Features Grabs discord tokens Grabs chrome passwords Grabs edge passwords Nothing else, I don't feel like releasing full on malware

oxy 1 Feb 12, 2022
A watchdog and logger to Discord for hosting ScPrime servers.

ScpDog A watchdog and logger to Discord for hosting ScPrime servers. Designed to work on Linux servers. This is only capable of sending the logs from

Keagan Landfried 3 Jan 10, 2022