Adresarova struktura Feature-Re-Request (#2)

wdolek: Pročetl jsem si zmíněné vlákno, a souhlasím s tebou. I když bych tomu osobně dával malou váhu :-)

:D Tak se tu prave poprel prizpevek od Patrika a od arrona. Pestrost vs uniformita – musim tedy pouzivat NetBeans, abych se ve zdrojacich Nette neztratil? Samozrejme i v Eclipse/Aptana obcas nejake proklikavani funguje, popripade si mohu otevrit dialog „Open Type“. Ale znate to, obcas potrebujete neco honem – rychle, nechcete otevirat IDE, ktere Vam s tim pomuze… Navic tu mame desitky ruznych IDE, kazde se chova jinak, nekdo programuje v PSPadu…

Paklize je ale filosofii Nette magie a neprehlednost, a to cele je vydavano za velke plus, tak budiz. :) Jen zkousim obnovit diskusi na toto tema – jestli treba obhajci stavajiciho stavu nezmenili casem svuj nazor.

pilec napsal(a):

Podle mého je to vcelku logické, co je přímo v namespace Nette je ve složce common aby v rootu byl pouze loader.php a nepletli se začátečníci obrovským množstvím php souborů.

Takze budeme radeji mast „nezacatecniky“? Sounds like a plan! Nemluve o tom, ze v puvodnim threadu je seznam vsech trid, ktere neodpovidaji svemu umisteni v adresarove strukture (nevim, jak je na tom stavajici verze Nette, ale neprekvapilo by mne, kdyby se situace ani trochu nezmenila) – nejde tedy jen o common.

(A mel jsem za to, ze „logicke“ veci nepodlehaji subjektivnim dojmum)

Editoval wdolek (15. 11. 2011 11:46)

Já jsem pro to, aby cesty odpovídaly názvům tříd (a tedy i dodržovaly PSR-0).
Mimochodem, třída Nette\Loaders\NetteLoader se mi nelíbí (s tímhle výčtem je Nette celkem kuriózní) a RobotLoader nepoužívám (používám PSR-0 autoloader).

wdolku o co ti sakra jde? ted už víš, že některé soubory jsou v adresáři common a příště je tam najdeš. co ještě dalšího potřebuješ ke štěstí? aby všichni slepě následovali tvou víru v PSR0? dej s těmahle malichernostma pokoj

a mimochodem, pojmenování a umísťování souborů je coding standard. za feature to nelze považovat ani omylem. tak nechápu co to dělá v téhle místnosti fóra. založil bych pro to místnost „plané plky“

Editoval paranoiq (15. 11. 2011 15:53)

Řekl akorát svůj názor :P a úplná blbost to není, logiku to přece má – přestože mě osobně to taky nikdy netankovalo, ctrl+klik a je to (i když v poslední době mi to nějak blbne), navíc mi přijde struktura celkem intuitivní a skoro PSR0 to taky je

paranoiq: +1.

Nette není u nás rozšíření kvůli tomu, že by ho David školil, či že by mělo českou dokumentaci, nedej bože kvůli tomu, jak je resistní vůči bc breaks. Ale proto, že právě slepě nedodržuje „standardy“ a snaží se nad každou věcí trochu víc zamyslet.

PSR-0 by způsobilo zabordelení např. root složky, nebo, chcete-li, zbytečně zanoření těchto tříd.

hrach napsal(a):

Ale proto, že právě slepě nedodržuje „standardy“ a snaží se nad každou věcí trochu víc zamyslet.

Nette skutecne neni uspesne kvuli nedodrzovani konvence v pojmenovani a umistovani souboru s tridami. Naopak bych vyrkl provokativni nazor, ze si tim Nette spise skodi – novacci (tj. lidi, kteri jiz pouzivali jiny framework) pak mohou byt z takoveho usporadani vykuleni, az se vrhnou zjistovat, co delaji zrovna spatne, nebo jak nejaka komponenta funguje. (A vykulenost urcite nepatri k pocitu, ktery by Nette melo navozovat – prvni dojem je vzdy dulezity!)

PSR-0 by způsobilo zabordelení např. root složky, nebo, chcete-li, zbytečně zanoření těchto tříd.

Pro nekoho, kdo nedela pouze s Nette, naopak zabordeleni zpusobuje absence podobne konvence ci logiky v ukladani souboru. Ona tam logika samozrejme je, ale uz je to na bazi nazoru, ze „trida Environment patri do common protoze …“ (zatimco druhy si rekne, ze „Environment by melo byt spise v Application“).

Ne kazdy vidi Davidovi do hlavy, aby vedel, proc to rozmistil zrovna takto. Proto je pak uzitecne dodrzovat neco, co je zcela bezne – a ne jen kricet, ze ostatni jsou tupci, a ze „my“ to delame nejlepe, protoze jdeme proti proudu. Jit proti proudu musi mit nejaky smysluplny duvod, ktery zrovna v tomto pripade skutecne postradam.

