# language-recognition-api-develop

**Repository Path**: lilinxx/language-recognition-api-develop

## Basic Information

- **Project Name**: language-recognition-api-develop
- **Description**: ## 基本介绍
```
该工程为语种识别实现，主要用于语种识别接口发布。
开发环境python3

共支持97国语言，语种缩略说明（常见）：
zh	汉语	en	英语	fr	法语
ar	阿拉伯语	mn	蒙古语	de	德语
ru	俄语	es	西班牙语	ko	韩语
ja	日语	th	泰语	it	意大利语

```
## 开发原则
```
* 日志规则参见utils/log.py，使用:from utils.log import *
* api.py为接口实现文件，可直接运行测试，内部可指定端口
* utils/confPaser.py 配置文件读取，使用:from utils.confPaser import *
* utils/result.py 返回结果定义
```
## 目录结构
```
├─ bin # 启停目录
├─ language
│  └─ lang_recognition.py # 语种识别实现
├─ utils # 常用函数定义目录
│  └─ log.py # 日志定义
│  └─ confPaser.py  # 配置文件解析
│  └─ result.py  # 返回
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-09-27
- **Last Updated**: 2021-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 基本介绍
```
该工程为语种识别实现，主要用于语种识别接口发布。
开发环境python3

共支持97国语言，语种缩略说明（常见）：
zh	汉语	en	英语	fr	法语
ar	阿拉伯语	mn	蒙古语	de	德语
ru	俄语	es	西班牙语	ko	韩语
ja	日语	th	泰语	it	意大利语

```
## 开发原则
```
* 日志规则参见utils/log.py，使用:from utils.log import *
* api.py为接口实现文件，可直接运行测试，内部可指定端口
* utils/confPaser.py 配置文件读取，使用:from utils.confPaser import *
* utils/result.py 返回结果定义
```
## 目录结构
```
├─ bin # 启停目录
├─ language
│  └─ lang_recognition.py # 语种识别实现
├─ utils # 常用函数定义目录
│  └─ log.py # 日志定义
│  └─ confPaser.py  # 配置文件解析
│  └─ result.py  # 返回结果定义，方便json格式化
├─ conf 
│  └─ conf.cfg # 配置文件
├─ api.py # 接口实现
├─ README.md
├─ requirements.txt # 依赖包
```
## 工程编译
* 生成 requirements.txt
```
# 每次提交代码工程之前需要重新生成requirements.txt，然后提交
生成方式，Terminal窗口中 
pip freeze > requirements.txt
```

* 编译
```
1. compile目录中 python compile.py
    生成target目录，将整个target目录部署到指定位置
```

## 启动方法
### 安装配置
```
 建议使用虚拟环境，防止各个工程依赖环境出现版本冲突
```
* 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. 更改conf.cfg中的端口
    2. bin目录中 sh start.sh

* 停止
    1. bin目录中 sh stop.sh    
    
```

### 接口定义
* 输入

| 参数 | 类型 | 是否必须 |详细说明 |
| ------ | ------ | ------ | ------ |
| text | string | 是 | 待处理文本 |

* 输出

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

* 示例
```
http://127.0.0.1:8018/language?text=我爱北京天安门
{
	"isSuc": false,
	"errMsg": null,
	"res": "ch"
}
```