Metadata-Version: 2.1
Name: loggerjava
Version: 0.8.3.dev2
Summary: an easy logger outputs like java logs
Author: HTony03
Author-email: HTony03 <HTony03@foxmail.com>
Project-URL: Homepage, https://github.com/HTony03/loggerjava
Project-URL: Issues, https://github.com/HTony03/loggerjava/issues
Keywords: python,logger,java_like
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

# loggerjava

---
an easy logger outputs like java logs
### How to use

```python
import loggerjava

logger = loggerjava
logger.info("test")
logger.warn("test", pos="insidecommand")
logger.log("test", level="w", pos="main_test", showinconsole=False)

new_logger = loggerjava.log()
new_logger.info({'txt':"test"})
new_logger.warn({'txt":test", ''pos':"insidecommand"})
new_logger.log({'txt':"test", 'level':"w", 'pos':"main_test", 'showinconsole':False})
```

### Outputs
```
[20:39:00] [main/debug]: test
[20:39:00] [main/info]: test
[20:39:00] [main/WARNING]: test
[20:39:00] [main/ERROR]: test
[20:39:00] [main/FATAL]: test
```

### Developing features
- [X] multiple variable with different configs
- [ ] catch and format errors
- [x] new config format
- [X] override config once


### Config
```python
import loggerjava
loggerjava.config(**kwargs)
"""
:param kwargs:input config names and config data
format: config_name = config_data
:type kwargs: dict
below are config_name and the description

name : change the name of the log file, only actives when abolutepath config is off
:type name: str, default 'log'

fileextension : change the extension of the log file, only actives when abolutepath config is off
:type fileextension: str, default '.log'

absolutepath : change whether inputing the absolute path of the log file,
True for using the name and fileextension to create file in the program running location
False for using the route to create file in the specific location
(note:the route should contain the extension of the file,like:D:\test.log)
:type absolutepath: bool, default False

route : change the file location, only activates when abolutepath config is on
the route should contain the extension of the file
:type route: str, default 'log.log'

file_encoding : change the file encoding method
:type file_encoding: encoding str, default 'utf-8'

showdetailedtime : whether to show detailed time in the log file
:type showdetailedtime: bool, default False

showinconsole : whether to show the log in the python console
:type showinconsole: bool, default True

fatalexit : whether to exit the program after a fatal log
:type fatalexit: bool, default False

debuginanotherfile: whether to save debug logs in another file
True: saving in <filename><debugfilename><fileextension>
False:saving in <filename><fileextension>
:type debuginanotherfile: bool, default False

debugfilename: the <debugfilename> part above
:type debugfilename: str, default '_debug'

debuginfile: whether to save debug logs in the main log file
:type debuginfile: bool, defualt True
p.s.: if the 'debuginanotherfile' config is set to true, 
the debug log would only be saved in the new debug file.

:return: complete config changing debug log
"""
```
using `logger.exportconfig()` to export your current config

and using `logger.loadconfig(inputconfig)` to load your saved config

### Exception handler
using the `loggerjava.exceptionhandler.exception(exc)` function to process an Exception

remember to register the defs/classes after you created them

```python
import loggerjava
import loggerjava.exceptionhandler
def test1(a):
    print(b)
class test2():
    def printa(self):
        print(self.b)
loggerjava.exceptionhandler.register_def(test1)
loggerjava.exceptionhandler.register_def(test2)
if __name__ == "__main__":
    try:
        test1(1)
    except Exception as E:
        loggerjava.error(loggerjava.exceptionhandler.handler(E))
    try:
        a = test2
        a.printa()
    except Exception as E:
        loggerjava.error(loggerjava.exceptionhandler.handler(E))
```
#### Output：
```
[20:39:00] [main/ERROR]: NameError: name 'b' is not defined
    at <module> (test.py:30)
    at test1.test1 (test.py:21)

[20:39:00] [main/ERROR]: AttributeError: 'test2' object has no attribute 'b'
    at <module> (test.py:35)
    at test2.printa (test.py:25)
```
### Versions

`v0.8.3.dev2` reformatted the defs, adding a new 'log' class available for multiple configs

`v0.8.0` added the exceptionhandler and clearcurrentlog function

`v0.7.6` change filetype -> fileextension, simplified the code, completed the override funciton

`v0.7.5.dev1` follow SemVer, no actual updates

`v0.0.7.5` edited the original log codes,adding "log" feature,add the fatalexit config

`v0.0.7.2` adding the "fatalexit" feature,adding an easier log function(not completed)

`v0.0.7.1` adding debug config,adding debug

`v0.0.7` no actual updates, updating version num to ver x.x.x

`0.0.6.1` update readme

`0.0.6` change the config method, adding file_encoding,absolutepath,filetype config

`0.0.5.1` rename outputconfig -> exportconfig

`0.0.5` added the outputconfig and the loadconfig function,edited the config part to let it output log

`0.0.4` upgrade the config sys and add helps

`0.0.3` upload the descriptions

`0.0.2` initial upload