Navic – o co jde? Prejmenovat par souboru / soubory nekam premistit… Je to skutecne takovy problem?

Samozrejme, cele toto me prani o pouzivani PSR-0 je o tom, abych snaze dohledal veci v Nette, kdyz to zrovna potrebuji. Svuj kod si budu psat ciste, a verim, ze malokdo si zacne dobrovolne delat zmatek ve svem vlastnim kodu ;) (i kdyz by mu ten zmatek zprvu pripadal prehledny)

U velkých knihoven typu Zendu, Symfony, Doctrine a podobně RobotLoader věru není dobrým řešením, protože pak člověk přidá třídu v aplikaci a pak po F5 si může jít vařit kafe. #trueStory

1. Pokud vim při přidání se neinvaliduje celá cache, normálně si přidávám třídy a zpomalení oproti defaultnímu načtení není žádné
2. Projekt kde je Doctrine se mi reindexuje na tom pomalejším z PC asi 2.5 sekundy, to se k tomu kafi ani nezdvihnu ze židle. Možná pokud by měl někdo fakt psychoprojekt s 3 celýma frameworkama spojenýma dohromady (??) a několika knihovnama … i tak to proběhne rychleji než kdyby člověk dělal s jazykem, který se kompiluje

(RobotLoader v podstatě ten výčtový loader je)

Abych si s váma taky zaflejmoval…

Na všechno teď používám UniversalClassLoader, který spojuje PEAR standard a PSR-0 pro pojmenování a díky tomu není potřeba, aby php procházelo několik loaderů, než se třída načte. Ke knihovnám, které uznávají tenhle standard, má RobotLoader zakázaný přístup, takže indexuju jenom app/ a cokoliv co nejde jinak.

A kde je jaký soubor neřeším, IDE prakticky nevypínám :)

@**wdolek** má pravdu v tom, že je to na první pohled matoucí, ale tím spíše si to zapamatuješ, kde máš příště hledat, aniž by jsi se snažil si to pamatovat :) No a taky, common je jediný adresář, který má v Nette/ malé písmeno.

HosipLan napsal(a):

A kde je jaký soubor neřeším, IDE prakticky nevypínám :)

Zda se ale, ze ne vsechny IDE jsou multiplatformni (PHPEd), popripade ne vsechny IDE to zvladaji (Aptana mi s proklikavanim do Nette nefugnuje, Eclipse jen kdyz je venku hezky, NetBeans jzem zavrhl s posledni verzi (7))

…ale tím spíše si to zapamatuješ, kde máš příště hledat, aniž by jsi se snažil si to pamatovat :)

Zase tak casto do kodu Nette nelezu, abych si to musel vylozene pamatovat. Otravne je to, ze musim grepovat celou knihovnu, abych zjistil, kde se trida skutecne nachazi.

btw a co API s vyhledavacem? Lenost programatoru me stale neprestava udivovat, jen se bojim az se zdrojaky budou kodit sami a my vsichni prijdem o praci :-D

hAssassin napsal(a):

btw a co API s vyhledavacem? Lenost programatoru me stale neprestava udivovat

Takze krome diktatu „musis pouzivat jedine NetBeans“ tu mame dalsi „musis byt neustale online“… ? :)

hrach napsal(a):

takze kdybys misto tech kecu tady se na to podival, nemas problem.

Vyprosoval bych si nejake verbalni utoky hodne malych deti. Predpokladam, ze jsme zde vsichni alespon trochu na urovni, tak se podle toho chovejme.

A k tematu, aktualni seznam trid/souboru (ktery tedy stejne nikoho nezajima):

