dolibarr-dev
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Dolibarr-dev] IDE and Code format style ?


From: Marcos García
Subject: Re: [Dolibarr-dev] IDE and Code format style ?
Date: Mon, 24 Feb 2014 17:47:28 +0100

Hi all:

I just want to say that I agree with Raphaël, but I also want to say that using PSR-2 without some things is not using PSR-2 but creating a new standard. I would appreciate that we take that into consideration, if we want to follow PSR-2 we should follow it with all its pros and cons, we could start by using PSR-1 and then moving to PSR-2.

Also you should take a look at http://cs.sensiolabs.org/ which is a script that converts the code into PSR-2 CS.

Raphaël, PSR-0, PSR-3 and PSR-4 are standards for other uses, I don't think we should take them into this discussion.

Regards,
 
Marcos García
address@hidden


2014-02-24 16:45 GMT+01:00 Doursenaud, Raphaël <address@hidden>:
FWIW PSR-2 also includes PSR-1 and PSR-0.
Well, Dolibarr is very far from being PSR compliant, even with the indentation (tabs instead of 4 spaces) and line length (unlimited vs, mmm well, unlimited with a recommendation to keep them under control, preferably under 120 chars, 80 chars being optimum) discrepancies.

A few examples:
Some Dolibarr files declare symbols and cause side effects
Most Dolibarr classes are not named in StudlyCaps.
Most Dolibarr methods are not named in CamelCase()
PHP closing tag is never omitted.
Use of var instead of visibility in most, if not all, class properties
Visibility is not set on most methods.
Opening braces, control structures and spaces don't meet PSR-2 requirements.

Now, what should we do?
Keep using the legacy style or make the code PSR-2 compliant ASAP?

You know I vote for the later.

What about PSR-3 and PSR-4 ?
I think we should adopt the whole PSR package or use any other well-defined coding style available (PEAR, Drupal, Wordpress…) rather than rolling our own.

Also, other developers, you have an opinion, please chime in and speak now or forever hold your peace ;)
Shall we/you/I start a poll ?

Cheers,


2014-02-24 11:16 GMT+01:00 Destailleur Laurent <address@hidden>:

We discussed on that few month ago but i forgot to save conclusion onto developer wiki documentation. I added them onto page:


Conclusion is that we use PSR2 with 2 exceptions (see wiki updated page). And there is a checkstyle page to check we follow this.


2014-02-23 21:58 GMT+01:00 Florian Henry <address@hidden>:
Hi,

     I was working on stuff in dev branch, and it was long time I didn't get to commit. I copy-paste some code lines from other branch or module (to integrate them into the core) and I've seen a lot of the travis "style" syntax check come into pull request.

     I use Eclipse Kepler (4.3) + PDT as IDE. What is yours ?
      - Notepad++
      - PHP Storm
      - Eclipse Indigo (3.7) + PDT
      - Eclipse Helios (3.6) + PDT
      - Vim
     - others

     This question is to know, if it's hard for you to do "auto format" code ?

     After lot's of try and adjustement, I think I found a PHP->Code Style->Formatter Dolibarr syntax that is complaint with the dev/codesniffer/ruleset.xml.
     I put it in attachement. Mostly base one PSR-0 (the default into Eclipse Kepler 4.3)
     I think that the current code style format is the one use by default by Eclipse Indigo (3.7) or Eclipse Helios (3.6), a code style that I didn't found by defaut into Eclipse Kepler and seems not to be a PSR-0 or other standard code style PHP format.

     Well, I think it would be nice to use a normalize code style format like PSR or other one. I think the devcamp will be a good time to do it. What do you think about it ?

     I know I will hate myself, because when I will want to integrate some code lines from others branches I've done for some projets, a compare/diff between old and new files will thanks to me for this brilliant idea. Ok, so lets go to auto format the all code previous branch and it will do the tricks. andafter that no more problem with formating check style.

     I also know that, for Dolibarr, code style PHP format is not a important matter. But if it can be done with the agreement of lot's of person it will be nice.

Regards.

--
Florian HENRY
address@hidden
+33 6 03 76 48 07
http://www.open-concept.pro
Twitter : @_Open_Concept_



_______________________________________________
Dolibarr-dev mailing list
address@hidden
https://lists.nongnu.org/mailman/listinfo/dolibarr-dev




--
Laurent Destailleur (alias Eldy)
------------------------------------------------------------------------------------
Social networks of my OpenSource projects:


_______________________________________________
Dolibarr-dev mailing list
address@hidden
https://lists.nongnu.org/mailman/listinfo/dolibarr-dev




--

http://gpcsolutions.fr
Technopole Hélioparc
2 avenue du Président Pierre Angot
64053 PAU CEDEX 9
SARL GPC.solutions au capital de 7 500 € - R.C.S. PAU 528 995 921

_______________________________________________
Dolibarr-dev mailing list
address@hidden
https://lists.nongnu.org/mailman/listinfo/dolibarr-dev



reply via email to

[Prev in Thread] Current Thread [Next in Thread]