## 基本介绍
```
该工程为词性分析接口实现，主要用于词性分析接口发布。
开发环境python3

词性分析使用算法贝叶斯
中文词性分析：jieba
英文词性分析：nltk
```
## 开发原则
```
* 日志规则参见utils/log.py，使用:from utils.log import *
* api.py为接口实现文件，可直接运行测试，内部可指定端口
* utils/confPaser.py 配置文件读取，使用:from utils.confPaser import *
* utils/result.py 返回结果定义
```
## 目录结构
```
├─ tagCN  # 中文目录
│  └─ tag_CN.py # 中文实现函数
├─ tagEN # 英文目录
│  └─ tag_CN.py  # 英文实现函数
├─ utils # 常用函数定义目录
│  └─ log.py # 日志定义
│  └─ confPaser.py  # 配置文件解析
│  └─ result.py  # 返回结果定义，方便json格式化
├─ conf 
│  └─ conf.cfg # 配置文件
│  └─ dic_en.txt # 英文配置文件
│  └─ dic_cn.txt # 中文配置文件
├─ api.py # 接口实现
├─ README.md
├─ requirements.txt # 依赖包
```
## 启动方法
### 安装配置
```
 建议使用虚拟环境，防止各个工程依赖环境出现版本冲突
```
* windows环境（pycharm）
```
* 安装python3环境，设置环境变量（前提）
* 配置虚拟环境（隔离其他工程）
    File | Settings | Project: xxx | Project Interpreter
    add >> 填写虚拟环境目录（默认工程内部venv目录）>> base Interpreter(已经安装的基础Python环境)
* 安装依赖环境 
    Terminal窗口中 
    pip install -r requirements.txt
```
* linux 环境
```
* 安装python3（前提）
* pip3 install virtualenv
* 在工程目录下，创建虚拟环境env  
    virtualenv env
    
* 启用此环境，后续命令行前面出现（env）代表此时环境已切换，
    source ./env/bin/activate
    
* 之后执行pip python3 等指令，相当于是在此环境中执行
    pip3 install -r requirements.txt
    
* 查看已安装依赖，
    pip3 list
    
* 退出虚拟环境，
    deactivate
    
```
* 启动
```
1. 更改api.py中的端口
2. python3 api.py
```

* 生成 requirements.txt
```
# 每次提交代码工程之前需要重新生成requirements.txt，然后提交
生成方式，Terminal窗口中 
pip freeze > requirements.txt
```

### 接口定义
* 输入

| 参数 | 类型 | 是否必须 |详细说明 |
| ------ | ------ | ------ | ------ |
| text | string | 是 | 待处理文本 |
| lang | string | 是 | 文本语言cn/en |

* 输出

| 参数 | 类型 | 详细说明 |
| ------ | ------ | ------ |
| isSuc | boolean | 是否调用成功 |
| errMsg | string | 接口错误信息 |
| res | string | 类别 |

* 示例
```
http://127.0.0.1:8018/tag?lang=en&text=I have a beautiful dog.
{
	"isSuc": true,
	"errMsg": null,
	"res": [{
		"word": "I",
		"tag": "PRP",
		"pos": "代词"
	}, {
		"word": "have",
		"tag": "VBP",
		"pos": "动词"
	}, {
		"word": "a",
		"tag": "DT",
		"pos": "限定符"
	}, {
		"word": "beautiful",
		"tag": "JJ",
		"pos": "形容词"
	}, {
		"word": "dog",
		"tag": "NN",
		"pos": "名词"
	}, {
		"word": ".",
		"tag": ".",
		"pos": "标点"
	}]
}

http://127.0.0.1:8018/tag?lang=cn&text=我爱北京天安门
{
	"isSuc": true,
	"errMsg": null,
	"res": [{
		"word": "我",
		"tag": "R",
		"pos": "代词"
	}, {
		"word": "爱",
		"tag": "V",
		"pos": "动词"
	}, {
		"word": "北京",
		"tag": "NS",
		"pos": "名词"
	}, {
		"word": "天安门",
		"tag": "NS",
		"pos": "名词"
	}]
}
```

* 结果说明
```
中文：
    名词-NR;NT;NS;NZ;N
    动词-VC;VE;VV;VD;VN;V
    数词-M
    代词-PN;DT;R
    副词-AD;DG;D
    连词-C
    形容词-A;AG;AD;AN
    语气词-Y
    介词-P
    方位词-F
    助词-U
    时间词-T
    标点-W;X
    量词-Q
    拟声词-O
    区别词-B
    英文词-ENG
英文：
    并列连词-CC
    名词-NNS;NNP;NN
    感叹词-UH
    基数词-CD
    动词-VB;VBD;VBG;VBN;MD;VBP;VBZ
    限定符-DT;PDT;WDT
    存在词-EX
    外来词-FW
    所有格结尾-POS
    介词-IN
    代词-PRP;PRP$;WP;WP$
    形容词-JJ;JJR;JJS
    副词-RB;RBR;RBS;WRB
    符号-SYM
    助词-暂无
    符号-SYM
```

李林/pos-tagging-api-develop

简介

发行版

贡献者

近期动态

李林/pos-tagging-api-develop .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

李林/pos-tagging-api-develop