Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

metasyntactic - Themed metasyntactic variables names

Project description

Version: 0.99


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.

Release history Release notifications

This version
History Node


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
metasyntactic-0.99.tar.gz (160.2 kB) Copy SHA256 hash SHA256 Source None Sep 8, 2011

Supported by

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