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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
PYTHON=python
PACKAGE=phonenumbers
TOPDIR=../..
PYDIR=$(TOPDIR)/python
all: alldata
# Dump the JRE's Locale information
DumpLocale.class: DumpLocale.java
javac $<
$(PYDIR)/phonenumbers/geodata/locale.py: DumpLocale.class | $(PYDIR)/phonenumbers/geodata
java DumpLocale > $@
$(PYDIR)/phonenumbers/geodata/locale.pyi:
echo "LOCALE_DATA: dict[str, dict[str, str]]" > $@
locale: $(PYDIR)/phonenumbers/geodata/locale.py $(PYDIR)/phonenumbers/geodata/locale.pyi
# Generate Python files from geocoding data
$(PYDIR)/phonenumbers/geodata:
mkdir $@
$(PYDIR)/phonenumbers/geodata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/geocoding | $(PYDIR)/phonenumbers/geodata
$(PYTHON) buildprefixdata.py --var GEOCODE $(TOPDIR)/resources/geocoding $@ .
$(PYDIR)/tests/testgeodata:
mkdir $@
$(PYDIR)/tests/testgeodata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/test/geocoding | $(PYDIR)/tests/testgeodata
$(PYTHON) buildprefixdata.py --var GEOCODE $(TOPDIR)/resources/test/geocoding $@ phonenumbers
geodata: $(PYDIR)/phonenumbers/geodata/__init__.py $(PYDIR)/tests/testgeodata/__init__.py
# Generate Python files from carrier data
$(PYDIR)/phonenumbers/carrierdata:
mkdir $@
$(PYDIR)/phonenumbers/carrierdata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/carrier | $(PYDIR)/phonenumbers/carrierdata
$(PYTHON) buildprefixdata.py --var CARRIER $(TOPDIR)/resources/carrier $@ .
$(PYDIR)/tests/testcarrierdata:
mkdir $@
$(PYDIR)/tests/testcarrierdata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/test/carrier | $(PYDIR)/tests/testcarrierdata
$(PYTHON) buildprefixdata.py --var CARRIER $(TOPDIR)/resources/test/carrier $@ phonenumbers
carrierdata: $(PYDIR)/phonenumbers/carrierdata/__init__.py $(PYDIR)/tests/testcarrierdata/__init__.py
# Generate Python files from timezone data
$(PYDIR)/phonenumbers/tzdata:
mkdir $@
$(PYDIR)/phonenumbers/tzdata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/timezones/map_data.txt | $(PYDIR)/phonenumbers/tzdata
$(PYTHON) buildprefixdata.py --var TIMEZONE --flat --sep '&' $(TOPDIR)/resources/timezones/map_data.txt $@ .
$(PYDIR)/tests/testtzdata:
mkdir $@
$(PYDIR)/tests/testtzdata/__init__.py: buildprefixdata.py $(TOPDIR)/resources/test/timezones/map_data.txt | $(PYDIR)/tests/testtzdata
$(PYTHON) buildprefixdata.py --var TIMEZONE --flat --sep '&' $(TOPDIR)/resources/test/timezones/map_data.txt $@ phonenumbers
tzdata: $(PYDIR)/phonenumbers/tzdata/__init__.py $(PYDIR)/tests/testtzdata/__init__.py
# Generate Python files from metadata
$(PYDIR)/phonenumbers/data/__init__.py: $(TOPDIR)/resources/PhoneNumberMetadata.xml $(TOPDIR)/resources/PhoneNumberAlternateFormats.xml buildmetadatafromxml.py
$(PYTHON) buildmetadatafromxml.py --alt $(TOPDIR)/resources/PhoneNumberAlternateFormats.xml $(TOPDIR)/resources/PhoneNumberMetadata.xml $(PYDIR)/phonenumbers/data .
$(PYDIR)/phonenumbers/shortdata/__init__.py: $(TOPDIR)/resources/ShortNumberMetadata.xml buildmetadatafromxml.py
$(PYTHON) buildmetadatafromxml.py --short $(TOPDIR)/resources/ShortNumberMetadata.xml $(PYDIR)/phonenumbers/shortdata .
$(PYDIR)/tests/testdata/__init__.py: $(TOPDIR)/resources/PhoneNumberMetadataForTesting.xml buildmetadatafromxml.py
$(PYTHON) buildmetadatafromxml.py --lax $(TOPDIR)/resources/PhoneNumberMetadataForTesting.xml $(PYDIR)/tests/testdata phonenumbers
metadata: $(PYDIR)/phonenumbers/data/__init__.py $(PYDIR)/phonenumbers/shortdata/__init__.py $(PYDIR)/tests/testdata/__init__.py geodata carrierdata tzdata
alldata: metadata geodata carrierdata tzdata locale
test: alldata
cd $(PYDIR) && $(PYTHON) -m testwrapper
# Coverage; requires coverage module
COVERAGE=$(shell hash python-coverage 2>&- && echo python-coverage || echo coverage)
COVERAGE_FILES=$(subst $(PYDIR),.,$(wildcard $(PYDIR)/phonenumbers/*.py))
coverage: alldata $(PYDIR)/tests/testdata/__init__.py coverage_clean coverage_generate coverage_report
coverage_clean:
cd $(PYDIR) && $(COVERAGE) erase
coverage_generate:
cd $(PYDIR) && PYTHONPATH=. $(COVERAGE) run testwrapper.py
coverage_report:
cd $(PYDIR) && $(COVERAGE) report $(COVERAGE_FILES)
coverage_annotate:
cd $(PYDIR) && $(COVERAGE) annotate $(COVERAGE_FILES)
# Lint: requires pycodestyle
# Explicitly allow:
# E501 line too long
# E129 visually indented line with same indent as next logical line
# E402 module level import not at top of file
# W504 line break after binary operator
lint:
cd $(PYDIR) && pycodestyle --ignore E501,E129,E402,W504 phonenumbers/*.py tests/*.py
# Profile
profile: alldata $(PYDIR)/tests/testdata/__init__.py profile_clean profile_report
profile_clean:
rm -f phonenumbers.pstats
phonenumbers.pstats:
python -m cProfile -o phonenumbers.pstats $(PYDIR)/tests/testwrapper.py
profile_report: phonenumbers.pstats
python -c "import pstats; p = pstats.Stats('phonenumbers.pstats');p.sort_stats('time').print_stats(50)" | grep -v "test.py" | grep -v testwrapper.py
# Packaging
VERSION=$(shell grep __version__ $(PYDIR)/phonenumbers/__init__.py | sed 's/__version__ = "\(.*\)"/\1/')
TARBALL_LOCAL=dist/$(PACKAGE)-$(VERSION).tar.gz
TARBALL=$(PYDIR)/$(TARBALL_LOCAL)
# Build setuptools packaged tarball $(TARBALL)
sdist: alldata
cd $(PYDIR) && $(PYTHON) setup.py sdist
$(TARBALL): sdist
install: alldata
cd $(PYDIR) && $(PYTHON) setup.py build
cd $(PYDIR) && sudo $(PYTHON) setup.py install
clean: coverage_clean profile_clean
rm -f *.pyc
rm -rf __pycache__
rm -f $(PYDIR)/MANIFEST $(PYDIR)/*.pyc
rm -f $(PYDIR)/phonenumbers/*.pyc
rm -f $(PYDIR)/phonenumbers/data/*.pyc
rm -f $(PYDIR)/phonenumbers/shortdata/*.pyc
rm -f $(PYDIR)/phonenumbers/geodata/*.pyc
rm -f $(PYDIR)/phonenumbers/carrierdata/*.pyc
rm -f $(PYDIR)/phonenumbers/tzdata/*.pyc
rm -rf $(PYDIR)/phonenumbers/__pycache__
rm -rf $(PYDIR)/phonenumbers/data/__pycache__
rm -rf $(PYDIR)/phonenumbers/shortdata/__pycache__
rm -rf $(PYDIR)/phonenumbers/geodata/__pycache__
rm -rf $(PYDIR)/phonenumbers/carrierdata/__pycache__
rm -rf $(PYDIR)/phonenumbers/tzdata/__pycache__
rm -f $(PYDIR)/phonenumbers/*.py,cover $(PYDIR)/.coverage*
rm -f $(PYDIR)/tests/*.pyc $(PYDIR)/tests/testdata/*.pyc $(PYDIR)/tests/testgeodata/*.pyc $(PYDIR)/tests/testcarrierdata/*.pyc
rm -rf $(PYDIR)/tests/__pycache__ $(PYDIR)/tests/testdata/__pycache__ $(PYDIR)/tests/testgeodata/__pycache__ $(PYDIR)/tests/testcarrierdata/__pycache__
rm -rf $(PYDIR)/build $(PYDIR)/deb_dist $(PYDIR)/dist
metaclean:
rm -rf $(PYDIR)/phonenumbers/data $(PYDIR)/phonenumbers/shortdata $(PYDIR)/tests/testdata
rm -rf $(PYDIR)/phonenumbers/geodata $(PYDIR)/tests/testgeodata
rm -rf $(PYDIR)/phonenumbers/carrierdata $(PYDIR)/tests/testcarrierdata
rm -rf $(PYDIR)/phonenumbers/tzdata $(PYDIR)/tests/testtzdata
distclean: clean metaclean
rm -rf $(PYDIR)/$(PACKAGE).egg-info
rm -rf $(PYDIR)/build
rm -f DumpLocale.class
# Create Debian package. Requires py2dsc, included in the python-stdeb package.
DEB_PACKAGE=python-$(PACKAGE)
DEB_VERSION=$(VERSION)-1_all
deb: $(PYDIR)/deb_dist/$(DEB_PACKAGE)_$(DEB_VERSION).deb
$(PYDIR)/deb_dist/$(DEB_PACKAGE)_$(VERSION)-1_all.deb: $(TARBALL)
cd $(PYDIR) && py2dsc $(TARBALL_LOCAL)
cd $(PYDIR)/deb_dist/$(PACKAGE)-$(VERSION) && dpkg-buildpackage -us -uc -nc
#####################################################################################################
# Protobuf interface. Requires local installation of protobuf compiler and Python package (google.protobuf)
pb2: $(PYDIR)/phonenumbers/pb2/phonenumber_pb2.py
$(PYDIR)/phonenumbers/pb2/phonenumber_pb2.py: $(TOPDIR)/resources/phonenumber.proto
protoc -I$(TOPDIR)/resources --python_out=$(PYDIR)/phonenumbers/pb2 $<
testpb2: pb2
cd $(PYDIR) && $(PYTHON) -m testpb2
#####################################################################################################
# Generate docs with pydoc
DOCDIR=$(TOPDIR)/docs
SUBMODULES=asyoutypeformatter.py carrier.py geocoder.py phonemetadata.py phonenumber.py phonenumbermatcher.py phonenumberutil.py prefix.py re_util.py shortnumberinfo.py timezone.py unicode_util.py util.py
DOCS_SUBMODULES=$(addprefix $(DOCDIR)/phonenumbers.,$(subst .py,.html,$(SUBMODULES)))
PYDIR_ABS=$(realpath $(PYDIR))
docs: $(DOCDIR)/phonenumbers.html $(DOCS_SUBMODULES)
$(DOCDIR)/phonenumbers.html: $(PYDIR)/phonenumbers/__init__.py
cd $(PYDIR) && pydoc -w phonenumbers
mv $(PYDIR)/phonenumbers.html $@
sed 's@href="file:$(PYDIR_ABS)/@href="https://github.com/daviddrysdale/python-phonenumbers/blob/dev/python/@' $@ | sed 's@$(PYDIR_ABS)/@@' > $@.temp
mv $@.temp $@
$(DOCDIR)/phonenumbers.%.html: $(PYDIR)/phonenumbers/%.py
cd $(PYDIR) && pydoc -w phonenumbers.$*
mv $(PYDIR)/phonenumbers.$*.html $@
sed 's@href="file:$(PYDIR_ABS)/@href="https://github.com/daviddrysdale/python-phonenumbers/blob/dev/python/@' $@ | sed 's@$(PYDIR_ABS)/@@' > $@.temp
mv $@.temp $@
docclean:
rm -f $(DOCDIR)/phonenumbers.html $(DOCS_SUBMODULES)
|
