Metadata-Version: 2.1
Name: simple-print
Version: 1.7.0
Summary: Powerful debugging tool for Python.
Home-page: https://github.com/Sobolev5/simple-print/
Author: Sobolev Andrey
Author-email: email.asobolev@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: termcolor (==1.1.0)
Requires-Dist: executing (==0.8.1)
Requires-Dist: asttokens (==2.0.5)
Requires-Dist: typing-extensions (>=4.1.0)

# Simple print
Powerful debugging tool for Python.  
Userful for `bash` console messages.

```no-highlight
https://github.com/Sobolev5/simple-print
```

## Install
To install run:
```no-highlight
pip install simple-print
```

### Print variables
Function params:
> `c` color [grey, red, green, yellow, blue, magenta, cyan, white]  
> `b` background [on_grey, on_red, on_green, on_yellow, on_blue, on_magenta, on_cyan]  
> `a` attribute  [bold, dark, underline, blink, reverse, concealed]  
> `p` path [with path to file]  
> `i` indent [indent 1..40]  
> `s` string [return as string]  
> `f` force print [ignore SIMPLE_PRINT_ENABLED=False for docker production logs for example]  

```python
from simple_print import sprint 

master = "yoda"
sprint(master) 
sprint(master, c="blue") 
sprint(master, c="blue", b="on_white") 
sprint(master, c="blue", b="on_white", a="underline") 
sprint(master, c="blue", b="on_white", a="bold", p=True) 
my_string = sprint(master, s=True) # return as string
my_string = sprint(master, s=True, p=True) # return as string with path to file 
```
Result:   
![](https://github.com/Sobolev5/simple-print/blob/master/screenshots/common.png)   
`p` param is `False` by default, but you can override this behavior with `SIMPLE_PRINT_PATH_TO_FILE=True` in your local environment.

### Example with indent
For indent use `i` param:
```python

def test_indent():
    fruits = ["lemon", "orange", "banana"]
    sprint(fruits, c="green")  
    for fruit in fruits:
        sprint(fruit, c="yellow", i=4)
```
Result:   
![](https://github.com/Sobolev5/simple-print/blob/master/screenshots/indent.png)

### ENV
Stop printing:  
```sh
export SIMPLE_PRINT_ENABLED=False
```
  
Always show path to file:  
```sh
export SIMPLE_PRINT_SHOW_PATH_TO_FILE=True
```

### Test 
```sh
pytest test/test_print.py -s
```


