Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Automagically add method definition boilerplate

Project description

autoself: automagically add method definition boilerplate

First, a disclaimer. Explicit self is good. Bytecode hacks are bad.
Put them together and it's quite clear that THIS MODULE IS AN ABOMINATION!
But, it's a neat excursion into python's lower levels and if you *really*
*really* want to save yourself some keystrokes (like, you're desperately
trying to hack into the Death Star's security system to override the trash
compactor as its cold metal jaws slowly squeeze you to a purple paste) then
it can help you do that. But, stop and consider Guido's proclamation on
the matter:

Having self be explicit is a *good thing*. It makes the code clear by
removing ambiguity about how a variable resolves. It also makes the
difference between functions and methods small.
"Things that will Not Change in Python 3000":
http://www.python.org/dev/peps/pep-3099/#core-language

This module is not about making 'self' implicit. It doesn't try to change
the way methods work, or make any semantic changes whatsoever. It does one
simple thing: automatically adds the boilerplate code to make a function do
the "right thing" when called as a method.

It provides a single function 'autoself'. Given a function as argument,
'autoself' will return an equivalent function with the necessary boilerplate
in place to act as a method. This will depend on the specifics of the
function, and could mean:

* Inserting 'self' as the zeroth argument
* Inserting 'cls' as the zeroth argument, and wrapping with classmethod()
* Wrapping with staticmethod() if 'self' and 'cls' are not used
* Doing nothing, if it's not a proper function or is fine the way it is

For example, defining the method 'likes' using:

def likes(self,ham,eggs):
print self, "likes", ham, "and", eggs

Is equivalent to defining it in the following way:

def likes(ham,eggs):
print self, "likes", ham, "and", eggs
likes = autoself(likes)

Or neater, using the @autoself decorator. Of course, this isn't going to
save you any typing! 'autoself' can also be applied to a class, and will
autoselfify all functions in that class's dict:

class HeapsLessTyping:
def likes(ham,eggs):
# This gets 'self' automatically added as zeroth argument
print self, "likes", ham, "and", eggs
def hates(spam):
# This becomes a classmethod, with 'cls' added as zeroth argument
print "all", cls, "hate", spam
def meh(toast):
# This becomes a staticmethod
print toast, "is boring"
HeapsLessTyping = autoself(HeapsLessTyping)

When it becomes available (Python 2.6?), it will be even more convenient to
use this with the class decorator syntax.

Want to save even more typing? 'autoself' can be used as a metaclass to
work its magic on all classes defined in a module:

__metaclass__ = autoself

class LookNoSelf:
def __init__(my,special,args):
self.my = my
self.special = special
self.args = args
class FiveKeystrokesSaved:
def __init__(this,works,great):
self.this = this
self.works = works
self.great = great
counter = 0
def ClassMethodsSaveEvenMore():
cls.counter += 1

Using this style, you can see a net saving in keystrokes with five method
definitions or less!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
autoself-1.1.0-py2.4.egg (13.9 kB) Copy SHA256 hash SHA256 Egg 2.4 Sep 18, 2007
autoself-1.1.0-py2.5.egg (13.8 kB) Copy SHA256 hash SHA256 Egg 2.5 Sep 18, 2007
autoself-1.1.0.tar.gz (5.8 kB) Copy SHA256 hash SHA256 Source None Sep 18, 2007

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page