django-numfilters 0.1.1

Download

To install it by using pip:

$ pip install django-numfilters

or by using easy_install:

$ easy_install django-numfilters

You can also pot for installing it from source:

$ git clone git@github.com:amatellanes/django-numfilters.git
$ cd django-numfilters
$ python setup.py install

Installation

To enable django-numfilters in your Django project, you need to add django_numfilters to INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'django_numfilters',
    ...
)

Usage

This section provides a summary of django-numfilters features.

Firstly, you need make filters available to your templates using {% load numfilters %} tag. After this, you can use next tags:

abs

Returns the absolute value of a, for a number.

add

This filter is provided by Django.

sub

Returns a - b, for a and b numbers.

mul

Returns a * b, for a and b numbers.

div

Returns a / b, for a and b numbers (classic division).

mod

Returns a % b, for a and b numbers.

floordiv

Returns a // b, for a and b numbers.

pow

Returns a ** b, for a and b numbers.

sqrt

Return the square root of a, for a number.

Example

{% load numfilters %}
<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Example django-numfilters</title>
</head>
<body>
<ul>

    <li>abs(-41) = {{ -41|abs }}</li>

    <li>23 - 7 = {{ 23|sub:7 }}</li>

    <li>25 * 2 = {{ 25|mul:2 }}</li>

    <li>32 / 4 = {{ 32|div:4 }}</li>

    {% with a=15 b=3 %}
        <li>15 % 3 = {{ a|mod:b }}</li>
    {% endwith %}

    {% with a=5 b=2 %}
        <li>5 // 2 = {{ a|floordiv:b }}</li>
    {% endwith %}

    <li>pow(5, 2) = {{ 5|pow:2 }}</li>

    {% with a=64 %}
        <li>sqrt(64) = {{ a|sqrt }}</li>
    {% endwith %}

</ul>
</body>
</html>

Testing

You can see the current Travis CI build here: https://travis-ci.org/amatellanes/django-numfilters.

Changelog

Release 0.1.1 (no codename, released on December 26th 2014)

• Fix minor bugs.

Release 0.1.0 (no codename, released on July 20th 2014)

• Initial release.

License

MIT License, see LICENSE file.