# Shirabe

Shirabe is a port of [Composer](https://github.com/composer/composer), the dependency manager for PHP, written in Rust.
It aims at 100% compatibility with Composer, including the plugin API.
*WORK IN PROGRESS*: while full compatibility is the goal, the project is at an early stage and still has many incompatibilities and bugs. See [known incompatibilities](./docs/known-incompatibilities.md) for the known differences.
## Plugins
Shirabe runs Composer plugins using the system-provided real PHP. The plugin API is partially implemented. The following plugins are verified to work:
* [composer/installers](https://github.com/composer/installers)
* [dealerdirect/phpcodesniffer-composer-installer](https://github.com/PHPCSStandards/composer-installer)
* [phpstan/extension-installer](https://github.com/phpstan/extension-installer)
* [symfony/runtime](https://github.com/symfony/runtime)
## Requirements
Running Shirabe requires:
* Linux (see [platform support](./docs/known-incompatibilities.md#platform-support))
* PHP, found on `PATH` or pointed at by the `PHP_BINARY` environment variable
Shirabe is tested with PHP 8.5. Older PHP versions have not been tested.
Building Shirabe requires:
* Rust toolchain
* Git
* PHP
* Composer
* Just (optional)
* Nix (optional)
* Direnv (optional)
Nix flake supported; use `nix develop` to enter the development shell.
## Install
Prebuilt binaries are available on the [releases page](https://github.com/nsfisis/php-shirabe/releases) for the following targets:
* `x86_64-unknown-linux-musl`: Linux on x86-64 (statically linked)
* `aarch64-unknown-linux-musl`: Linux on ARM64 (statically linked)
* `aarch64-apple-darwin`: macOS on Apple silicon
Download the archive for your platform, verify its build provenance attestation with the [GitHub CLI](https://cli.github.com/), and put the `shirabe` executable on your `PATH`:
```
$ VERSION=0.2.0
$ TARGET=x86_64-unknown-linux-musl
$ curl -LO "https://github.com/nsfisis/php-shirabe/releases/download/$VERSION/shirabe-$VERSION-$TARGET.tar.gz"
$ gh attestation verify "shirabe-$VERSION-$TARGET.tar.gz" --repo nsfisis/php-shirabe
$ tar -xzf "shirabe-$VERSION-$TARGET.tar.gz"
$ install -m 755 "shirabe-$VERSION-$TARGET/shirabe" ~/.local/bin/shirabe
$ shirabe --version
```
## Build
```
$ git submodule update --init
$ composer install --no-dev --working-dir=composer
$ cargo build --release
```
### Nix
```
$ nix build
```
## Test
```
$ just fetch-fixtures
$ cargo test
```
`just fetch-fixtures` fetches third-party Composer plugins.
## License
See [LICENSE.md](./LICENSE.md).
|