Skip to content

AI35/easylogging

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 

Repository files navigation

easylogging

Simple and Easy Logger lib for python

easylogging version status Codacy Badge python windows linux license

This library has returned with a new version (easylogging2) --> https://github.com/AI35/easylogging2

  • (v1.3 stopped development) This lib is very simple and poor so its need a lot of development and time to become useful in full projects.
  • v1.2.5 More stable but will not be Published.
  • End : 9 October 2018 , v1.2.0
  • This library may come back someday better and more useful.

REQUIREMENTS

Notes

  • Now This lib is Stable.
  • I am created this lib because i want use easy logging lib.
  • Important(To Work --logfile) : You need to put easylogging.py in same folder with your main file.
  • Known Bug : You need to place easylogging.py next to the file that uses this lib.

Installation

  • Clone this repo:

     $ git clone https://github.com/AI35/easylogging
    
  • Using pip:

     $ pip install easylogging
    

Usage

  • First you need import lib and Set name :

      import easylogging
      
      easylogging.logname(__file__)
    
  • Use the functions you need:

    • easylogging.critical(msg)
    • easylogging.error(msg, exc_info) default: exc_info=False
    • easylogging.warning(msg)
    • easylogging.info(msg)
    • easylogging.debug(msg)
  • You can start logging from Cmd or PowerShell :

      $ Python yourfile.py --logging --logfile
      
      usage: youefile.py [--logging] [--logfile]
      
      optional arguments:
        --logging            Display log in Console
        --logfile            Create log file
    
  • After first run you will see new file logging.conf :

    • Change level number to display log in console without --logging (0 display all level).
        level=50
      
    • Change file_level number to set level in log file with --logfile (50 hide all level).
      - This option work on --logfile without use --logging (if use --logging file write all level)
        file_level=0
      
  • in Version 1.1.0 : Now you can show and hide error info from logging.conf :

    - Show Error info (easylogging.error(msg, exc_info))
    - True or False or None
    - * (None) means that exc_info takes the value entered from the user, example: easylogging.error(msg, exc_info=True)
      exc_info=None
    
  • in Version 1.1.2 : Fix DeprecationWarning:

    - Fix warn function
  • in Version 1.1.3 : Fix input msg:

    - You can know input (int or any value) , example:
      easylogging.error(msg) ; msg = 10
    
  • in Version 1.2.0 : Important Fixes:

    - You don't need to place easylogging.py next to the file that uses this lib.
    - File level in logging.conf work on --logfile without use --logging (if use --logging file write all level).
    - V 1.2.0 is stable version and ready to use.
    - You can install lib from pip.
    - Change lib name from pylog to easylogging Because pylog already exists in pip.
  • Level table :

    Level Numeric value
    CRITICAL < 50
    ERROR < 40
    WARNING < 30
    INFO < 20
    DEBUG < 10
    NOTSET 0
  • You can see test file test.py to know how this lib is work.

LICENSE

Copyright 2018 LinePY - ALI B OTHMAN(AI35), Inc.

easylogging

   Licensed under the GNU License , you may not use this
   file except in compliance with the License.
   You may obtain a copy of the License at :

   https://github.com/AI35/easylog/blob/master/LICENSE
ALI .B .OTH - ORG : LinePY