Skip to main content

metasyntactic - Themed metasyntactic variables names

Project description

Version: 1.0.14


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()

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

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


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

# get default category
>>> foo.default()

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

# get all names in specific category
>>> foo.all(category="fr")

>>> 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.

Download files

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

Files for metasyntactic, version 1.0.14
Filename, size File type Python version Upload date Hashes
Filename, size metasyntactic-1.0.14-py3-none-any.whl (421.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size metasyntactic-1.0.14.tar.gz (336.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page