Compare commits
No commits in common. "87aa249f5d3b4b493a069e0f75ff05a17be17d51" and "18e4300fe88da866844122f6ebf717ccd152920c" have entirely different histories.
87aa249f5d
...
18e4300fe8
297
ahserver.egg-info/PKG-INFO
Executable file
297
ahserver.egg-info/PKG-INFO
Executable file
@ -0,0 +1,297 @@
|
|||||||
|
Metadata-Version: 2.1
|
||||||
|
Name: ahserver
|
||||||
|
Version: 0.3.4
|
||||||
|
Summary: ahserver
|
||||||
|
Home-page: https://github.com/yumoqing/ahserver
|
||||||
|
Author: yumoqing
|
||||||
|
Author-email: yumoqing@gmail.com
|
||||||
|
Classifier: Operating System :: OS Independent
|
||||||
|
Classifier: Programming Language :: Python :: 3
|
||||||
|
Classifier: License :: OSI Approved :: MIT License
|
||||||
|
Description-Content-Type: text/markdown
|
||||||
|
|
||||||
|
# ahserver
|
||||||
|
|
||||||
|
ahserver is a http(s) server base on aiohttp asynchronous framework.
|
||||||
|
|
||||||
|
ahserver capabilities:
|
||||||
|
* user authorization and authentication support
|
||||||
|
* https support
|
||||||
|
* processor for registed file type
|
||||||
|
* pre-defined variables and function can be called by processors
|
||||||
|
* multiple database connection and connection pool
|
||||||
|
* a easy way to wrap SQL
|
||||||
|
* configure data from json file stored at ./conf/config.json
|
||||||
|
* upload file auto save under config.filesroot folder
|
||||||
|
* i18n support
|
||||||
|
* processors include:
|
||||||
|
+ 'dspy' file subffix by '.dspy', is process as a python script
|
||||||
|
+ 'tmpl' files subffix by '.tmpl', is process as a template
|
||||||
|
+ 'md' files subffix by '.md', is process as a markdown file
|
||||||
|
+ 'xlsxds' files subffix by '.xlsxds' is process as a data source from xlsx file
|
||||||
|
+ 'sqlds' files subffixed by '.sqlds' is process as a data source from database via a sql command
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
see requirements.txt
|
||||||
|
|
||||||
|
[pyutils](https://github.com/yumoqing/pyutils)
|
||||||
|
|
||||||
|
[sqlor](https://github.com/yumoqing/sqlor)
|
||||||
|
|
||||||
|
## How to use
|
||||||
|
see ah.py
|
||||||
|
|
||||||
|
```
|
||||||
|
from ahserver.configuredServer import ConfiguredServer
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
server = ConfiguredServer()
|
||||||
|
server.run()
|
||||||
|
```
|
||||||
|
|
||||||
|
## Folder structure
|
||||||
|
|
||||||
|
+ app
|
||||||
|
+ |-ah.py
|
||||||
|
+ |--ahserver
|
||||||
|
+ |-conf
|
||||||
|
+ |-config.json
|
||||||
|
+ |-i18n
|
||||||
|
|
||||||
|
## Configuration file content
|
||||||
|
ahserver using json file format in its configuration, the following is a sample:
|
||||||
|
```
|
||||||
|
{
|
||||||
|
"databases":{
|
||||||
|
"aiocfae":{
|
||||||
|
"driver":"aiomysql",
|
||||||
|
"async_mode":true,
|
||||||
|
"coding":"utf8",
|
||||||
|
"dbname":"cfae",
|
||||||
|
"kwargs":{
|
||||||
|
"user":"test",
|
||||||
|
"db":"cfae",
|
||||||
|
"password":"test123",
|
||||||
|
"host":"localhost"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"cfae":{
|
||||||
|
"driver":"mysql.connector",
|
||||||
|
"coding":"utf8",
|
||||||
|
"dbname":"cfae",
|
||||||
|
"kwargs":{
|
||||||
|
"user":"test",
|
||||||
|
"db":"cfae",
|
||||||
|
"password":"test123",
|
||||||
|
"host":"localhost"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"website":{
|
||||||
|
"paths":[
|
||||||
|
["$[workdir]$/../usedpkgs/antd","/antd"],
|
||||||
|
["$[workdir]$/../wolon",""]
|
||||||
|
],
|
||||||
|
"host":"0.0.0.0",
|
||||||
|
"port":8080,
|
||||||
|
"coding":"utf-8",
|
||||||
|
"ssl":{
|
||||||
|
"crtfile":"$[workdir]$/conf/www.xxx.com.pem",
|
||||||
|
"keyfile":"$[workdir]$/conf/www.xxx.com.key"
|
||||||
|
},
|
||||||
|
"indexes":[
|
||||||
|
"index.html",
|
||||||
|
"index.tmpl",
|
||||||
|
"index.dspy",
|
||||||
|
"index.md"
|
||||||
|
],
|
||||||
|
"visualcoding":{
|
||||||
|
"default_root":"/samples/vc/test",
|
||||||
|
"userroot":{
|
||||||
|
"ymq":"/samples/vc/ymq",
|
||||||
|
"root":"/samples/vc/root"
|
||||||
|
},
|
||||||
|
"jrjpath":"/samples/vc/default"
|
||||||
|
},
|
||||||
|
"processors":[
|
||||||
|
[".xlsxds","xlsxds"],
|
||||||
|
[".sqlds","sqlds"],
|
||||||
|
[".tmpl.js","tmpl"],
|
||||||
|
[".tmpl.css","tmpl"],
|
||||||
|
[".html.tmpl","tmpl"],
|
||||||
|
[".tmpl","tmpl"],
|
||||||
|
[".dspy","dspy"],
|
||||||
|
[".md","md"]
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"langMapping":{
|
||||||
|
"zh-Hans-CN":"zh-cn",
|
||||||
|
"zh-CN":"zh-cn",
|
||||||
|
"en-us":"en",
|
||||||
|
"en-US":"en"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### database configuration
|
||||||
|
the ahserver using packages for database engines are:
|
||||||
|
* oracle:cx_Oracle
|
||||||
|
* mysql:mysql-connector
|
||||||
|
* postgresql:psycopg2
|
||||||
|
* sql server:pymssql
|
||||||
|
|
||||||
|
however, you can change it, but must change the "driver" value the the package name in the database connection definition.
|
||||||
|
|
||||||
|
in the databases section in config.json, you can define one or more database connection, and also, it support many database engine, just as ORACLE,mysql,postgreSQL.
|
||||||
|
define a database connnect you need follow the following json format.
|
||||||
|
|
||||||
|
* mysql or mariadb
|
||||||
|
```
|
||||||
|
"metadb":{
|
||||||
|
"driver":"mysql.connector",
|
||||||
|
"coding":"utf8",
|
||||||
|
"dbname":"sampledb",
|
||||||
|
"kwargs":{
|
||||||
|
"user":"user1",
|
||||||
|
"db":"sampledb",
|
||||||
|
"password":"user123",
|
||||||
|
"host":"localhost"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
the dbname and "db" should the same, which is the database name in mysql database
|
||||||
|
* Oracle
|
||||||
|
```
|
||||||
|
"db_ora":{
|
||||||
|
"driver":"cx_Oracle",
|
||||||
|
"coding":"utf8",
|
||||||
|
"dbname":sampledb",
|
||||||
|
"kwargs":{
|
||||||
|
"user":"user1",
|
||||||
|
"host":"localhost",
|
||||||
|
"dsn":"10.0.185.137:1521/SAMPLEDB"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
* SQL Server
|
||||||
|
```
|
||||||
|
"db_mssql":{
|
||||||
|
"driver":"pymssql",
|
||||||
|
"coding":"utf8",
|
||||||
|
"dbname":"sampledb",
|
||||||
|
"kwargs":{
|
||||||
|
"user":"user1",
|
||||||
|
"database":"sampledb",
|
||||||
|
"password":"user123",
|
||||||
|
"server":"localhost",
|
||||||
|
"port":1433,
|
||||||
|
"charset":"utf8"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
* PostgreSQL
|
||||||
|
```
|
||||||
|
"db_pg":{
|
||||||
|
"driver":"psycopg2",
|
||||||
|
"dbname":"testdb",
|
||||||
|
"coding":"utf8",
|
||||||
|
"kwargs":{
|
||||||
|
"database":"testdb",
|
||||||
|
"user":"postgres",
|
||||||
|
"password":"pass123",
|
||||||
|
"host":"127.0.0.1",
|
||||||
|
"port":"5432"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
### https support
|
||||||
|
|
||||||
|
In config.json file, config.website.ssl need to set(see above)
|
||||||
|
|
||||||
|
### website configuration
|
||||||
|
#### paths
|
||||||
|
ahserver can serve its contents (static file, dynamic contents render by its processors) resided on difference folders on the server file system.
|
||||||
|
ahserver finds a content identified by http url in order the of the paths specified by "paths" lists inside "website" definition of config.json file
|
||||||
|
#### processors
|
||||||
|
all the prcessors ahserver using, must be listed here.
|
||||||
|
#### host
|
||||||
|
by defaualt, '0.0.0.0'
|
||||||
|
#### port
|
||||||
|
by default, 8080
|
||||||
|
#### coding
|
||||||
|
ahserver recomments using 'utf-8'
|
||||||
|
|
||||||
|
### langMapping
|
||||||
|
|
||||||
|
the browsers will send 'Accept-Language' are difference even if the same language. so ahserver using a "langMapping" definition to mapping multiple browser lang to same i18n file
|
||||||
|
|
||||||
|
|
||||||
|
## international
|
||||||
|
|
||||||
|
ahserver using MiniI18N in appPublic modules in pyutils package to implements i18n support
|
||||||
|
|
||||||
|
it will search translate text in ms* txt file in folder named by language name inside i18n folder in workdir folder, workdir is the folder where the ahserver program resided or identified by command line paraments.
|
||||||
|
|
||||||
|
## performance
|
||||||
|
|
||||||
|
To be list here
|
||||||
|
|
||||||
|
## Behind the nginx
|
||||||
|
when ahserver running behind the nginx, nginx should be forward following header to ahserver
|
||||||
|
|
||||||
|
* X-Forwarded-For: client real ip
|
||||||
|
* X-Forwarded-Scheme: scheme in client browser
|
||||||
|
* X-Forwarded-Host: host in client browser
|
||||||
|
* X-Forwarded-Url: url in client browser
|
||||||
|
|
||||||
|
## environment for processors
|
||||||
|
|
||||||
|
When coding in processors, ahserver provide some environment stuff for build apllication, there are modules, functions, classes and variables
|
||||||
|
|
||||||
|
|
||||||
|
### modules:
|
||||||
|
* time
|
||||||
|
* datetime
|
||||||
|
* random
|
||||||
|
* json
|
||||||
|
|
||||||
|
### functions:
|
||||||
|
* configValue
|
||||||
|
* isNone
|
||||||
|
* int
|
||||||
|
* str
|
||||||
|
* float
|
||||||
|
* type
|
||||||
|
* str2date
|
||||||
|
* str2datetime
|
||||||
|
* curDatetime
|
||||||
|
* uuid
|
||||||
|
* runSQL
|
||||||
|
* runSQLPaging
|
||||||
|
* runSQLIterator
|
||||||
|
* runSQLResultFields
|
||||||
|
* getTables
|
||||||
|
* getTableFields
|
||||||
|
* getTablePrimaryKey
|
||||||
|
* getTableForignKeys
|
||||||
|
* folderInfo
|
||||||
|
* abspath
|
||||||
|
* request2ns
|
||||||
|
* CRUD
|
||||||
|
* data2xlsx
|
||||||
|
* xlsxdata
|
||||||
|
* openfile
|
||||||
|
* i18n
|
||||||
|
* i18nDict
|
||||||
|
* absurl
|
||||||
|
* abspath
|
||||||
|
* request2ns
|
||||||
|
|
||||||
|
### variables
|
||||||
|
* resource
|
||||||
|
* terminalType
|
||||||
|
|
||||||
|
### classes
|
||||||
|
* ArgsConvert
|
||||||
36
ahserver.egg-info/SOURCES.txt
Executable file
36
ahserver.egg-info/SOURCES.txt
Executable file
@ -0,0 +1,36 @@
|
|||||||
|
README.md
|
||||||
|
setup.py
|
||||||
|
ahserver/__init__.py
|
||||||
|
ahserver/auth_api.py
|
||||||
|
ahserver/baseProcessor.py
|
||||||
|
ahserver/configuredServer.py
|
||||||
|
ahserver/dbadmin.py
|
||||||
|
ahserver/dsProcessor.py
|
||||||
|
ahserver/error.py
|
||||||
|
ahserver/filedownload.py
|
||||||
|
ahserver/filestorage.py
|
||||||
|
ahserver/filetest.py
|
||||||
|
ahserver/functionProcessor.py
|
||||||
|
ahserver/globalEnv.py
|
||||||
|
ahserver/llmProcessor.py
|
||||||
|
ahserver/llm_client.py
|
||||||
|
ahserver/loadplugins.py
|
||||||
|
ahserver/myTE.py
|
||||||
|
ahserver/p2p_middleware.py
|
||||||
|
ahserver/processorResource.py
|
||||||
|
ahserver/proxyProcessor.py
|
||||||
|
ahserver/restful.py
|
||||||
|
ahserver/serverenv.py
|
||||||
|
ahserver/sqldsProcessor.py
|
||||||
|
ahserver/uriop.py
|
||||||
|
ahserver/url2file.py
|
||||||
|
ahserver/utils.py
|
||||||
|
ahserver/version.py
|
||||||
|
ahserver/websocketProcessor.py
|
||||||
|
ahserver/xlsxData.py
|
||||||
|
ahserver/xlsxdsProcessor.py
|
||||||
|
ahserver.egg-info/PKG-INFO
|
||||||
|
ahserver.egg-info/SOURCES.txt
|
||||||
|
ahserver.egg-info/dependency_links.txt
|
||||||
|
ahserver.egg-info/requires.txt
|
||||||
|
ahserver.egg-info/top_level.txt
|
||||||
1
ahserver.egg-info/dependency_links.txt
Executable file
1
ahserver.egg-info/dependency_links.txt
Executable file
@ -0,0 +1 @@
|
|||||||
|
|
||||||
17
ahserver.egg-info/requires.txt
Normal file
17
ahserver.egg-info/requires.txt
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
asyncio
|
||||||
|
aiofiles
|
||||||
|
aiodns
|
||||||
|
cchardet
|
||||||
|
aiohttp
|
||||||
|
aiohttp_session
|
||||||
|
aiohttp_auth_autz
|
||||||
|
aiohttp-cors
|
||||||
|
aiomysql
|
||||||
|
aioredis
|
||||||
|
psycopg2-binary
|
||||||
|
aiopg
|
||||||
|
jinja2
|
||||||
|
ujson
|
||||||
|
openpyxl
|
||||||
|
pillow
|
||||||
|
py-natpmp
|
||||||
1
ahserver.egg-info/top_level.txt
Executable file
1
ahserver.egg-info/top_level.txt
Executable file
@ -0,0 +1 @@
|
|||||||
|
ahserver
|
||||||
@ -1,7 +1,7 @@
|
|||||||
asyncio
|
asyncio
|
||||||
aiofiles
|
aiofiles
|
||||||
aiodns
|
aiodns
|
||||||
# cchardet
|
cchardet
|
||||||
aiohttp
|
aiohttp
|
||||||
aiohttp_session
|
aiohttp_session
|
||||||
aiohttp_auth_autz
|
aiohttp_auth_autz
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user