aurimasniekis/gsatis

Simple Repository Generator

1.0.0 2017-08-10 06:25 UTC

Requires

• php: ^5.6 || ^7.0
• composer/composer: ^1.4
• symfony/console: ^2.1 || ^3.0.4
• twig/twig: ^1.7 || ^2.0

Requires (Dev)

• mikey179/vfsstream: ^1.6
• phpunit/phpunit: ^4.5 || ^5.0.5
• phpunit/phpunit-mock-objects: 2.3.0 || ^3.0

MIT

• Jordi Boggiano
• Nils Adermann

• generator
• package
• composer
• repository
• static

README

Simple static Composer repository generator.

GitHub Private Organisation Support

I have few private GitHub organisations which have many private composer libraries, and Satis requires to add them all one by one in satis.json file, which is pretty annoying if you have more than few libraries.

So I forked Satis project and added Github Organisation support by running GitHub API V4 GraphQL query to fetch all repositories with composer.json file if it exists and add that repository into repository list programmatically.

For authentication, it uses Composer Github OAuth Token so no additional configuration is required.

{
  "name": "Satis Repository",
  "homepage": "http://127.0.0.1",
  "repositories": [
  ],
  "github-organisations": ["composer"],
  "require-all": true,
  "output-dir": "./public"
}

Run from source

Satis requires a recent PHP version, it does not run with unsupported PHP versions. Check the composer.json file for details.

• Install satis: composer create-project aurimasniekis/gsatis:dev-master
• Build a repository: php bin/satis build <configuration-file> <output-directory>

Read the more detailed instructions in the documentation.

Contributing

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Fork the project, create a feature branch, and send us a pull request.

If you introduce a new feature, or fix a bug, please try to include a testcase.

Authors

See the list of contributors who participate(d) in this project.

Community Tools

• satis-go - A simple web server for managing Satis configuration and hosting the generated Composer repository.
• satisfy - Symfony based composer repository manager with a simple web UI.
• satis-control-panel - Simple web UI for managing your Satis Repository with optional CI integration.
• composer-satis-builder - Simple tool for updating the Satis configuration (satis.json) "require" key on the basis of the project composer.json.

Examples

• eventum/composer - A simple static set of packages hosted in GitHub Pages

License

Satis is licensed under the MIT License - see the LICENSE file for details