csoellinger/silverstripe-model-annotations-task

A SilverStripe Task to generate data object model annotations for defined db fields including fields defined in extensions.

v1.0.1 2022-04-22 12:39 UTC

Requires

• php: >=7.4,<8.1
• ext-ast: *
• ext-bcmath: *
• ext-intl: *
• ext-json: *
• ext-mbstring: *
• ext-sodium: *
• azjezz/psl: ^1.6
• silverstripe/framework: ~4.10

Requires (Dev)

• pds/skeleton: ^1.0
• php-parallel-lint/php-parallel-lint: ^1.3
• php-standard-library/psalm-plugin: ^1.1
• phpstan/extension-installer: ^1.1
• phpstan/phpstan: ^1.4
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.1
• phpstan/phpstan-strict-rules: ^1.1
• phpunit/phpunit: ^9.5
• psalm/plugin-phpunit: ^0.16.1
• silverstripe/sqlite3: ^2
• squizlabs/php_codesniffer: ^3
• vimeo/psalm: ^4.22

BSD-3-Clause

• CSoellinger

• database
• generator
• php
• plugin
• module
• annotation
• model
• addon
• silverstripe
• ide
• silverstripe-module
• silverstripe-vendormodule
• vendormodule

README

This module adds a dev task which generates annotations for your data object models. The problem is if you are working a lot with silver stripe models you will learn that no IDE can handle the DB fields as properties and/or collections as methods. So i made this task which completes my models with annotations from existing configs of the model itself and all extensions of it. Configs handled: db, has_one, has_many, many_many, many_many(through), belongs_to, belongs_many_many.

1. Requirements
2. Installation
3. Usage
   1. Web
   2. Terminal
   3. Optional params
4. Options
   1. dryRun (default: true)
   2. quiet (default: false)
   3. createBackupFile (default: false)
   4. addUseStatements (default: false)
5. Example
6. Documentation
7. License
8. Maintainers
9. Bugtracker
10. Development and contribution

Requirements

• PHP 7.4 - PHP 8.0
• PHP-AST extension
• PHP-BCMATH extension
• SilverStripe ^4.10

Installation

composer require --dev csoellinger/silverstripe-model-annotations-task

Usage

Run dev build to load the task and after you can execute it in your browser or cli.

Web

http://localhost/tasks/ModelAnnotationsTask

Terminal

vendor/bin/sake dev/tasks/ModelAnnotationsTask

Optional params

• dryRun=0/1
• quiet=0/1
• createBackupFile=0/1
• addUseStatements=0/1

Take a look at options section below to get more information about the params.

Options

All optional params from above can be set as silverstripe config at the ModelAnnotationsTask. Only difference is that the config is set as boolean var and not as integer. By default dryRun is set to true. If you want write the files with this task you need to set the config or set the param to false.

dryRun (default: true)

Only print the changes inside your browser or terminal and don't write any file.

quiet (default: false)

No output.

createBackupFile (default: false)

Create a backup file before writing the model. Only if dryRun is false.

addUseStatements (default: false)

Collect data types which are not declared as use statement and add them to the file. If this config is true it also shortens the data types.

Example

Here you see a small example how it will look your model file after using the task.

Your Input

<?php

class Player extends DataObject
{
    private static $db = [
        'Name' => 'Varchar(255)',
    ];
    private static $has_many = [
        'Jobs' => 'Job',
    ];
}

Task would write this file:

<?php

/**
 * @property string $Name Name...
 *
 * @method HasManyList Jobs() Get jobs
 */
class Player extends DataObject
{
    private static $db = [
        'Name' => 'Varchar(255)',
    ];
    private static $has_many = [
        'Jobs' => 'Job',
    ];
}

Documentation

• Documentation readme

License

See License

Maintainers

• CSoellinger [e-mail]

Bugtracker

Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.

If the issue does look like a new bug:

• Create a new issue
• Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
• Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.

Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.