Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python module and command line script client for http://urbandictionary.com
branch: master
Failed to load latest commit information.
.gitignore add .gitignore
README Make it work on Python 2.7
setup.py Bump version to 0.2.
urbandicli Fix pager support in Python 2.x
urbandict.py Support new HTML markup

README

py-urbandict
============

py-urbandict is a client for urbandictionary.com.

Project page on github: https://github.com/novel/py-urbandict

Installation
------------

Just run:

  sudo setup.py install

Usage
__________
To use it from command line, just use 'urbancli' tool like that:

$ urbandicli xterm
1. xterm
  Godly creature, omnipotent, guru in every way imaginable.
  
  Examples:
  
  * I wish i was an xterm


$

Usage from Python:

$ python3.2
Python 3.2 (r32:88445, Feb 27 2011, 09:51:00) 
[GCC 4.2.1 20070719  [FreeBSD]] on freebsd8
Type "help", "copyright", "credits" or "license" for more information.
>>> import urbandict
>>> urbandict.define('xterm')
[{'word': 'xterm', 'example': 'I wish i was an xterm', 'def': 'Godly creature, omnipotent, guru in every way imaginable.'}]
>>> 

It returns list of defitinitions for a term. Each list item is a dict with the following keys:

 * word -- the word itself
 * def -- definition of the term
 * example -- example of its usage (could be empty)
Something went wrong with that request. Please try again.