jinja2-github 0.1.1

安装

jinja2-github 可从 PyPI 通过 pip 下载

$ pip install jinja2-github

它将自动安装 jinja2 和 pygithub。

用法

github_repo_branch_sha标签

此扩展包含一个 github_repo_branch_sha 标签，允许渲染与GitHub项目分支关联的最后一个提交SHA。

默认情况下，使用 master 分支。

from jinja2 import Environment

env = Environment(extensions=['jinja2_github.GitHubRepoBranchShaExtension'])

# Default branch is master -> "4f5191b50026f7281ca1b1cd180e05fad1d716c6"
template = env.from_string("{% github_repo_branch_sha 'Slicer/Slicer' %}")

template.render()

还可以指定分支（或标签）名称

from jinja2 import Environment

env = Environment(extensions=['jinja2_github.GitHubRepoBranchShaExtension'])

# With an explicit branch name -> "cfe12ceefd761502181660de76a8cc5d40d5f31c"
template = env.from_string("{% github_repo_branch_sha 'Slicer/Slicer', 'master-48' %}")

template.render()

github_repo_description

此扩展包含一个 github_repo_description 标签，允许渲染GitHub项目的描述。

from jinja2 import Environment

env = Environment(extensions=['jinja2_github.GitHubRepoDescriptionExtension'])

# -> "Multi-platform, free open source software for visualization and image computing."
template = env.from_string("{% github_repo_description 'Slicer/Slicer' %}")

template.render()

问题

如果在使用过程中遇到任何问题，请附带详细描述，在 此处提交问题。

维护者：制作发行版

1. 请确保所有 CI 测试在 CircleCI 上通过。

2. 按版本顺序列出所有标签

$ git tag -l | sort -V

3. 选择下一个发布版本号

$ release=X.Y.Z

4. 下载最新源码

$ cd /tmp && \
  git clone git@github.com:jcfr/jinja2-github && \
  cd jinja2-github

5. 在 jinja2_github.py 脚本中更新 __version__。

$ sed -i "5s/.*/__version__ = '$release'/" jinja2_github.py

6. 提交更改并推送

$ git add jinja2_github.py
$ git commit -m "jinja2-github $release"
$ git push origin master

7. 标记发布

$ git tag --sign -m "jinja2-github ${release}" ${release} origin/master

8. 发布发布标签

$ git push origin ${release}

9. 在 CircleCI 上检查构建状态。

10. 构建完成后，请检查 PyPI 上是否有可用的分布。

行为准则

所有在 jinja2-github 项目的代码库、问题跟踪器、聊天室和邮件列表中互动的人都被期望遵循 PyPA 行为准则。

许可协议

遵循 Apache 2.0 许可协议，jinja2-github 是免费和开源软件