Python Programming, news on the Voidspace Python Projects and all things techie.
rest2web 0.5.1 is now available. This is a minor feature enhancement release.
What Is rest2web?
Maintaining websites or project documentation in HTML is a pain. rest2web takes out the pain, and brings back the joy.
rest2web is a simple tool that lets you build your website from a single template (or as many as you want), and keep the contents in ReStructured Text. (You can still keep pages in HTML if needed.)
It has an easy to use templating system, with embedded Python for unlimited flexibility and no new templating language to learn. It has built in functions or creating sidebars and navigation elements of a site.
What's New in 0.5.1 ?
Added some extra debugging info to syntax errors in the templates.
Fixed odict and pathutils for Python 2.5 compatibility.
Added the 'promote_headers' option to the config file.
Added the sortpages method to the sections. This sorts the pages in a section (or all sections) alphabetically. You can also pass in a custom sort function.
More ConfigObj Fixes in Subversion
The latest changes are to ConfigObj, validate and the docs :
The changes are :
- Fixed validate doc to talk of boolean instead of bool; changed the is_bool function to is_boolean (Sourceforge bug #1531525). Thanks to the reporter for this one.
- Added a missing self. in the _handle_comment method and a related test, per Sourceforge bug #1523975. Thanks to the reporter for this one too.
- Allowed arbitrary indentation in the indent_type parameter, removed the NUM_INDENT_SPACES and MAX_INTERPOL_DEPTH (a leftover) constants, added indentation tests (including another docutils workaround, sigh), updated the documentation. Thanks for this one go to Jorge Vargas, even if I ended up not using his patch that added a new indent_size parameter.
- Made the import of compiler conditional so that ConfigObj will run on IronPython
There are still some further changes to go in. Nicola and I are discussing how and if all the proposed features should be added.
New Windows Forms Tutorial Entry
In celebration of the new IronPython section I've added a new entry to the Windows Forms Tutorial Series.
This is entry number eleven :
It uses a few new controls to create a slightly more complex GUI than we've seen before in this series.
New IronPython Section
I've created a new section on Voidspace :
I've moved the Windows Forms tutorials here and setup an aggregator for IronPython related blogs.
If you spot any typos, or know of any good blogs I should add to the Planet feed then let me know.
Selfless as a Metaclass
Having created a decorator that removes the need to explicitly declare self in methods, wouldn't it be nice to be able to apply it automatically ?
An Introduction to Metaclasses is a brief tutorial that explains the basics of metaclasses. It creates a metaclass factory which produces metaclasses that decorate all the methods in a class with a function.
This is illustrated by creating a metaclass called Selfless that automatically wraps every method in classes with the selfless decorator from the previous entry.
Have you ever had friends who wouldn't try Python because of the explicit declaration of self ? Well, me neither actually; but I do know at least one Polish Ruby programmer  who dislikes it. But if you did know people like that, your worries would be over...
To follow this frippery you'll need the Byteplay module.
Below is a decorator named selfless. It automatically adds the self argument to methods on classes, so they can be defined without it.
The Test class proves that it works.
def _transmute(opcode, arg):
if ((opcode == opmap['LOAD_GLOBAL']) and
(arg == 'self')):
return opmap['LOAD_FAST'], arg
return opcode, arg
code = Code.from_code(function.func_code)
code.args = tuple(['self'] + list(code.args))
code.code = [_transmute(op, arg) for op, arg in code.code]
function.func_code = code.to_code()
self.x = x
self.x = x
test = Test()
Because self isn't passed explicitly to the functions, the interpreter treats self as a global. selfless (and its sidekick _transmute) change the LOAD_GLOBAL op-codes into LOAD_FAST. We then tell the code object that it takes an extra argument, self. The byteplay Code automatically handles setting the correct stack-size on the new code object it creates.
In the next exciting instalment we'll (well, me actually...) create a metaclass that applies this automatically to all methods in a class.
If you're interesting in bytecodes and code objects, you may be interested in Anonymous Code Blocks in Python.
|||Mentioning no names Andrzej...|
This work is licensed under a Creative Commons Attribution-Share Alike 2.0 License.