News for hackers. Stuff that matters.
Re:Ten Years of Git: An Interview with Linus Torvalds by squeaky-clean on Monday April 06, 2015 @03:48PM (#9330297)
Off topic from the article, but this is something I literally just spent my morning wrestling with and fixing, so I'd like to talk/rant about it a little. My apologies in advance for rambling.

You can use doc comments to signify types. You mention you use PyCharm in your article, and it supports doc comments in it's autocomplete and code analysis, I find most popular libraries are commented well enough that PyCharm can understand them.

I also always try (and encourage others) to use names that are declarative for both purpose and type. Of course, you can't always rely on third party libraries (or even colleagues) to be so nice, but I find a good name (almost) always removes all the confusion that normally comes from a lack of static typing.

For example, one of Codecademy's very first Python lessons includes some code like this:

    meal = 44.50
    tax = 0.0675
    tip = 0.15
Which I think is unclear. Imagine these were function arguments. calc_total(meal, tax, tip) is vague. Is meal an object, or a numeric value? (I could possibly see it containing a list of all items in the meal with prices). Tax is almost always a percentage, but what about tip? Judging by the the above values, we can assume a 15% tip, but we don't know if the customer was stingy and tipped $0.15, and by just name alone, we can't tell at all.

    calc_total(meal_cost, tax_percent, tip_percent)
It's now immediately clear to me the type and range of values it accepts. The tip_percent is also an example of when a good name can provide info that even static typing could not, because in either case it is a floating point (please let's not get into a debate about Decimal or currency types :P ). This is a very basic example, but it applies at all levels. Don't call the parameter "users" if the function is not expecting an iterable of User objects. Maybe "usernames" would be better. Etc.

But of course, this only helps if the code you're working with is named well. In something like Java, you have better protection and tools when working alongside lower quality code. I also completely agree with you on point #2 about No Static Types. Navigating through my editor is so much easier in a static language than it is in PyCharm with large projects. And the most annoying thing is that autocomplete breaks with ORMs, and most ORM usage is actually flagged as a warning or error. Ugh.

I also feel very confident in the automated refactoring in something such as an IntelliJ Java project, or ReSharper, but am apprehensive about using PyCharm to refactor anything with usages spanning more than one file. Same goes for Javascript (or any other dynamic language, I suppose. Those are just the two I use).

Enjoyed the posts by the way, adding your blog to my reading list.

Re:Ten Years of Git: An Interview with Linus Torvalds by S4M on Monday April 06, 2015 @04:39PM (#9330564)
The example you mentioned, translated in Java, would be:

    Double mean = 55.50;
    Double tax = 0.0675;
    Double tip = 0.15;
And the function declaration would be:

    Double calc_total(Double meal, Double tax, Double tip)
So even with the types, you have exactly the same problem as in python, and creating a special class to wrap up percentages is something I find quite heavy.

Your alternatives would be to have naming conventions, like you do, or some proper documentation that tells you what the function expects for its arguments, with an example of a function call, which I particularly like in python because of the REPL.

Re:Ten Years of Git: An Interview with Linus Torvalds by vilhelm_s on Monday April 06, 2015 @05:06PM (#9330701)
But perhaps a better type system can still be helpful. E.g. F# supports units of measure, so you can declare 'dollar' as a unit, and write

    let calc_total (meal_cost : float<dollar>) (tax : float) (tip : float) =
       meal_cost * (1.0+tax) * (1.0+tip)
This way it is at least clear from the types that the numbers are meant to be multiplied, not added.
Re:Ten Years of Git: An Interview with Linus Torvalds by S4M on Monday April 06, 2015 @05:12PM (#9330731)
I never used F#. In your example, would the code:

    meal_cost + tax
trigger a compiler exception?
Re:Ten Years of Git: An Interview with Linus Torvalds by vilhelm_s on Monday April 06, 2015 @05:24PM (#9330777)
Yes, you get

    The type 'float' does not match the type 'float<dollar>'
There is an online typechecker, so one can try out F# without installing it: http://www.tryfsharp.org/Learn/scientific-computing#units-of...
Re:Ten Years of Git: An Interview with Linus Torvalds by S4M on Monday April 06, 2015 @05:28PM (#9330798)
And how about:

    meal_cost * tax
?

This one makes sense in the real world, so I suppose an advanced type system allows the programmer to specify what operations are legit or not across different types.

Re:Ten Years of Git: An Interview with Linus Torvalds by vilhelm_s on Monday April 06, 2015 @06:51PM (#9331162)
One could imagine systems for that, but units of measure doesn't do any customization of different operations. It's just unit checking for for arithmetic, like in high-school math.
Re:Ten Years of Git: An Interview with Linus Torvalds by squeaky-clean on Monday April 06, 2015 @06:14PM (#9331005)
> So even with the types, you have exactly the same problem as in python, and creating a special class to wrap up percentages is something I find quite heavy.

Yep, I agree completely and was hoping to make that point. The typing makes it clear that meal is going to be a single price, and that tip won't be a String or something unexpected, but it is still unclear whether it is a percentage or a amount.

I guess what I mean to say is that while static typing certainly helps, it isn't the be-all and end-all of code clarity, and descriptive names can really help code readability regardless of your typing system.

Also, admittedly the example I provided is rather simple. And in any language, you should be using a proper Currency type or library when dealing with money, which would make most of my argument moot:

    Currency calc_total(Currency meal, Double tax, Double tip)
And now specifying tax and tip as percentages isn't necessary. But not all examples are so friendly!
Re:Ten Years of Git: An Interview with Linus Torvalds by mgkimsal on Monday April 06, 2015 @10:39PM (#9331733)
reading "tip_percent" wouldn't tell me how to use it. I've seen people passing in 15 and 0.15 to signify 15% - it depends on how you think about it.

Float tip_percent

might be more of a tip off, but probably not even then.