Re: Understanding other people's code

2013-07-27 Thread Chris Angelico
On Sat, Jul 27, 2013 at 2:13 PM, Albert van der Horst wrote: > If the code is really tidy, it is possible to understand a function > using only the *documentation* (not the code itself) of any function > or data it uses. I'd broaden that slightly to the function's signature, which consists of the

Re: Understanding other people's code

2013-07-27 Thread Albert van der Horst
In article , Azureaus wrote: >On Friday, 12 July 2013 15:22:59 UTC+1, Azureaus wrote: > >To be fair to who programmed it, most functions are commented and I >can't complain about the messiness of the code, It's actually very tidy. >(I suppose Python forcing it's formatting is another reason it'

Re: Understanding other people's code

2013-07-25 Thread Azureaus
On Friday, July 12, 2013 3:22:59 PM UTC+1, Azureaus wrote: > Hi all, > > I've been asked to take over a project from someone else and to extend the > functionality of this. The project is written in Python which I haven't had > any real experience with (although I do really like it) so I've spen

Re: Understanding other people's code

2013-07-19 Thread David Hutto
I forgot to mention idle. It can step through another's code and show you a step-by-step insructional, of what the code does. On Tue, Jul 16, 2013 at 8:05 PM, David Hutto wrote: > Any program, to me, is just like speaking english. The class, or function > name might not fully mesh with w

Re: Understanding other people's code

2013-07-16 Thread David Hutto
Any program, to me, is just like speaking english. The class, or function name might not fully mesh with what your cognitive structure assumes it to be.read through the imports first, and see the classes and functions come alive with experience comes intuition of what it does, and the instances tha

Re: Understanding other people's code

2013-07-16 Thread David M Chess
> Literally any idea will help, pen and paper, printing off all the code and doing some sort of highlighting session - anything! > I keep reading bits of code and thinking "well where the hell has that been defined and what does it mean" to find it was inherited from 3 modules up the chain. >

Re: Understanding other people's code

2013-07-16 Thread Jean-Michel Pichavant
- Original Message - > Thanks for all the suggestions, I'm afraid I didn't get a chance to > view them over the weekend but I will get started with them this > morning. I'm currently using sublime 2 for my text editor and tried > to create a UML diagram using Pylint to try and get a map ove

Re: Understanding other people's code

2013-07-15 Thread asimjalis
On Friday, July 12, 2013 7:22:59 AM UTC-7, Azureaus wrote: > Hi all, > I've been asked to take over a project from someone else and to extend the > functionality of this. The project is written in Python which I haven't had > any real experience with (although I do really like it) so I've spent t

Re: Understanding other people's code

2013-07-15 Thread CM
On Monday, July 15, 2013 6:02:30 AM UTC-4, Azureaus wrote: > To be fair to who programmed it, most functions are commented and I can't > complain about the messiness of the code, It's actually very tidy. (I suppose > Python forcing it's formatting is another reason it's an easily readable > lan

Re: Understanding other people's code

2013-07-15 Thread Azureaus
On Friday, 12 July 2013 15:22:59 UTC+1, Azureaus wrote: > Hi all, > > I've been asked to take over a project from someone else and to extend the > functionality of this. The project is written in Python which I haven't had > any real experience with (although I do really like it) so I've spent

Re: Understanding other people's code

2013-07-14 Thread CM
> Basically the problem is I am new to the language and this was clearly > written by someone who at the moment is far better at it than I am! Sure, as a beginner, yes, but also it sounds like the programmer didn't document it much at all, and that doesn't help you. I bet s/he didn't always us

Re: Understanding other people's code

2013-07-12 Thread Joel Goldstick
On Fri, Jul 12, 2013 at 6:11 PM, Terry Reedy wrote: > On 7/12/2013 10:22 AM, L O'Shea wrote: > >> Hi all, I've been asked to take over a project from someone else and >> to extend the functionality of this. The project is written in Python >> which I haven't had any real experience with (although

Re: Understanding other people's code

2013-07-12 Thread Terry Reedy
On 7/12/2013 10:22 AM, L O'Shea wrote: Hi all, I've been asked to take over a project from someone else and to extend the functionality of this. The project is written in Python which I haven't had any real experience with (although I do really like it) so I've spent the last week or two settling

Re: Understanding other people's code

2013-07-12 Thread Eric S. Johansson
On Fri, 12 Jul 2013 10:22:59 -0400, L O'Shea wrote: Literally any idea will help, pen and paper, printing off all the code and doing some sort of highlighting session - anything! I keep reading bits of code and thinking "well where the hell has that been defined and what does it mean" to

Re: Understanding other people's code

2013-07-12 Thread Peter Otten
L O'Shea wrote: > Hi all, > I've been asked to take over a project from someone else and to extend the > functionality of this. The project is written in Python which I haven't > had any real experience with (although I do really like it) so I've spent > the last week or two settling in, trying to

Re: Understanding other people's code

2013-07-12 Thread Chris Angelico
On Sat, Jul 13, 2013 at 12:22 AM, L O'Shea wrote: > I'm starting to get pretty worried about my lack of overall progress and so I > wondered if anyone out there had some tips and techniques for understanding > other peoples code. There has to be 10/15 different scripts with at least 10 > functi