jaapio
Repos
71
Followers
51
Following
11

Documentation Generator for PHP

0
0

Reflection library to do Static Analysis for PHP Projects

0
0

Events

issue comment
Update the personell page with new elections

Ah sorry, I picked the wrong Alessandro.

It should now be correct.

Created at 3 weeks ago

Update the personell page with new elections

Created at 3 weeks ago
pull request opened
Update the personell page with new elections

I'm not sure if I'm supposed to do this, however, this document seemed to be outdated.

I added 2 years for all people mentioned for re-election. And added me and Navarr to the list of core committee members.

Created at 3 weeks ago
create branch
jaapio create branch update_personell
Created at 3 weeks ago

Add statement about compound statements

Compound statements can lead to very unclear behavior in IDE's and api-doc generators. Thus they should be avoided.

Update proposed/phpdoc.md

Co-Authored-By: jaapio jaap@ijaap.nl

Propose no-return type

This type should be used mainly as a return type to designate a function/method as a never returning back. It shows that the function/method will always throw an exception or will call exit() or will call trigger_error() or will stop program execution in any other available way.

This return type is available in many languages/tools:

  1. Kotlin — Nothing return type. See https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-nothing.html
  2. Hack lang — noreturn return type. See https://docs.hhvm.com/hack/built-in-types/noreturn (examples: https://github.com/facebookarchive/hack-langspec/blob/master/tests/Functions/noreturn.php)
  3. Vimeo Psalm — @return no-return PhpDoc type. See https://github.com/vimeo/psalm/issues/1155#issuecomment-451002822
  • they have config option, but it's only for functions/static methods and is going to be deprecated/removed in the future.
  1. Phpstan has @return never PhpDoc type. See https://github.com/phpstan/phpstan/pull/1472
  • they have config option and it's possible to specify dynamic method calls there too.
  1. Phan doesn't have this — see https://github.com/phan/phan/issues/2118, but they plan to add it.
  2. PhpStorm doesn't have this feature, but they plan to add it and the PhpDoc tag is not decided yet. See https://youtrack.jetbrains.com/issue/WI-10673

Update reference to PSR-2 to PSR-12

PSR-2 is now deprecated.

Use "Structural Elements" in reference @internal

API components is a new definition which does not allign with the rest of the document where we are using "Structural Elements"

feat: add errata detailing addition of scalar type hints

See:

  • https://github.com/php-fig/container/pull/27
  • https://github.com/php-fig/container/pull/28

Add Errata vote specifications

Add Secretaries as backup for calling the vote

Co-authored-by: Larry Garfield larry@garfieldtech.com

Add clarification about where to put the errata

Co-authored-by: Larry Garfield larry@garfieldtech.com

Add TYPO3 project

Merge pull request #1217 from php-fig/typo3

Add TYPO3 project

Merge pull request #1216 from php-fig/add-errata-vote

Add Errata vote specifications

Move Beau Simonsen to Former Core Committee; Add Vacancy

Update personnel.md

Update terms, add Ben Edmunds, move now-inactive members.

Merge pull request #1219 from SlvrEagle23/master

Move Beau Simensen to Former Core Committee; Add Vacancy

Add errata for typed releases of PSR-13.

Update for PHP 8.0.

Add errata for type additions.

Merge pull request #1214 from jaapio/patch-1

Use "Structural Elements" in reference @internal

Merge pull request #1131 from phpDocumentor/compound-statements

Add statement about compound statements

Created at 3 weeks ago
jaapio delete branch POC/lexer-parser
Created at 4 weeks ago
POC: Setup AST lexer & parser

Will never merge this, as I'm looking at other options to improve this library

Created at 4 weeks ago
pull request closed
POC: Setup AST lexer & parser
Created at 4 weeks ago
jaapio delete branch modernize_ci
Created at 4 weeks ago

Upgrade ci to standardized pipeline

Merge pull request #340 from phpDocumentor/modernize_ci

Upgrade ci to standardized pipeline

