Nette\Reflection anotace: @property-read ano či ne

Upozornění: Tohle vlákno je hodně staré a informace nemusí být platné pro současné Nette.
před 13 lety
Mikulas Dite
Člen | 756
+
0
-

Reflexe jsou velká část frameworku, která přepisuje chování php, ale přesto dědí originál. Protože napodobují Nette\Object, funguje v nich magický property access. A protože property používám moc rád, hodila by se (všem) podpora pomocí phpdoc.

Ten jsem napsal, to není problém: deb9f83c064.

Otázka je, jestli do docu vypsat úplně všechny zavolatelné property (což jsem zatím udělal), nebo jenom ty důležité, řekněme:

fileName
shortName
abstract
final
internal

atp., nebo i ty ostatní, třeba mojí oblíbenou

numberOfRequiredParameters

Ten phpdoc je hodně moc dlouhej a moc se mi v té třídě nelíbí, ale možnost psát s properties to převažuje, ne?

před 13 lety
Jan Tvrdík
Nette guru | 2595
+
0
-

Jsem pro to, aby tam byly uvedeny všechny property.

před 13 lety
Patrik Votoček
Člen | 2221
+
0
-

jsem taky pro všechny… :-)

před 13 lety
jtousek
Člen | 951
+
0
-

všechny

před 13 lety
westrem
Člen | 398
+
0
-

vsechny +1

před 13 lety
grey
Člen | 94
+
0
-

všechny.

před 13 lety
Mikulas Dite
Člen | 756
+
0
-

A tak si říkám, jestli vůbec. Vycházel jsem z toho, že jenom Reflection nenapovídají, ale něco málo chybí i u ostatních tříd (přestože většina má ty property realné/vypsané v kódu, nejenom pomocí getterů). Bylo by fajn to asi mít všude.

Asi není problém je tam dopstat, ale to spíš to potom udržovat. Kouknu, kolik chybí u různých tříd a podle toho se ukáže, jak moc to má smysl (tzn. doufám, že chybí málo).