From 63ad7e278ed61b30f12ddd6d961bed26f032e15b Mon Sep 17 00:00:00 2001
From: MissterHao <henryliking@gmail.com>
Date: Fri, 10 Feb 2023 16:30:15 +0800
Subject: [PATCH 1/3] Update README.md

---
 README.md                                     |  29 ++++++++++++++----
 .../dysession-beautiful-error-log-example.png | Bin 0 -> 18965 bytes
 tests/test_aws_dynamodb.py                    |   2 +-
 3 files changed, 24 insertions(+), 7 deletions(-)
 create mode 100644 asset/dysession-beautiful-error-log-example.png

diff --git a/README.md b/README.md
index 047d2b7..8e2e5a4 100644
--- a/README.md
+++ b/README.md
@@ -36,15 +36,16 @@ DynamoDB is Fast, flexible NoSQL database service for single-digit millisecond p
 
 Using DynamoDB for session storage alleviates issues that occur with session handling in a distributed web application by moving sessions off of the local file system and into a shared location. [[1]]
 
-+ Easy to use! All you need is add two lines of Code!
-+ Support ttl attribute
++ Easy to use! All you need is add **2 lines** of Code!
++ Support **TTL(Time to Live) attribute**
   Django's default session won't delete expired session data.
   By using DynamoDB, we can take advantage of DynamoDB's ttl attrubute to auto delete expired session data.
-+ Taking advantage of AWS serverless service! ( No more effort to maintain and autoscale )
++ No more effort to maintain and autoscale your session database ( Taking advantage of AWS serverless service! )
++ Provide beautiful, clearful and colorful error log
 
 
 ## Requirements
