Keruald - Revision history

Dereckson: /* Troubleshoot */ +arc unit

2026-04-19T10:15:01Z

Troubleshoot: +arc unit

← Older revision		Revision as of 10:15, 19 April 2026
Line 89:		Line 89:

	=== Troubleshoot ===		=== Troubleshoot ===
			==== Run Arcanist unit tests ====
			Before running an arc unit or arc diff command, you need to set the XDEBUG_MODE environment variable to "coverage".

			This is done automatically by the Arcanist code installed on devserver role. For local development, use arcanist with the patches from our production branch. It's available at https://github.com/nasqueron/arcanist

	==== Error: Class "Keruald\GitHub\XHubSignature" not found ====		==== Error: Class "Keruald\GitHub\XHubSignature" not found ====
	When a new library is added to the repository, a new entry is added to composer.json to provide that library.		When a new library is added to the repository, a new entry is added to composer.json to provide that library.

2024-11-11T16:29:53Z

Error: Class "Keruald\GitHub\XHubSignature" not found

← Older revision		Revision as of 16:29, 11 November 2024
Line 90:		Line 90:
	=== Troubleshoot ===		=== Troubleshoot ===
	==== Error: Class "Keruald\GitHub\XHubSignature" not found ====		==== Error: Class "Keruald\GitHub\XHubSignature" not found ====
	When a new library is ~~imported~~, a new entry is added to composer.json to provide that library.		When a new library is added to the repository, a new entry is added to composer.json to provide that library.

	The Composer autoloader needs to be updated with <code>composer dump-autoload</code>.		The Composer autoloader needs then to be updated with <code>composer dump-autoload</code>.

	=== Annex A. IDE configuration ===		=== Annex A. IDE configuration ===

2024-11-10T12:42:12Z

+Troubleshoot

← Older revision		Revision as of 12:42, 10 November 2024
Line 87:		Line 87:

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

			=== Troubleshoot ===
			==== Error: Class "Keruald\GitHub\XHubSignature" not found ====
			When a new library is imported, a new entry is added to composer.json to provide that library.

			The Composer autoloader needs to be updated with <code>composer dump-autoload</code>.

	=== Annex A. IDE configuration ===		=== Annex A. IDE configuration ===

2024-11-10T12:40:01Z

How to import an existing library?

← Older revision		Revision as of 12:40, 10 November 2024
Line 72:		Line 72:

	Then follow the procedure for a new library to update the monorepo metadata.		Then follow the procedure for a new library to update the monorepo metadata.

			Don't forget to use <code>composer dump-autoload</code> to update your local Composer autoloader.

	=== How to create a new library? ===		=== How to create a new library? ===

2024-11-10T12:29:58Z

Developer guide

@@ Line 39: / Line 39: @@
 * 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? ===

2024-10-17T17:40:22Z

How to create a new library?

← Older revision		Revision as of 17:40, 17 October 2024
Line 65:		Line 65:
	To create a new library quux, we need a new empty manyrepo on DevCentral, a mirror on GitHub and to declare it on Packagist:		To create a new library quux, we need a new empty manyrepo on DevCentral, a mirror on GitHub and to declare it on Packagist:

	~~# Create an empty folder in the monorepo repository with the name of the package, here <code>mkdir quux</code>~~
	# Declare your library in <code>metadata.yml</code>		# Declare your library in <code>metadata.yml</code>
	# Regenerate shared files with <code>make regenerate</code> (you need Python and Jinja2): that will add your repository to files like phpcs.xml		# Regenerate shared files with <code>make regenerate</code> (you need Python and Jinja2): that will add your repository to files like phpcs.xml

2024-10-17T17:40:07Z

How to import an existing library?

← Older revision		Revision as of 17:40, 17 October 2024
Line 60:		Line 60:
	</syntaxhighlight>		</syntaxhighlight>

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

	=== How to create a new library? ===		=== How to create a new library? ===

2024-10-17T17:39:56Z

How to import an existing library?

← Older revision		Revision as of 17:39, 17 October 2024
Line 59:		Line 59:
	Updated 6 paths from the index		Updated 6 paths from the index
	</syntaxhighlight>		</syntaxhighlight>

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

	=== How to create a new library? ===		=== How to create a new library? ===

2024-10-17T17:39:10Z

How to import an existing library?

← Older revision		Revision as of 17:39, 17 October 2024
Line 48:		Line 48:
	For example, to import Keruald/GitHub library:		For example, to import Keruald/GitHub library:

	<syntaxhighlight>		<syntaxhighlight lang="console">
	$ export MONOREPO_NAME=keruald		$ export MONOREPO_NAME=keruald
	$ echo "ssh://vcs@devcentral.nasqueron.org:5022/source/github.git github" \| tomono --continue		$ echo "ssh://vcs@devcentral.nasqueron.org:5022/source/github.git github" \| tomono --continue

2024-10-17T17:38:08Z

How to import an existing library?

← Older revision		Revision as of 17:38, 17 October 2024
Line 46:		Line 46:
	If the name of the repository is NOT "core", export it as MONOREPO_NAME environment variable.		If the name of the repository is NOT "core", export it as MONOREPO_NAME environment variable.

	For example, to import Keruald/GitHub library~~, we used~~:		For example, to import Keruald/GitHub library:

	<syntaxhighlight>		<syntaxhighlight>