pico_phone 0.6.2-aarch64-linux

data/ext/pico_phone/timezone_data.h

@@ -0,0 +1,25 @@
+// First-party pico_phone file, not vendored. Declares the accessor for
+// timezone_data.cc (generated by generate_timezone_data.rb). Unlike
+// carrier_data.h, this doesn't need to live under phonenumbers/geocoding/
+// -- that constraint only applies to files generated by libphonenumber's
+// own generate_geocoding_data tool, which hardcodes that include path.
+// This generator is first-party too, so it just includes this header
+// directly by relative name.
+
+#ifndef PICO_PHONE_TIMEZONE_DATA_H_
+#define PICO_PHONE_TIMEZONE_DATA_H_
+
+#include "phonenumbers/geocoding/geocoding_data.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+// A single flat prefix -> raw '&'-joined time zone names table. No
+// per-language dimension (unlike geocoding/carrier) since time zone
+// identifiers aren't translated.
+const PrefixDescriptions* get_timezone_descriptions();
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif  // PICO_PHONE_TIMEZONE_DATA_H_

data/ext/pico_phone/timezone_mapper.cc

@@ -0,0 +1,54 @@
+// First-party pico_phone file. See timezone_mapper.h.
+
+#include "timezone_mapper.h"
+
+#include <sstream>
+#include <string>
+#include <vector>
+
+#include "phonenumbers/geocoding/area_code_map.h"
+#include "phonenumbers/phonenumber.pb.h"
+#include "timezone_data.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+using std::string;
+using std::vector;
+
+namespace {
+
+// Time zones are joined with '&' in the raw description string, matching
+// libphonenumber's own PrefixTimeZonesMap.RAW_STRING_TIMEZONES_SEPARATOR.
+vector<string> SplitTimeZones(const string& raw) {
+  vector<string> result;
+  std::stringstream stream(raw);
+  string token;
+  while (std::getline(stream, token, '&')) {
+    if (!token.empty()) {
+      result.push_back(token);
+    }
+  }
+  return result;
+}
+
+}  // namespace
+
+PhoneNumberTimeZonesMapper::PhoneNumberTimeZonesMapper() {
+  area_code_map_.reset(new AreaCodeMap());
+  area_code_map_->ReadAreaCodeMap(get_timezone_descriptions());
+}
+
+PhoneNumberTimeZonesMapper::~PhoneNumberTimeZonesMapper() {}
+
+vector<string> PhoneNumberTimeZonesMapper::GetTimeZonesForNumber(
+    const PhoneNumber& number) const {
+  const char* description = area_code_map_->Lookup(number);
+  if (!description || *description == '\0') {
+    return vector<string>();
+  }
+  return SplitTimeZones(description);
+}
+
+}  // namespace phonenumbers
+}  // namespace i18n

data/ext/pico_phone/timezone_mapper.h

@@ -0,0 +1,49 @@
+// First-party pico_phone file. Unlike carrier_mapper.h, this doesn't need
+// its own AreaCodeMap-alike class: timezone data is a single flat prefix
+// table (no per-language dimension, no multiple files to lazily choose
+// between), so it's a thin wrapper directly around the vendored
+// AreaCodeMap -- same longest-prefix-match lookup logic already reused by
+// the geocoder and carrier mapper, just with one eagerly-loaded table
+// (the whole thing is ~86KB source data, small enough that lazy loading
+// isn't worth the complexity here).
+
+#ifndef PICO_PHONE_TIMEZONE_MAPPER_H_
+#define PICO_PHONE_TIMEZONE_MAPPER_H_
+
+#include <string>
+#include <vector>
+
+#include "phonenumbers/base/memory/scoped_ptr.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+class AreaCodeMap;
+class PhoneNumber;
+
+class PhoneNumberTimeZonesMapper {
+ public:
+  PhoneNumberTimeZonesMapper();
+
+  PhoneNumberTimeZonesMapper(const PhoneNumberTimeZonesMapper&) = delete;
+  PhoneNumberTimeZonesMapper& operator=(const PhoneNumberTimeZonesMapper&) = delete;
+
+  ~PhoneNumberTimeZonesMapper();
+
+  // Returns the time zones the given phone number's prefix belongs to, or
+  // an empty vector if no mapping is available. A single prefix can map to
+  // several time zones (e.g. NANPA numbers span many), hence the plural --
+  // matching libphonenumber's own Java PhoneNumberToTimeZonesMapper shape,
+  // though this returns an empty vector for "not found" rather than Java's
+  // single-element ["Etc/Unknown"] sentinel, to match this codebase's own
+  // convention (see carrier_mapper.h) of empty over sentinel values.
+  std::vector<std::string> GetTimeZonesForNumber(const PhoneNumber& number) const;
+
+ private:
+  scoped_ptr<AreaCodeMap> area_code_map_;
+};
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif  // PICO_PHONE_TIMEZONE_MAPPER_H_