[er] "Nette\Application\AbortException" does not correspond to path "Nette/Application/exceptions.php"
[er] "Nette\Application\ApplicationException" does not correspond to path "Nette/Application/exceptions.php"
[er] "Nette\Application\InvalidPresenterException" does not correspond to path "Nette/Application/exceptions.php"
[er] "Nette\Application\BadRequestException" does not correspond to path "Nette/Application/exceptions.php"
[er] "Nette\Application\ForbiddenRequestException" does not correspond to path "Nette/Application/exceptions.php"
[er] "NetteModule\MicroPresenter" does not correspond to path "Nette/Application/MicroPresenter.php"
[er] "Nette\ArrayHash" does not correspond to path "Nette/common/ArrayHash.php"
[er] "Nette\ArrayList" does not correspond to path "Nette/common/ArrayList.php"
[er] "Nette\Callback" does not correspond to path "Nette/common/Callback.php"
[er] "Nette\Configurator" does not correspond to path "Nette/common/Configurator.php"
[er] "Nette\DateTime" does not correspond to path "Nette/common/DateTime.php"
[er] "Nette\Environment" does not correspond to path "Nette/common/Environment.php"
[er] "Nette\ArgumentOutOfRangeException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\InvalidStateException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\NotImplementedException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\NotSupportedException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\DeprecatedException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\MemberAccessException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\IOException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\FileNotFoundException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\DirectoryNotFoundException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\InvalidArgumentException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\OutOfRangeException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\UnexpectedValueException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\StaticClassException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\FatalErrorException" does not correspond to path "Nette/common/exceptions.php"
[er] "Nette\Framework" does not correspond to path "Nette/common/Framework.php"
[er] "Nette\FreezableObject" does not correspond to path "Nette/common/FreezableObject.php"
[er] "Nette\IFreezable" does not correspond to path "Nette/common/IFreezable.php"
[er] "Nette\Image" does not correspond to path "Nette/common/Image.php"
[er] "Nette\UnknownImageFileException" does not correspond to path "Nette/common/Image.php"
[er] "Nette\Object" does not correspond to path "Nette/common/Object.php"
[er] "Nette\ObjectMixin" does not correspond to path "Nette/common/ObjectMixin.php"
[er] "Nette\DI\MissingServiceException" does not correspond to path "Nette/DI/exceptions.php"
[er] "Nette\DI\AmbiguousServiceException" does not correspond to path "Nette/DI/exceptions.php"
[er] "Nette\Mail\SmtpException" does not correspond to path "Nette/Mail/SmtpMailer.php"
[er] "Nette\Utils\RecursiveDirectoryIteratorFixed" does not correspond to path "Nette/Utils/Finder.php"
[er] "Nette\Utils\JsonException" does not correspond to path "Nette/Utils/Json.php"
[er] "Nette\Utils\NeonException" does not correspond to path "Nette/Utils/Neon.php"
[er] "Nette\Utils\RegexpException" does not correspond to path "Nette/Utils/Strings.php"
[er] "Nette\Utils\TokenizerException" does not correspond to path "Nette/Utils/Tokenizer.php"

… Ano, mohu se podivat, mohu se to namemorovat jako basnicku nebo jako matematicke vzorecky. Bohuzel pro mne Nette neni stredem vesmiru a pracuji i s jinymi frameworky – takze i kdybych si tuto informaci pamatovat chtel, stejne to vypustim po par dnech z hlavy.

Mou motivaci pro zmenu adresarove struktury je vymyceni co nejvice WTF faktoru z Nette… Chapu, ze jsem se nekterym dotkl jejich modly a rozumim tomu – proto zde ale uvadim svuj pohled na vec, a doufam, ze budu pochopen.

Shrnu-li to…:

Ve stavajici diskusi padly argumenty (doufam, ze jsem neco neprehledl):

• nedodrzeni PSR-0 je jednodussi pro novacky, protoze nevidi v Nette knihovne balast (a zaroven ze novacek v Nette knihovne stejne nema co delat, coz vlastne popira cely tento duvod)
• NetBeans umi proklikavat jmena trid
• na internetu je online dokumentace vsech trid vcetne zdrojaku

Me argumenty jsou:

• dodrzeni PSR-0 je common sense – zdravy selsky rozum (kterym je postizen okolni svet)
• pro nekoho, kdo dela v jinem frameworku je to zkratka WTF, byt ma treba IDE s proklikavanim a nebo je online a muze se podivat do dokumentace
• odpada pouzivani vice typu loaderu, vcetne kuriozity, kterou jsem nikde jinde nevidel – vyctovy loader se seznamem trid a mapovanim na soubor (a stale staci jen inicializovat jediny loader)

Zdrojovy kod se vice cte nez pise – proto tomu celemu davam takovou vahu – a proto by melo byt na prvni pohled jasne, kde co je.

Editoval wdolek (17. 11. 2011 14:28)

hrach napsal(a):

třídy naprosto zřejmé, pakliže patří do hlavního namespacu, ale neruší v root složce.

Zrejme… Uz skutecne nevim, co bych k tomu mohl vice dodat. Ano, v pripade Exceptions to smysl dava – na druhou stranu by to pak byla vyjimka v pouziti PSR-0. A dale se odkazuji na predesly post se seznamem argumentu pro/proti.

Někdo, kdo si na něco stežuje a v tu chvili dělá to stejné, je pro mě ignorant.