Created at 4 weeks ago
pull request closed
Upgrade ci to standardized pipeline
Created at 4 weeks ago

Upgrade ci to standardized pipeline

Created at 4 weeks ago

Upgrade ci to standardized pipeline

Created at 4 weeks ago

Bump phpdocumentor/type-resolver from 1.6.0 to 1.6.1

Bumps phpdocumentor/type-resolver from 1.6.0 to 1.6.1.


updated-dependencies:

  • dependency-name: phpdocumentor/type-resolver dependency-type: direct:production update-type: version-update:semver-patch ...

Signed-off-by: dependabot[bot] support@github.com

Merge pull request #333 from phpDocumentor/dependabot/composer/phpdocumentor/type-resolver-1.6.1

Bump phpdocumentor/type-resolver from 1.6.0 to 1.6.1

Bump webmozart/assert from 1.10.0 to 1.11.0

Bumps webmozart/assert from 1.10.0 to 1.11.0.


updated-dependencies:

  • dependency-name: webmozart/assert dependency-type: direct:production update-type: version-update:semver-minor ...

Signed-off-by: dependabot[bot] support@github.com

Bump psalm/phar from 4.22.0 to 4.24.0

Bumps psalm/phar from 4.22.0 to 4.24.0.


updated-dependencies:

  • dependency-name: psalm/phar dependency-type: direct:development update-type: version-update:semver-minor ...

Signed-off-by: dependabot[bot] support@github.com

Merge pull request #336 from phpDocumentor/dependabot/composer/webmozart/assert-1.11.0

Bump webmozart/assert from 1.10.0 to 1.11.0

Merge pull request #338 from phpDocumentor/dependabot/composer/psalm/phar-4.24.0

Bump psalm/phar from 4.22.0 to 4.24.0

Upgrade ci to standardized pipeline

Created at 4 weeks ago
issue comment
Return tag with constant wildcard list parsed into InvalidTag instead of Return_

hm, our type resolver doesn't has support for this type of notations. And it would be hard to build in. In your example the self::STATUS_* resolves into the correct class, so that would be possible. But if it would refer to something else, like My\Namespaced\Class_ we would need some kind of autoloading or discovery after we parsed the file. This will have an impact on the way our parser works as we are parsing per file.

The best I could think of is that we would introduce some new type. that needs to be resolved in some post processing. The reason why our libraries are fast, is because there are no relations between files and classes. So if you ask for the docblock of a class / method / property we will just process that particular file.

An UnresolvedType would allow us to detect these types while processing the Typed tags. But it will be up to the consumer to find the correct referenced type. And that might not be easy. Psalm and other analyzers are loading the entire project, then do post-processing and other magic to detect errors. As those are applications it is possible for them to build this. As this is a library, it will be way harder to solve this issue.

My intuition says I won't be able to build such a feature in the short term. If it would ever be built in this or any of our libs.

Created at 4 weeks ago

Remove usage of dynamic properties.

php 8.2 will make dynamic properties deprecated. We were using one in our code. By now the FQSEN is stored as an attribute on the nodes. The fqsen property is still available, but will be removed in a future release.

Created at 4 weeks ago

Auto merge dependabot

Created at 1 month ago
constants support in traits
Created at 1 month ago
delete branch
jaapio delete branch build_php82
Created at 1 month ago

Add php 8.2 build

Merge pull request #259 from phpDocumentor/build_php82

Add php 8.2 build

Created at 1 month ago
pull request closed
Add php 8.2 build
Created at 1 month ago
pull request opened
Add php 8.2 build
Created at 1 month ago
create branch
jaapio create branch build_php82
Created at 1 month ago
delete branch
jaapio delete branch trait_consts
Created at 1 month ago

Add constants support for traits

Merge pull request #258 from phpDocumentor/trait_consts

Add constants support for traits

Created at 1 month ago
pull request closed
Add constants support for traits
Created at 1 month ago
pull request opened
Add constants support for traits
Created at 1 month ago
create branch
jaapio create branch trait_consts
Created at 1 month ago