data/ext/pico_phone/vendor_headers/phonenumbers/geocoding/area_code_map.h

@@ -0,0 +1,92 @@
+// Vendored verbatim from libphonenumber's
+// cpp/src/phonenumbers/geocoding/area_code_map.h (pinned version 9.0.34,
+// see ext/pico_phone/build_deps.sh). Upstream's CMake install step only
+// installs phonenumber_offline_geocoder.h from this directory, not this
+// file, even though AreaCodeMap's implementation (area_code_map.cc) is
+// already compiled into libgeocoding.a/libgeocoding.dylib in both pico_phone
+// build paths (static-vendored and dynamic/Homebrew). This header is needed
+// at compile time only, to declare the interface for carrier_mapper.cc; no
+// implementation is duplicated here. Copied under the same Apache License,
+// Version 2.0 as the rest of the vendored libphonenumber source. If the
+// vendored libphonenumber version is ever bumped, diff this against the new
+// version's copy to confirm the interface hasn't changed.
+
+// Copyright (C) 2012 The Libphonenumber Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Author: Patrick Mezard
+
+#ifndef I18N_PHONENUMBERS_AREA_CODE_MAP_H_
+#define I18N_PHONENUMBERS_AREA_CODE_MAP_H_
+
+#include <cstdint>
+#include <map>
+#include <string>
+
+#include "phonenumbers/base/basictypes.h"
+#include "phonenumbers/base/memory/scoped_ptr.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+using std::map;
+using std::string;
+
+class DefaultMapStorage;
+class PhoneNumber;
+class PhoneNumberUtil;
+struct PrefixDescriptions;
+
+// A utility that maps phone number prefixes to a string describing the
+// geographical area the prefix covers.
+class AreaCodeMap {
+ public:
+  AreaCodeMap();
+
+  // This type is neither copyable nor movable.
+  AreaCodeMap(const AreaCodeMap&) = delete;
+  AreaCodeMap& operator=(const AreaCodeMap&) = delete;
+
+  ~AreaCodeMap();
+
+  // Returns the description of the geographical area the number corresponds
+  // to. This method distinguishes the case of an invalid prefix and a prefix
+  // for which the name is not available in the current language. If the
+  // description is not available in the current language an empty string is
+  // returned. If no description was found for the provided number, null is
+  // returned.
+  const char* Lookup(const PhoneNumber& number) const;
+
+  // Creates an AreaCodeMap initialized with area_codes. Note that the
+  // underlying implementation of this method is expensive thus should
+  // not be called by time-critical applications.
+  //
+  // area_codes maps phone number prefixes to geographical area description.
+  void ReadAreaCodeMap(const PrefixDescriptions* descriptions);
+
+ private:
+  // Does a binary search for value in the provided array from start to end
+  // (inclusive). Returns the position if {@code value} is found; otherwise,
+  // returns the position which has the largest value that is less than value.
+  // This means if value is the smallest, -1 will be returned.
+  int BinarySearch(int start, int end, int64_t value) const;
+
+  const PhoneNumberUtil& phone_util_;
+  scoped_ptr<const DefaultMapStorage> storage_;
+};
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif /* I18N_PHONENUMBERS_AREA_CODE_MAP_H_ */

data/ext/pico_phone/vendor_headers/phonenumbers/geocoding/carrier_data.h

