Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dev-chenxing/neighborhood-locator

A simple Python script that helps finding its neighborhood given a street address and street data | 自动化分居委以提高街道工作人员工作效率
https://github.com/dev-chenxing/neighborhood-locator

javascript openpyxl pandas python rich rich-console xlsx yargs

Last synced: 1 day ago
JSON representation

A simple Python script that helps finding its neighborhood given a street address and street data | 自动化分居委以提高街道工作人员工作效率

Awesome Lists containing this project

README

        

# 自动化分居委

自动化分居委是一个用 Python 和 JavaScript 写的简易小工具,目的在于将给定的某街道辖区内的任一地址对应到其所属社区(aka 居委)

## 如何使用 JavaScript 版(推荐)

### 安装 Node 和 Node 包

安装 [Node.js v11.9.0+](https://nodejs.org/en/download).

克隆这个仓库到你的电脑:

```bash
git clone https://github.com/dev-chenxing/neighborhood-locator.git
```

cd 到克隆目录下面后,使用 npm 安装所需的包:

```powershell
cd neighborhood-locator
npm install
```

### 运行脚本

#### 手動操作

在命令行运行 JavaScript 脚本:

```bash
node ./neighborhood_locator.js "./生活美容美发和快递服务类企业底册名单.xls" 住所 所在居委 --log-level ERROR --create-copy true --delete-unknown false
```

这里,``是输入地址所在的 Excel 表文件名。

脚本运行完毕时,命令行会输出地址和所属居委的列表,同时输入的 Excel 表也会更新所属居委列表。

#### Shell Script 全自動 (不推荐)

`neighborhood-locator`腳本是針對某特定格式的辦公表格而寫的全自動腳本,只需一行命令即可完成 99%分居委的工作,但需要安裝`Shell`, 如:[Git Bash](https://git-scm.com/downloads)

```bash
chmod +x ./neighborhood-locator
./neighborhood-locator 2024年5月区新开办企业情况清单.xlsx <區> <街道>
```

## 如何使用 Python 版

### 前期准备

安装`Python 3.9+`. 如果`Python 3.9+`不支持你的电脑系统,请使用[JavaScript 版](#如何使用javascript版)

### 安装

克隆这个仓库到你的电脑:

```bash
git clone https://github.com/dev-chenxing/neighborhood-locator.git
```

cd 到克隆目录下面后,创建虚拟环境:

```powershell
cd neighborhood-locator
python -m venv venv
venv/Scripts/activate # source venv/bin/activate 如果是Linux系统
```

使用 pip 安装所需的 Python 包:

```bash
pip install -r requirements.txt
```

### 最后一步

在命令行运行 Python 脚本:

```bash
python locator.py
```

这里,``是输入地址所在的 Excel 表文件名,``是表中地址一列的表头名。
例如,如果输入的 Excel 表是`新开办企业情况清单.xlsx`, `住所`是地址一列的表头名,则应运行:

```bash
python locator.py 新开办企业情况清单.xlsx 住所
```

脚本运行完毕时,命令行会输出地址和所属居委的列表,同时输入的 Excel 表也会更新所属居委列表。