aiologging 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. aiologging-1.0.0/PKG-INFO +141 -0
  2. aiologging-1.0.0/README.md +120 -0
  3. aiologging-1.0.0/aiologging/__init__.py +96 -0
  4. aiologging-1.0.0/aiologging.egg-info/PKG-INFO +141 -0
  5. aiologging-1.0.0/aiologging.egg-info/SOURCES.txt +8 -0
  6. aiologging-1.0.0/aiologging.egg-info/dependency_links.txt +1 -0
  7. aiologging-1.0.0/aiologging.egg-info/top_level.txt +1 -0
  8. aiologging-1.0.0/setup.cfg +4 -0
  9. aiologging-1.0.0/setup.py +28 -0
aiologging-1.0.0/PKG-INFO ADDED
@@ -0,0 +1,141 @@
1
+ Metadata-Version: 2.2
2
+ Name: aiologging
3
+ Version: 1.0.0
4
+ Summary: Asynchronous module for logging in python.
5
+ Home-page: https://github.com/users/zvenios/projects/2
6
+ Author: zvenios
7
+ Author-email: kont.vladdd@gmail.com
8
+ Project-URL: GitGub, https://github.com/zvenios
9
+ Keywords: aio log logger logging aiolog aiologger aiologging
10
+ Requires-Python: >=3.11
11
+ Description-Content-Type: text/markdown
12
+ Dynamic: author
13
+ Dynamic: author-email
14
+ Dynamic: description
15
+ Dynamic: description-content-type
16
+ Dynamic: home-page
17
+ Dynamic: keywords
18
+ Dynamic: project-url
19
+ Dynamic: requires-python
20
+ Dynamic: summary
21
+
22
+ # aiologging #
23
+
24
+ ## What is this? ##
25
+ **aiologging** - asynchronous module for logging asynchronous applications.
26
+
27
+ #### Starting from version 2.0.0, logs will be written to a file and output to "print", specifying this in "aiologging.Logger()", before version 2.0.0 they were output only in "print()". ####
28
+
29
+ ## Quick Guide
30
+
31
+ ---
32
+
33
+ **Connecting the module:**
34
+ > import aiologging
35
+
36
+ ---
37
+
38
+ **Getting the logger:**
39
+ > logger = aiologging.Logger(name="logger name")
40
+
41
+ The 'name=' parameter is optional, the default value is 'root'.
42
+
43
+ ---
44
+
45
+ **Logging:**
46
+ > await logger.log(level, message)
47
+
48
+ > await logger.log(2, message) # level = INFO (int)
49
+
50
+ > await logger.log("INFO", message) # level = INFO (str)
51
+
52
+ > await logger.log(aiologging.INFO, message) # level = INFO (int)
53
+
54
+ > from aiologging import NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL
55
+ > await logger.log(INFO, message) # level = INFO (int)
56
+
57
+ Replace 'INFO' or '2' with the desired int/str level.
58
+
59
+ level is 'str' or 'int'.
60
+
61
+ | str | int |
62
+ |--|--|
63
+ | CRITICAL, FATAL | 5 |
64
+ | ERROR | 4 |
65
+ | WARNING, WARN | 3 |
66
+ | INFO | 2 |
67
+ | NOTSET | 0 |
68
+ | DEBUG | 1 |
69
+
70
+ ---
71
+
72
+ ### the records have the following format: ###
73
+ > 2025-01-18 16:10:16.271609 :: NAME :: LEVEL :: MESSAGE
74
+
75
+ **2025-01-18 16:10:16.271609 - date and time of the log.**
76
+ **NAME - the name of the logger, by default 'root'.**
77
+ **LEVEL - log level (NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL).**
78
+ **MESSAGE - the log message.**
79
+
80
+ ---
81
+
82
+ # Other functions #
83
+
84
+ ---
85
+
86
+ > async def levelToName(level: int):
87
+
88
+ Accepts level in 'int' and returns 'str' the name of the level (2 - "INFO")
89
+
90
+ ---
91
+
92
+ > async def nameToLevel(level: str):
93
+
94
+ Accepts level name in 'str' and returns 'int' the number of the level ("INFO" - 2)
95
+
96
+ ---
97
+
98
+ > async def log(time, name, level: str, msg):
99
+
100
+ It is used for recording or outputting logs via "Logger.log()". It is not recommended to use it outside of the class
101
+
102
+ ---
103
+
104
+ # Global variables #
105
+
106
+ ---
107
+
108
+ CRITICAL = 5
109
+ FATAL = CRITICAL
110
+ ERROR = 4
111
+ WARNING = 3
112
+ WARN = WARNING
113
+ INFO = 2
114
+ DEBUG = 1
115
+ NOTSET = 0
116
+
117
+ ---
118
+
119
+ _levelToName = {
120
+ CRITICAL: 'CRITICAL',
121
+ ERROR: 'ERROR',
122
+ WARNING: 'WARNING',
123
+ INFO: 'INFO',
124
+ DEBUG: 'DEBUG',
125
+ NOTSET: 'NOTSET',
126
+ }
127
+
128
+ ---
129
+
130
+ _nameToLevel = {
131
+ 'CRITICAL': CRITICAL,
132
+ 'FATAL': FATAL,
133
+ 'ERROR': ERROR,
134
+ 'WARN': WARNING,
135
+ 'WARNING': WARNING,
136
+ 'INFO': INFO,
137
+ 'DEBUG': DEBUG,
138
+ 'NOTSET': NOTSET,
139
+ }
140
+
141
+ ---
aiologging-1.0.0/README.md ADDED
@@ -0,0 +1,120 @@
1
+ # aiologging #
2
+
3
+ ## What is this? ##
4
+ **aiologging** - asynchronous module for logging asynchronous applications.
5
+
6
+ #### Starting from version 2.0.0, logs will be written to a file and output to "print", specifying this in "aiologging.Logger()", before version 2.0.0 they were output only in "print()". ####
7
+
8
+ ## Quick Guide
9
+
10
+ ---
11
+
12
+ **Connecting the module:**
13
+ > import aiologging
14
+
15
+ ---
16
+
17
+ **Getting the logger:**
18
+ > logger = aiologging.Logger(name="logger name")
19
+
20
+ The 'name=' parameter is optional, the default value is 'root'.
21
+
22
+ ---
23
+
24
+ **Logging:**
25
+ > await logger.log(level, message)
26
+
27
+ > await logger.log(2, message) # level = INFO (int)
28
+
29
+ > await logger.log("INFO", message) # level = INFO (str)
30
+
31
+ > await logger.log(aiologging.INFO, message) # level = INFO (int)
32
+
33
+ > from aiologging import NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL
34
+ > await logger.log(INFO, message) # level = INFO (int)
35
+
36
+ Replace 'INFO' or '2' with the desired int/str level.
37
+
38
+ level is 'str' or 'int'.
39
+
40
+ | str | int |
41
+ |--|--|
42
+ | CRITICAL, FATAL | 5 |
43
+ | ERROR | 4 |
44
+ | WARNING, WARN | 3 |
45
+ | INFO | 2 |
46
+ | NOTSET | 0 |
47
+ | DEBUG | 1 |
48
+
49
+ ---
50
+
51
+ ### the records have the following format: ###
52
+ > 2025-01-18 16:10:16.271609 :: NAME :: LEVEL :: MESSAGE
53
+
54
+ **2025-01-18 16:10:16.271609 - date and time of the log.**
55
+ **NAME - the name of the logger, by default 'root'.**
56
+ **LEVEL - log level (NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL).**
57
+ **MESSAGE - the log message.**
58
+
59
+ ---
60
+
61
+ # Other functions #
62
+
63
+ ---
64
+
65
+ > async def levelToName(level: int):
66
+
67
+ Accepts level in 'int' and returns 'str' the name of the level (2 - "INFO")
68
+
69
+ ---
70
+
71
+ > async def nameToLevel(level: str):
72
+
73
+ Accepts level name in 'str' and returns 'int' the number of the level ("INFO" - 2)
74
+
75
+ ---
76
+
77
+ > async def log(time, name, level: str, msg):
78
+
79
+ It is used for recording or outputting logs via "Logger.log()". It is not recommended to use it outside of the class
80
+
81
+ ---
82
+
83
+ # Global variables #
84
+
85
+ ---
86
+
87
+ CRITICAL = 5
88
+ FATAL = CRITICAL
89
+ ERROR = 4
90
+ WARNING = 3
91
+ WARN = WARNING
92
+ INFO = 2
93
+ DEBUG = 1
94
+ NOTSET = 0
95
+
96
+ ---
97
+
98
+ _levelToName = {
99
+ CRITICAL: 'CRITICAL',
100
+ ERROR: 'ERROR',
101
+ WARNING: 'WARNING',
102
+ INFO: 'INFO',
103
+ DEBUG: 'DEBUG',
104
+ NOTSET: 'NOTSET',
105
+ }
106
+
107
+ ---
108
+
109
+ _nameToLevel = {
110
+ 'CRITICAL': CRITICAL,
111
+ 'FATAL': FATAL,
112
+ 'ERROR': ERROR,
113
+ 'WARN': WARNING,
114
+ 'WARNING': WARNING,
115
+ 'INFO': INFO,
116
+ 'DEBUG': DEBUG,
117
+ 'NOTSET': NOTSET,
118
+ }
119
+
120
+ ---
aiologging-1.0.0/aiologging/__init__.py ADDED
@@ -0,0 +1,96 @@
1
+ """
2
+ import aiologging
3
+
4
+ logger = aiologging.Logger()
5
+
6
+ logger.log(level, msg)
7
+
8
+ await logger.log(5, "my CRITICAL message")
9
+ await logger.log(4, "my ERROR message")
10
+ await logger.log(3, "my WARNING message")
11
+ await logger.log(2, "my INFO message")
12
+ await logger.log(1, "my DEBUG message")
13
+ await logger.log(0, "my NOTSET message")
14
+
15
+ await logger.log("CRITICAL", "my CRITICAL message")
16
+ await logger.log("FATAL", "my CRITICAL message")
17
+ await logger.log("ERROR", "my ERROR message")
18
+ await logger.log("WARNING", "my WARNING message")
19
+ await logger.log("WARN", "my WARNING message")
20
+ await logger.log("INFO", "my INFO message")
21
+ await logger.log("DEBUG", "my DEBUG message")
22
+ await logger.log("NOTSET", "my NOTSET message")
23
+
24
+ await logger.log(aiologging.CRITICAL, "my CRITICAL message")
25
+ await logger.log(aiologging.FATAL, "my CRITICAL message")
26
+ await logger.log(aiologging.ERROR, "my ERROR message")
27
+ await logger.log(aiologging.WARNING, "my WARNING message")
28
+ await logger.log(aiologging.WARN, "my WARNING message")
29
+ await logger.log(aiologging.INFO, "my INFO message")
30
+ await logger.log(aiologging.DEBUG, "my DEBUG message")
31
+ await logger.log(aiologging.NOTSET, "my NOTSET message")
32
+
33
+ from aiologging import CRITICAL, FATAL, ERROR, WARNING, WARN, INFO, DEBUG, NOTSET
34
+
35
+ await logger.log(CRITICAL, "my CRITICAL message")
36
+ await logger.log(FATAL, "my CRITICAL message")
37
+ await logger.log(ERROR, "my ERROR message")
38
+ await logger.log(WARNING, "my WARNING message")
39
+ await logger.log(WARN, "my WARNING message")
40
+ await logger.log(INFO, "my INFO message")
41
+ await logger.log(DEBUG, "my DEBUG message")
42
+ await logger.log(NOTSET, "my NOTSET message")
43
+ """
44
+
45
+ import datetime
46
+
47
+ CRITICAL = 5
48
+ FATAL = CRITICAL
49
+ ERROR = 4
50
+ WARNING = 3
51
+ WARN = WARNING
52
+ INFO = 2
53
+ DEBUG = 1
54
+ NOTSET = 0
55
+
56
+ _levelToName = {
57
+ CRITICAL: 'CRITICAL',
58
+ ERROR: 'ERROR',
59
+ WARNING: 'WARNING',
60
+ INFO: 'INFO',
61
+ DEBUG: 'DEBUG',
62
+ NOTSET: 'NOTSET',
63
+ }
64
+
65
+ _nameToLevel = {
66
+ 'CRITICAL': CRITICAL,
67
+ 'FATAL': FATAL,
68
+ 'ERROR': ERROR,
69
+ 'WARN': WARNING,
70
+ 'WARNING': WARNING,
71
+ 'INFO': INFO,
72
+ 'DEBUG': DEBUG,
73
+ 'NOTSET': NOTSET,
74
+ }
75
+
76
+ async def levelToName(level: int):
77
+ return _levelToName.get(level)
78
+
79
+ async def nameToLevel(name: str):
80
+ return _nameToLevel.get(name)
81
+
82
+ async def log(time, name, level: str, msg):
83
+ print(f"{time} :: {name} :: {level} :: {msg}")
84
+
85
+ class Logger:
86
+ def __init__(self, name="root"):
87
+ self.name = name
88
+
89
+ async def log(self, level, msg):
90
+ time = datetime.datetime.now()
91
+ if type(level) == int:
92
+ await log(time, self.name, await levelToName(level), msg)
93
+ elif type(level) == str:
94
+ await log(time, self.name, level, msg)
95
+ else:
96
+ await log(time, self.name, await levelToName(ERROR), f"parametr level \'{level}\' is not \'int\' or \'str\'")
aiologging-1.0.0/aiologging.egg-info/PKG-INFO ADDED
@@ -0,0 +1,141 @@
1
+ Metadata-Version: 2.2
2
+ Name: aiologging
3
+ Version: 1.0.0
4
+ Summary: Asynchronous module for logging in python.
5
+ Home-page: https://github.com/users/zvenios/projects/2
6
+ Author: zvenios
7
+ Author-email: kont.vladdd@gmail.com
8
+ Project-URL: GitGub, https://github.com/zvenios
9
+ Keywords: aio log logger logging aiolog aiologger aiologging
10
+ Requires-Python: >=3.11
11
+ Description-Content-Type: text/markdown
12
+ Dynamic: author
13
+ Dynamic: author-email
14
+ Dynamic: description
15
+ Dynamic: description-content-type
16
+ Dynamic: home-page
17
+ Dynamic: keywords
18
+ Dynamic: project-url
19
+ Dynamic: requires-python
20
+ Dynamic: summary
21
+
22
+ # aiologging #
23
+
24
+ ## What is this? ##
25
+ **aiologging** - asynchronous module for logging asynchronous applications.
26
+
27
+ #### Starting from version 2.0.0, logs will be written to a file and output to "print", specifying this in "aiologging.Logger()", before version 2.0.0 they were output only in "print()". ####
28
+
29
+ ## Quick Guide
30
+
31
+ ---
32
+
33
+ **Connecting the module:**
34
+ > import aiologging
35
+
36
+ ---
37
+
38
+ **Getting the logger:**
39
+ > logger = aiologging.Logger(name="logger name")
40
+
41
+ The 'name=' parameter is optional, the default value is 'root'.
42
+
43
+ ---
44
+
45
+ **Logging:**
46
+ > await logger.log(level, message)
47
+
48
+ > await logger.log(2, message) # level = INFO (int)
49
+
50
+ > await logger.log("INFO", message) # level = INFO (str)
51
+
52
+ > await logger.log(aiologging.INFO, message) # level = INFO (int)
53
+
54
+ > from aiologging import NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL
55
+ > await logger.log(INFO, message) # level = INFO (int)
56
+
57
+ Replace 'INFO' or '2' with the desired int/str level.
58
+
59
+ level is 'str' or 'int'.
60
+
61
+ | str | int |
62
+ |--|--|
63
+ | CRITICAL, FATAL | 5 |
64
+ | ERROR | 4 |
65
+ | WARNING, WARN | 3 |
66
+ | INFO | 2 |
67
+ | NOTSET | 0 |
68
+ | DEBUG | 1 |
69
+
70
+ ---
71
+
72
+ ### the records have the following format: ###
73
+ > 2025-01-18 16:10:16.271609 :: NAME :: LEVEL :: MESSAGE
74
+
75
+ **2025-01-18 16:10:16.271609 - date and time of the log.**
76
+ **NAME - the name of the logger, by default 'root'.**
77
+ **LEVEL - log level (NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL).**
78
+ **MESSAGE - the log message.**
79
+
80
+ ---
81
+
82
+ # Other functions #
83
+
84
+ ---
85
+
86
+ > async def levelToName(level: int):
87
+
88
+ Accepts level in 'int' and returns 'str' the name of the level (2 - "INFO")
89
+
90
+ ---
91
+
92
+ > async def nameToLevel(level: str):
93
+
94
+ Accepts level name in 'str' and returns 'int' the number of the level ("INFO" - 2)
95
+
96
+ ---
97
+
98
+ > async def log(time, name, level: str, msg):
99
+
100
+ It is used for recording or outputting logs via "Logger.log()". It is not recommended to use it outside of the class
101
+
102
+ ---
103
+
104
+ # Global variables #
105
+
106
+ ---
107
+
108
+ CRITICAL = 5
109
+ FATAL = CRITICAL
110
+ ERROR = 4
111
+ WARNING = 3
112
+ WARN = WARNING
113
+ INFO = 2
114
+ DEBUG = 1
115
+ NOTSET = 0
116
+
117
+ ---
118
+
119
+ _levelToName = {
120
+ CRITICAL: 'CRITICAL',
121
+ ERROR: 'ERROR',
122
+ WARNING: 'WARNING',
123
+ INFO: 'INFO',
124
+ DEBUG: 'DEBUG',
125
+ NOTSET: 'NOTSET',
126
+ }
127
+
128
+ ---
129
+
130
+ _nameToLevel = {
131
+ 'CRITICAL': CRITICAL,
132
+ 'FATAL': FATAL,
133
+ 'ERROR': ERROR,
134
+ 'WARN': WARNING,
135
+ 'WARNING': WARNING,
136
+ 'INFO': INFO,
137
+ 'DEBUG': DEBUG,
138
+ 'NOTSET': NOTSET,
139
+ }
140
+
141
+ ---
aiologging-1.0.0/aiologging.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,8 @@
1
+ README.md
2
+ setup.cfg
3
+ setup.py
4
+ aiologging/__init__.py
5
+ aiologging.egg-info/PKG-INFO
6
+ aiologging.egg-info/SOURCES.txt
7
+ aiologging.egg-info/dependency_links.txt
8
+ aiologging.egg-info/top_level.txt
aiologging-1.0.0/aiologging.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+ aiologging
aiologging-1.0.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
aiologging-1.0.0/setup.py ADDED
@@ -0,0 +1,28 @@
1
+ from setuptools import setup, find_packages
2
+
3
+
4
+ def readme():
5
+ with open("README.md", "r") as file:
6
+ return file.read()
7
+
8
+
9
+ setup(
10
+ name="aiologging",
11
+ version="1.0.0",
12
+ author="zvenios",
13
+ author_email="kont.vladdd@gmail.com",
14
+ description="Asynchronous module for logging in python.\n\'import aiologging\' and you can use it, it's simple",
15
+ long_description=readme(),
16
+ long_description_content_type="text/markdown",
17
+ url="https://github.com/users/zvenios/projects/2",
18
+ packages=find_packages(),
19
+ install_requires=[],
20
+ classifiers=[
21
+
22
+ ],
23
+ keywords="aio log logger logging aiolog aiologger aiologging",
24
+ project_urls={
25
+ "GitGub": "https://github.com/zvenios"
26
+ },
27
+ python_requires=">=3.11"
28
+ )