@@ -0,0 +1,52 @@
+// First-party pico_phone file, NOT vendored/copied from libphonenumber
+// (unlike its siblings in this directory). Declares the accessors for
+// carrier_data.cc, which is generated at build time by running
+// libphonenumber's own (unmodified) generate_geocoding_data tool against
+// resources/carrier/ with accessor prefix "_carrier" -- see
+// ext/pico_phone/build_deps.sh. Mirrors the shape of libphonenumber's own
+// test/phonenumbers/geocoding/geocoding_test_data.h, which does the same
+// thing for its "_test" prefix: reuse the CountryLanguages/
+// PrefixDescriptions struct layouts from geocoding_data.h, declare
+// prefix-renamed accessor functions.
+//
+// This file must live at exactly this path (phonenumbers/geocoding/
+// carrier_data.h, relative to an include root) because the generator
+// tool hardcodes `#include "phonenumbers/geocoding/<base_name>.h"` in
+// every file it emits, where base_name is derived from the output .cc
+// filename -- not configurable.
+
+#ifndef PICO_PHONE_CARRIER_DATA_H_
+#define PICO_PHONE_CARRIER_DATA_H_
+
+#include "phonenumbers/geocoding/geocoding_data.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+// Returns a sorted array of country calling codes with carrier data.
+const int* get_carrier_country_calling_codes();
+
+// Returns the number of country calling codes in
+// get_carrier_country_calling_codes() array.
+int get_carrier_country_calling_codes_size();
+
+// Returns the CountryLanguages record for country at index, index
+// being in [0, get_carrier_country_calling_codes_size()).
+const CountryLanguages* get_carrier_country_languages(int index);
+
+// Returns a sorted array of prefix language code pairs like
+// "1_de" or "82_ko".
+const char** get_carrier_prefix_language_code_pairs();
+
+// Returns the number of elements in
+// get_carrier_prefix_language_code_pairs()
+int get_carrier_prefix_language_code_pairs_size();
+
+// Returns the PrefixDescriptions for language/code pair at index,
+// index being in [0, get_carrier_prefix_language_code_pairs_size()).
+const PrefixDescriptions* get_carrier_prefix_descriptions(int index);
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif  // PICO_PHONE_CARRIER_DATA_H_

data/ext/pico_phone/vendor_headers/phonenumbers/geocoding/geocoding_data.h

