Makefile

@@ -16,7 +16,7 @@ OBJS := $(patsubst %.cpp,%.o,$(cpp_files))
 
 # C flags
 PG_CPPFLAGS := -fPIC -std=c++14
-PG_CPPFLAGS += -Isrc/ -I/usr/include -I/usr/local/include
+PG_CPPFLAGS += -Isrc/ -I/usr/include
 PG_CPPFLAGS += -Wall -Wextra
 ifeq ($(CONFIG),debug)
 	PG_CPPFLAGS += -g -Og

README.md

@@ -13,10 +13,14 @@ get it there.
 
 ```sql
 CREATE EXTENSION pg_libphonenumber;
-SELECT parse_packed_phone_number('03 7010 1234', 'AU');
+SELECT parse_phone_number('03 7010 1234', 'AU');
-SELECT parse_packed_phone_number('2819010011', 'US');
+SELECT parse_phone_number('2819010011', 'US');
 
-CREATE TABLE foo ( ph packed_phone_number );
+CREATE TABLE foo ( ph phone_number );
+
+-- DO NOT RELY ON THIS
+-- may not always this work way with implicit cast.
+SELECT '2819010011'::phone_number; -- assumes US
 ```
 
 ## Installation

debian/changelog

@@ -1,5 +0,0 @@
-pg-libphonenumber (0.0~git20200211.753e2fa-1) bullseye; urgency=medium
-
-  * Add Debian packaging
-
- -- jordi fita mas <jordi@tandem.blog>  Tue, 24 Jan 2023 13:07:39 +0000

debian/control

@@ -1,26 +0,0 @@
-Source: pg-libphonenumber
-Section: database
-Priority: optional
-Maintainer: jordi fita mas <jordi@tandem.blog>
-Build-Depends:
-  debhelper-compat (= 13),
-  postgresql-all (>= 217~),
-  libphonenumber-dev
-Standards-Version: 4.6.0
-Vcs-Browser: https://github.com/blm768/pg-libphonenumber
-Vcs-Git: https://github.com/blm768/pg-libphonenumber
-Homepage: https://github.com/blm768/pg-libphonenumber
-Rules-Requires-Root: no
-
-Package: postgresql-13-pg-libphonenumber
-Architecture: all
-Depends:
-  ${shlibs:Depends},
-  ${misc:Depends},
-  postgresql-13
-description: PostgreSQL extension for libphonenumber
- pg_libphonenumber is a (partially implemented!) PostgreSQL extension that
- provides access to Google's libphonenumber.
- .
- libphonenumber is a  library for parsing, formatting, and validating
- international phone numbers.

debian/control.in

@@ -1,26 +0,0 @@
-Source: pg-libphonenumber
-Section: database
-Priority: optional
-Maintainer: jordi fita mas <jordi@tandem.blog>
-Build-Depends:
-  debhelper-compat (= 13),
-  postgresql-all (>= 217~),
-  libphonenumber-dev
-Standards-Version: 4.6.0
-Vcs-Browser: https://github.com/blm768/pg-libphonenumber
-Vcs-Git: https://github.com/blm768/pg-libphonenumber
-Homepage: https://github.com/blm768/pg-libphonenumber
-Rules-Requires-Root: no
-
-Package: postgresql-PGVERSION-pg-libphonenumber
-Architecture: all
-Depends:
-  ${shlibs:Depends},
-  ${misc:Depends},
-  postgresql-PGVERSION
-description: PostgreSQL extension for libphonenumber
- pg_libphonenumber is a (partially implemented!) PostgreSQL extension that
- provides access to Google's libphonenumber.
- .
- libphonenumber is a  library for parsing, formatting, and validating
- international phone numbers.

debian/copyright

