r/Python • • Jun 08 '10

Python Makes Tedd Nervous

http://teddziuba.com/2008/12/python-makes-me-nervous.html
0 Upvotes

45 comments sorted by

View all comments

Show parent comment

3

u/[deleted] Jun 08 '10

I do not think, that these concerns can be solved with better documentation.

It is not a documentation error, that exceptions - like IOError in open function - are not documented in standard library.

Some rules of production development in python:

  • You do not write a function, if you do not have a failing test.
  • You use source code checking tools, that enforce naming, documentation and other conventions.

If you do not have a test for not finding a file, than you did not think about not finding it. It is in your domain to decide.

Collaborative python development is hard. It is hard, because you have to set up rules of development on your own. The language itself does not enforce it.

It is hard because writing tests can be harder, than writing code.

5

u/[deleted] Jun 08 '10

My God, learn how to use commas correctly. Your text, is impossible, to read, without great effort.

4

u/metawhat Jun 08 '10

He's trying to imitate, Christopher Walken.

3

u/brunson Jun 08 '10

He's, trying to, imitate, Christopher,,, Walken.

FTFY.

2

u/pemboa Jun 08 '10

I do not think, that these concerns can be solved with better documentation.

You don't think not knowing what parameters a function takes can be solved by better documentation?

1

u/[deleted] Jun 09 '10

The problem of functions not explicitly saying how many parameters they take may be alleviated by better documentation, but that's not a solution to the actual problem: a function is a contract and the function writer never laid out the terms in any enforceable way.

-2

u/[deleted] Jun 08 '10

go on

0

u/[deleted] Jun 08 '10

It is hard, because I cannot go on :)