corneltek/phprelease

1.3.2 2016-10-10 09:59 UTC

This package is auto-updated.

Last update: 2024-08-29 04:03:31 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License Build Status

定义您的发布流程的最简单方式。

特性

  • 自动为Composer、Onion、PHPDoc或类常量进行版本升级。
  • 支持从PHPDoc或类常量中解析版本。
  • Git标签,推送。
  • 最简单的配置。

安装

$ curl -OLSs https://raw.github.com/c9s/PHPRelease/master/phprelease
$ chmod +x phprelease
$ mv phprelease /usr/bin

将 phprelease 包含到您的项目中

简化运行 composer require 包含该包

composer require --dev corneltek/phprelease

使用方法

通过简单的命令创建 phprelease.ini 配置文件

$ phprelease init

上述命令创建了一个 phprelease.ini 配置文件,您也可以自行编辑它

Steps = PHPUnit, BumpVersion, GitTag, GitPush, GitPushTags

发布步骤可能包含脚本文件,您只需插入脚本路径,phprelease 会为您运行。返回码 0 表示我们将进行下一步。

Steps = BumpVersion, scripts/compile, GitTag

然后,要发布您的包,只需输入

$ phprelease

版本升级

升级主版本并发布

$ phprelease --bump-major
===> Bumping version from 2.2.3 => 3.0.0

升级次版本并发布

$ phprelease --bump-minor
===> Bumping version from 2.2.3 => 2.3.0

升级次版本并设置稳定性后缀

$ phprelease --bump-minor --dev
===> Bumping version from 2.2.3 => 2.3.0-dev

$ phprelease --bump-minor --beta
===> Bumping version from 2.2.3 => 2.3.0-beta

$ phprelease --bump-minor --rc
===> Bumping version from 2.2.3 => 2.3.0-rc

$ phprelease --bump-minor --rc1
===> Bumping version from 2.2.3 => 2.3.0-rc1

$ phprelease --bump-minor --rc2
===> Bumping version from 2.2.3 => 2.3.0-rc2

$ phprelease --bump-minor --stable
===> Bumping version from 2.2.3 => 2.3.0

为 git 标签使用版本前缀,请将此键添加到您的 phprelease.ini 中

GitTagPrefix = v.

这将导致如下结果:

$ phprelease
===> Version bump from 2.2.3 to 2.3.0
===> Running PHPRelease\Tasks\GitTag
===> Tagging as v.1.2.2

配置 GitAdd 任务

要使用 GitAdd 任务,您可以在 phprelease.ini 中添加以下配置

[GitAdd]
Paths[] = src/
Paths[] = tests/

跳过特定步骤

$ phprelease --skip BumpVersion

从 PHP 源文件获取版本

如果您在 PHP 源文件或类常量中定义了版本字符串,要从 PHP 源文件中升级版本,您可以简单地定义一个 VersionFrom 选项

; to read version from php class file or from phpdoc "@VERSION ..."
VersionFrom = src/PHPRelease/Console.php

任务选项

每个任务都有自己的选项,运行帮助命令,您应该会看到这些任务的选项

$ phprelease help
PHPRelease - The Fast PHP Release Manager

Usage
    phprelease [options] [command] [argument1 argument2...]

Options
           -v, --verbose   Print verbose message.
             -d, --debug   Print debug message.
             -q, --quiet   Be quiet.
              -h, --help   help
               --version   show version
                   --dry   dryrun mode.
            --bump-major   bump major (X) version.
            --bump-minor   bump minor (Y) version.
            --bump-patch   bump patch (Z) version, this is the default.
 -s, --stability <value>   set stability
                   --dev   set stability to dev.
                    --rc   set stability to rc.
                   --rc1   set stability to rc1.
                   --rc2   set stability to rc2.
                   --rc3   set stability to rc3.
                   --rc4   set stability to rc4.
                   --rc5   set stability to rc5.
                  --beta   set stability to beta.
                 --alpha   set stability to alpha.
                --stable   set stability to stable.
       --remote <value>+   git remote names for pushing.

因此,要升级主版本,只需传递标志

phprelease --bump-major

您还可以在 dry-run 模式下测试您的发布步骤

phprelease --dryrun

内置任务

BumpVersion
GitCommit
GitPush
GitPushTags
GitTag
PHPUnit

黑客攻击

  1. 为此项目。

  2. 获取 composer,并运行

    composer install --dev

  3. 黑客攻击!