@@ -1,190 +0,0 @@
-Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Source: https://github.com/blm768/pg-libphonenumber
-Upstream-Name: pg_libphonenumber
-Upstream-Contact: blm768@gmail.com
-
-Files: *
-Copyright: 2015–2019 Benjamin L. Merritt
-License: Apache-2.0
-
-Files: debian/*
-Copyright: 2023 jordi fita mas
-License: Apache-2.0
-
-License: Apache-2.0
- Apache License
- Version 2.0, January 2004
- http://www.apache.org/licenses/
- .
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
- .
- 1. Definitions.
- .
-    "License" shall mean the terms and conditions for use, reproduction,
-    and distribution as defined by Sections 1 through 9 of this document.
- .
-    "Licensor" shall mean the copyright owner or entity authorized by
-    the copyright owner that is granting the License.
- .
-    "Legal Entity" shall mean the union of the acting entity and all
-    other entities that control, are controlled by, or are under common
-    control with that entity. For the purposes of this definition,
-    "control" means (i) the power, direct or indirect, to cause the
-    direction or management of such entity, whether by contract or
-    otherwise, or (ii) ownership of fifty percent (50%) or more of the
-    outstanding shares, or (iii) beneficial ownership of such entity.
- .
-    "You" (or "Your") shall mean an individual or Legal Entity
-    exercising permissions granted by this License.
- .
-    "Source" form shall mean the preferred form for making modifications,
-    including but not limited to software source code, documentation
-    source, and configuration files.
- .
-    "Object" form shall mean any form resulting from mechanical
-    transformation or translation of a Source form, including but
-    not limited to compiled object code, generated documentation,
-    and conversions to other media types.
- .
-    "Work" shall mean the work of authorship, whether in Source or
-    Object form, made available under the License, as indicated by a
-    copyright notice that is included in or attached to the work
-    (an example is provided in the Appendix below).
- .
-    "Derivative Works" shall mean any work, whether in Source or Object
-    form, that is based on (or derived from) the Work and for which the
-    editorial revisions, annotations, elaborations, or other modifications
-    represent, as a whole, an original work of authorship. For the purposes
-    of this License, Derivative Works shall not include works that remain
-    separable from, or merely link (or bind by name) to the interfaces of,
-    the Work and Derivative Works thereof.
- .
-    "Contribution" shall mean any work of authorship, including
-    the original version of the Work and any modifications or additions
-    to that Work or Derivative Works thereof, that is intentionally
-    submitted to Licensor for inclusion in the Work by the copyright owner
-    or by an individual or Legal Entity authorized to submit on behalf of
-    the copyright owner. For the purposes of this definition, "submitted"
-    means any form of electronic, verbal, or written communication sent
-    to the Licensor or its representatives, including but not limited to
-    communication on electronic mailing lists, source code control systems,
-    and issue tracking systems that are managed by, or on behalf of, the
-    Licensor for the purpose of discussing and improving the Work, but
-    excluding communication that is conspicuously marked or otherwise
-    designated in writing by the copyright owner as "Not a Contribution."
- .
-    "Contributor" shall mean Licensor and any individual or Legal Entity
-    on behalf of whom a Contribution has been received by Licensor and
-    subsequently incorporated within the Work.
- .
- 2. Grant of Copyright License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    copyright license to reproduce, prepare Derivative Works of,
-    publicly display, publicly perform, sublicense, and distribute the
-    Work and such Derivative Works in Source or Object form.
- .
- 3. Grant of Patent License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    (except as stated in this section) patent license to make, have made,
-    use, offer to sell, sell, import, and otherwise transfer the Work,
-    where such license applies only to those patent claims licensable
-    by such Contributor that are necessarily infringed by their
-    Contribution(s) alone or by combination of their Contribution(s)
-    with the Work to which such Contribution(s) was submitted. If You
-    institute patent litigation against any entity (including a
-    cross-claim or counterclaim in a lawsuit) alleging that the Work
-    or a Contribution incorporated within the Work constitutes direct
-    or contributory patent infringement, then any patent licenses
-    granted to You under this License for that Work shall terminate
-    as of the date such litigation is filed.
- .
- 4. Redistribution. You may reproduce and distribute copies of the
-    Work or Derivative Works thereof in any medium, with or without
-    modifications, and in Source or Object form, provided that You
-    meet the following conditions:
- .
-    (a) You must give any other recipients of the Work or
-        Derivative Works a copy of this License; and
- .
-    (b) You must cause any modified files to carry prominent notices
-        stating that You changed the files; and
- .
-    (c) You must retain, in the Source form of any Derivative Works
-        that You distribute, all copyright, patent, trademark, and
-        attribution notices from the Source form of the Work,
-        excluding those notices that do not pertain to any part of
-        the Derivative Works; and
- .
-    (d) If the Work includes a "NOTICE" text file as part of its
-        distribution, then any Derivative Works that You distribute must
-        include a readable copy of the attribution notices contained
-        within such NOTICE file, excluding those notices that do not
-        pertain to any part of the Derivative Works, in at least one
-        of the following places: within a NOTICE text file distributed
-        as part of the Derivative Works; within the Source form or
-        documentation, if provided along with the Derivative Works; or,
-        within a display generated by the Derivative Works, if and
-        wherever such third-party notices normally appear. The contents
-        of the NOTICE file are for informational purposes only and
-        do not modify the License. You may add Your own attribution
-        notices within Derivative Works that You distribute, alongside
-        or as an addendum to the NOTICE text from the Work, provided
-        that such additional attribution notices cannot be construed
-        as modifying the License.
- .
-    You may add Your own copyright statement to Your modifications and
-    may provide additional or different license terms and conditions
-    for use, reproduction, or distribution of Your modifications, or
-    for any such Derivative Works as a whole, provided Your use,
-    reproduction, and distribution of the Work otherwise complies with
-    the conditions stated in this License.
- .
- 5. Submission of Contributions. Unless You explicitly state otherwise,
-    any Contribution intentionally submitted for inclusion in the Work
-    by You to the Licensor shall be under the terms and conditions of
-    this License, without any additional terms or conditions.
-    Notwithstanding the above, nothing herein shall supersede or modify
-    the terms of any separate license agreement you may have executed
-    with Licensor regarding such Contributions.
- .
- 6. Trademarks. This License does not grant permission to use the trade
-    names, trademarks, service marks, or product names of the Licensor,
-    except as required for reasonable and customary use in describing the
-    origin of the Work and reproducing the content of the NOTICE file.
- .
- 7. Disclaimer of Warranty. Unless required by applicable law or
-    agreed to in writing, Licensor provides the Work (and each
-    Contributor provides its Contributions) on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied, including, without limitation, any warranties or conditions
-    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-    PARTICULAR PURPOSE. You are solely responsible for determining the
-    appropriateness of using or redistributing the Work and assume any
-    risks associated with Your exercise of permissions under this License.
- .
- 8. Limitation of Liability. In no event and under no legal theory,
-    whether in tort (including negligence), contract, or otherwise,
-    unless required by applicable law (such as deliberate and grossly
-    negligent acts) or agreed to in writing, shall any Contributor be
-    liable to You for damages, including any direct, indirect, special,
-    incidental, or consequential damages of any character arising as a
-    result of this License or out of the use or inability to use the
-    Work (including but not limited to damages for loss of goodwill,
-    work stoppage, computer failure or malfunction, or any and all
-    other commercial damages or losses), even if such Contributor
-    has been advised of the possibility of such damages.
- .
- 9. Accepting Warranty or Additional Liability. While redistributing
-    the Work or Derivative Works thereof, You may choose to offer,
-    and charge a fee for, acceptance of support, warranty, indemnity,
-    or other liability obligations and/or rights consistent with this
-    License. However, in accepting such obligations, You may act only
-    on Your own behalf and on Your sole responsibility, not on behalf
-    of any other Contributor, and only if You agree to indemnify,
-    defend, and hold each Contributor harmless for any liability
-    incurred by, or claims asserted against, such Contributor by reason
-    of your accepting any such warranty or additional liability.
- .
- END OF TERMS AND CONDITIONS

debian/patches/0001-Increase-the-length-of-the-test-phone-number.patch

@@ -1,44 +0,0 @@
-From 2f2046aac124a8dd4f28131980d72015ad8dda71 Mon Sep 17 00:00:00 2001
-From: jordi fita mas <jordi@tandem.blog>
-Date: Tue, 24 Jan 2023 14:17:19 +0100
-Subject: [PATCH] Increase the length of the test phone number
-
-Apparently, now libphonenumber does accept 555-555-55555555555 without
-complain, so the expected output is wrong and to trigger the original
-error message we need to add an extra 5 there.
----
- expected/regression.out | 4 ++--
- sql/regression.sql      | 2 +-
- 2 files changed, 3 insertions(+), 3 deletions(-)
-
-diff --git a/expected/regression.out b/expected/regression.out
-index 474df36..c3cf363 100644
---- a/expected/regression.out
-+++ b/expected/regression.out
-@@ -12,8 +12,8 @@ select parse_packed_phone_number('555-555-5555555555', 'US');
- ERROR:  phone number '+1 5555555555555555' is too long
- DETAIL:  National number is too long
- --Produces an error from libphonenumber
--select parse_packed_phone_number('555-555-55555555555', 'US');
--ERROR:  unable to parse '555-555-55555555555' as a phone number
-+select parse_packed_phone_number('555-555-555555555555', 'US');
-+ERROR:  unable to parse '555-555-555555555555' as a phone number
- DETAIL:  National number is too long
- -- Do we get correct country codes?
- -- TODO: expand.
-diff --git a/sql/regression.sql b/sql/regression.sql
-index 221b4c2..8496e7d 100644
---- a/sql/regression.sql
-+++ b/sql/regression.sql
-@@ -6,7 +6,7 @@ select parse_packed_phone_number('555-555-5555', 'US');
- --Produces an error in pg-libphonenumber's code
- select parse_packed_phone_number('555-555-5555555555', 'US');
- --Produces an error from libphonenumber
--select parse_packed_phone_number('555-555-55555555555', 'US');
-+select parse_packed_phone_number('555-555-555555555555', 'US');
- 
- -- Do we get correct country codes?
- -- TODO: expand.
--- 
-2.35.3
-

debian/patches/series

@@ -1 +0,0 @@
-0001-Increase-the-length-of-the-test-phone-number.patch

debian/pgversions

@@ -1 +0,0 @@
-13+

debian/rules

@@ -1,6 +0,0 @@
-#!/usr/bin/make -f
-
-include /usr/share/postgresql-common/pgxs_debian_control.mk
-
-%:
-	dh $@ --with pgxs_loop

debian/source/format

@@ -1 +0,0 @@
-3.0 (quilt)

docker/run-tests.sh

@@ -7,6 +7,3 @@ pg_ctl=/usr/lib/postgresql/${PG_MAJOR}/bin/pg_ctl
 "$pg_ctl" "--pgdata=${PGDATA}" start -w
 make installcheck
 "$pg_ctl" "--pgdata=${PGDATA}" stop
-if [ -f regression.diffs ]; then
-    cat regression.diffs
-fi

expected/regression.out

@@ -1,23 +1,23 @@
 CREATE EXTENSION IF NOT EXISTS pg_libphonenumber;
 --Test phone number parsing
-select parse_packed_phone_number('555-555-5555', 'US');
+select parse_phone_number('555-555-5555', 'US');
- parse_packed_phone_number 
+ parse_phone_number 
----------------------------
+--------------------
  +1 555-555-5555
 (1 row)
 
 --These two should produce errors because the number is too long.
 --Produces an error in pg-libphonenumber's code
-select parse_packed_phone_number('555-555-5555555555', 'US');
+select parse_phone_number('555-555-5555555555', 'US');
 ERROR:  phone number '+1 5555555555555555' is too long
 DETAIL:  National number is too long
 --Produces an error from libphonenumber
-select parse_packed_phone_number('555-555-55555555555', 'US');
+select parse_phone_number('555-555-55555555555', 'US');
 ERROR:  unable to parse '555-555-55555555555' as a phone number
 DETAIL:  National number is too long
 -- Do we get correct country codes?
 -- TODO: expand.
-select phone_number_country_code(parse_packed_phone_number('+1-555-555-5555', 'USA'));
+select phone_number_country_code(parse_phone_number('+1-555-555-5555', 'USA'));
  phone_number_country_code 
 ---------------------------
                          1

sql/pg_libphonenumber--0.1.0.sql

@@ -2,52 +2,56 @@
 \echo Use "CREATE EXTENSION pg_libphonenumber" to load this file. \quit
 
 --
--- Packed number type
+-- Phone number type
 --
 
-CREATE TYPE packed_phone_number;
+CREATE TYPE phone_number;
 
-CREATE FUNCTION packed_phone_number_in(cstring) RETURNS packed_phone_number
+CREATE FUNCTION phone_number_in(cstring) RETURNS phone_number
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_in';
+    AS 'pg_libphonenumber', 'phone_number_in';
 
-CREATE FUNCTION packed_phone_number_out(packed_phone_number) RETURNS cstring
+CREATE FUNCTION phone_number_out(phone_number) RETURNS cstring
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_out';
+    AS 'pg_libphonenumber', 'phone_number_out';
 
-CREATE FUNCTION packed_phone_number_recv(internal) RETURNS packed_phone_number
+CREATE FUNCTION phone_number_recv(internal) RETURNS phone_number
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_recv';
+    AS 'pg_libphonenumber', 'phone_number_recv';
 
-CREATE FUNCTION packed_phone_number_send(packed_phone_number) RETURNS bytea
+CREATE FUNCTION phone_number_send(phone_number) RETURNS bytea
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_send';
+    AS 'pg_libphonenumber', 'phone_number_send';
 
-CREATE TYPE packed_phone_number (
+CREATE TYPE phone_number (
     INTERNALLENGTH = 8,
-    INPUT = packed_phone_number_in,
+    INPUT = phone_number_in,
-    OUTPUT = packed_phone_number_out,
+    OUTPUT = phone_number_out,
-    RECEIVE = packed_phone_number_recv,
+    RECEIVE = phone_number_recv,
-    SEND = packed_phone_number_send,
+    SEND = phone_number_send,
     ALIGNMENT = double,
     STORAGE = plain
 );
 
+--
 -- Casts
+--
 
-CREATE CAST (packed_phone_number AS text)
+CREATE CAST (phone_number AS text)
     WITH INOUT;
 
+--
 -- Operators and indexing
+--
 
-CREATE FUNCTION packed_phone_number_equal(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_equal(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_equal';
+    AS 'pg_libphonenumber', 'phone_number_equal';
 
 CREATE OPERATOR = (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_equal,
+    procedure = phone_number_equal,
     commutator = =,
     negator = <>,
     restrict = eqsel,
@@ -56,99 +60,97 @@ CREATE OPERATOR = (
     merges = true
 );
 
-CREATE FUNCTION packed_phone_number_not_equal(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_not_equal(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_not_equal';
+    AS 'pg_libphonenumber', 'phone_number_not_equal';
 
 CREATE OPERATOR <> (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_not_equal,
+    procedure = phone_number_not_equal,
     commutator = <>,
     negator = =,
     restrict = neqsel,
     join = neqjoinsel
 );
 
-CREATE FUNCTION packed_phone_number_less(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_less(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_less';
+    AS 'pg_libphonenumber', 'phone_number_less';
 
 CREATE OPERATOR < (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_less,
+    procedure = phone_number_less,
     commutator = >,
     negator = >=,
     restrict = scalarltsel,
     join = scalarltjoinsel
 );
 
-CREATE FUNCTION packed_phone_number_less_or_equal(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_less_or_equal(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_less_or_equal';
+    AS 'pg_libphonenumber', 'phone_number_less_or_equal';
 
 CREATE OPERATOR <= (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_less_or_equal,
+    procedure = phone_number_less_or_equal,
     commutator = >=,
     negator = >,
     restrict = scalarltsel,
     join = scalarltjoinsel
 );
 
-CREATE FUNCTION packed_phone_number_greater(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_greater(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_greater';
+    AS 'pg_libphonenumber', 'phone_number_greater';
 
 CREATE OPERATOR > (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_greater,
+    procedure = phone_number_greater,
     commutator = >,
     negator = <=,
     restrict = scalargtsel,
     join = scalargtjoinsel
 );
 
-CREATE FUNCTION packed_phone_number_greater_or_equal(packed_phone_number, packed_phone_number) RETURNS bool
+CREATE FUNCTION phone_number_greater_or_equal(phone_number, phone_number) RETURNS bool
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_greater_or_equal';
+    AS 'pg_libphonenumber', 'phone_number_greater_or_equal';
 
 CREATE OPERATOR >= (
-    leftarg = packed_phone_number,
+    leftarg = phone_number,
-    rightarg = packed_phone_number,
+    rightarg = phone_number,
-    procedure = packed_phone_number_greater_or_equal,
+    procedure = phone_number_greater_or_equal,
     commutator = >=,
     negator = <,
     restrict = scalargtsel,
     join = scalargtjoinsel
 );
 
-CREATE FUNCTION packed_phone_number_cmp(packed_phone_number, packed_phone_number) RETURNS integer
+CREATE FUNCTION phone_number_cmp(phone_number, phone_number) RETURNS integer
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_cmp';
+    AS 'pg_libphonenumber', 'phone_number_cmp';
 
-CREATE OPERATOR CLASS packed_phone_number_ops
+CREATE OPERATOR CLASS phone_number_ops
-    DEFAULT FOR TYPE packed_phone_number USING btree AS
+    DEFAULT FOR TYPE phone_number USING btree AS
         OPERATOR 1 <,
         OPERATOR 2 <=,
         OPERATOR 3 =,
         OPERATOR 4 >=,
         OPERATOR 5 >,
-        FUNCTION 1 packed_phone_number_cmp(packed_phone_number, packed_phone_number);
+        FUNCTION 1 phone_number_cmp(phone_number, phone_number);
-
--- Constructors
-
-CREATE FUNCTION parse_packed_phone_number(text, text) RETURNS packed_phone_number
-    LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'parse_packed_phone_number';
 
 --
 -- General functions
 --
 
-CREATE FUNCTION phone_number_country_code(packed_phone_number) RETURNS integer
+CREATE FUNCTION parse_phone_number(text, text) RETURNS phone_number
     LANGUAGE c IMMUTABLE STRICT
-    AS 'pg_libphonenumber', 'packed_phone_number_country_code';
+    AS 'pg_libphonenumber', 'parse_phone_number';
+
+CREATE FUNCTION phone_number_country_code(phone_number) RETURNS integer
+    LANGUAGE c IMMUTABLE STRICT
+    AS 'pg_libphonenumber', 'phone_number_country_code';

sql/regression.sql

@@ -1,13 +1,13 @@
 CREATE EXTENSION IF NOT EXISTS pg_libphonenumber;
 
 --Test phone number parsing
-select parse_packed_phone_number('555-555-5555', 'US');
+select parse_phone_number('555-555-5555', 'US');
 --These two should produce errors because the number is too long.
 --Produces an error in pg-libphonenumber's code
-select parse_packed_phone_number('555-555-5555555555', 'US');
+select parse_phone_number('555-555-5555555555', 'US');
 --Produces an error from libphonenumber
-select parse_packed_phone_number('555-555-55555555555', 'US');
+select parse_phone_number('555-555-55555555555', 'US');
 
 -- Do we get correct country codes?
 -- TODO: expand.
-select phone_number_country_code(parse_packed_phone_number('+1-555-555-5555', 'USA'));
+select phone_number_country_code(parse_phone_number('+1-555-555-5555', 'USA'));

src/error_handling.cpp

@@ -9,7 +9,7 @@ extern "C" {
     #include "postgres.h"
 }
 
-#include "packed_phone_number.h"
+#include "short_phone_number.h"
 
 using namespace i18n::phonenumbers;
 
@@ -65,7 +65,7 @@ void reportException(const std::exception& exception) {
         std::string phone_number = too_long->number_string();
         phone_number += '\0';
         ereport(ERROR,
-            (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+            (errcode(ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE),
                 errmsg("phone number '%s' is too long", phone_number.data()),
                 errdetail("%s", exception.what())));
         return;

src/error_handling.h

@@ -1,5 +1,3 @@
-#pragma once
-
 #include <exception>
 
 #include "phonenumbers/phonenumberutil.h"

src/mask.h

@@ -1,5 +1,3 @@
-#pragma once
-
 #include <cstddef>
 #include <type_traits>
 

src/pg_libphonenumber.cpp

@@ -10,17 +10,17 @@ extern "C" {
 }
 
 #include "error_handling.h"
-#include "packed_phone_number.h"
+#include "short_phone_number.h"
 
 using namespace i18n::phonenumbers;
 
 static const PhoneNumberUtil* const phoneUtil = PhoneNumberUtil::GetInstance();
 
 /**
- * Clamps a value to the given (inclusive) range
+ * Clips a value to the given (inclusive) range
  */
 template <typename T>