-django-dysession use `boto3` to communicate with DynamoDB.
+**django-dysession** use [boto3](https://aws.amazon.com/tw/sdk-for-python/) to interact with AWS DynamoDB.
 Boto3 is the Amazon Web Services (AWS) Software Development Kit (SDK) for Python, which allows Python developers to write software that makes use of services like **DynamoDB**.
 
 + Django >= 3.2
@@ -52,9 +53,9 @@ Boto3 is the Amazon Web Services (AWS) Software Development Kit (SDK) for Python
 
 ## Installation
 
-Install from PyPI ( or manually download from PyPI):
+Install from PyPI ( or manually download from [PyPI](https://pypi.org/project/django-dysession/#files) ):
 ```bash
-pip install django-dysession
+pip install -U django-dysession
 ```
 
 ## Getting Started
@@ -137,3 +138,19 @@ DYSESSION = {
 | CACHE_PERIOD       | 3600           | Define how long should be the cache live in DynamoDB's table |
 | DYNAMODB_REGION    | ap-northeast-1 | The region of the DynamoDB table                             |
 
+
+## Logging
+
+Django-Dysession support three kinds of logging.
+
+1. Colorful TTY-based Console Log
+
+   Support colorful and beautiful log when django-dysession interacting with AWS Dysession.
+   ![](/asset/dysession-beautiful-error-log-example.png)
+2. Default logging stream
+
+   Django-Dysession use python core library `logging.StreamHandler`
+3. Default File Stream
+
+   Django-Dysession use python core library `logging.FileHandler`
+
diff --git a/asset/dysession-beautiful-error-log-example.png b/asset/dysession-beautiful-error-log-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..03eb14f22e5c3530b6e85dd733b42cb056e6140a
GIT binary patch
literal 18965
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
SH^8Hu7(8A5T-G@yGywqnnwS;<

literal 0
HcmV?d00001

diff --git a/tests/test_aws_dynamodb.py b/tests/test_aws_dynamodb.py
index 732f7e8..c2d4787 100644
--- a/tests/test_aws_dynamodb.py
+++ b/tests/test_aws_dynamodb.py
@@ -21,7 +21,7 @@
 
 class AWSDynamoDBTestCase(TestCase):
     def setUp(self):
-        logging.disable(logging.CRITICAL)
+        logging.disable(logging.NOTSET)
 
     def tearDown(self):
         logging.disable(logging.NOTSET)

From ec31caef17cfcfc2ba4ba9353f715ab3ba5346c6 Mon Sep 17 00:00:00 2001
From: MissterHao <henryliking@gmail.com>
Date: Fri, 10 Feb 2023 16:56:07 +0800
Subject: [PATCH 2/3] feat: add logging configuration to settings.py

---
 README.md                    | 21 +++++++++++++--------
 dysession/logger/__init__.py | 18 ++++++++++++++++--
 dysession/settings.py        |  3 +++
 tests/test_aws_dynamodb.py   | 15 +++++----------
 4 files changed, 37 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 8e2e5a4..f5e8abf 100644
--- a/README.md
+++ b/README.md
@@ -126,17 +126,22 @@ DYSESSION = {
     "TTL_ATTRIBUTE_NAME": "ttl",
     "CACHE_PERIOD": 3600,
     "DYNAMODB_REGION": "ap-northeast-1",
+    "LOGGING": {
+        "TYPE": "CONSOLE",
+    },
 }
 ```
 
-
-| Argument           | Default        | Description                                                  |
-| ------------------ | -------------- | ------------------------------------------------------------ |
-| DYNAMODB_TABLENAME | sessions       | DynamoDB table name                                          |
-| PARTITION_KEY_NAME | PK             | Partition key name                                           |
-| TTL_ATTRIBUTE_NAME | ttl            | Time to live attribute name                                  |
-| CACHE_PERIOD       | 3600           | Define how long should be the cache live in DynamoDB's table |
-| DYNAMODB_REGION    | ap-northeast-1 | The region of the DynamoDB table                             |
+| Argument             | Default        | Description                                                                                                                                                                                                                                               |
+|----------------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| DYNAMODB_TABLENAME   | sessions       | DynamoDB table name                                                                                                                                                                                                                                       |
+| PARTITION_KEY_NAME   | PK             | Partition key name                                                                                                                                                                                                                                        |
+| TTL_ATTRIBUTE_NAME   | ttl            | Time to live attribute name                                                                                                                                                                                                                               |
+| CACHE_PERIOD         | 3600           | Define how long should be the cache live in DynamoDB's table                                                                                                                                                                                              |
+| DYNAMODB_REGION      | ap-northeast-1 | The region of the DynamoDB table                                                                                                                                                                                                                          |
+| LOGGING              | Dict           | Configuration of Logging                                                                                                                                                                                                                                  |
+| LOGGING["TYPE"]      | CONSOLE        | Only accept two kinds of parameters: `CONSOLE`, `FILE`. If this set to `CONSOLE`, django-dysession will use `StreamHandler` to stream to the console. If this set to `FILE`, django-dysession will use `FileHandler` to stream to `LOGGING["FILE_PATH"]`. |
+| LOGGING["FILE_PATH"] | session.log    | The file path to save logs of session managements.                                                                                                                                                                                                        |
 
 
 ## Logging
diff --git a/dysession/logger/__init__.py b/dysession/logger/__init__.py
index ccac192..334b77c 100644
--- a/dysession/logger/__init__.py
+++ b/dysession/logger/__init__.py
@@ -4,6 +4,8 @@
 from functools import lru_cache
 from typing import Literal
 
+from dysession.settings import get_config
+
 from .handler.colorful_console import ColorfulConsoleLoggerHandler
 
 
@@ -23,7 +25,7 @@ def is_tty() -> bool:
 
 def get_logger(
     logger_name: str = "dysession",
-    logger_type: Literal[LoggingType.CONSOLE, LoggingType.FILE] = LoggingType.CONSOLE,
+    logger_type: Literal[None, LoggingType.CONSOLE, LoggingType.FILE] = None,
     level: int = logging.DEBUG,
 ) -> logging.Logger:
     """
@@ -40,6 +42,17 @@ def get_logger(
     ```
     """
 
+    if logger_type is None:
+        try:
+            logger_type = LoggingType[get_config()["LOGGING"]["TYPE"]]
+            if (
+                logger_type == LoggingType.PLAINTEXT_CONSOLE
+                or logger_type == LoggingType.COLOR_CONSOLE
+            ):
+                raise KeyError
+        except KeyError:
+            raise KeyError("logger_type only accept 'CONSOLE' and 'FILE'")
+
     logger = logging.getLogger(logger_name)
     format = logging.Formatter(
         "[%(asctime)-s] [%(levelname)-8s] %(name)s %(message)s ... ( %(filename)s:%(levelno)s )"
@@ -53,7 +66,8 @@ def get_logger(
             else:
                 handler = logging.StreamHandler()
         elif logger_type == LoggingType.FILE:
-            handler = logging.FileHandler("session.log", "a", encoding="utf-8")
+            filepath = get_config()["LOGGING"].get("FILE_PATH", "session.log")
+            handler = logging.FileHandler(filepath, "a", encoding="utf-8")
 
         handler.setFormatter(format)
         logger.addHandler(handler)
diff --git a/dysession/settings.py b/dysession/settings.py
index 40a76a3..d255252 100644
--- a/dysession/settings.py
+++ b/dysession/settings.py
@@ -12,6 +12,9 @@
     "TTL_ATTRIBUTE_NAME": "ttl",
     "CACHE_PERIOD": 3600,
     "DYNAMODB_REGION": "ap-northeast-1",
+    "LOGGING": {
+        "TYPE": "CONSOLE",
+    },
 }
 
 
diff --git a/tests/test_aws_dynamodb.py b/tests/test_aws_dynamodb.py
index c2d4787..ade3c3d 100644
--- a/tests/test_aws_dynamodb.py
+++ b/tests/test_aws_dynamodb.py
@@ -5,15 +5,10 @@
 from moto import mock_dynamodb
 from parameterized import parameterized
 
-from dysession.aws.dynamodb import (
-    check_dynamodb_table_exists,
-    create_dynamodb_table,
-    delete_session_item,
-    destory_dynamodb_table,
-    get_item,
-    insert_session_item,
-    key_exists,
-)
+from dysession.aws.dynamodb import (check_dynamodb_table_exists,
+                                    create_dynamodb_table, delete_session_item,
+                                    destory_dynamodb_table, get_item,
+                                    insert_session_item, key_exists)
 from dysession.aws.error import DynamodbItemNotFound, DynamodbTableNotFound
 from dysession.backends.model import SessionDataModel
 from dysession.settings import get_config
@@ -21,7 +16,7 @@
 
 class AWSDynamoDBTestCase(TestCase):
     def setUp(self):
-        logging.disable(logging.NOTSET)
+        logging.disable(logging.CRITICAL)
 
     def tearDown(self):
         logging.disable(logging.NOTSET)

From aaea2ed604ad295754aada8cfd0a3c106e634435 Mon Sep 17 00:00:00 2001
From: MissterHao <henryliking@gmail.com>
Date: Mon, 13 Feb 2023 13:44:50 +0800
Subject: [PATCH 3/3] feat: documentation and type hint

---
 README.md                                    | 2 +-
 dysession/backends/db.py                     | 7 +++----
 dysession/backends/model.py                  | 6 +++---
 dysession/logger/__init__.py                 | 1 +
 dysession/logger/handler/colorful_console.py | 3 ++-
 dysession/settings.py                        | 3 +++
 dysession/version.txt                        | 2 +-
 7 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index f5e8abf..a8eb96b 100644
--- a/README.md
+++ b/README.md
@@ -141,7 +141,7 @@ DYSESSION = {
 | DYNAMODB_REGION      | ap-northeast-1 | The region of the DynamoDB table                                                                                                                                                                                                                          |
 | LOGGING              | Dict           | Configuration of Logging                                                                                                                                                                                                                                  |
 | LOGGING["TYPE"]      | CONSOLE        | Only accept two kinds of parameters: `CONSOLE`, `FILE`. If this set to `CONSOLE`, django-dysession will use `StreamHandler` to stream to the console. If this set to `FILE`, django-dysession will use `FileHandler` to stream to `LOGGING["FILE_PATH"]`. |
-| LOGGING["FILE_PATH"] | session.log    | The file path to save logs of session managements.                                                                                                                                                                                                        |
+| LOGGING["FILE_PATH"] | session.log    | Optional. Only use this configuration when LOGGING["TYPE"] is set to `FILE`. The file path to save logs of session managements.                                                                                                                           |
 
 
 ## Logging
diff --git a/dysession/backends/db.py b/dysession/backends/db.py
index 8a57f46..6860b3a 100644
--- a/dysession/backends/db.py
+++ b/dysession/backends/db.py
@@ -58,7 +58,7 @@ def _get_session(self, no_load=False) -> SessionDataModel:
     def key_salt(self):
         return "dysession.backends." + self.__class__.__qualname__
 
-    def is_empty(self):
+    def is_empty(self) -> bool:
         "Return True when there is no session_key and the session is empty."
         try:
             return not self._session_key and not self._session_cache.is_empty
@@ -69,10 +69,10 @@ def clear(self):
         super().clear()
         self._session_cache = SessionDataModel()
 
-    def items(self):
+    def items(self) -> Dict[str, Any]:
         return self._session.items()
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str(self._get_session())
 
     # Methods that subclass must implement
@@ -124,7 +124,6 @@ def delete(self, session_key=None):
         if session_key is None:
             session_key = self._session_key
 
-        
         try:
             self.db.delete(self._get_session())
         except DeleteSessionError:
diff --git a/dysession/backends/model.py b/dysession/backends/model.py
index 261ca6f..a3a1309 100644
--- a/dysession/backends/model.py
+++ b/dysession/backends/model.py
@@ -48,12 +48,12 @@ def __delitem__(self, key):
     def __iter__(self):
         return iter(self.__variables_names)
 
-    def __is_empty(self):
+    def __is_empty(self) -> bool:
         return len(self.__variables_names) == 0
 
     is_empty = property(__is_empty)
 
-    def get(self, key, default=...):
+    def get(self, key, default=...) -> Any:
         try:
             return self[key]
         except AttributeError:
@@ -61,7 +61,7 @@ def get(self, key, default=...):
                 raise
             return default
 
-    def pop(self, key, default=...):
+    def pop(self, key, default=...) -> Any:
         try:
             ret = self[key]
             del self[key]
diff --git a/dysession/logger/__init__.py b/dysession/logger/__init__.py
index 334b77c..60863c6 100644
--- a/dysession/logger/__init__.py
+++ b/dysession/logger/__init__.py
@@ -10,6 +10,7 @@
 
 
 class LoggingType(Enum):
+    """Enum of python logger type."""
 
     PLAINTEXT_CONSOLE = auto()
     COLOR_CONSOLE = auto()
diff --git a/dysession/logger/handler/colorful_console.py b/dysession/logger/handler/colorful_console.py
index 1139523..298e981 100644
--- a/dysession/logger/handler/colorful_console.py
+++ b/dysession/logger/handler/colorful_console.py
@@ -1,8 +1,9 @@
 import logging
+from typing import Dict
 
 from .ansi import ANSIColor
 
-LOGLEVEL_TRANSFORM = {
+LOGLEVEL_TRANSFORM: Dict[int, str] = {
     logging.DEBUG: ANSIColor.DEBUG.value,
     logging.INFO: ANSIColor.OKCYAN.value,
     logging.WARNING: ANSIColor.WARNING.value,
diff --git a/dysession/settings.py b/dysession/settings.py
index d255252..4dcbb7e 100644
--- a/dysession/settings.py
+++ b/dysession/settings.py
@@ -29,6 +29,9 @@ def get_config() -> Dict[str, Union[str, int]]:
         * TTL_ATTRIBUTE_NAME
         * CACHE_PERIOD
         * DYNAMODB_REGION
+        * LOGGING
+            * TYPE
+            * FILE_PATH
 
     Returns:
         Dict[str, Union[str, int]]
diff --git a/dysession/version.txt b/dysession/version.txt
index 1cc5f65..8cfbc90 100644
--- a/dysession/version.txt
+++ b/dysession/version.txt
@@ -1 +1 @@
-1.1.0
\ No newline at end of file
+1.1.1
\ No newline at end of file