add config/logger.yaml example files to start from.

Miguel Barão
1 parent 1841cc32
Showing 5 changed files with 116 additions and 26 deletions Show diff stats
README.md
aprendizations/knowledge.py
aprendizations/serve.py
config/logger-debug.yaml
config/logger.yaml
@@ -220,6 +220,7 @@ errors in the browser.
 Logging levels can be adjusted in `~/.config/aprendizations/logger.yaml` and 
 `~/.config/aprendizations/logger-debug.yaml`.
  
+If these files do not yet exist, there are examples in `aprendizations/config` that can be copied to `~/.config/aprendizations`.
  
 #### UnicodeEncodeError
  
@@ -69,13 +69,14 @@ class StudentKnowledge(object):
     # ------------------------------------------------------------------------
     async def start_topic(self, topic):
         logger.debug('StudentKnowledge.start_topic()')
+
         if self.current_topic == topic:
-            logger.info('  Restarting current topic is not allowed.')
+            logger.info('Restarting current topic is not allowed.')
             return False
  
         # do not allow locked topics
         if self.is_locked(topic):
-            logger.debug(f'  Topic {topic} is locked')
+            logger.debug(f'Topic {topic} is locked')
             return False
  
         # starting new topic
@@ -96,23 +97,16 @@ class StudentKnowledge(object):
         # synchronous:
         # self.questions = [self.factory[ref].generate() for ref in questions]
  
-        loop = asyncio.get_running_loop()
-
         # async:
-        # generators = [loop.run_in_executor(None, self.factory[qref].generate)
-        #               for qref in questions]
-        # self.questions = await asyncio.gather(*generators)
-
-        # another async:
-        self.questions = []
-        for qref in questions:
-            q = await loop.run_in_executor(None, self.factory[qref].generate)
-            self.questions.append(q)
-
-        logger.debug(f'Generated {len(self.questions)} questions')
+        loop = asyncio.get_running_loop()
+        generators = [loop.run_in_executor(None, self.factory[qref].generate)
+                      for qref in questions]
+        self.questions = await asyncio.gather(*generators)
  
         # get first question
         self.next_question()
+
+        logger.debug(f'Generated {len(self.questions)} questions')
         return True
  
     # ------------------------------------------------------------------------
 #!/usr/bin/env python3
  
 # python standard library
-from os import path
-import os
 import sys
 import base64
 import uuid
@@ -13,12 +11,12 @@ import signal
 import functools
 import ssl
 import asyncio
-# from typing import NoReturn
+from os import path, environ
  
 # third party libraries
 import tornado.ioloop
-import tornado.web
 import tornado.httpserver
+import tornado.web
 from tornado.escape import to_unicode
  
 # this project
@@ -294,7 +292,7 @@ class QuestionHandler(BaseHandler):
         answer_qid = self.get_body_arguments('qid')[0]
         current_qid = self.learn.get_current_question_id(user)
         if answer_qid != current_qid:
