A simple package manager and scaffold for python & some other languages.
Project description
pmfp
- version: 4.0.3
- status: dev
- author: hsz
- email: hsz1273327@gmail.com
Description
一个用于管理项目及相关开发的工具
keywords: tool,project_manager
特点
- 可以独立使用功能模块
- 根据模板快速构建项目
- 简单的编译和打包指令
- 快速测试
- 文档维护,支持github page
注意
-
要支持grpc或者protobuf需要安装相关依赖
- 通用的编译工具:protoc
- python:
grpcio
,grpcio-tools
- node:
@grpc/proto-loader
,async
,google-protobuf
,grpc
,lodash
,minimist
Install
python -m pip install pmfp
使用
pmfp现在被设计为两个部分:
项目管理部分
用于快速根据托管在git仓库上的模板仓库项目构造项目调用功能部分
用于为不同的项目提供特定功能
项目管理
项目管理使用的子命令为project
,其整体设计思路是这样:
- 借助git仓库来保存组件模板.
- 每个组件模板使用jinja2作为模板引擎,允许使用其模板语法
- 用于保存组件模板的git仓库称为资源包(source pack)
- 资源包需要使用一个文件来声明其中注册的组件和默认行为,默认这个文件为资源包根目录下的
.pmfp_template.json
文件.其具体schema可以查看项目的protocol.py
文件中的TEMPLATE_INFO_SCHEMA
对象定义 - 如果资源包声明文件中
template_type
不为components
则说明这是一个模板资源包,我们就可以根据其作为模板构造项目. - 资源包中每个组件都有一个
source
字段,这个字段用于声明组件的位置,如果其中有//
则说明它是引用的另一个资源项目的组件 - 根据模板包构造项目只要指定一个资源包路径即可,其形式为
[[{host}::]{repo_namespace}::]{repo_name}[@{tag}]
- 如果是已有项目要添加组件,则可以使用
[[{host}::]{repo_namespace}::]{repo_name}[@{tag}]//{component_path_str}
- 默认的host为
github.com
,默认的repo_namespace为Project-Manager-With-Git
,默认的tag为latest
,如果tag为latest它会拉取master分支的head.默认的资源仓库可以通过修改~/.pmfprc/config.json
来修改,
另外我们还可以使用cache
子命令管理资源包缓存
资源仓库类型
本项目将所有资源仓库类型分为如下几种:
socket
,专指基于网络的通讯程序,包括http服务,websocket客户端与服务,各种rpc客户端与服务,以及zeromq,webrtc等GUI
,专指图形界面task
专指主动执行的任务,比如一般脚本,定时任务watcher
监听器,被动监听事件的任务,比如监听文件系统的任务,监听消息中间件的任务module
模块,必须被其他程序调用的程序components
组件集合,本身并不能执行doc
文档型组件
项目语言及对应的环境
本项目目前之前如下语言和执行环境组合:
-
language为
py
- env为
venv
,即python的标准库venv生成的c python虚拟环境 - env为
conda
,即anaconda/miniconda生成的c python虚拟环境 - env为
pypy
,即python的标准库venv生成的pypy虚拟环境
- env为
-
language为
js
- env为
node
,即以node为执行环境的javascript的babel标准环境 - env为
webpack
,即以浏览器为执行环境,使用webpack编译项目的javascript的babel标准环境
- env为
-
language为
cython
- env为
venv
,即python的标准库venv生成的c python虚拟环境 - env为
conda
,即anaconda/miniconda生成的c python虚拟环境
- env为
-
language为
go
- env为
gomod
,即golang的gomod模式管理项目
- env为
-
language为
C
- env为
cmake
,即使用cmake作为c语言的项目管理工具
- env为
-
language为
CXX
- env为
cmake
,即使用cmake作为c语言的项目管理工具
- env为
-
language为
md
- env为
http
,即使用markdown作为目标语言托管到http服务器上的纯文档环境
- env为
直接调用功能
支持直接调用功能的子命令包括:
build
快速编译支持的静态语言项目doc
快速构造项目的文档docker image
快速构造docker镜像docker compose
快速构造docker部署配置env
快速构建项目的独立执行环境grpc
快速构造了grpc的客户端和服务端http
用于构造静态http服务和构造http请求和压测pack
打包动态语言构造的项目proto
用于快速构建和编译protobuf文件schema
用于校验jsonschema
test
用于对项目进行测试requires
用于管理依赖
v4.0.4
bug修复
- 修复依赖错误
v4.0.3
bug修复
- 修复了python项目创建时的bug
- 修复依赖不全安装报错的bug
v4.0.2
bug修复
- 修复了python新建环境时报错的bug
改进
- 修改了模板的类型枚举
project as_template
子命令现在也会生成测试依赖了- 修改了
env new
的参数,改为必须有language而非env - 修改
project new
,现在env不是必填的参数,如果指定了template则可以不再指定language,如果没有则必须指定language
v4.0.1
bug修复
- 修正了cache clean命令无法执行的bug
改进
- 修改protocol,支持不声明language的组件
- 修改cc和cxx为全局项目配置
- 修改golang_version,python_version,node_version为全局项目配置
v4.0.0
4.0.0版本在整体架构和使用方式上都做出了大规模修改,现在多数功能都可以脱离pmfprc.json
单独执行.pmfprc.json
的作用现在只是一个存储默认参数的特殊文件,没有也可以执行.同时改用git仓库作为模板保存工具,从而增强扩展性同时减小pmfp的大小
新特性
- 功能性操作全部不再依赖
pmfprc.json
- 使用git仓库作为模板保存位置.
移除的特性(后续版本会回来)
- 移除对python 3.6以下的支持,本工具必须使用python3.6以上的版本
MIT License
Copyright (c) 2020 Python-Tools
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.