nmicheck 0.4.0

Functions to validate National Metering Identifiers (NMIs)

NMI-Checksum

A library to validate National Metering Identifiers (NMIs)

The validation rules are as per the Australian National Metering Identifier Procedure.

Usage

from nmicheck import nmi_checksum

checksum = nmi_checksum("QAAAVZZZZZ")
print(checksum)  # 3

from nmicheck import nmi_checksum_valid

print(nmi_checksum_valid("QAAAVZZZZZ3"))  # True
print(nmi_checksum_valid("QAAAVZZZZZ0"))  # False

from nmicheck import long_nmi, short_nmi

print(long_nmi("NMI00012345"))    # NMI000123458
print(short_nmi("NMI000123458"))  # NMI00012345

If you want to obfuscate a NMI (such as for privacy reasons) there is a helper function for that.

from nmicheck import obfuscate_nmi
print(obfuscate_nmi("NMI00012345", salt="secret"))  # 0E6816DCBA3
print(obfuscate_nmi("NMI00012345", salt="other"))   # 756C6E4B029

You can also look up the participant code for a particular NMI (which DNSP or TNSP) based on the NMI Allocation List.

from nmicheck import nmi_participant

participant = nmi_participant("6102000000")
print(participant)  # CITIPP

participant = nmi_participant("3202000000")
print(participant)  # PLINKP