-            logging.debug(f'User {user} desynchronized questions')
+            logging.info(f'User {user} desynchronized questions')
             self.write({
                 'method': 'invalid',
                 'params': {
@@ -428,16 +426,16 @@ def get_logger_config(debug=False):
         filename = 'logger.yaml'
         level = 'INFO'
  
-    config_dir = os.environ.get('XDG_CONFIG_HOME', '~/.config/')
+    config_dir = environ.get('XDG_CONFIG_HOME', '~/.config/')
     config_file = path.join(path.expanduser(config_dir), APP_NAME, filename)
  
     default_config = {
         'version': 1,
         'formatters': {
             'standard': {
-                'format': '%(asctime)s %(name)-24s %(levelname)-8s '
+                'format': '%(asctime)s %(name)-24s %(levelname)-10s - '
                           '%(message)s',
-                'datefmt': '%H:%M:%S',
+                'datefmt': '%Y-%m-%d %H:%M:%S',
                 },
             },
         'handlers': {
@@ -503,8 +501,8 @@ def main():
         sys.exit(1)
  
     # --- get SSL certificates
-    if 'XDG_DATA_HOME' in os.environ:
-        certs_dir = path.join(os.environ['XDG_DATA_HOME'], 'certs')
+    if 'XDG_DATA_HOME' in environ:
+        certs_dir = path.join(environ['XDG_DATA_HOME'], 'certs')
     else:
         certs_dir = path.expanduser('~/.local/share/certs')
  
@@ -523,7 +521,12 @@ def main():
         logging.critical('Certificates cert.pem and privkey.pem not found')
         sys.exit(1)
  
-    httpserver.listen(arg.port)
+    try:
+        httpserver.listen(arg.port)
+    except OSError:
+        logging.critical(f'Cannot bind port {arg.port}. Already in use?')
+        sys.exit(1)
+
     logging.info(f'Listening on port {arg.port}.')
  
     # --- run webserver
@@ -0,0 +1,46 @@
+---
+version: 1
+
+formatters:
+    void:
+        format: ''
+    standard:
+        format: '%(asctime)s | %(levelname)-9s | %(name)-24s | %(thread)-15d | %(message)s'
+        datefmt: '%H:%M:%S'
+
+handlers:
+    default:
+        level: 'DEBUG'
+        class: 'logging.StreamHandler'
+        formatter: 'standard'
+        stream: 'ext://sys.stdout'
+
+loggers:
+    '':
+        handlers: ['default']
+        level: 'DEBUG'
+
+    'aprendizations.factory':
+        handlers: ['default']
+        level: 'DEBUG'
+        propagate: false
+
+    'aprendizations.knowledge':
+        handlers: ['default']
+        level: 'DEBUG'
+        propagate: false
+
+    'aprendizations.learnapp':
+        handlers: ['default']
+        level: 'DEBUG'
+        propagate: false
+
+    'aprendizations.questions':
+        handlers: ['default']
+        level: 'DEBUG'
+        propagate: false
+
+    'aprendizations.tools':
+        handlers: ['default']
+        level: 'DEBUG'
+        propagate: false
@@ -0,0 +1,46 @@
+---
+version: 1
+
+formatters:
+    void:
+        format: ''
+    standard:
+        format: '%(asctime)s | %(thread)-15d | %(levelname)-9s | %(name)-24s | %(message)s'
+        datefmt: '%Y-%m-%d %H:%M:%S'
+
+handlers:
+    default:
+        level: 'INFO'
+        class: 'logging.StreamHandler'
+        formatter: 'standard'
+        stream: 'ext://sys.stdout'
+
+loggers:
+    '':
+        handlers: ['default']
+        level: 'INFO'
+
+    'aprendizations.factory':
+        handlers: ['default']
+        level: 'INFO'
+        propagate: false
+
+    'aprendizations.knowledge':
+        handlers: ['default']
+        level: 'INFO'
+        propagate: false
+
+    'aprendizations.learnapp':
+        handlers: ['default']
+        level: 'INFO'
+        propagate: false
+
+    'aprendizations.questions':
+        handlers: ['default']
+        level: 'INFO'
+        propagate: false
+
+    'aprendizations.tools':
+        handlers: ['default']
+        level: 'INFO'
+        propagate: false
...	...	@@ -220,6 +220,7 @@ errors in the browser.
220	220	Logging levels can be adjusted in `~/.config/aprendizations/logger.yaml` and
221	221	`~/.config/aprendizations/logger-debug.yaml`.
222	222
	223	+If these files do not yet exist, there are examples in `aprendizations/config` that can be copied to `~/.config/aprendizations`.
223	224
224	225	#### UnicodeEncodeError
225	226
...	...
...	...	@@ -69,13 +69,14 @@ class StudentKnowledge(object):
69	69	# ------------------------------------------------------------------------
70	70	async def start_topic(self, topic):
71	71	logger.debug('StudentKnowledge.start_topic()')
	72	+
72	73	if self.current_topic == topic:
73		- logger.info(' Restarting current topic is not allowed.')
	74	+ logger.info('Restarting current topic is not allowed.')
74	75	return False
75	76
76	77	# do not allow locked topics
77	78	if self.is_locked(topic):
78		- logger.debug(f' Topic {topic} is locked')
	79	+ logger.debug(f'Topic {topic} is locked')
79	80	return False
80	81
81	82	# starting new topic
...	...	@@ -96,23 +97,16 @@ class StudentKnowledge(object):
96	97	# synchronous:
97	98	# self.questions = [self.factory[ref].generate() for ref in questions]
98	99
99		- loop = asyncio.get_running_loop()
100		-
101	100	# async:
102		- # generators = [loop.run_in_executor(None, self.factory[qref].generate)
103		- # for qref in questions]
104		- # self.questions = await asyncio.gather(*generators)
105		-
106		- # another async:
107		- self.questions = []
108		- for qref in questions:
109		- q = await loop.run_in_executor(None, self.factory[qref].generate)
110		- self.questions.append(q)
111		-
112		- logger.debug(f'Generated {len(self.questions)} questions')
	101	+ loop = asyncio.get_running_loop()
	102	+ generators = [loop.run_in_executor(None, self.factory[qref].generate)
	103	+ for qref in questions]
	104	+ self.questions = await asyncio.gather(*generators)
113	105
114	106	# get first question
115	107	self.next_question()
	108	+
	109	+ logger.debug(f'Generated {len(self.questions)} questions')
116	110	return True
117	111
118	112	# ------------------------------------------------------------------------
...	...
1	1	#!/usr/bin/env python3
2	2
3	3	# python standard library
4		-from os import path
5		-import os
6	4	import sys
7	5	import base64
8	6	import uuid
...	...	@@ -13,12 +11,12 @@ import signal
13	11	import functools
14	12	import ssl
15	13	import asyncio
16		-# from typing import NoReturn
	14	+from os import path, environ
17	15
18	16	# third party libraries
19	17	import tornado.ioloop
20		-import tornado.web
21	18	import tornado.httpserver
	19	+import tornado.web
22	20	from tornado.escape import to_unicode
23	21
24	22	# this project
...	...	@@ -294,7 +292,7 @@ class QuestionHandler(BaseHandler):
294	292	answer_qid = self.get_body_arguments('qid')[0]
295	293	current_qid = self.learn.get_current_question_id(user)
296	294	if answer_qid != current_qid:
297		- logging.debug(f'User {user} desynchronized questions')
	295	+ logging.info(f'User {user} desynchronized questions')
298	296	self.write({
299	297	'method': 'invalid',
300	298	'params': {
...	...	@@ -428,16 +426,16 @@ def get_logger_config(debug=False):
428	426	filename = 'logger.yaml'
429	427	level = 'INFO'
430	428
431		- config_dir = os.environ.get('XDG_CONFIG_HOME', '~/.config/')
	429	+ config_dir = environ.get('XDG_CONFIG_HOME', '~/.config/')
432	430	config_file = path.join(path.expanduser(config_dir), APP_NAME, filename)
433	431
434	432	default_config = {
435	433	'version': 1,
436	434	'formatters': {
437	435	'standard': {
438		- 'format': '%(asctime)s %(name)-24s %(levelname)-8s '
	436	+ 'format': '%(asctime)s %(name)-24s %(levelname)-10s - '
439	437	'%(message)s',
440		- 'datefmt': '%H:%M:%S',
	438	+ 'datefmt': '%Y-%m-%d %H:%M:%S',
441	439	},
442	440	},
443	441	'handlers': {
...	...	@@ -503,8 +501,8 @@ def main():
503	501	sys.exit(1)
504	502
505	503	# --- get SSL certificates
506		- if 'XDG_DATA_HOME' in os.environ:
507		- certs_dir = path.join(os.environ['XDG_DATA_HOME'], 'certs')
	504	+ if 'XDG_DATA_HOME' in environ:
	505	+ certs_dir = path.join(environ['XDG_DATA_HOME'], 'certs')
508	506	else:
509	507	certs_dir = path.expanduser('~/.local/share/certs')
510	508
...	...	@@ -523,7 +521,12 @@ def main():
523	521	logging.critical('Certificates cert.pem and privkey.pem not found')
524	522	sys.exit(1)
525	523
526		- httpserver.listen(arg.port)
	524	+ try:
	525	+ httpserver.listen(arg.port)
	526	+ except OSError:
	527	+ logging.critical(f'Cannot bind port {arg.port}. Already in use?')
	528	+ sys.exit(1)
	529	+
527	530	logging.info(f'Listening on port {arg.port}.')
528	531
529	532	# --- run webserver
...	...
...	...	@@ -0,0 +1,46 @@
	1	+---
	2	+version: 1
	3	+
	4	+formatters:
	5	+ void:
	6	+ format: ''
	7	+ standard:
	8	+ format: '%(asctime)s \| %(levelname)-9s \| %(name)-24s \| %(thread)-15d \| %(message)s'
	9	+ datefmt: '%H:%M:%S'
	10	+
	11	+handlers:
	12	+ default:
	13	+ level: 'DEBUG'
	14	+ class: 'logging.StreamHandler'
	15	+ formatter: 'standard'
	16	+ stream: 'ext://sys.stdout'
	17	+
	18	+loggers:
	19	+ '':
	20	+ handlers: ['default']
	21	+ level: 'DEBUG'
	22	+
	23	+ 'aprendizations.factory':
	24	+ handlers: ['default']
	25	+ level: 'DEBUG'
	26	+ propagate: false
	27	+
	28	+ 'aprendizations.knowledge':
	29	+ handlers: ['default']
	30	+ level: 'DEBUG'
	31	+ propagate: false
	32	+
	33	+ 'aprendizations.learnapp':
	34	+ handlers: ['default']
	35	+ level: 'DEBUG'
	36	+ propagate: false
	37	+
	38	+ 'aprendizations.questions':
	39	+ handlers: ['default']
	40	+ level: 'DEBUG'
	41	+ propagate: false
	42	+
	43	+ 'aprendizations.tools':
	44	+ handlers: ['default']
	45	+ level: 'DEBUG'
	46	+ propagate: false
...	...