Validate urban and rural addresses in Colombia
Explore the docs»
Report Bug
·
Request Feature
Table of Contents
the project was developed through the definition of Mealy machines, regular expressions, regular grammars, Automata, for the validation of all addresses currently valid in Colombia.
the standardization of urban addresses of the ministry of education was used as a guideline.
pip install addressValidator
or
py -m pip install addressValidatorlatest stable version addressValidator==1.2.1
- Example
from addressValidator import address_validator address = "Calle 3BC #10-2 Barrio San Juan Apartamento 201" if address_validator(address): print(address+" direccion valida") else: print(address+" direccion invalida")
For more examples, please refer to the Examples packages
we can use 4 functions to validate both urban and rural addresses
address_validator function receives as a parameter a mandatory string which will be evaluated and will return a boolean if valid or not.
from addressValidator import address_validator
# address_validator(str) -> bool
address = address_validator("Calle 13B #10-3")
print(address)// #Trueif the address is not valid it will return False
from addressValidator import address_validator
# address_validator(str) -> bool
address = address_validator("Calle 13sur 13-121B")
print(address)// #Falsefucntion address_validator_dian returns the address validation according to dian nomenclature
from addressValidator import address_validator_dian
# address_validator_dian(str) -> bool
address = address_validator_dian("Cl 13 B 10 3")
print(address)// #Trueif the address is not valid it will return False
from addressValidator import address_validator_dian
# address_validator_dian(str) -> bool
address = address_validator_dian("Cl 13 sur 13 121 B")
print(address)// #Falseaddress_validator_file function receives a text file, does not return any value, this function creates a text file with the respective validations.
from addressValidator import address_validator_file
# address_validator_file(file) -> None
with open("address.txt") as file_object:
address_validator_file(file_object) # create output.txthere we can see that we read a file called address.txt that we find in the examples folder this function will return the validations of all the strings as we can see in the output.txt file.All this for urban and rural addresses
The function address_validator_file_dian receives a text file, creates a text file with the validations of the addresses with dian nomenclature
from addressValidator import address_validator_file_dian
# address_validator_file_dian(file) -> None
with open("addressDian.txt") as file_object:
address_validator_file_dian(file_object) # create output.txtWe read the addressDian file from the root path and send the document to the function and it returns the validations in an output.txt file. Validations with file for dian nomenclature is in the output_dian.txt file
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
