PHPackages metadrop/drupal-artifact-builder - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. metadrop/drupal-artifact-builder ActiveLibrary[Utility & Helpers](/categories/utility) metadrop/drupal-artifact-builder ================================ Helper to generate drupal artifacts 2.1.5(8mo ago)729.6k↓34.5%4[1 issues](https://github.com/Metadrop/drupal-artifact-builder/issues)1PHP Since Apr 28Pushed 8mo ago3 watchersCompare [ Source](https://github.com/Metadrop/drupal-artifact-builder)[ Packagist](https://packagist.org/packages/metadrop/drupal-artifact-builder)[ RSS](/packages/metadrop-drupal-artifact-builder/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (36)Used By (1) Drupal artifact builder ======================= [](#drupal-artifact-builder) Helps generating artifacts for Drupal by wrapping all code into an artifact, and pushing it to the artifact remote repository. Installation ------------ [](#installation) ``` composer require metadrop/drupal-artifact-builder ``` ### Configuration [](#configuration) Drupal artifact builder allow using a configuration file to create the artifact. Artifacts usually are executed using always the same parameters. So, a configuration file saves time adding those parameters every time the command is run. Configuration file is placed at root (it can be changed through command line parameters). You cam copy the template to have an starting point: ``` cp vendor/metadrop/drupal-artifact-builder/.drupal-artifact-builder.yml.dist .drupal-artifact-builder.yml ``` #### Configuration properties [](#configuration-properties) - **repository**: Repository URL (git SSH / git HTTP URL). Example: ``` repository: git@github.com:example/example-artifact.git ``` - **include**: Extra files or folders to include into the artifact. Example: ``` include: - oauth - solr ``` - **author**: It will be the author used in git commits. Example: ``` author: John Doe ``` - **branches\_map**: Key value map to git push source artifact branches to different artifact branches. Example: ``` branches_map: develop:develop-build ``` This example will make push the artifacts coming from develop source branch to the develop-build artifact branch. Usage ----- [](#usage) **Important**: Please note that Drupal Artifact Builder does not download Composer libraries or compile CSS assets. These tasks must be completed prior to running the command. Builds the artifact and push the changes to git: ``` drupal-artifact-builder ``` Generate the artifact: ``` drupal-artifact-builder create ``` Push the created artifact to git: ``` drupal-artifact-builder git ``` ### Parameters [](#parameters) - **config**: Allow setting the configuration file. Defaults to .drupal-artifact-builder.yml ``` drupal-artifact-builder git folder/.drupal-artifact-builder.custom.yml ``` - **repository**: Selects the repository where the artifacts will be pushed. Examples: For the complete command (create + git): ``` drupal-artifact-builder --repository git@example.com:example/example.git ``` For the git command: ``` drupal-artifact-builder git --repository git@example.com:example/example.git ``` - **include**: Allow adding more paths to the artifact. ``` drupal-artifact-builder --repository git@example.com:example/example.git --include=oauth.json,mycustomapp ``` Upgrade from 1.x to 2.x ----------------------- [](#upgrade-from-1x-to-2x) 2.0.0 release brings breaking changes and the way to use drupal-artifact-builder changes. These steps must be followed in order to upgrade to the 2.0.0 version: 1. Copy and configure .drupal-artifact-builder.yml: ``` cp vendor/metadrop/drupal-artifact-builder/.drupal-artifact-builder.yml.dist .drupal-artifact-builder.yml ``` 2. Change --extra-paths parameters to --include Before: ``` drupal-artifact-builder --extra-paths solr ``` Now: ``` drupal-artifact-builder --include solr ``` 3. Stop using GIT\_BRANCH environment variable, not it is --branch Before: ``` GIT_BRANCH=develop drupal-artifact-builder ``` Now: ``` drupal-artifact-builder --branch develop ``` ### Health Score 44 — FairBetter than 92% of packages Maintenance58 Moderate activity, may be stable Popularity34 Limited adoption so far Community16 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 93.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~27 days Total 33 Last Release 243d ago Major Versions 1.8.1 → 2.0.0-alpha12024-10-30 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/3202817?v=4)[Omar Mohamad - El Hassan Lopesino](/maintainers/omarlopesino)[@omarlopesino](https://github.com/omarlopesino) --- Top Contributors [![omarlopesino](https://avatars.githubusercontent.com/u/3202817?v=4)](https://github.com/omarlopesino "omarlopesino (67 commits)")[![jorgetutor](https://avatars.githubusercontent.com/u/1230268?v=4)](https://github.com/jorgetutor "jorgetutor (3 commits)")[![juanjol](https://avatars.githubusercontent.com/u/4212917?v=4)](https://github.com/juanjol "juanjol (2 commits)") ### Embed Badge ![Health badge](/badges/metadrop-drupal-artifact-builder/health.svg) ``` [![Health](https://phpackages.com/badges/metadrop-drupal-artifact-builder/health.svg)](https://phpackages.com/packages/metadrop-drupal-artifact-builder) ``` ### Alternatives [symplify/monorepo-builder Not only Composer tools to build a Monorepo. 5205.3M82](/packages/symplify-monorepo-builder)[shlinkio/shlink A self-hosted and PHP-based URL shortener application with CLI and REST interfaces 4.8k4.3k](/packages/shlinkio-shlink)[cognesy/instructor-php The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control 310107.9k1](/packages/cognesy-instructor-php)[shivas/versioning-bundle Symfony application versioning, simple console command to manage version (with providers e.g. git tag) of your application using Semantic Versioning 2.0.0 recommendations 1121.2M1](/packages/shivas-versioning-bundle)[overtrue/php-opencc 中文简繁转换，支持词汇级别的转换、异体字转换和地区习惯用词转换（中国大陆、台湾、香港、日本新字体）。基于 \[BYVoid/OpenCC\](https://github.com/BYVoid/OpenCC) 数据实现。 12130.7k](/packages/overtrue-php-opencc)[shyim/danger-php Port of danger to PHP 8544.9k](/packages/shyim-danger-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)