Document ApiClient magic methods with @method PHPDoc tag

[rulatir]

I can see that examples show usages like $client->exportLocale(/* ... */);, but the ApiClient class does not define any such methods. This must mean that they are somehow translated to endpoint paths using __call() automagic.

Please document these magic methods using @method PHPDoc tags so that they will be available for code completion and won't trigger code inspection warnings in modern IDEs.

Alternatively return new static instead of new self in ApiClient::factory() so that one can subclass it and add the missing PHPDoc to the subclass.

[timwhitlock]

Thanks for the suggestion. The service definition is completely auto-generated, so I will look into adding @method tags as part of that build process.

[timwhitlock]

Hi. Would you mind checking out the master branch? I've added the code hints, but I'm "between IDEs" at the moment, so I can't see if they work.

[timwhitlock]

https://github.com/loco/loco-php-sdk/releases/tag/2.0.1

[rulatir]

Great, works like charm, thanks!