Nejsem si vedom toho, ze bych tu vykrikoval neco o „necich kecech“ ;) … + mi ta veta po tretim precteni nedava uplne smysl :(

Editoval wdolek (17. 11. 2011 14:52)

Patrik Votoček: (Úvod stejný.) Zde nejde o problém si něco zapamatovat. Ale o to, že je vůbec třeba si něco takového pamatovat, když opravdu snadnou úpravou (resp. nesložitou) jde celá věc hezky zjednodušit bez dalších zbytečných kompikací (tím myslím PSR-0 s výjimkami… na které jsou další výjimky).

Ale to zde již bylo psáno také…

Editoval Yrwein (17. 11. 2011 16:33)

vojtech.dobes

Nette reseni mi ale neprijde univerzalni. A to, ze to „vsichni delaji nejak a Nette po svem“ to neni hlavni argument, ale uz jen takova poznamka – ono to ma asi nejaky duvod, proc se toho vsichni drzi. Duvodem je zjevne univerzalnost, a hlavne pritomnost toho selskeho rozumu, bez nutnosti si cokoliv pamatovat a je na prvni pohled videt, kde co je. (V teto zavorce bych rad zvyraznil to na prvni pohled … –na prvni pohled–)

Ano, mozna to v pripade Exceptions neni uplne vhodne, na druhou stranu dle meho univerzalnost PSR-0 prevysuje nevyhody.

Yrwein

+1

Mimochodem, napadlo me takove srandovni prirovnani: Pojdme psat dokumentaci pouze v Esperantu – Esperanto je snadny jazyk, a za jeho vznikem byla uslechtila myslenka. Nette se tak odlisi od vsech, a cele to bude hrozne skvele, protoze proste… esperanto. A az nekdo bude narikat, ze dokumentace neni v cestine nebo anglictine, muzeme mu rict, at se nauci tento jednoduchy jazyk.

Patrik Votoček napsal(a):

…A vedle toho napsat verbalni utoky hodne malych deti. Mě nepřipadá jako vhodný pokus o nápravu.

„utoky hodne malych deti“ je vlastnost takovychto verbalnich utoku. Mohl jsem klidne napsat, „…zelene verbalni utoky“ :) Nepovazuji na tom nic divneho, a ani jsem tim nikoho nechtel insultovat.

Editoval wdolek (17. 11. 2011 22:09)

Pokud ti PSR-0 přijde moc ukecané, vždycky můžeš používat minified verzi Nette.

Pánové, vždyť se tady jenom napadáte (byť slušně, většinou) a ještě jsem nečetl jediný logický důvod, proč by to nemohlo být v PRS-0. Proč ne? Proč jo? Mě by to fakt zajímalo. Už jsem se účastnil minulého flamu na tohle téma a do dnes to nevím.

Ani jeden z důvodů proti PRS-0 není podle mě objektivní.

Disclaimer: autorovi je to úplně u pr*ele.

wdolek napsal(a):
Nerikej mi ale, ze ty ses do zdrojaku Nette nikdy nepodival ;D (a netvrd mi, ze jsi hned vedel, kde ktera trida je – tohle by neuhodla ani televizni kartarka, ktera predpovida po pulnoci na Prime).

do kódů Nette se dívám velice často. zároveň nepoužívám žádné IDE, ale PSPad. nalezení souboru v adresáři Nette je ale o několik řádů jednodušší problém než pochopení zdrojového kódu v něm. jak už vysvětlili jiný výše pravidla jsou jednoduchá: opěvované PSR0 + výjimka pro hlavní namespace + výjimka pro výjimky…

wdolek napsal(a): „ukaž univerzální řešení“

univerzální řešení neexistují. vždy se musí někdo přizpůsobit

O jakém bordelu v rootu hostingu je řeč? Já tam nic takového nemám :-) jestli si nedovedeš udržet pořádek v rootu hostingu prostým umístěním projketu do adresáře app_name.com, tak je to tvůj problém a ne problém sandboxu.

Jinak mi tahle diskuze přijde úplně zbytečná a je asi 100 důležitějších věcí, která je v Nette potřeba řešit.

Už to někde proboha zamčete.

Já jsem si sice na nové(3.5.) namespace zvykl , ale tím chci říct, že se mi nelíbí dělat změny. Kromě toho Netbeans 6.9.1 spolupracuje, takže se lze proklikat a funguje autocomplete a ve výsledku to neřeším a je skoro jedno. PS: api.nette.org si můžete stáhnout a uložit na disk–nemusíte být online.

Ještě pro doplnění: zdrojáky si prohlížím zhruba pořád stejně, jako před rokem.

Editoval bojovyletoun (20. 11. 2011 22:07)

bene napsal(a):

Proč jsem ale na první dojem odbočil od tématu? Opravdu jen na první dojem. Protože mi nejde do hlavy proč je tolik lidí šťastných že má Nette v root adresáři čisto a pro začátečníka to je milý pohled, ale sandobx, který použije téměř každý začátečník se vydává NAPROSTO opačnou cestou. A upřímně, mít bordel v rootu hostingu je daleko větší problém a riziko než root adresář Nette.

+1 :-)

Složky app/, www/, log/, temp/, tests/ v rootu webu, se kterými má část hostingů problém.