-T clamp(const T& n, const T& lower, const T& upper) {
+T clip(const T& n, const T& lower, const T& upper) {
   return std::max(lower, std::min(n, upper));
 }
 
@@ -39,13 +39,15 @@ static char* text_to_c_string(const text* text) {
     return str;
 }
 
-//Internal function used by packed_phone_number_in and parse_packed_phone_number
+//Internal function used by phone_number_in and parse_phone_number
 //TODO: take a std::string to minimize copying?
-PackedPhoneNumber* do_parse_packed_phone_number(const char* number_str, const char* country) {
+//TODO: rename this so we're not relying on overloading to distinguish this from
+// its extern "C" counterpart.
+ShortPhoneNumber* parse_phone_number(const char* number_str, const char* country) {
     PhoneNumber number;
-    PackedPhoneNumber* short_number;
+    ShortPhoneNumber* short_number;
 
-    short_number = (PackedPhoneNumber*)palloc0(sizeof(PackedPhoneNumber));
+    short_number = (ShortPhoneNumber*)palloc0(sizeof(ShortPhoneNumber));
     if(short_number == nullptr) {
         throw std::bad_alloc();
     }
@@ -54,7 +56,7 @@ PackedPhoneNumber* do_parse_packed_phone_number(const char* number_str, const ch
     error = phoneUtil->Parse(number_str, country, &number);
     if(error == PhoneNumberUtil::NO_PARSING_ERROR) {
         //Initialize short_number using placement new.
-        new(short_number) PackedPhoneNumber(number);
+        new(short_number) ShortPhoneNumber(number);
         return short_number;
     } else {
         reportParseError(number_str, error);
@@ -78,15 +80,15 @@ extern "C" {
      * I/O functions
      */
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_in);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_in);
 
     PGDLLEXPORT Datum
-    packed_phone_number_in(PG_FUNCTION_ARGS) {
+    phone_number_in(PG_FUNCTION_ARGS) {
         try {
             const char *number_str = PG_GETARG_CSTRING(0);
 
             //TODO: use international format instead.
-            PackedPhoneNumber* number = do_parse_packed_phone_number(number_str, "US");
+            ShortPhoneNumber* number = parse_phone_number(number_str, "US");
             if(number) {
                 PG_RETURN_POINTER(number);
             } else {
@@ -98,12 +100,12 @@ extern "C" {
         }
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_out);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_out);
 
     PGDLLEXPORT Datum
-    packed_phone_number_out(PG_FUNCTION_ARGS) {
+    phone_number_out(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* short_number = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* short_number = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
             PhoneNumber number = *short_number;
 
             std::string formatted;
@@ -127,17 +129,17 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_recv);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_recv);
 
     PGDLLEXPORT Datum
-    packed_phone_number_recv(PG_FUNCTION_ARGS) {
+    phone_number_recv(PG_FUNCTION_ARGS) {
         try {
             StringInfo buf = (StringInfo)PG_GETARG_POINTER(0);
-            PackedPhoneNumber* number;
+            ShortPhoneNumber* number;
 
-            number = (PackedPhoneNumber*)palloc(sizeof(PackedPhoneNumber));
+            number = (ShortPhoneNumber*)palloc(sizeof(ShortPhoneNumber));
             //TODO: make portable (fix endianness issues, etc.).
-            pq_copymsgbytes(buf, (char*)number, sizeof(PackedPhoneNumber));
+            pq_copymsgbytes(buf, (char*)number, sizeof(ShortPhoneNumber));
             PG_RETURN_POINTER(number);
         } catch (const std::exception& e) {
             reportException(e);
@@ -146,16 +148,16 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_send);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_send);
 
     PGDLLEXPORT Datum
-    packed_phone_number_send(PG_FUNCTION_ARGS) {
+    phone_number_send(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber *number = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber *number = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
             StringInfoData buf;
 
             pq_begintypsend(&buf);
-            pq_sendbytes(&buf, (const char*)number, sizeof(PackedPhoneNumber));
+            pq_sendbytes(&buf, (const char*)number, sizeof(ShortPhoneNumber));
             PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
         } catch (const std::exception& e) {
             reportException(e);
@@ -168,13 +170,13 @@ extern "C" {
      * Operator functions
      */
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_equal);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_equal);
 
     PGDLLEXPORT Datum
-    packed_phone_number_equal(PG_FUNCTION_ARGS) {
+    phone_number_equal(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(*number1 == *number2);
         } catch(std::exception& e) {
@@ -184,13 +186,13 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_not_equal);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_not_equal);
 
     PGDLLEXPORT Datum
-    packed_phone_number_not_equal(PG_FUNCTION_ARGS) {
+    phone_number_not_equal(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(*number1 != *number2);
         } catch(std::exception& e) {
@@ -200,13 +202,13 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_less);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_less);
 
     PGDLLEXPORT Datum
-    packed_phone_number_less(PG_FUNCTION_ARGS) {
+    phone_number_less(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(number1->compare_fast(*number2) < 0);
         } catch(std::exception& e) {
@@ -216,13 +218,13 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_less_or_equal);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_less_or_equal);
 
     PGDLLEXPORT Datum
-    packed_phone_number_less_or_equal(PG_FUNCTION_ARGS) {
+    phone_number_less_or_equal(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(number1->compare_fast(*number2) <= 0);
         } catch(std::exception& e) {
@@ -232,13 +234,13 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_greater);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_greater);
 
     PGDLLEXPORT Datum
-    packed_phone_number_greater(PG_FUNCTION_ARGS) {
+    phone_number_greater(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(number1->compare_fast(*number2) > 0);
         } catch(std::exception& e) {
@@ -248,13 +250,13 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_greater_or_equal);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_greater_or_equal);
 
     PGDLLEXPORT Datum
-    packed_phone_number_greater_or_equal(PG_FUNCTION_ARGS) {
+    phone_number_greater_or_equal(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             PG_RETURN_BOOL(number1->compare_fast(*number2) >= 0);
         } catch(std::exception& e) {
@@ -264,17 +266,17 @@ extern "C" {
         PG_RETURN_NULL();
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_cmp);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_cmp);
 
     PGDLLEXPORT Datum
-    packed_phone_number_cmp(PG_FUNCTION_ARGS) {
+    phone_number_cmp(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number1 = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number1 = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
-            const PackedPhoneNumber* number2 = (PackedPhoneNumber*)PG_GETARG_POINTER(1);
+            const ShortPhoneNumber* number2 = (ShortPhoneNumber*)PG_GETARG_POINTER(1);
 
             int64_t compared = number1->compare_fast(*number2);
 
-            PG_RETURN_INT32(clamp<int64_t>(compared, -1, 1));
+            PG_RETURN_INT32(clip<int64_t>(compared, -1, 1));
         } catch(std::exception& e) {
             reportException(e);
         }
@@ -286,10 +288,10 @@ extern "C" {
      * Other functions
      */
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(parse_packed_phone_number);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(parse_phone_number);
 
     PGDLLEXPORT Datum
-    parse_packed_phone_number(PG_FUNCTION_ARGS) {
+    parse_phone_number(PG_FUNCTION_ARGS) {
         try {
             const text* number_text = PG_GETARG_TEXT_P(0);
             const text* country_text = PG_GETARG_TEXT_P(1);
@@ -297,7 +299,7 @@ extern "C" {
             char* number_str = text_to_c_string(number_text);
             char* country = text_to_c_string(country_text);
 
-            PackedPhoneNumber* number = do_parse_packed_phone_number(number_str, country);
+            ShortPhoneNumber* number = parse_phone_number(number_str, country);
             //TODO: prevent leaks.
             pfree(number_str);
             pfree(country);
@@ -312,12 +314,12 @@ extern "C" {
         }
     }
 
-    PGDLLEXPORT PG_FUNCTION_INFO_V1(packed_phone_number_country_code);
+    PGDLLEXPORT PG_FUNCTION_INFO_V1(phone_number_country_code);
 
     PGDLLEXPORT Datum
-    packed_phone_number_country_code(PG_FUNCTION_ARGS) {
+    phone_number_country_code(PG_FUNCTION_ARGS) {
         try {
-            const PackedPhoneNumber* number = (PackedPhoneNumber*)PG_GETARG_POINTER(0);
+            const ShortPhoneNumber* number = (ShortPhoneNumber*)PG_GETARG_POINTER(0);
 
             PG_RETURN_INT32(number->country_code());
         } catch(std::exception& e) {

src/short_phone_number.cpp

@@ -1,11 +1,9 @@
-#include "packed_phone_number.h"
+#include "short_phone_number.h"
 
 using namespace google::protobuf;
 using namespace i18n::phonenumbers;
 
-namespace {
+const PhoneNumberUtil* const PhoneNumberTooLongException::phoneUtil = PhoneNumberUtil::GetInstance();
-    const PhoneNumberUtil* phoneUtil = PhoneNumberUtil::GetInstance();
-}
 
 PhoneNumberTooLongException::PhoneNumberTooLongException(const PhoneNumber& number, const char* msg) :
     std::runtime_error(msg), _number(number) {};
@@ -16,8 +14,7 @@ std::string PhoneNumberTooLongException::number_string() const {
     return formatted;
 }
 
-PackedPhoneNumber::PackedPhoneNumber(const i18n::phonenumbers::PhoneNumber& number) {
+ShortPhoneNumber::ShortPhoneNumber(i18n::phonenumbers::PhoneNumber number) {
-    // TODO: check has_national_number(), etc?
     uint32 country_code = number.country_code();
     if(country_code > max_country_code) {
         throw PhoneNumberTooLongException(number, "Country code is too long");
@@ -41,7 +38,7 @@ PackedPhoneNumber::PackedPhoneNumber(const i18n::phonenumbers::PhoneNumber& numb
     }
 }
 
-PackedPhoneNumber::operator PhoneNumber() const {
+ShortPhoneNumber::operator PhoneNumber() const {
     PhoneNumber number;
     number.set_country_code(country_code());
     number.set_national_number(national_number());

src/short_phone_number.h

@@ -1,5 +1,3 @@
-#pragma once
-
 #include <cstdint>
 #include <exception>
 #include <string>
@@ -9,16 +7,16 @@
 #include "mask.h"
 
 /**
- * Raised when a phone number is too long to fit in a PackedPhoneNumber
+ * Raised when a phone number is too long to fit in a ShortPhoneNumber
  * 
- * This shouldn't happen for any phone numbers that meet ITU specifications.
+ * This shouldn't happen for any valid phone numbers.
  */
 class PhoneNumberTooLongException : public std::runtime_error {
     public:
     PhoneNumberTooLongException(const i18n::phonenumbers::PhoneNumber& number, const char* msg);
 
     /// Returns the original phone number object
-    const i18n::phonenumbers::PhoneNumber& number() const {
+    i18n::phonenumbers::PhoneNumber number() const {
         return _number;
     }
 
@@ -26,12 +24,14 @@ class PhoneNumberTooLongException : public std::runtime_error {
     std::string number_string() const;
     private:
     i18n::phonenumbers::PhoneNumber _number;
+
+    static const i18n::phonenumbers::PhoneNumberUtil* const phoneUtil;
 };
 
 /**
  * Stores a phone number (packed into a 64-bit integer)
  */
-class PackedPhoneNumber {
+class ShortPhoneNumber {
     public:
     /// The largest possible country code
     static constexpr size_t max_country_code = 999;
@@ -52,13 +52,13 @@ class PackedPhoneNumber {
     static constexpr size_t leading_zeros_offset = country_code_offset + country_code_bits;
     static constexpr size_t national_number_offset = leading_zeros_offset + leading_zeros_bits;
 
-    PackedPhoneNumber(const i18n::phonenumbers::PhoneNumber& number);
+    ShortPhoneNumber(i18n::phonenumbers::PhoneNumber number);
 
-    bool operator==(const PackedPhoneNumber other) const {
+    bool operator==(const ShortPhoneNumber other) const {
         return this->_data == other._data;
     }
 
-    bool operator != (const PackedPhoneNumber other) const {
+    bool operator != (const ShortPhoneNumber other) const {
         return !(*this == other);
     }
 
@@ -66,7 +66,7 @@ class PackedPhoneNumber {
     operator i18n::phonenumbers::PhoneNumber() const;
 
     /*
-     * Compares to another PackedPhoneNumber using a fast collation heuristic
+     * Compares to another ShortPhoneNumber using a fast collation heuristic
      *
      * May not produce intuitive results for numbers with the same
      * country code but different lengths
@@ -76,7 +76,7 @@ class PackedPhoneNumber {
      * - 0 (if a == b)
      * - >0 (if a > b)
      */
-    int64_t compare_fast(PackedPhoneNumber other) const {
+    int64_t compare_fast(ShortPhoneNumber other) const {
         return other._data - this->_data;
     }
 
@@ -115,7 +115,7 @@ class PackedPhoneNumber {
 };
 
 /*
- * If the size of the PackedPhoneNumber class changes for any reason, it will trip this assertion and remind us to
+ * If the size of the ShortPhoneNumber class changes for any reason, it will trip this assertion and remind us to
  * update the SQL definition of the short_phone_number type.
  */
-static_assert(sizeof(PackedPhoneNumber) == 8, "unexpected size for PackedPhoneNumber");
+static_assert(sizeof(ShortPhoneNumber) == 8, "unexpected size for ShortPhoneNumber");