Metadata-Version: 2.1
Name: tproj-zombie110year
Version: 0.1.0
Summary: 管理项目模板
Home-page: https://github.com/zombie110year/tproj-py/
Author: zombie110year
Author-email: zombie110year@outlook.com
Maintainer: zombie110year
Maintainer-email: zombie110year@outlook.com
License: MIT
Description: # tproj
        
        tproj 用于管理用户创建的项目模板，一个项目所需的起始文件、目录被包含在一个 zip 格式的压缩包中。
        
        ## install
        
        - 通过源码安装
        
        ```sh
        git clone https://github.com/zombie110year/tproj-py.git
        cd tproj-py && python setup.py install
        ```
        - 通过 pip 安装
        
        ```sh
        pip install tproj-py
        ```
        
        - 通过 pipx 安装
        
        更推荐使用此方法， pipx 是一个用于安装基于 Python 的应用程序的包管理器，相比 pip
        它会创建独立的虚拟环境，不会污染当前 Python 环境。
        
        ```sh
        pipx install tproj-py
        ```
        
        ## usage
        
        tproj 提供名为 tproj 的可执行文件，可以：根据当前目录内容创建归档并自动重命名、
        移动至数据目录中，应用模板归档创建项目，浏览已有的归档。
        
        ### 创建模板归档
        
        创建归档使用 `tproj create` 子命令，默认将当前目录下的所有文件以及子目录中的文件递归地添加到归档中。
        并且通过 stdin 询问归档名称，最终保存到 `$TPROJ_HOME/template` 目录下。
        
        除此之外还提供以下参数：
        
        - `-n/--name` 直接在命令行参数中指定归档名
        - `-f/--force` 覆盖同名归档（默认取消创建）
        
        <!-- TODO
        - `--git-archive` 调用 git archive 子命令来创建归档，在这个参数之后的参数会传递给 git archive 命令
        - `--exclude` 忽略列表，遵守 gitignore 类似的语法，每个实体之间用 `:` 冒号分隔
        - `--ignorefile` 与 `--exclude` 作用相同，但从文件中读取规则，文件采用和 gitignore 相同的语法
          - 如果 `--ignorefile` 与 `--exclude` 同时使用，最后的应用的规则会取并集
        -->
        
        示例
        
        ```sh
        tproj create -n helloworld
        ```
        
        ### 应用模板归档
        
        应用指定的归档，使用 `tproj apply` 子命令，扫描 `$TPROJ_HOME/template` 目录下的模板归档，将其解压至当前工作目录。
        
        具有特性
        
        - 不输入 .zip 后缀，程序会自动添加，如果输入了 .zip 后缀，那么 tproj 将会寻找名称类似于 *.zip.zip 的归档
        - 不需要输入完整的模板名，只要输入足够唯一确定一个模板的名字即可，但如果输入对应了多个模板，程序将终止
        
        除此之外还提供以下参数：
        
        - `-O/--out-dir` 解压至指定目录，而非当前工作目录（不存在会创建）
        
        示例
        
        ```sh
        mkdir helloworld
        cd helloworld
        tproj apply helloworld
        ```
        
        ### 浏览已有模板
        
        浏览已有模板，使用 `tproj ls` 子命令，将列出 `$TRPOJ_HOME/template` 下的归档文件（去除 .zip 后缀）
        
        示例
        
        ```sh
        tproj ls
        ```
        
        ## 参考资料
        
        ### 文件系统
        
        tproj 的所有数据文件都保存在特定的目录中，将这个目录所在的路径称为 `TPROJ_HOME`，
        可以修改环境变量 `TPROJ_HOME` 来修改此目录的路径，如果未设置此环境变量，那么将使用以下默认值：
        
        - 对于 Windows 系统，默认使用 `%APPDATA%\tproj`
        - 对于 Linux 系统，遵守 XDG 规范，默认使用 `$XDG_DATA_HOME/tproj`
          - 有些 Linux 没有提供 `$XDG_*` 变量，那么就直接使用 `~/.local/share/tproj`
        
        - 归档文件存储在 `$TPROJ_HOME/template` 目录下
        - 配置文件存储为文件 `$TPROJ_HOME/tproj.conf`（TOOD）
        
        ### tproj 包
        
        一个 tproj 包实质上是一个用过 Deflate 算法压缩的归档文件，并且以 `.zip` 为后缀名。
        除了用 `tproj create -n ...` 来创建之外，也可以使用你喜欢的任何压缩工具来打包。
        项目所需的文件原样存储在归档的 "根目录" 中，并在应用时原样解压到当前工作目录或
        `tproj apply -d ...` 指定的目录中。
        
Platform: win32
Platform: linux
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires: pyyaml
Requires-Python: >=3.7
Description-Content-Type: text/markdown
