Generating Python Code and Eggs

This document describes the pyegg UML profile.

Profile

UML:Package

<<pyegg>>

Create or point a complete python egg structure. A pyegg package can be named with dotted name. Splitted name represents namespace packages. Package directories are located in src folder of egg root. File README.txt is created if inexistent. setup.py is created or pointed.

Tagged Values:

• version: Used as version in setup.
• description: Used as description in setup.
• author: Used as author in setup.
• email: Used as author_email in setup.
• keywords: Used as keywords in setup.
• url: Used as url in setup.
• license: Used as license in setup.
• zipsafe: Used as zipsafe in setup. Either True or False.
• classifiers: Used as classifiers in setup. Valid Classifiers can be found at http://pypi.python.org/pypi?%3Aaction=list_classifiers. Classifiers must be seperated by comma (,).
• copyright: Used as Copyright header for python modules. Linebreak is indicated by linefeed (\n).

<<pypackage>>

Create or point the directory with package name and create or point package’s __init__.py file.

Tagged Values: None

<<pymodule>>

Treat package as python module. Thus create or point a python file with package name. All classes in this packages are written into same module instead of creating module files for each class in a UML package if marked with pypackage.

Tagged Values: None

UML:Class

<<stub>>

Indicate class as stub. Used for generalization of 3rd-party objects.

Tagged Values:

• import: Package name to import general class from, i.e. assuming class name is Baz, setting value to foo.bar results in from foo.bar import Baz.

<<decorator>>

Define python decorator.

If args and kwargs are omitted in model, they’re never touched, change them in generated code as you like.

Tagged Values:

• name: Decorator name.
• args: Arguments passed to decorator, i.e. foo, bar. Arguments must be seperated by comma (,).
• kwargs: Keyword arguments passed to decorator, i.e. foo=0, bar=1. Keyword arguments must be seperated by comma (,).

UML:Operation

<<decorator>>

See UML:Class::decorator

UML:Generalization

<<derive>>

Derive settings.

Tagged Values:

• order: If UML Class inherits from 2 or more bases but order matters, set integer value for all generalizations. Lower value for the one needed first.

UML:Property

<<expression>>

Set an expression for UML Property. Normally you do not model properties on python level, except they are useful for documentation or semantic reasons. Even if, value is set to None by default. Expression stereotype provides changing this.

Tagged Values:

• expression: Some python expression, i.e. [x for x in ["xxx"]].