Liking cljdoc? Tell your friends :D


There you are, your own number on your very own door. And behind that door, your very own office! Welcome to the team, DZ-015

  • Mr. Warrenn (Brazil 1985)

An implementation of the validation formula for cpf (Cadastro de Pessoa Física) and cnpj (Cadastro Nacional de Pessoa Jurídica), the unique codes for people and companies in Brazil.


0.4.0+ should be stable and work with clj and cljs.

When clojure 1.9.0 is released I'll release version 1.0.0 with specs for the public API and never break it.



Requires clojure 1.7.0 because of reader conditionals.

In clojurescript it works with 1.9.293, for lower versions ¯\_(ツ)_/¯.

[cadastro-de-pessoa "0.4.0"]

Namespace declaration

(ns example.core
   [cadastro-de-pessoa.cpf  :as cpf]
   [cadastro-de-pessoa.cnpj :as cnpj]))


Functions that take a cpf/cnpj accepts either a sequence of digits or a string, while functions that return a cpf/cnpf return it as a formatted string.

Validate using the formula. In the case of a string, characters that are not numbers are ignored.

(cpf/valid? [2 2 1 8 3 5 1 3 1 5 2])
(cnpj/valid? "27.865.757/0001-02")

Check formatting

(cpf/formatted? "") ;=> false
(cnpj/formatted? "27.865.757/0001-02") ;=> true

Format a cpf or cnpj correctly. Extra digits are ignored.

(cpf/format [2 2 1 8 3 5 1 3 1 5 2]) ;=> "221.835.131-52"
(cnpj/format "27865xxx757xxx000xxx102") ;=> "27.865.757/0001-02"

Generate a random, valid cpf or cnpj

(cpf/gen) ;=> "343.696.318-66"

(cnpj/gen)   ;=> "02.583.753/5448-95"

;; Can also take a branch number.
(cnpj/gen 1) ;=> "24.275.606/0001-06"


;; The length of the codes
cpf/length  ;=> 11
cnpj/length ;=> 14

;; regexen that match the properly formatted string of the codes
cpf/regex => #"..."
cnpj/regex => #"..."


Copyright © 2016 Aleksander Madland Stapnes

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

Can you improve this documentation?Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close