Jason Winnebeck wrote:
I am working on upgrading my Trac 0.10 environment to 0.11, but I am having problems with development. I am a Java/C++/C# developer so my Python experience is negligable. I am reading up on Python as a language, so that's not what my question is about.Basically my question is that I don't know how to RTFM on Trac because I don't know how to find documentation. I've read the wikis on Trac with TracDev, and I've found examples online -- I've gotten mostly as far as I have because of that. But I can't move beyond the "copy and paste" level. OK so to get to the point: In Java I would be able to use Javadoc to find out what methods exist in a Trac object, and what the parameters to expand_macro are, and their types. How can I do this in Trac? Like in expand_macro I get a variable "formatter" but what type is it? If it's an object what methods and variables does it have? Am I missing something, like a document generator like Javadoc that would generate something to give me lists of functions and classes in Trac? Another example is Markup. From what I can tell I should be converting stuff to use the Markup object, which is in trac.wiki.util I think. I've had some small success finding source code to use as "documentation", but there is no such directory, so I can't even find the source for Markup. Part of this probably comes from the fact that Python has weak typing. I figure that the way to overcome that is by documentation, but I'm working hard trying to find it, and how to use it effectively. Also, I know that Python isn't "compiled" but is there a command to run to even at least check my syntax? Right now my method is trial-and-error by uploading plugins and testing. Python virtualenv is helping me immensely but it is still slow going.
Rather than answer this directly, I am just going to say you should come sit in #trac (on freenode). You will be able to get faster and better answers in general.
--Noah
signature.asc
Description: OpenPGP digital signature
