valar 1.2.3__tar.gz → 1.2.4__tar.gz

{valar-1.2.3/src/valar.egg-info → valar-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: valar
-Version: 1.2.3
+Version: 1.2.4
 Summary: valar for morghulis
 Home-page: https://gitee.com/GRIFFIN120/valar_dev
 Author: LYP
@@ -28,7 +28,7 @@ Dynamic: summary
 
 valar for morghulis
 
-# 1. install
+# 1. installation
 
 ```shell
 pip install valar
@@ -37,24 +37,16 @@ pip install valar
 # 1. settings
 
 ```python
-from django.core.management.utils import get_random_secret_key
 from pathlib import Path
 
-"""       Compulsory settings       """
-
+""" Compulsory settings """
 DEBUG = True
 BASE_DIR = Path(__file__).resolve().parent.parent
 BASE_APP = str(BASE_DIR.name)
 DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
-SECRET_KEY = get_random_secret_key()
-
-"""       Valar Options       """
+SECRET_KEY = 'django-insecure-of@tfouoq^_f$l!yki#m=6j7)@&kjri$1_$!mca-=%7=+@f@5^'
 
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
-MONGO_URI = 'mongodb://root:19870120@121.41.111.175:27017/'
-MINIO_URL = "s3://admin:password@120.27.8.186:9000"
-
-"""       Minimized compulsory settings       """
+""" Minimized compulsory settings """
 
 DATABASES = {
     'default': {
@@ -62,29 +54,32 @@ DATABASES = {
         'NAME': BASE_DIR / 'db.sqlite3',
     }
 }
+
 INSTALLED_APPS = [
     'django.contrib.sessions',
     "corsheaders",
     'channels',
     'valar.apps.ValarConfig',
 ]
+
 MIDDLEWARE = [
     'django.contrib.sessions.middleware.SessionMiddleware',
     'corsheaders.middleware.CorsMiddleware',
     'django.middleware.common.CommonMiddleware',
 ]
+
 CHANNEL_LAYERS = {
     "default": {
         "BACKEND": "channels.layers.InMemoryChannelLayer"
     }
 }
+
 CORS_ORIGIN_ALLOW_ALL = True
 CORS_ALLOW_CREDENTIALS = True
 ROOT_URLCONF = "%s.urls" % BASE_APP
 ASGI_APPLICATION = "%s.asgi.application" % BASE_APP
 
-"""       Optional settings       """
-
+""" Optional settings """
 ALLOWED_HOSTS = ['*']
 LANGUAGE_CODE = 'en-us'
 TIME_ZONE = 'Asia/Shanghai'
@@ -95,6 +90,13 @@ SESSION_COOKIE_AGE = 60 * 60
 FILE_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 
+""" Valar Options """
+
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+MONGO_URI = 'mongodb://username:password@host:27017'
+MINIO_URL = "s3://username:password@host:9000"
+MINIO_ROOT = "https://host:9001"
+
 ```
 
 # 2. asgi
@@ -103,6 +105,7 @@ DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 from django.core.asgi import get_asgi_application
 from channels.routing import ProtocolTypeRouter, URLRouter
 from django.urls import re_path
+
 from valar.channels.consumer import ValarConsumer
 
 application = ProtocolTypeRouter({
@@ -112,39 +115,77 @@ application = ProtocolTypeRouter({
     ])
 })
 
+
 ```
 
 # 3. migrate
 
-no need, valar will auto migration
+- no need to makemigrations and migrate for valar, valar will auto migration
 
 # 4. root urls
 
-no need, valar will auto set urlpatterns
+no need to provide urls for val, valar will auto set urlpatterns for Morghulis (
+see https://www.npmjs.com/package/morghulis)
 
-# 5. how to use valar_channel
+# 5. how to register a channel handler for Morghulis async methods
 
-5.1 set HANDLER_MAPPING in settings
+## 5.1 create a handler
 
 ```python
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+import time
+from valar.channels.sender import ValarChannelSender
+from valar.channels.counter import Counter
+
+
+def valar_test_handler(sender: ValarChannelSender):
+    data = sender.data
+    length = data.get('length', 100)
+    counter = Counter(length)
+    for i in range(length):
+        time.sleep(0.1)
+        tick = counter.tick()
+        tick.update({'name': 'test1'})
+        sender.load(tick)
 ```
 
-5.2 create a handler
+### 5.2 create a dict (e.g. using the name 'channel_mapping') to save your handler
+
+- I'd like to put it in the root urls.py, you can put it anywhere
 
 ```python
-from valar.channels.sender import ValarSocketSender
+channel_mapping = {
+    'test': valar_test_handler,
+}
+```
 
+## 5.2 register the channel_mapping in the settings.py
 
-def test_handler(sender: ValarSocketSender):
-    data = sender.data
-    sender.load(data)
+```python
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
 ```
 
-5.3 register handler in channel_mapping
+### 5.4 you can copy the following codes to your urls.py
 
 ```python
+import json
+
+from django.urls import path
+
+from valar.classes.valar_response import ValarResponse
+from valar.views.handler import valar_test_handler
+
+
+def test_request(request):
+    body = json.loads(request.body)
+    return ValarResponse(body)
+
+
+urlpatterns = [
+    path('test', test_request),
+]
+
 channel_mapping = {
-    'test': test_handler,
+    'test_handler': valar_test_handler,
 }
+
 ```

{valar-1.2.3 → valar-1.2.4}/README.md

@@ -1,6 +1,6 @@
 valar for morghulis
 
-# 1. install
+# 1. installation
 
 ```shell
 pip install valar
@@ -9,24 +9,16 @@ pip install valar
 # 1. settings
 
 ```python
-from django.core.management.utils import get_random_secret_key
 from pathlib import Path
 
-"""       Compulsory settings       """
-
+""" Compulsory settings """
 DEBUG = True
 BASE_DIR = Path(__file__).resolve().parent.parent
 BASE_APP = str(BASE_DIR.name)
 DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
-SECRET_KEY = get_random_secret_key()
-
-"""       Valar Options       """
+SECRET_KEY = 'django-insecure-of@tfouoq^_f$l!yki#m=6j7)@&kjri$1_$!mca-=%7=+@f@5^'
 
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
-MONGO_URI = 'mongodb://root:19870120@121.41.111.175:27017/'
-MINIO_URL = "s3://admin:password@120.27.8.186:9000"
-
-"""       Minimized compulsory settings       """
+""" Minimized compulsory settings """
 
 DATABASES = {
     'default': {
@@ -34,29 +26,32 @@ DATABASES = {
         'NAME': BASE_DIR / 'db.sqlite3',
     }
 }
+
 INSTALLED_APPS = [
     'django.contrib.sessions',
     "corsheaders",
     'channels',
     'valar.apps.ValarConfig',
 ]
+
 MIDDLEWARE = [
     'django.contrib.sessions.middleware.SessionMiddleware',
     'corsheaders.middleware.CorsMiddleware',
     'django.middleware.common.CommonMiddleware',
 ]
+
 CHANNEL_LAYERS = {
     "default": {
         "BACKEND": "channels.layers.InMemoryChannelLayer"
     }
 }
+
 CORS_ORIGIN_ALLOW_ALL = True
 CORS_ALLOW_CREDENTIALS = True
 ROOT_URLCONF = "%s.urls" % BASE_APP
 ASGI_APPLICATION = "%s.asgi.application" % BASE_APP
 
-"""       Optional settings       """
-
+""" Optional settings """
 ALLOWED_HOSTS = ['*']
 LANGUAGE_CODE = 'en-us'
 TIME_ZONE = 'Asia/Shanghai'
@@ -67,6 +62,13 @@ SESSION_COOKIE_AGE = 60 * 60
 FILE_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 
+""" Valar Options """
+
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+MONGO_URI = 'mongodb://username:password@host:27017'
+MINIO_URL = "s3://username:password@host:9000"
+MINIO_ROOT = "https://host:9001"
+
 ```
 
 # 2. asgi
@@ -75,6 +77,7 @@ DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 from django.core.asgi import get_asgi_application
 from channels.routing import ProtocolTypeRouter, URLRouter
 from django.urls import re_path
+
 from valar.channels.consumer import ValarConsumer
 
 application = ProtocolTypeRouter({
@@ -84,39 +87,77 @@ application = ProtocolTypeRouter({
     ])
 })
 
+
 ```
 
 # 3. migrate
 
-no need, valar will auto migration
+- no need to makemigrations and migrate for valar, valar will auto migration
 
 # 4. root urls
 
-no need, valar will auto set urlpatterns
+no need to provide urls for val, valar will auto set urlpatterns for Morghulis (
+see https://www.npmjs.com/package/morghulis)
 
-# 5. how to use valar_channel
+# 5. how to register a channel handler for Morghulis async methods
 
-5.1 set HANDLER_MAPPING in settings
+## 5.1 create a handler
 
 ```python
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+import time
+from valar.channels.sender import ValarChannelSender
+from valar.channels.counter import Counter
+
+
+def valar_test_handler(sender: ValarChannelSender):
+    data = sender.data
+    length = data.get('length', 100)
+    counter = Counter(length)
+    for i in range(length):
+        time.sleep(0.1)
+        tick = counter.tick()
+        tick.update({'name': 'test1'})
+        sender.load(tick)
 ```
 
-5.2 create a handler
+### 5.2 create a dict (e.g. using the name 'channel_mapping') to save your handler
+
+- I'd like to put it in the root urls.py, you can put it anywhere
 
 ```python
-from valar.channels.sender import ValarSocketSender
+channel_mapping = {
+    'test': valar_test_handler,
+}
+```
 
+## 5.2 register the channel_mapping in the settings.py
 
-def test_handler(sender: ValarSocketSender):
-    data = sender.data
-    sender.load(data)
+```python
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
 ```
 
-5.3 register handler in channel_mapping
+### 5.4 you can copy the following codes to your urls.py
 
 ```python
+import json
+
+from django.urls import path
+
+from valar.classes.valar_response import ValarResponse
+from valar.views.handler import valar_test_handler
+
+
+def test_request(request):
+    body = json.loads(request.body)
+    return ValarResponse(body)
+
+
+urlpatterns = [
+    path('test', test_request),
+]
+
 channel_mapping = {
-    'test': test_handler,
+    'test_handler': valar_test_handler,
 }
+
 ```

{valar-1.2.3 → valar-1.2.4}/setup.py

@@ -16,7 +16,7 @@ requires = [
 
 setup(
     name="valar",  # 包名
-    version="1.2.3",  # 版本号
+    version="1.2.4",  # 版本号
     author="LYP",  # 作者
     author_email="liuyinpeng@buaa.edu.cn",  # 邮箱
     description="valar for morghulis",  # 简短描述

{valar-1.2.3 → valar-1.2.4/src/valar.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: valar
-Version: 1.2.3
+Version: 1.2.4
 Summary: valar for morghulis
 Home-page: https://gitee.com/GRIFFIN120/valar_dev
 Author: LYP
@@ -28,7 +28,7 @@ Dynamic: summary
 
 valar for morghulis
 
-# 1. install
+# 1. installation
 
 ```shell
 pip install valar
@@ -37,24 +37,16 @@ pip install valar
 # 1. settings
 
 ```python
-from django.core.management.utils import get_random_secret_key
 from pathlib import Path
 
-"""       Compulsory settings       """
-
+""" Compulsory settings """
 DEBUG = True
 BASE_DIR = Path(__file__).resolve().parent.parent
 BASE_APP = str(BASE_DIR.name)
 DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
-SECRET_KEY = get_random_secret_key()
-
-"""       Valar Options       """
+SECRET_KEY = 'django-insecure-of@tfouoq^_f$l!yki#m=6j7)@&kjri$1_$!mca-=%7=+@f@5^'
 
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
-MONGO_URI = 'mongodb://root:19870120@121.41.111.175:27017/'
-MINIO_URL = "s3://admin:password@120.27.8.186:9000"
-
-"""       Minimized compulsory settings       """
+""" Minimized compulsory settings """
 
 DATABASES = {
     'default': {
@@ -62,29 +54,32 @@ DATABASES = {
         'NAME': BASE_DIR / 'db.sqlite3',
     }
 }
+
 INSTALLED_APPS = [
     'django.contrib.sessions',
     "corsheaders",
     'channels',
     'valar.apps.ValarConfig',
 ]
+
 MIDDLEWARE = [
     'django.contrib.sessions.middleware.SessionMiddleware',
     'corsheaders.middleware.CorsMiddleware',
     'django.middleware.common.CommonMiddleware',
 ]
+
 CHANNEL_LAYERS = {
     "default": {
         "BACKEND": "channels.layers.InMemoryChannelLayer"
     }
 }
+
 CORS_ORIGIN_ALLOW_ALL = True
 CORS_ALLOW_CREDENTIALS = True
 ROOT_URLCONF = "%s.urls" % BASE_APP
 ASGI_APPLICATION = "%s.asgi.application" % BASE_APP
 
-"""       Optional settings       """
-
+""" Optional settings """
 ALLOWED_HOSTS = ['*']
 LANGUAGE_CODE = 'en-us'
 TIME_ZONE = 'Asia/Shanghai'
@@ -95,6 +90,13 @@ SESSION_COOKIE_AGE = 60 * 60
 FILE_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 
+""" Valar Options """
+
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+MONGO_URI = 'mongodb://username:password@host:27017'
+MINIO_URL = "s3://username:password@host:9000"
+MINIO_ROOT = "https://host:9001"
+
 ```
 
 # 2. asgi
@@ -103,6 +105,7 @@ DATA_UPLOAD_MAX_MEMORY_SIZE = 1024 * 1024 * 100
 from django.core.asgi import get_asgi_application
 from channels.routing import ProtocolTypeRouter, URLRouter
 from django.urls import re_path
+
 from valar.channels.consumer import ValarConsumer
 
 application = ProtocolTypeRouter({
@@ -112,39 +115,77 @@ application = ProtocolTypeRouter({
     ])
 })
 
+
 ```
 
 # 3. migrate
 
-no need, valar will auto migration
+- no need to makemigrations and migrate for valar, valar will auto migration
 
 # 4. root urls
 
-no need, valar will auto set urlpatterns
+no need to provide urls for val, valar will auto set urlpatterns for Morghulis (
+see https://www.npmjs.com/package/morghulis)
 
-# 5. how to use valar_channel
+# 5. how to register a channel handler for Morghulis async methods
 
-5.1 set HANDLER_MAPPING in settings
+## 5.1 create a handler
 
 ```python
-HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
+import time
+from valar.channels.sender import ValarChannelSender
+from valar.channels.counter import Counter
+
+
+def valar_test_handler(sender: ValarChannelSender):
+    data = sender.data
+    length = data.get('length', 100)
+    counter = Counter(length)
+    for i in range(length):
+        time.sleep(0.1)
+        tick = counter.tick()
+        tick.update({'name': 'test1'})
+        sender.load(tick)
 ```
 
-5.2 create a handler
+### 5.2 create a dict (e.g. using the name 'channel_mapping') to save your handler
+
+- I'd like to put it in the root urls.py, you can put it anywhere
 
 ```python
-from valar.channels.sender import ValarSocketSender
+channel_mapping = {
+    'test': valar_test_handler,
+}
+```
 
+## 5.2 register the channel_mapping in the settings.py
 
-def test_handler(sender: ValarSocketSender):
-    data = sender.data
-    sender.load(data)
+```python
+HANDLER_MAPPING = "%s.urls.channel_mapping" % BASE_APP
 ```
 
-5.3 register handler in channel_mapping
+### 5.4 you can copy the following codes to your urls.py
 
 ```python
+import json
+
+from django.urls import path
+
+from valar.classes.valar_response import ValarResponse
+from valar.views.handler import valar_test_handler
+
+
+def test_request(request):
+    body = json.loads(request.body)
+    return ValarResponse(body)
+
+
+urlpatterns = [
+    path('test', test_request),
+]
+
 channel_mapping = {
-    'test': test_handler,
+    'test_handler': valar_test_handler,
 }
+
 ```