Merge branch 'developer' into deploy

.rmcache.bash

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+
+### THE DELETE FILES
+find . -type f -name '*.pyc' -delete
+
+### THE DELETE DIRECTORY
+## .tox/*
+find .tox -path "*" -delete
+## ./build/*
+find ./build -path "*" ! -name "build" -delete
+## ./src/com.dvsnier.*.egg-info
+find ./src -path "*com.dvsnier*" -delete
+# find ./src -path "*com.dvsnier.*" -type d -exec rm -r {} +
+# find ./src -path "*com.dvsnier.*" -type f -delete
+## ./dist/*
+find ./dist -path "*" ! -name "dist" -delete
+## ./out/log/*
+find ./out/log -path "*" ! -name "log" -delete
+## __pycache__
+find . -type d -name __pycache__ -exec rm -r {} +

.rmcache.ps1

@@ -0,0 +1,24 @@
+#
+# the airticle link reference:
+#
+#   1. https://docs.microsoft.com/zh-cn/powershell/scripting/samples/working-with-files-and-folders?view=powershell-7.1
+#   2. https://docs.microsoft.com/zh-cn/powershell/scripting/samples/working-with-registry-keys?view=powershell-7.1
+#
+
+### THE DELETE FILES
+Get-ChildItem -Path . -include *.pyc -Recurse | Remove-Item
+
+### THE DELETE DIRECTORY
+## .tox/*
+Remove-Item -Path .\.tox -Recurse
+## ./build/*
+Remove-Item -Path .\build\* -Recurse
+## ./src/com.dvsnier.*.egg-info
+Remove-Item -Path .\src\com.dvsnier.*.egg-info -Recurse
+# Get-ChildItem -Path .\src\com.dvsnier.*.egg-info -Recurse
+## ./dist/*
+Remove-Item -Path .\dist\* -Recurse
+## ./out/log/*
+Remove-Item -Path .\out\log\* -Recurse
+## __pycache__
+Get-ChildItem -Path . -include __pycache__ -Recurse | Remove-Item

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // 使用 IntelliSense 了解相关属性。 
+    // 悬停以查看现有属性的描述。
+    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: 当前文件",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,101 @@
+{
+    "[python]": {
+        "editor.defaultFormatter": "ms-python.python"
+    },
+    // "python.analysis.extraPaths": [
+    //     "./src",
+    //     "./mock",
+    //     "./test",
+    //     // darwin
+    //     "./venv2/bin",
+    //     "./venv2/lib/python2.7/site-packages",
+    //     "./venv/bin",
+    //     "./venv/lib/python3.7/site-packages",
+    //     // win32
+    //     "./venv2/Scripts",
+    //     "./venv2/Lib/site-packages",
+    //     "./venv/Scripts",
+    //     "./venv/Lib/site-packages",
+    // ],
+    "python.analysis.logLevel": "Trace",
+    // "python.analysis.watchSearchPaths": true,
+    "python.analysis.typeCheckingMode": "basic",
+    // "python.analysis.typeCheckingMode": "strict",
+    "python.analysis.diagnosticMode": "openFilesOnly",
+    // https://github.com/microsoft/pylance-release/blob/main/DIAGNOSTIC_SEVERITY_RULES.md
+    "python.analysis.diagnosticSeverityOverrides": {},
+    "python.analysis.useLibraryCodeForTypes": true,
+    "python.analysis.autoImportCompletions": true,
+    "python.autoComplete.addBrackets": true,
+    "python.analysis.completeFunctionParens": true,
+    // "python.autoComplete.addBrackets": false,
+    // "python.analysis.completeFunctionParens": false,
+    // https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance#settings-and-customization
+    // "python.autoComplete.extraPaths": [
+    //     "./src",
+    //     "./mock",
+    //     "./tests",
+    //     // darwin
+    //     "./venv2/bin",
+    //     "./venv2/lib/python2.7/site-packages",
+    //     "./venv/bin",
+    //     "./venv/lib/python3.7/site-packages",
+    //     // win32
+    //     "./venv2/Scripts",
+    //     "./venv2/Lib/site-packages",
+    //     "./venv/Scripts",
+    //     "./venv/Lib/site-packages",
+    // ],
+    // "python.autoUpdateLanguageServer": true,
+    // "python.defaultInterpreterPath": "${workspaceFolder}/venv2/bin/python",
+    // "python.defaultInterpreterPath": "venv2/bin/python",
+    // "python.diagnostics.sourceMapsEnabled": true,
+    "python.envFile": "${workspaceFolder}/.env",
+    // "python.pythonPath": "${workspaceFolder}/venv2/bin/python",
+    // "python.pythonPath": "venv2/bin/python",
+    // "python.pythonPath": "venv2\\Scripts\\python.exe",
+    "python.formatting.provider": "yapf",
+    // "python.formatting.yapfArgs": [
+    //     "--style",
+    //     "{based_on_style: pep8, indent_width: 4}"
+    // ],
+    "python.formatting.yapfArgs": [
+        "--style",
+        "{based_on_style: pep8 ,indent_width: 4, column_limit: 120}",
+    ],
+    // "python.languageServer": "Jedi",
+    "python.languageServer": "Pylance",
+    // "python.languageServer": "Microsoft",
+    // "python.logging.level": "info",
+    "python.linting.enabled": true,
+    "python.linting.flake8Enabled": true,
+    "python.linting.flake8Args": [
+        "--max-line-length=140",
+        // "--ignore=E251",
+        "--verbose",
+    ],
+    "python.linting.ignorePatterns": [
+        ".vscode/*.py",
+        "**/site-packages/**/*.py"
+    ],
+    "python.linting.lintOnSave": true,
+    "python.linting.pylintEnabled": false,
+    // https://github.com/microsoft/vscode-python/discussions/15997#discussioncomment-636389
+    // "python.testing.unittestArgs": [
+    //     "-v",
+    //     "-s",
+    //     "./tests",
+    //     "-p",
+    //     "test_*.py"
+    // ],
+    // "python.testing.autoTestDiscoverOnSaveEnabled": true,
+    "python.testing.cwd": "${workspaceFolder}",
+    "python.testing.nosetestsEnabled": false,
+    "python.testing.pytestEnabled": false,
+    "python.testing.promptToConfigure": false,
+    "python.testing.unittestEnabled": true,
+    // "workbench.settings.openDefaultSettings": true,
+    // "workbench.settings.editor": "ui",
+    // "workbench.settings.openDefaultKeybindings": true,
+    // "workbench.settings.useSplitJSON": true,
+}