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
|
# `pnc` -- a libphonenumber command-line wrapper, and GNU AWK extension - Sxmo extended version
[](https://builds.sr.ht/~anjan/pnc/commits/master/.build.yml?)
`pnc` is a tool that allows command line user/programmers to operate on phone
numbers (get validity information, reformat them, or extract numbers from a
text snippet), using
[libphonenumber](https://github.com/googlei18n/libphonenumber).
This repository also contains a GNU AWK extension library, exposing some libphonenumber features in AWK. See [gawkext/README.md](gawkext/README.md) for more details.
The original pn project is archived. See:
https://github.com/Orange-OpenSource/pn
This project is a fork of pn is called "pnc" for pn continued.
pnc is maintained by the Sxmo project:
https://sxmo.org
# Features
See the man page for more details.
Check the validity of a number:
```
$ pnc valid -v +33123456789
valid number
(SUCCESS)
$ pnc valid -v '(202) 555-0110'
invalid country code
(ERROR)
$ pnc valid -v -c US '(202) 555-0110'
valid number
(SUCCESS)
```
Re-format a phone number:
```
$ pnc format "+1 20 2 555 01 10"
+12025550110
$ pnc format -c FR "0123456789"
+33123456789
$ pnc format -c FR -f nat "0123456789"
01 23 45 67 89
$ pnc format -f int "+12025550110"
+1 202-555-0110
```
Find valid numbers inside a free text input:
```
$ pnc find -f nat "2017/04/20: You have 2 messsages, call +1-202-555-0110 to listen to them."
(202) 555-0110
$ pnc find -c FR "rappelle-moi au 01 23 4 56789 ou au 06 78 90 12 34 après 20h00"
+33123456789
+33678901234
```
Get some information about a number:
```
$ pnc info "+33 2 96 48 46 98"
country code: 33 (FR)
number type: fixed line
location: Lannion
possible short number: false
valid short number: false
emergency number: false
$ pnc info -c FR 112
country code: 33 (FR)
number type: unknown
location:
possible short number: true
valid short number: true
emergency number: true
```
# How to build `pnc`?
## Prerequisites
For **Debian (>= 9)**, **Ubuntu (>= 16.10)**:
```
$ sudo apt install cmake build-essential libphonenumber-dev libicu-dev
```
For **Ubuntu 16.04**:
```
$ sudo apt install cmake build-essential libphonenumber-dev libgeocoding-dev libicu-dev
```
**Note:** You might want to use a newer version of **libphonenumber** than the one packaged by your distribution. In that case, fetch the source code and compile it on your own, following the instructions provided [here](https://github.com/google/libphonenumber/blob/master/cpp/README#L132).
**Other platforms:**
To build `pnc` you need a C++ compiler, [CMake](https://cmake.org/), Google's
[libphonenumber](https://github.com/googlei18n/libphonenumber) (including the
geocoding part) binaries and dev headers, [ICU](http://site.icu-project.org/)
binaries and dev headers.
## Build
Provided that the prerequisites are met, to build `pn` and the gawk extension `gawkpn.so` (it is only compiled if CMake was able to locate gawk's .h header on the system) simply issue :
```
pnc/$ cd build
pnc/build/$ cmake ..
pnc/build/$ make
```
## Install
```
pnc/build/$ sudo make install
```
|
