68publishers / tracy-git-version
Git version panel for Tracy.
Installs: 5 006
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 1
Open Issues: 0
Requires
- php: ^7.4 | ^8.0
- ext-json: *
- tracy/tracy: ^2.6.0
Requires (Dev)
- czproject/git-php: ^4.2
- friendsofphp/php-cs-fixer: ^3.13
- nette/application: ^3.1.0
- nette/bootstrap: ^3.1
- nette/di: ^3.0.10
- nette/tester: ^2.4.3
- phpstan/phpstan: ^1.9
- phpstan/phpstan-nette: ^1.1
- roave/security-advisories: dev-latest
- symfony/console: ^5.4 | ^6.0
Suggests
- nette/di: For an integration with the Nette Framework.
- symfony/console: If you want to use a git repository cloning for production build purposes.
Conflicts
- nette/di: <3.0
- nette/schema: <1.2
- nette/utils: <3.2.5
README
Tracy Git version
Simple and extensible panel for Tracy that shows information from Git.
Table of contents
- Installation
- Basic integration
- Solution for application builds without Git
- Advanced guide
- Contributing
- License
Installation
The best way to install 68publishers/tracy-git-version
is using Composer:
$ composer require 68publishers/tracy-git-version
Basic integration
Standalone Tracy integration
The simplest way how to register the panel into Tracy is by creating a default instance and providing it directly into a Bar.
use Tracy\Debugger; use SixtyEightPublishers\TracyGitVersion\Bridge\Tracy\GitVersionPanel; Debugger::getBar()->addPanel(GitVersionPanel::createDefault());
Integration into Nette Framework
Basic integration into Nette is really simple. Just register an extension.
extensions: 68publishers.tracy_git_version: SixtyEightPublishers\TracyGitVersion\Bridge\Nette\DI\TracyGitVersionExtension
And everything works 😉
Solution for application builds without Git
Often when we deploy an application to a production environment, neither Git nor the .git
directory is available due to trying to have a build as small as possible.
However, at this moment we have no source of information about the current version. The solution is to export a file that contains all important information at the time when the Git is still accessible.
Setup for standalone Tracy
You must create repositories and the panel manually but there is not much work to do.
use Tracy\Debugger; use SixtyEightPublishers\TracyGitVersion\Bridge\Tracy\GitVersionPanel; use SixtyEightPublishers\TracyGitVersion\Repository\LocalGitRepository; use SixtyEightPublishers\TracyGitVersion\Repository\ExportedGitRepository; use SixtyEightPublishers\TracyGitVersion\Repository\ResolvableGitRepository; use SixtyEightPublishers\TracyGitVersion\Repository\RuntimeCachedGitRepository; use SixtyEightPublishers\TracyGitVersion\Bridge\Tracy\Block\CurrentStateBlock; # create a repository that reads from the .git directory: $localGitRepository = LocalGitRepository::createDefault(); # create a repository that reads from a JSON export: $exportedGitRepository = ExportedGitRepository::createDefault('/var/git-version/repository.json'); # combine there two repositories, if the .git directory is not accessible then try to read from the export file: $resolvableGitRepository = new ResolvableGitRepository([$localGitRepository, $exportedGitRepository]); # add runtime cache, commands results are stored so there are no duplicated calls to the real repository: $cachedGitRepository = new RuntimeCachedGitRepository($resolvableGitRepository); # add the panel into Tracy Debugger::getBar()->addPanel(new GitVersionPanel($cachedGitRepository, [new CurrentStateBlock()]));
Setup for Nette Framework
The setup for Nette is more simple. Just add another extension into your neon configuration.
extensions: 68publishers.tracy_git_version: SixtyEightPublishers\TracyGitVersion\Bridge\Nette\DI\TracyGitVersionExtension 68publishers.tracy_git_version.export: SixtyEightPublishers\TracyGitVersion\Bridge\Nette\DI\TracyGitVersionExportExtension
The default name for the exported file is %tempDir%/git-version/repository.json
but you can change it.
68publishers.tracy_git_version.export: export_filename: %tempDir%/my/custom/path.json
Creating the export file
The export file should be created by executing a script that is located in the composer's bin
directory.
The script is independent of the application so you must provide the filename of the exported file as an option.
$ vendor/bin/tracy-git-version export-repository --output-file <your_temp>/git-version/repository.json -vv
Advanced guide
If you want to read more about repositories, how to extend them or how to add custom data into the panel, please see the Advanced guide.
Contributing
Before opening a pull request, please check your changes using the following commands
$ make init # to pull and start all docker images
$ make cs.check
$ make stan
$ make tests.all
License
The package is distributed under the MIT License. See LICENSE for more information.