Keruald

Keruald is a set of libraries to build PHP applications.

Libraries

List of libraries

Package name	Description
keruald/omnitools	General purpose library
keruald/globalfunctions	Wrapper to replace our old old sites "core.php" by calls to omnitools
keruald/commands	Create simple CLI application
keruald/report	Reporting library
keruald/health	Site health check
keruald/dockerhub	Docker Hub, managing payload signatures
keruald/github	GitHub payloads for webhooks - managing payload signatures, class representations
keruald/mailgun	Mailgun API client
keruald/database	Database abstraction layer
keruald/broker	Wrapper around brokers like RabbitMQ

Developer guide

Contribution workflow

You'll find the general contribution guide at How to contribute code. Here some pointers specific for Keruald libraries.

We use a monorepo: clone the rKERUALD repository on DevCentral, you'll find your library as a direct subdirectory on it.

Each subdirectory matches:

• a resource folder, not included in packages, if starting by an underscore _ or a dot .
• a name of a package if starting by a letter, e.g. keruald/commands for commands/

How to import an existing library?

First, use tomono in the PARENT DIRECTORY of the monorepo directory.

If the name of the repository is NOT "core", export it as MONOREPO_NAME environment variable.

For example, to import Keruald/GitHub library:

$ export MONOREPO_NAME=keruald
$ echo "ssh://vcs@devcentral.nasqueron.org:5022/source/github.git github" | tomono --continue
From ssh://devcentral.nasqueron.org:5022/source/github
 * [new branch]      main       -> github/main
 * [new tag]         0.1.0      -> github/0.1.0
 * [new tag]         0.1.1      -> github/0.1.1
 * [new tag]         0.2.0      -> github/0.2.0
 * [new tag]         0.2.1      -> github/0.2.1
Updated 6 paths from the index

Then follow the procedure for new repositories to update the monorepo metadata.

How to create a new library?

To create a new library quux, we need a new empty manyrepo on DevCentral, a mirror on GitHub and to declare it on Packagist:

1. Create an empty folder in the monorepo repository with the name of the package, here mkdir quux
2. Declare your library in metadata.yml
3. Regenerate shared files with make regenerate (you need Python and Jinja2): that will add your repository to files like phpcs.xml
4. Create on DevCentral a new repository with a callsign starting by K for Keruald like KQUUX, and "quux" as shortname
5. Create on GitHub a new repository called keruald/quux
6. Publish on packagist

If the shortname is already taken on DevCentral, it's time to create a new task to provide a map of subdirectory/package repository.

Don't commit anything in newly created repos but contribute as usual by creating quux/ subdirectory in the monorepo

Annex A. IDE configuration

PhpStorm

Clone the monorepo on your drive, then open it in PhpStorm to generate an .idea folder.

• Edit keruald.iml with this modules content to declare the code namespaces: https://devcentral.nasqueron.org/P300
• For code style, you can use https://github.com/nasqueron/codestyle/blob/main/JetBrains/php-codestyle.xml