python-stdnum branch master updated. 0.9-11-g86f60a2

[Commits of the python-stdnum project <python-stdnum-commits [at] lists.arthurdejong.org>]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "python-stdnum".

The branch, master has been updated
       via  86f60a2acb592a6ac6260867f8c9d423fc25d9d8 (commit)
      from  fbb03161eec04454431dc4e3099b6d1a3706edcc (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://arthurdejong.org/git/python-stdnum/commit/?id=86f60a2acb592a6ac6260867f8c9d423fc25d9d8

commit 86f60a2acb592a6ac6260867f8c9d423fc25d9d8
Author: Tony Bajan <tony.bajan@onefinestay.com>
Date:   Mon Sep 1 14:22:19 2014 +0100

    Add US bank routing transit numbers

diff --git a/stdnum/us/rtn.py b/stdnum/us/rtn.py
new file mode 100644
index 0000000..17ba1a8
--- /dev/null
+++ b/stdnum/us/rtn.py
@@ -0,0 +1,87 @@
+# rtn.py - functions for handling banking routing transit numbers
+#
+# Copyright (C) 2014 Lifealike Ltd
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+# 02110-1301 USA
+
+"""RTN (Routing transport number).
+
+The routing transport number is a nine digit number used in the US banking
+system for processing deposits between banks.
+
+The last digit is a checksum.
+
+>>> calc_check_digit('11100002')
+'5'
+>>> validate('111000025')
+'111000025'
+>>> validate('11100002')  # Not nine digits
+Traceback (most recent call last):
+    ...
+InvalidLength: ..
+>>> validate('11100002B')  # Not all numeric
+Traceback (most recent call last):
+    ...
+InvalidFormat: ..
+>>> validate('112000025')  # bad checksum
+Traceback (most recent call last):
+    ...
+InvalidChecksum: ..
+"""
+
+from stdnum.exceptions import *
+from stdnum.util import clean
+
+
+def compact(number):
+    """Convert the number to the minimal representation. This strips the
+    number of any surrounding whitespace."""
+    number = clean(number).strip()
+    return number
+
+
+def calc_check_digit(number):
+    """Calculate the check digit. The number passed should not have the
+    check digit included."""
+    digits = [int(c) for c in number]
+    checksum = (
+        7 * (digits[0] + digits[3] + digits[6]) +
+        3 * (digits[1] + digits[4] + digits[7]) +
+        9 * (digits[2] + digits[5])
+    ) % 10
+    return str(checksum)
+
+
+def validate(number):
+    """Checks to see if the number provided is a valid routing number. This
+    checks the length and check digit."""
+    number = compact(number)
+    if not number.isdigit():
+        raise InvalidFormat()
+    if len(number) != 9:
+        raise InvalidLength()
+    if calc_check_digit(number[:-1]) != number[-1]:
+        raise InvalidChecksum()
+    return number
+
+
+def is_valid(number):
+    """Checks to see if the number provided is a valid RTN. This checks the
+     length and check digit."""
+    try:
+        return bool(validate(number))
+    except ValidationError:
+        return False

-----------------------------------------------------------------------

Summary of changes:
 stdnum/{gr/vat.py => us/rtn.py} |   59 ++++++++++++++++++++++-----------------
 1 file changed, 34 insertions(+), 25 deletions(-)
 copy stdnum/{gr/vat.py => us/rtn.py} (55%)


hooks/post-receive
-- 
python-stdnum
-- 
To unsubscribe send an email to
python-stdnum-commits-unsubscribe@lists.arthurdejong.org or see
http://lists.arthurdejong.org/python-stdnum-commits/