We, at Qafoo, do Code Reviews quite often together with our customers. This often focusses on dicussing metrics, browsing the associated code and discussing solutions for the issues found. We started using a bunch of shell scripts for that, like everyone else, but at some point we came up with a webinterface to do this in a more comfortable way. Now we want to share this tool with you.

Included in the post are several screenshots showing the results of the different types of evaluations - the ones mentioned above as well as things like "methods per class", cyclomatic complexity and NPath complexity. There's also a source code browser and a visual class structure generation tool (UML). It's under a AGPLv3 license and can be found on their site.

Sometimes you need to share a design with your colleagues. You can walk him through the code, and explain which classes and interfaces you created, but there are higher abstracted models that you can show to him to make him grasp the picture quickly. One of these tools is UML, and in particular class diagrams.

His script creates a UML diagram from a PHP object graph, a sort of "reverse engineering" of the current object's hierarchy and relationships. It creates definitions that Yuml.me can use to generate the image and does some handy things like following the path down N levels until it hits "the bottom" and the ability to ignore certain namespaces (like "Zend_" or "Doctrine_") to help limit things down to just your application. He includes a sample set of tests to show it in action as well as a resulting UML diagram generated from the PHPUnit structure.

When discussing books on software engineering with colleagues, I got the idea of listing the best books I've read in the past 15 years. Because it seems useful, but also because that will allow others to tell me which ones I should have read.

He lists five books that cover some of the "meta" about programming:

• Applying UML patterns
• Design Patterns - GoF
• Refactoring (Martin Fowler)
• Test-Driven Development (Kent Beck)
• Clean Code (Robert Martin)

Rise your hands if time ago (or even now) you stood literally in trance listening to your friends or colleagues talking about design patterns. [...] Anyway I felt better (and also my ego did) when I found those Design Patterns were no more than ways to solve common programming problems, and as I was programming since 2 or 3 years, I had already discovered some of them myself.

He points out two patterns - the strategy and factory patterns - and gives code examples (and UML diagrams) to show how they work.

Visustin is the ideal diagramming tool for software developers and document writers. Save your documentation efforts by automatic charting! Visustin reverse engineers your source code and visualizes it. No manual drawing is required. Your existing code is all you need. If you see a real complex case, print it out as a big mosaic and hang it on your wall.

Functionality includes the automatic creation of a optimized layout, the ability to do a multi-page printout, saving the graphs/charts/etc in various formats, run a "bulk chart" on all of your files at once, and export options including PowerPoint, out to the web, and Word.

You can get the full details on the product (as well as screenshots and a demo) from their website.