serkanyersen / underscore.py

Python port of underscore.js

                   __
                  /\ \
 __  __    ___    \_\ \     __   _ __   ____    ___    ___   _ __    __      _____   __  __
/\ \/\ \ /' _ `\  /'_` \  /'__`\/\`'__\/',__\  /'___\ / __`\/\`'__\/'__`\   /\ '__`\/\ \/\ \
\ \ \_\ \/\ \/\ \/\ \_\ \/\  __/\ \ \//\__, `\/\ \__//\ \_\ \ \ \//\  __/  _\ \ \_\ \ \ \_\ \
 \ \____/\ \_\ \_\ \___,_\ \____\\ \_\\/\____/\ \____\ \____/\ \_\\ \____\/\_\ \ ,__/\/`____ \
  \/___/  \/_/\/_/\/__,_ /\/____/ \/_/ \/___/  \/____/\/___/  \/_/ \/____/\/_/\ \ \/  `/___/> \
                                                                               \ \_\     /\___/
                                                                                \/_/     \/__/

Underscore.py is a python port of excellent javascript library underscore.js

What is underscore.js?

From underscore page: Underscore.js is a utility-belt library for JavaScript that provides support for the
usual functional suspects (each, map, reduce, filter...) without extending any core JavaScript objects.

NOTE: It's obvious that python already has nearly all features of underscore library built-in. I'm not trying to fill any gap in python. If you are coming from JavaScript this library will provide you a familiar interface, a set of tools you already know how to use and micro templating functionality. Use it wisely and try to use built-in functions wherever possible.

Installing

Install from pypi

pip install underscore.py

or

Clone the repository:

git clone git://github.com/serkanyersen/underscore.py.git

Get into underscore.py directory

cd underscore.py

Run setup script

sudo python setup.py install

That's it

Usage

Import underscore to your project

from underscore import _

or if you don't want to mess with _ variable

from underscore import _ as us  # You can use any name you want, __ or u

Use it just like javascript version

# Dynamically
_(["foo", "bar"]).invoke("upper")  # ["FOO", "BAR"]
# or statically
_.filter(["foo", "hello", "bar", "world"], lambda x, *a: len(x) > 3)  # ["hello", "world"]
# Do chaining
_([10, 48, 56, 30, 20]).chain().filter(lambda x, *a: x > 20).map(lambda x, *a: x * 2).sortBy().value()
# [60, 96, 112]

Full micro templating support

tmpl = _.template("Name: <% if prefix: %><%= prefix %>. <% endif %><%= name %>\n\
Last Name: <%=lname.upper() %>\n\
<% if email: %>\
E-mail: <%= email %>\n\
<% endif %>")

people = [{
  "prefix": "",
  "name": "John",
  "lname": "Doe",
  "email": "[e-mail]"
},{
  "prefix": "Mr",
  "name": "James",
  "lname": "Brown",
  "email": "[e-mail]"
}]

for person in people:
  print tmpl(person)

Output

Name: John
Last Name: DOE
E-mail: [e-mail]
Name: Mr. James
Last Name: BROWN
E-mail: [e-mail]

For more information and documentation underscorejs.org

Original Source: Underscore.js on Github

Disclaimer

Please keep in mind that this is a direct port of a javascript library, so don't get started with the "but it's not pythonic" stuff. This library has no intentions to be pythonic, infact it tries to bring the same underscore experience from javascript to python