contao-community-alliance / build-system-repositories
This package is abandoned and no longer maintained.
The author suggests using the bit3/build-system-repositories package instead.
Multiple repositories manager for CCABS.
dev-master / 1.0.x-dev
2014-11-11 16:31 UTC
Requires
- contao-community-alliance/build-system-repository-git: ~1.0
- guzzle/guzzle: ~3.0
- symfony/console: ~2.3
- symfony/filesystem: ~2.3
- symfony/yaml: ~2.3
Requires (Dev)
- monolog/monolog: ~1
- phpunit/phpunit: 3.7.*
- symfony/filesystem: ~2.3
This package is not auto-updated.
Last update: 2019-02-20 18:17:40 UTC
README
Configuration reference
config: # local path where the repositories should stored in storage: /local/path # (optional) A scheme for the repository directories, created in the storage path directory-scheme: %repository% providers: # full bitbucket example bitbucket: # the remote name remote: origin # the provider type type: bitbucket # the name of the owner owner: contao-community-alliance # repository specific settings, all matching setting will be merged in order repositories: # a specific repository build-system-repositories: # (optional) select branches to work on branches: # a specific branch - "master" # a simple wildcard branch pattern - "dev-*" # a regexp branch pattern (a regexp must start and end with the same non-numeric character) - "~release/\d+\.\d+~" # (optional) select tags to work on tags: # a specific version - 1.2.3 # a simple wildcard version pattern - 2.* # a regexp version pattern (a regexp must start and end with the same non-numeric character) - ~2\.\d+~ # (optional) tag: min: 1.1 max: 2 ignore: [ 1.2.2, 1.2.4 ] # a simple wildcard repository pattern build-system-*: ... # a regexp repository pattern (a regexp must start and end with the same non-numeric character) ~^build-system.*~: ... # (optional) tag: # (optional) sort tags in a specific order sorting: desc # (optional) how to compare tags with each other, use a (custom) comparing function here compareFunction: version_compare # (optional) if multiple tags are selected, limit to a specific amount (a value <=0 disable this function) limit: -1 # authentication informations auth: # basic auth type: basic username: xxx password: xxx # full github example github: # the remote name remote: origin # the provider type type: github # the name of the owner owner: contao-community-alliance # repository specific settings, all matching setting will be merged in order repositories: # a specific repository build-system-repositories: # (optional) select branches to work on branches: # a specific branch - "master" # a simple wildcard branch pattern - "dev-*" # a regexp branch pattern (a regexp must start and end with the same non-numeric character) - "~release/\d+\.\d+~" # (optional) select tags to work on tags: # a specific version - 1.2.3 # a simple wildcard version pattern - 2.* # a regexp version pattern (a regexp must start and end with the same non-numeric character) - ~2\.\d+~ # (optional) min/max range tag: min: 1.1 max: 2 # a simple wildcard repository pattern build-system-*: ... # a regexp repository pattern (a regexp must start and end with the same non-numeric character) ~^build-system.*~: ... # (optional) tag: # (optional) sort tags in a specific order sorting: desc # (optional) how to compare tags with each other, use a (custom) comparing function here compareFunction: version_compare # (optional) if multiple tags are selected, limit to a specific amount (a value <=0 disable this function) limit: -1 # authentication informations auth: # basic auth type: basic username: xxx password: xxx # full vcs example vcs: type: git remote: "<remote name>" owner: "<owner name>" name: "<repository name>" readUrl: "<repository read url>" writeUrl: "<repository write url>" webUrl: "<repository web url>" ref: "<ref spec>" realRef: "<real ref spec>" refType: "[ branch | tag ]" # Actions that are executed before the execution is started, for syntax see the actions section # Warning: repository specific placeholders are not available here! pre: ... # Actions that are executed on each repository actions: # execute a process - git rev-parse - [git, rev-parse] - [[git, rev-parse], { workingDirectory: /some/other/pass, env: { ENV: VALUE }, timeout: 300, verbose: true }] # alternative syntax - { exec: [git, rev-parse], workingDirectory: /some/other/pass, env: { ENV: VALUE }, timeout: 300 } # forward to another command - { command: [ccabs:vcs:commit, --message, 'Do a new commit on %repository%'] } # group multiple actions - actions: - git rev-parse - [git, rev-parse] # overwrite the timeout setting for one action - [[git, rev-parse], { timeout: 900 }] # these settings will be inherited to the child-actions # the working directory, the default is the local repository path workingDirectory: /some/other/pass # environment variables env: { ENV: VALUE } # process timeout, the default is no timeout timeout: 300 # ignore that the action has failed, otherwise an exception is thrown ignoreFailure: true # a condition to run the action(s) only under certain cases if: { not: { fileExists: '/some/path/that/does/NOT/exists' } } # Actions that are executed after the execution is finished, for syntax see the actions section # Warning: repository specific placeholders are not available here! post: ... # A list of custom variables that can be used as placeholders, note that you can not overwrite existing placeholders! variables: my-path: /my/custom/path
Condition reference
AND / OR condition
... if: # the first level is an implicit AND condition - { ... } - { ... } - { ... } # AND / OR conditions can be nested - or: - { ... } - and: [{...}, {...}] - { ... }
Multiple conditions in one array will result in an AND condition.
... if: # produce an implicit AND condition with two conditions... not: { ... } fileExists: { ... } # expect it is nested to an OR condition or: not: { ... } fileExists: { ... }
NOT condition
... # invert the result of another condition if: { not: { ... } }
File exists condition
... # test if a file exist, placeholders are supported if: { fileExists: "/%dir%/to/test/for/existence" }
Placeholder reference
scheme | The scheme extracted from the repository URL. |
---|---|
host | The host extracted from the repository URL. |
port | The port extracted from the repository URL. |
user | The user extracted from the repository URL. |
pass | The pass extracted from the repository URL. |
path | The path extracted from the repository URL. |
query | The query extracted from the repository URL. |
fragment | The fragment extracted from the repository URL. |
repository | Shortcut for `%owner%/%name%`. |
owner | The name of the repository owner. |
name | The name of the repository. |
dir | The local directory path inside the storage. |
ref | The working ref name, e.g. `master`. |
real-ref | The real ref name, e.g. `origin/master`. |
ref-type | The ref type, `branch`, `tag` or `commit`. |
tag | The most recent tag name. |
commit | The commit name / hash. |
author-name | The author name. |
author-email | The author email. |
author-date[:format] | The author date. |
committer-name | The committer name. |
committer-email | The committer email. |
committer-date[:format] | The committer date. |