skip to navigation
skip to content

metasyntactic 0.99

metasyntactic - Themed metasyntactic variables names


This is a port of the excellent Perl module Acme::MetaSyntactic, written by Phillipe (BooK) Bruhat.

In fact it is automatically generated from Acme::MetaSynctacic. And this particular version was generated from version 0.99.

The original CONTRIBUTORS file is shipped with this distribution.



Get a list of all themes:

>>> import metasyntactic
>>> metasyntactic.all_themes

Get random theme:

>>> metasyntactic.random()
<module 'metasyntactic.themes.stars' from 'metasyntactic/themes/'>

Get random metavariable from random theme:

>>> metasyntactic.random().random()

Get 4 random metavariables from random theme:

>>> metasyntactic.random().random(4)
['eve', 'irene', 'frank', 'ellen']

Get random metavariables from 4 random themes:

>>> [theme.random() for theme in metasyntactic.random(4)]
['Barbouille', 'Fragarach', 'Grumpy', 'the_Lord_of_the_Rings']

Get 2 random metavariables from 4 random themes:

>>> [theme.random(2) for theme in metasyntactic.random(4)]
[['Lupa', 'Civetta'],
 ['spigot', 'physique'],
 ['Patrice_Petit', 'Yvette_Chauvire'],


# Get theme by theme name >>> foo = metasyntactic.get(“foo”) >>> foo <module ‘’ from ‘metasyntactic/themes/’>

# Get random name >>> foo.random() ‘fubar’

# Get several random names. >>> foo.random(8) [‘bar’, ‘xyzzy’, ‘foobar’, ‘thud’, ‘foo’, ‘fred’, ‘garply’, ‘quux’]

# Get all names >>> foo.all() set(….)


# Get random name in specific category >>> foo.random(8, category=”fr”) [‘truc’, ‘test1’, ‘machin’, ‘titi’, ‘tutu’, ‘pipo’, ‘test2’, ‘tata’]

# get default category >>> foo.default() ‘en’

# get all available categories >>> foo.categories() set([‘en’, ‘fr’, ‘nl’])

# get all names in specific category >>> foo.all(category=”fr”) set(…)

>>> yapc = metasyntactic.get("yapc")
>>> yapc.random(4, section="america north")
['Buffalo', 'Pittsburgh', 'Boca_Raton', 'Saint_Louis']
>>> yapc.sections()
set(['america north',
     'america south',


You can install metasyntactic either via the Python Package Index (PyPI) or from source.

To install using pip,:

$ pip install metasyntactic

To install using easy_install,:

$ easy_install metasyntactic

If you have downloaded a source tarball you can install it by doing the following,:

$ python build
# python install # as root

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to our issue tracker at


This software is licensed under the Artistic License. And I don’t reserve any copyright for this work, as all the hard work should be credited to the original authors.

File Type Py Version Uploaded on Size
metasyntactic-0.99.tar.gz (md5) Source 2011-09-08 156KB