nezu 0.5.1a1

Elegant debuging module

Nezu

Elegant debug module

• Python Code Example

  # file.py
  from nezu import dbg
  x = 13
  dbg('x')  # Prints debug info.
  

• Bash Commands to Debug

  export NEZU_SEEK=1
  python file.py
      @4 L.. x:int  =>  13
  

• Powershell Commands to Debug

  $env:NEZU_SEEK = 1
  python file.py
      @4 L.. x:int  =>  13
  

Table of Contents

NEZU

• Table of Contents
• Installation
• Usage
  • Output Interpretation
  • Function dbg
• Config
  • Env Vars Config
  • JSON Config
  • Hardcoded Config
• Coloring output
• Hiding output

Installation

• Pip

  python -m pip install nezu
  

• Poetry

  python -m poetry add nezu
  

Usage

• Inspect variable using function dbg in your code.
• Configure Nezu to show output.
• Interpret output and debug.

Output Interpretation

@7 ..B print:function  =>  Prints the values to a stream, or to sys...
 │ │   │     │             │
 │ │   │     │             └─ Value of inspected variable
 │ │   │     │
 │ │   │     └─────────────── Type of inspected variable.
 │ │   │
 │ │   └───────────────────── Name of inspected variable.
 │ │
 │ └───────────────────────── Scope of inspected variable (see bollow).
 |
 └─────────────────────────── Line number of inspection.

• Scope codes
  • L.. - local scope, no shadowing
  • Lg. - local scope, shadowing global
  • L.b - local scope, shadowing built-in
  • Lgb - local scope, shadowing global and built-in
  • .G. - Global scope, no shadowing
  • .Gb - Global scope, shadowing built-in
  • ..B - Built-in scope, no shadowing
  • ... - Undefined

Function dbg

Inspect scopes and values of given keys (variable names etc.).

• Args

  • *keys:str

    Names of variables to inspect

  • note:str = None

    Optional comment. Ignored if equal to None.

  • hide:int = 1

    This argument is compared with nezu.seek. If nezu.seek >= hide this debug inspection will be displayed. If hide <= 0, this message will be displayed by default.

• Python Code Example

  # file.py
  from nezu import dbg
  
  egg = 3
  ham = int()
  spam = {'spam':'bacon'}
  
  dbg('egg')          # Works on simple variables.
  dbg('ham.real')     # Works on attributes.
  dbg('print')        # Works on functions and built-ins.
  dbg('spam["spam"]') # DOES NOT work on keys and indexes yet.
  

• Note

  Output of dbg function is hidden by default. If you want to see dbg you need to configure env var NEZU_SEEK with value of 1 or more.

Config

Module nezu creates nezu object that has config attributes used by function dbg.

• Attributes
  • nezu.seek:int = 0 Compared to dbg argumenthide, if nezu.seek >= hide then dbg will be printed.
  • nezu.color:bool = False Determines if output of dbg function should be colored.
  • nezu.lock:bool = False If nezu.lock = True, this config cannot be changed later, during runtime.

Env Vars Config

If you want to use default config method, change your env vars in terminal and run Python script.

• Bash

  export NEZU_SEEK=1
  export NEZU_COLOR=1
  export NEZU_LOCK=0
  python file.py
  

• PowerShell

  $env:NEZU_SEEK = 1
  $env:NEZU_COLOR = $True
  $env:NEZU_LOCK = $True
  python file.py
  

JSON Config

If you don't want to use env vars as config, you can call nezu.json() to read config data from json file. It will search for key nezu inside chosen file.

• Args

  • path:str = 'nezu.json' - path of config file

• Example Python Code

  from nezu import nezu, dbg
  nezu.json('my/json/file.json')
  

• Example Config File

  "nezu": {
    "seek": 1,
    "color": true,
    "locked": false
  }
  

---

Hardcoded Config

If you don't want to use env vars as config you can also call object nezu like function to make hardcoded config.

• Args

  • seek:int = 0 - debug level
  • color:bool = False - output coloring
  • lock:bool = False - lock this config

• Example

  # file.py
  from nezu import nezu, dbg
  
  nezu(1, True, False)
  ...
  

• Tip

  There is no built-in support for yaml, toml or .env in nezu This is so nezu can stay free of dependencies. However you can use hardcoded config to pass data from any config file.

Coloring output

By default nezu output is monochrome. If your terminal of choise support coloring you can change that.

• Example Bash Command

  export NEZU_COLOR=1
  python file.py
  

• Example PowerShell Command

  $env:NEZU_COLOR = $True
  python file.py
  

• Example JSON Config File

  "nezu": {
    "color": true,
  }
  

• Example Hardcoded Config

  from nezu import nezu, dbg
  
  nezu(color = True)
  ...
  

Hiding Output

Function dbg() can be hidden more by hide parameter. By default only dbg calls with hide <= nezu.seek will be printed. In examples bellow only dbg hidden up to level 3 are displayed.

• Python Code Example

  #file.py
  from nezu import dbg
  
  dbg('egg', hide=1)
  dbg('ham', hide=2)
  dbg('spam', hide=3)
  dbg('bacon', hide=4)
  dbg('lobster', hide=5)
  

• Bash Example

  export NEZU_SEEK=3
  python file.py
        @4 ... egg
        @5 ... ham
        @6 ... spam
  

• PowerShell Example

  $ENV:NEZU_SEEK = 3
  python file.py
        @4 ... egg
        @5 ... ham
        @6 ... spam
  

• JSON File Example

  "nezu": {
      "seek": 3
  }