1 #/usr/bin/env python
   2 # -*- coding:UTF-8 -*-
   3 
   4 
   5 """
   6 
   7 Este módulo fornece uma classe wrapper para ser usada com números de
   8 CPF, que além de oferecer um método simples de verificação, também
   9 conta com métodos para comparação e conversão.
  10 
  11 
  12 >>> a = CPF('56068332551')
  13 >>> b = CPF('560.683.325-51')
  14 >>> c = CPF((1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 0))
  15 >>> assert a.valido()
  16 >>> assert b.valido()
  17 >>> assert not c.valido()
  18 >>> assert a == b
  19 >>> assert not b == c
  20 >>> assert not a == c
  21 >>> assert eval(repr(a)) == a
  22 >>> assert eval(repr(b)) == b
  23 >>> assert eval(repr(c)) == c
  24 >>> assert str(a) == \"560.683.325-51\"
  25 >>> assert str(b) == str(a)
  26 >>> assert str(c) == \"123.456.789-00\"
  27 
  28 """
  29 
  30 
  31 
  32 
  33 class CPF(object):
  34 
  35     def __init__(self, cpf):
  36         """Classe representando um número de CPF
  37 
  38         >>> a = CPF('95524361503')
  39         >>> b = CPF('955.243.615-03')
  40         >>> c = CPF([9, 5, 5, 2, 4, 3, 6, 1, 5, 0, 3])
  41 
  42         """
  43 
  44         try:
  45             basestring
  46         except:
  47             basestring = (str, unicode)
  48 
  49         if isinstance(cpf, basestring):
  50             cpf = cpf.replace(".", "")
  51             cpf = cpf.replace("-", "")
  52             if not cpf.isdigit():
  53                 raise ValueError("Valor não segue a forma xxx.xxx.xxx-xx")
  54             
  55         if len(cpf) < 11:
  56             raise ValueError("O número de CPF deve ter 11 digítos")
  57 
  58         self.cpf = map(int, cpf)
  59 
  60 
  61     def __getitem__(self, index):
  62         """Retorna o dígito em index como string
  63 
  64         >>> a = CPF('95524361503')
  65         >>> a[9] == '0'
  66         True
  67         >>> a[10] == '3'
  68         True
  69         >>> a[9] == 0
  70         False
  71         >>> a[10] == 3
  72         False
  73 
  74         """
  75         return str(self.cpf[index])
  76 
  77     def __repr__(self):
  78         """Retorna uma representação 'real', ou seja:
  79 
  80         eval(repr(cpf)) == cpf
  81 
  82         >>> a = CPF('95524361503')
  83         >>> print repr(a)
  84         CPF('95524361503')
  85         >>> eval(repr(a)) == a
  86         True
  87         
  88         """
  89         return "CPF('%s')" % ''.join([str(x) for x in self.cpf])
  90 
  91     def __eq__(self, other):
  92         """Provê teste de igualdade para números de CPF
  93 
  94         >>> a = CPF('95524361503')
  95         >>> b = CPF('955.243.615-03')
  96         >>> c = CPF('123.456.789-00')
  97         >>> a == b
  98         True
  99         >>> a != c
 100         True
 101         >>> b != c
 102         True
 103 
 104         """
 105         if isinstance(other, CPF):
 106             return self.cpf == other.cpf
 107         return False
 108     
 109     def __str__(self):
 110         """Retorna uma string do CPF na forma com pontos e traço
 111 
 112         >>> a = CPF('95524361503')
 113         >>> str(a)
 114         '955.243.615-03'
 115         
 116 
 117         """
 118         d = ((3, "."), (7, "."), (11, "-"))
 119         s = map(str, self.cpf)
 120         for i, v in d:
 121             s.insert(i, v)
 122         r = ''.join(s)
 123         return r
 124 
 125     def valido(self):
 126         """Valida o número de cpf
 127 
 128         >>> a = CPF('95524361503')
 129         >>> a.valido()
 130         True
 131         >>> b = CPF('12345678900')
 132         >>> b.valido()
 133         False
 134 
 135         """
 136         cpf = self.cpf[:9]
 137         # pegamos apenas os 9 primeiros dígitos do cpf e geramos os
 138         # dois dígitos que faltam
 139         while len(cpf) < 11:
 140 
 141             r = sum(map(lambda(i,v):(len(cpf)+1-i)*v,enumerate(cpf))) % 11
 142 
 143             if r > 1:
 144                 f = 11 - r
 145             else:
 146                 f = 0
 147             cpf.append(f)
 148 
 149         # se o número com os digítos faltantes coincidir com o número
 150         # original, então ele é válido
 151         return bool(cpf == self.cpf)
 152 
 153     def __nonzero__(self):
 154         """Valida o número de cpf
 155         
 156         >>> a = CPF('95524361503')
 157         >>> bool(a)
 158         True
 159         >>> b = CPF('12345678900')
 160         >>> bool(b)
 161         False
 162         >>> if a:
 163         ...     print 'OK'
 164         ... 
 165         OK
 166 
 167         >>> if b:
 168         ...     print 'OK'
 169         ... 
 170         >>>
 171         """
 172 
 173         return self.valido()
 174 
 175 
 176 
 177 if __name__ == "__main__":
 178 
 179     import doctest, sys
 180     doctest.testmod(sys.modules[__name__])