1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
# isrc.py - functions for International Standard Recording Codes (ISRC)
# coding: utf-8
#
# Copyright (C) 2021 Nuno André Novo
# Copyright (C) 2021 Arthur de Jong
#
# 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
"""ISRC (International Standard Recording Code).
The ISRC is an international standard code (ISO 3901) for uniquely
identifying sound recordings and music video recordings.
More information:
* https://en.wikipedia.org/wiki/International_Standard_Recording_Code
>>> validate('US-SKG-19-12345')
'USSKG1912345'
>>> validate('XX-SKG-19-12345')
Traceback (most recent call last):
...
InvalidComponent: ...
"""
from __future__ import annotations
import re
from stdnum.exceptions import *
from stdnum.isin import _iso_3116_1_country_codes
from stdnum.util import clean
# An ISRC is composed of a country code, a registrant code a year of
# reference and designation code.
_isrc_re = re.compile(
r'^(?P<country>[A-Z]{2})(?P<registrant>[A-Z0-9]{3})(?P<year>[0-9]{2})(?P<record>[0-9]{5})$')
# These special codes are allowed for ISRC
# Source: https://isrc.ifpi.org/downloads/Valid_Characters.pdf
_country_codes = set(_iso_3116_1_country_codes + [
'BC', # Pro-música Brazil - Brasil
'BK', # Pro-música Brazil - Brasil
'BP', # Pro-música Brazil - Brasil
'BX', # Pro-música Brazil - Brasil
'CB', # Connect - Canada
'CP', # reserved for further overflow
'DG', # reserved for further overflow
'FX', # SCPP - France
'GX', # PPL UK - United Kingdom
'KS', # KMCA - South Korea
'QM', # US new registrants due to US codes became exhausted
'QN', # International ISRC Agency codes - Worldwide
'QT', # RIAA - US
'QZ', # RIAA - US
'UK', # PPL UK - United Kingdom
'XK', # International ISRC Agency codes - Kosovo
'YU', # International ISRC Agency codes - Former Yugoslavia before 2006
'ZB', # RISA - South Africa
'ZZ', # International ISRC Agency codes - Worldwide
])
def compact(number: str) -> str:
"""Convert the ISRC to the minimal representation. This strips the
number of any valid separators and removes surrounding whitespace."""
return clean(number, ' -').strip().upper()
def validate(number: str) -> str:
"""Check if the number provided is a valid ISRC. This checks the length,
the alphabet, and the country code but does not check if the registrant
code is known."""
number = compact(number)
if len(number) != 12:
raise InvalidLength()
match = _isrc_re.search(number)
if not match:
raise InvalidFormat()
if match.group('country') not in _country_codes:
raise InvalidComponent()
return number
def is_valid(number: str) -> bool:
"""Check if the number provided is a valid ISRC."""
try:
return bool(validate(number))
except ValidationError:
return False
def format(number: str, separator: str = '-') -> str:
"""Reformat the number to the standard presentation format."""
number = compact(number)
return separator.join((number[0:2], number[2:5], number[5:7], number[7:]))
|