@@ -0,0 +1,93 @@
+// Vendored verbatim from libphonenumber's
+// cpp/src/phonenumbers/geocoding/geocoding_data.h (pinned version 9.0.34,
+// see ext/pico_phone/build_deps.sh). Same rationale as area_code_map.h and
+// mapping_file_provider.h in this directory: upstream doesn't install this
+// header. Needed here for the CountryLanguages/PrefixDescriptions struct
+// layouts, which carrier_data.h (first-party, not vendored -- see that
+// file) reuses for its own get_carrier_* accessors. The unsuffixed
+// get_*() declarations below are also harmless to have in scope: they're
+// declarations only (no bodies), resolved at link time to the real
+// geocoding_data.cc's implementations already compiled into
+// libgeocoding.a/libgeocoding.dylib, exactly as libphonenumber's own
+// phonenumber_offline_geocoder.cc and test/.../geocoding_test_data.h
+// already do elsewhere in this same codebase. Copied under the same
+// Apache License, Version 2.0 as the rest of the vendored libphonenumber
+// source.
+
+// Copyright (C) 2012 The Libphonenumber Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// This file is generated automatically, do not edit it manually.
+
+#ifndef I18N_PHONENUMBERS_GEOCODING_DATA
+#define I18N_PHONENUMBERS_GEOCODING_DATA
+
+#include <cstdint>
+
+namespace i18n {
+namespace phonenumbers {
+
+struct CountryLanguages {
+  // Sorted array of language codes.
+  const char** available_languages;
+
+  // Number of elements in available_languages.
+  const int available_languages_size;
+};
+
+struct PrefixDescriptions {
+  // Sorted array of phone number prefixes.
+  const int32_t* prefixes;
+
+  // Number of elements in prefixes.
+  const int prefixes_size;
+
+  // Array of phone number prefix descriptions, mapped one to one
+  // to prefixes.
+  const char** descriptions;
+
+  // Sorted array of unique prefix lengths in base 10.
+  const int32_t* possible_lengths;
+
+  // Number of elements in possible_lengths.
+  const int possible_lengths_size;
+};
+
+// Returns a sorted array of country calling codes.
+const int* get_country_calling_codes();
+
+// Returns the number of country calling codes in
+// get_country_calling_codes() array.
+int get_country_calling_codes_size();
+
+// Returns the CountryLanguages record for country at index, index
+// being in [0, get_country_calling_codes_size()).
+const CountryLanguages* get_country_languages(int index);
+
+// Returns a sorted array of prefix language code pairs like
+// "1_de" or "82_ko".
+const char** get_prefix_language_code_pairs();
+
+// Returns the number of elements in
+// get_prefix_language_code_pairs()
+int get_prefix_language_code_pairs_size();
+
+// Returns the PrefixDescriptions for language/code pair at index,
+// index being in [0, get_prefix_language_code_pairs_size()).
+const PrefixDescriptions* get_prefix_descriptions(int index);
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif  // I18N_PHONENUMBERS_GEOCODING_DATA

data/ext/pico_phone/vendor_headers/phonenumbers/geocoding/mapping_file_provider.h

@@ -0,0 +1,89 @@
+// Vendored verbatim from libphonenumber's
+// cpp/src/phonenumbers/geocoding/mapping_file_provider.h (pinned version
+// 9.0.34, see ext/pico_phone/build_deps.sh). Same rationale as
+// area_code_map.h in this directory: upstream doesn't install this header,
+// even though mapping_file_provider.cc is already compiled into
+// libgeocoding.a/libgeocoding.dylib in both pico_phone build paths. Header
+// only, no implementation duplicated. Copied under the same Apache License,
+// Version 2.0 as the rest of the vendored libphonenumber source.
+
+// Copyright (C) 2012 The Libphonenumber Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Author: Patrick Mezard
+
+#ifndef I18N_PHONENUMBERS_GEOCODING_MAPPING_FILE_PROVIDER_H_
+#define I18N_PHONENUMBERS_GEOCODING_MAPPING_FILE_PROVIDER_H_
+
+#include <string>
+
+#include "phonenumbers/base/basictypes.h"
+
+namespace i18n {
+namespace phonenumbers {
+
+using std::string;
+
+struct CountryLanguages;
+
+// A utility which knows the data files that are available for the geocoder to
+// use. The data files contain mappings from phone number prefixes to text
+// descriptions, and are organized by country calling code and language that the
+// text descriptions are in.
+class MappingFileProvider {
+ public:
+  typedef const CountryLanguages* (*country_languages_getter)(int index);
+
+  // Initializes a MappingFileProvider with country_calling_codes, a sorted
+  // list of country_calling_code_size calling codes, and a function
+  // get_country_languages(int index) returning the CountryLanguage information
+  // related to the country code at index in country_calling_codes.
+  MappingFileProvider(const int* country_calling_codes,
+                      int country_calling_code_size,
+                      country_languages_getter get_country_languages);
+
+  // This type is neither copyable nor movable.
+  MappingFileProvider(const MappingFileProvider&) = delete;
+  MappingFileProvider& operator=(const MappingFileProvider&) = delete;
+
+  // Returns the name of the file that contains the mapping data for the
+  // country_calling_code in the language specified, or an empty string if no
+  // such file can be found.
+  // language is a two or three-letter lowercase language code as defined by ISO
+  // 639. Note that where two different language codes exist (e.g. 'he' and 'iw'
+  // for Hebrew) we use the one that Java/Android canonicalized on ('iw' in this
+  // case).
+  // script is a four-letter titlecase (the first letter is uppercase and the
+  // rest of the letters are lowercase) ISO script code as defined in ISO 15924.
+  // region is a two-letter uppercase ISO country code as defined by ISO 3166-1.
+  const string& GetFileName(int country_calling_code, const string& language,
+                            const string& script, const string& region, string*
+                            filename) const;
+
+ private:
+  void FindBestMatchingLanguageCode(const CountryLanguages* languages,
+                                    const string& language,
+                                    const string& script,
+                                    const string& region,
+                                    string* best_match) const;
+
+  const int* const country_calling_codes_;
+  const int country_calling_codes_size_;
+  const country_languages_getter get_country_languages_;
+};
+
+}  // namespace phonenumbers
+}  // namespace i18n
+
+#endif  // I18N_PHONENUMBERS_GEOCODING_MAPPING_FILE_PROVIDER_H_