intl-tel-input 18.2.0 → 18.3.0

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/phonenumbers/PhoneNumberInApp.java

@@ -0,0 +1,96 @@
+package com.google.phonenumbers.demoapp.phonenumbers;
+
+import java.io.Serializable;
+
+/**
+ * Represents a phone number and the conversion of it in the app (between reading from and writing
+ * to contacts).
+ */
+public class PhoneNumberInApp implements Serializable, Comparable<PhoneNumberInApp> {
+
+  /** ID to identify the phone number in the device's contacts. */
+  private final String id;
+  /** Display name of the contact the phone number belongs to. */
+  private final String contactName;
+
+  /** Phone number as originally in contacts. */
+  private final String originalPhoneNumber;
+  /**
+   * The in E.164 formatted {@link PhoneNumberInApp#originalPhoneNumber} (e.g. {@code +41446681800})
+   * if formattable, else {@code null}.
+   */
+  private String formattedPhoneNumber = null;
+
+  private FormattingState formattingState = FormattingState.PENDING;
+
+  /**
+   * Equal to the value of the checkbox in the UI. Only if {@code true} the phone number should be
+   * updated in the contacts.
+   */
+  private boolean shouldContactBeUpdated = false;
+
+  public PhoneNumberInApp(String id, String contactName, String originalPhoneNumber) {
+    this.id = id;
+    this.contactName = contactName;
+    this.originalPhoneNumber = originalPhoneNumber;
+  }
+
+  public String getId() {
+    return id;
+  }
+
+  public String getContactName() {
+    return contactName;
+  }
+
+  public String getOriginalPhoneNumber() {
+    return originalPhoneNumber;
+  }
+
+  public String getFormattedPhoneNumber() {
+    return formattedPhoneNumber;
+  }
+
+  public void setFormattedPhoneNumber(String formattedPhoneNumber) {
+    this.formattedPhoneNumber = formattedPhoneNumber;
+  }
+
+  public FormattingState getFormattingState() {
+    return formattingState;
+  }
+
+  public void setFormattingState(FormattingState formattingState) {
+    this.formattingState = formattingState;
+  }
+
+  public boolean shouldContactBeUpdated() {
+    return shouldContactBeUpdated;
+  }
+
+  public void setShouldContactBeUpdated(boolean shouldContactBeUpdated) {
+    this.shouldContactBeUpdated = shouldContactBeUpdated;
+  }
+
+  @Override
+  public int compareTo(PhoneNumberInApp o) {
+    return getContactName().compareTo(o.getContactName());
+  }
+
+  /**
+   * Represents the state the formatting of {@link PhoneNumberInApp#originalPhoneNumber} can be at.
+   */
+  public enum FormattingState {
+    /** Used before the formatting is tried/done. */
+    PENDING,
+    /** Formatting completed to {@link PhoneNumberInApp#formattedPhoneNumber} without errors. */
+    COMPLETED,
+    /** Error while parsing the {@link PhoneNumberInApp#originalPhoneNumber}. */
+    PARSING_ERROR,
+    /** {@link PhoneNumberInApp#originalPhoneNumber} is a short number. */
+    NUMBER_IS_SHORT_NUMBER,
+    /** {@link PhoneNumberInApp#originalPhoneNumber} is not a valid number. */
+    NUMBER_IS_NOT_VALID,
+    /** {@link PhoneNumberInApp#originalPhoneNumber} is already in E.164 format. */
+    NUMBER_IS_ALREADY_IN_E164
+  }
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/result/FormattableFragment.java

@@ -0,0 +1,161 @@
+package com.google.phonenumbers.demoapp.result;
+
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.Button;
+import androidx.fragment.app.Fragment;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import com.google.android.material.snackbar.Snackbar;
+import com.google.phonenumbers.demoapp.R;
+import com.google.phonenumbers.demoapp.contacts.ContactsWrite;
+import com.google.phonenumbers.demoapp.phonenumbers.PhoneNumberInApp;
+import java.util.ArrayList;
+
+/**
+ * Used to handle and process interactions from/with the "Formattable" results section in the result
+ * page UI of the app.
+ */
+public class FormattableFragment extends Fragment {
+
+  /** The fragment root view. */
+  private View root;
+  /** The RecyclerView containing the list. */
+  private RecyclerView recyclerView;
+
+  private Button btnUpdateSelected;
+
+  /** The sorted phone numbers the list currently contains. */
+  private ArrayList<PhoneNumberInApp> phoneNumbers;
+
+  public FormattableFragment(ArrayList<PhoneNumberInApp> phoneNumbers) {
+    this.phoneNumbers = phoneNumbers;
+  }
+
+  @Override
+  public View onCreateView(
+      LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+    root = inflater.inflate(R.layout.fragment_formattable, container, false);
+    recyclerView = root.findViewById(R.id.recycler_view);
+    recyclerView.setLayoutManager(new LinearLayoutManager(root.getContext()));
+
+    btnUpdateSelected = root.findViewById(R.id.btn_update_selected);
+    btnUpdateSelected.setOnClickListener(v -> btnUpdateSelectedClicked());
+
+    reloadList();
+    return root;
+  }
+
+  /**
+   * Attempts to update the selected contacts and shows success or error based on the outcome.
+   * Called when the update selected button is clicked.
+   */
+  private void btnUpdateSelectedClicked() {
+    updateUiState(UiState.PROCESSING);
+
+    // Get the most up to date list of phone numbers from the RecyclerView adapter.
+    if (recyclerView.getAdapter() == null) {
+      showErrorSnackbar();
+      updateUiState(UiState.SELECT_PHONE_NUMBERS);
+      return;
+    }
+    phoneNumbers = ((FormattableRvAdapter) recyclerView.getAdapter()).getAllPhoneNumbers();
+
+    // Create a sublist with all phone numbers that have the checkbox checked.
+    ArrayList<PhoneNumberInApp> phoneNumbersToUpdate = new ArrayList<>();
+    for (PhoneNumberInApp phoneNumber : phoneNumbers) {
+      if (phoneNumber.shouldContactBeUpdated()) {
+        phoneNumbersToUpdate.add(phoneNumber);
+      }
+    }
+
+    if (phoneNumbersToUpdate.isEmpty()) {
+      showNoNumbersSelectedSnackbar();
+      updateUiState(UiState.SELECT_PHONE_NUMBERS);
+      return;
+    }
+
+    boolean errorWhileUpdatingPhoneNumbers =
+        !ContactsWrite.updatePhoneNumbers(phoneNumbersToUpdate, root.getContext());
+    if (errorWhileUpdatingPhoneNumbers) {
+      showErrorSnackbar();
+      updateUiState(UiState.SELECT_PHONE_NUMBERS);
+    } else {
+      showContactsWriteSuccessSnackbar();
+      phoneNumbers.removeAll(phoneNumbersToUpdate);
+      reloadList();
+    }
+  }
+
+  /** Shows a Snackbar informing that no numbers are selected. */
+  private void showNoNumbersSelectedSnackbar() {
+    Snackbar.make(root, R.string.formattable_no_numbers_selected_text, Snackbar.LENGTH_LONG).show();
+  }
+
+  /** Shows a Snackbar informing that the selected contacts were successfully written. */
+  private void showContactsWriteSuccessSnackbar() {
+    Snackbar.make(root, R.string.formattable_contacts_write_success_text, Snackbar.LENGTH_LONG)
+        .show();
+  }
+
+  /** Shows a Snackbar informing that there was an error (and the user should try again). */
+  private void showErrorSnackbar() {
+    Snackbar.make(root, R.string.formattable_error_text, Snackbar.LENGTH_LONG).show();
+  }
+
+  /**
+   * Reloads the UI so the list contains the phone numbers currently in {@link
+   * FormattableFragment#phoneNumbers}.
+   */
+  private void reloadList() {
+    FormattableRvAdapter adapter = new FormattableRvAdapter(phoneNumbers, root.getContext());
+    recyclerView.setAdapter(adapter);
+    updateUiState(
+        phoneNumbers.isEmpty() ? UiState.NO_PHONE_NUMBERS_IN_LIST : UiState.SELECT_PHONE_NUMBERS);
+  }
+
+  /**
+   * Updates the UI to represent the param {@code uiState}.
+   *
+   * @param uiState State the UI should be changed to
+   */
+  private void updateUiState(UiState uiState) {
+    // Specifically: btnUpdateSelected, and all CheckBoxes (of the list items)
+    boolean mainInteractionsEnabled = false;
+
+    switch (uiState) {
+      case SELECT_PHONE_NUMBERS:
+      default:
+        mainInteractionsEnabled = true;
+        btnUpdateSelected.setText(R.string.formattable_update_selected_text_default);
+        break;
+      case PROCESSING:
+        btnUpdateSelected.setText(R.string.formattable_update_selected_text_processing);
+        break;
+      case NO_PHONE_NUMBERS_IN_LIST:
+        btnUpdateSelected.setText(R.string.formattable_update_selected_text_default);
+        break;
+    }
+
+    btnUpdateSelected.setEnabled(mainInteractionsEnabled);
+
+    if (recyclerView.getAdapter() != null) {
+      ((FormattableRvAdapter) recyclerView.getAdapter()).setAllEnabled(mainInteractionsEnabled);
+    }
+  }
+
+  /** Represents the different states the UI of this fragment can become. */
+  enum UiState {
+    /** The user should select the phone numbers to update. */
+    SELECT_PHONE_NUMBERS,
+    /** Used when loading or processing. The UI is disabled for the user during this time. */
+    PROCESSING,
+    /**
+     * There are no phone number sin the list (the list is empty). Therefore the update selected
+     * button is disabled.
+     */
+    NO_PHONE_NUMBERS_IN_LIST
+  }
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/result/FormattableRvAdapter.java

@@ -0,0 +1,157 @@
+package com.google.phonenumbers.demoapp.result;
+
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.CheckBox;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.constraintlayout.widget.ConstraintLayout;
+import androidx.recyclerview.widget.RecyclerView;
+import com.google.phonenumbers.demoapp.R;
+import com.google.phonenumbers.demoapp.phonenumbers.PhoneNumberInApp;
+import java.util.ArrayList;
+
+/** Adapter for the {@link RecyclerView} used in {@link FormattableFragment}. */
+public class FormattableRvAdapter extends RecyclerView.Adapter<FormattableRvAdapter.ViewHolder> {
+
+  private final LayoutInflater layoutInflater;
+
+  /** List of the original version of {@link PhoneNumberInApp}s at the time of object creation. */
+  private final ArrayList<PhoneNumberInApp> originalPhoneNumbers;
+
+  /** List of all created {@link ViewHolder}s. */
+  private final ArrayList<ViewHolder> viewHolders = new ArrayList<>();
+
+  public FormattableRvAdapter(ArrayList<PhoneNumberInApp> phoneNumbers, Context context) {
+    this.originalPhoneNumbers = phoneNumbers;
+    this.layoutInflater = LayoutInflater.from(context);
+  }
+
+  @NonNull
+  @Override
+  public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+    View view = layoutInflater.inflate(R.layout.formattable_list_item, parent, false);
+    ViewHolder viewHolder = new ViewHolder(view);
+    viewHolders.add(viewHolder);
+    return viewHolder;
+  }
+
+  @Override
+  public void onViewRecycled(@NonNull ViewHolder holder) {
+    super.onViewRecycled(holder);
+    viewHolders.remove(holder);
+  }
+
+  @Override
+  public void onBindViewHolder(@NonNull ViewHolder viewHolder, int position) {
+    if (position >= 0 && position < getItemCount()) {
+      viewHolder.setFromPhoneNumberInAppRepresentation(originalPhoneNumbers.get(position));
+    }
+  }
+
+  @Override
+  public int getItemCount() {
+    return originalPhoneNumbers.size();
+  }
+
+  /**
+   * Sets the enabled state for the checkbox of all list items.
+   *
+   * @param enabled boolean enable state to set
+   */
+  public void setAllEnabled(boolean enabled) {
+    for (ViewHolder viewHolder : viewHolders) {
+      viewHolder.setEnabled(enabled);
+    }
+  }
+
+  /**
+   * Returns a list of all list items as {@link PhoneNumberInApp}s in the current state of the UI.
+   *
+   * @return ArrayList of all list items as {@link PhoneNumberInApp}s in the current state of the UI
+   */
+  public ArrayList<PhoneNumberInApp> getAllPhoneNumbers() {
+    ArrayList<PhoneNumberInApp> phoneNumbers = new ArrayList<>();
+    for (ViewHolder viewHolder : viewHolders) {
+      phoneNumbers.add(viewHolder.getPhoneNumberInAppRepresentation());
+    }
+    return phoneNumbers;
+  }
+
+  /** {@link RecyclerView.ViewHolder} specifically for a list item of a formattable phone number. */
+  public static class ViewHolder extends RecyclerView.ViewHolder {
+
+    /** Representation of the UI as a {@link PhoneNumberInApp}. */
+    private PhoneNumberInApp phoneNumberInAppRepresentation;
+
+    private final TextView tvContactName;
+    private final TextView tvOriginalPhoneNumber;
+    private final TextView tvArrow;
+    private final TextView tvFormattedPhoneNumber;
+
+    private final CheckBox checkBox;
+
+    public ViewHolder(View view) {
+      super(view);
+      ConstraintLayout clListItem = view.findViewById(R.id.cl_list_item);
+      clListItem.setOnClickListener(v -> toggleChecked());
+
+      tvContactName = view.findViewById(R.id.tv_contact_name);
+      tvOriginalPhoneNumber = view.findViewById(R.id.tv_original_phone_number);
+      tvArrow = view.findViewById(R.id.tv_arrow);
+      tvFormattedPhoneNumber = view.findViewById(R.id.tv_formatted_phone_number);
+      checkBox = view.findViewById(R.id.check_box);
+
+      checkBox.setOnCheckedChangeListener((buttonView, isChecked) -> updateUiToMatchCheckBox());
+    }
+
+    /**
+     * Sets the content of the view to the information of param {@code
+     * phoneNumberInAppRepresentation}.
+     *
+     * @param phoneNumberInAppRepresentation PhoneNumberInApp to set content of the view from
+     */
+    public void setFromPhoneNumberInAppRepresentation(
+        PhoneNumberInApp phoneNumberInAppRepresentation) {
+      this.phoneNumberInAppRepresentation = phoneNumberInAppRepresentation;
+      tvContactName.setText(phoneNumberInAppRepresentation.getContactName());
+      tvOriginalPhoneNumber.setText(phoneNumberInAppRepresentation.getOriginalPhoneNumber());
+      String formattedPhoneNumber = phoneNumberInAppRepresentation.getFormattedPhoneNumber();
+      tvFormattedPhoneNumber.setText(formattedPhoneNumber != null ? formattedPhoneNumber : "");
+      checkBox.setChecked(phoneNumberInAppRepresentation.shouldContactBeUpdated());
+    }
+
+    /** Toggles the checked state of the {@link ViewHolder#checkBox} if it is enabled. */
+    private void toggleChecked() {
+      if (checkBox.isEnabled()) {
+        checkBox.toggle();
+        phoneNumberInAppRepresentation.setShouldContactBeUpdated(checkBox.isChecked());
+      }
+    }
+
+    /**
+     * Update the rest of the UI elements to represent the checked state of {@link
+     * ViewHolder#checkBox} correctly.
+     */
+    private void updateUiToMatchCheckBox() {
+      boolean isChecked = checkBox.isChecked();
+      tvArrow.setEnabled(isChecked);
+      tvFormattedPhoneNumber.setEnabled(isChecked);
+    }
+
+    /**
+     * Sets the enabled state of the {@link ViewHolder#checkBox}.
+     *
+     * @param enabled boolean whether the {@link ViewHolder#checkBox} should be enabled
+     */
+    public void setEnabled(boolean enabled) {
+      checkBox.setEnabled(enabled);
+    }
+
+    public PhoneNumberInApp getPhoneNumberInAppRepresentation() {
+      return phoneNumberInAppRepresentation;
+    }
+  }
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/result/NotFormattableFragment.java

@@ -0,0 +1,119 @@
+package com.google.phonenumbers.demoapp.result;
+
+import android.os.Bundle;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import androidx.fragment.app.Fragment;
+import androidx.recyclerview.widget.LinearLayoutManager;
+import androidx.recyclerview.widget.RecyclerView;
+import com.google.android.material.chip.Chip;
+import com.google.android.material.snackbar.Snackbar;
+import com.google.phonenumbers.demoapp.R;
+import com.google.phonenumbers.demoapp.phonenumbers.PhoneNumberInApp;
+import com.google.phonenumbers.demoapp.phonenumbers.PhoneNumberInApp.FormattingState;
+import java.util.ArrayList;
+import java.util.Arrays;
+
+/**
+ * Used to handle and process interactions from/with the "Not formattable" results section in the
+ * result page UI of the app.
+ */
+public class NotFormattableFragment extends Fragment {
+
+  /** The fragment root view. */
+  private View root;
+  /** The RecyclerView containing the list. */
+  private RecyclerView recyclerView;
+
+  /**
+   * The sorted phone numbers the list contains (some might not be visible in the UI due to the
+   * {@link NotFormattableFragment#appliedFilters}).
+   */
+  private final ArrayList<PhoneNumberInApp> phoneNumbers;
+
+  /** The filters that are currently applied to the list. */
+  private final ArrayList<FormattingState> appliedFilters = new ArrayList<>();
+
+  public NotFormattableFragment(ArrayList<PhoneNumberInApp> phoneNumbers) {
+    this.phoneNumbers = phoneNumbers;
+  }
+
+  @Override
+  public View onCreateView(
+      LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
+    root = inflater.inflate(R.layout.fragment_not_formattable, container, false);
+    recyclerView = root.findViewById(R.id.recycler_view);
+    recyclerView.setLayoutManager(new LinearLayoutManager(root.getContext()));
+
+    Chip chipParsingError = root.findViewById(R.id.chip_parsing_error);
+    connectChipToFormattingState(chipParsingError, FormattingState.PARSING_ERROR);
+    Chip chipShortNumber = root.findViewById(R.id.chip_short_number);
+    connectChipToFormattingState(chipShortNumber, FormattingState.NUMBER_IS_SHORT_NUMBER);
+    Chip chipAlreadyE164 = root.findViewById(R.id.chip_already_e164);
+    connectChipToFormattingState(chipAlreadyE164, FormattingState.NUMBER_IS_ALREADY_IN_E164);
+    Chip chipInvalidNumber = root.findViewById(R.id.chip_invalid_number);
+    connectChipToFormattingState(chipInvalidNumber, FormattingState.NUMBER_IS_NOT_VALID);
+
+    // Add add filters as they are all preselected in the UI
+    appliedFilters.addAll(
+        Arrays.asList(
+            FormattingState.PARSING_ERROR,
+            FormattingState.NUMBER_IS_SHORT_NUMBER,
+            FormattingState.NUMBER_IS_ALREADY_IN_E164,
+            FormattingState.NUMBER_IS_NOT_VALID));
+    // List only needs to be loaded if there are phone numbers.
+    if (!phoneNumbers.isEmpty()) {
+      reloadListWithFilters();
+    }
+    return root;
+  }
+
+  /**
+   * Sets up the param {@code chip} to add/remove the param {@code formattingState} from the {@link
+   * NotFormattableFragment#appliedFilters} list when it is checked/unchecked, and then reloads the
+   * phone number list.
+   *
+   * @param chip Chip of which to handle check/uncheck action
+   * @param formattingState FormattingState the param {@code chip} represents
+   */
+  private void connectChipToFormattingState(Chip chip, FormattingState formattingState) {
+    chip.setOnCheckedChangeListener(
+        (buttonView, isChecked) -> {
+          if (isChecked) {
+            appliedFilters.add(formattingState);
+          } else {
+            appliedFilters.remove(formattingState);
+          }
+          reloadListWithFilters();
+        });
+  }
+
+  /**
+   * Reloads the UI so the list contains the phone numbers matching the currently {@link
+   * NotFormattableFragment#appliedFilters}.
+   */
+  private void reloadListWithFilters() {
+    ArrayList<PhoneNumberInApp> phoneNumbersToShow = new ArrayList<>();
+    for (PhoneNumberInApp phoneNumber : phoneNumbers) {
+      if (appliedFilters.contains(phoneNumber.getFormattingState())) {
+        phoneNumbersToShow.add(phoneNumber);
+      }
+    }
+
+    if (phoneNumbersToShow.isEmpty()) {
+      showNoNumbersMatchFiltersSnackbar();
+    }
+
+    NotFormattableRvAdapter adapter =
+        new NotFormattableRvAdapter(phoneNumbersToShow, root.getContext());
+    recyclerView.setAdapter(adapter);
+  }
+
+  /** Shows a Snackbar informing that no numbers match the selected filters. */
+  private void showNoNumbersMatchFiltersSnackbar() {
+    Snackbar.make(
+            root, R.string.not_formattable_no_numbers_match_filters_text, Snackbar.LENGTH_LONG)
+        .show();
+  }
+}

package/third_party/libphonenumber/java/demoapp/app/src/main/java/com/google/phonenumbers/demoapp/result/NotFormattableRvAdapter.java

@@ -0,0 +1,94 @@
+package com.google.phonenumbers.demoapp.result;
+
+import android.content.Context;
+import android.view.LayoutInflater;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.TextView;
+import androidx.annotation.NonNull;
+import androidx.recyclerview.widget.RecyclerView;
+import com.google.phonenumbers.demoapp.R;
+import com.google.phonenumbers.demoapp.phonenumbers.PhoneNumberInApp;
+import java.util.ArrayList;
+
+/** Adapter for the {@link RecyclerView} used in {@link NotFormattableFragment}. */
+public class NotFormattableRvAdapter
+    extends RecyclerView.Adapter<NotFormattableRvAdapter.ViewHolder> {
+
+  private final LayoutInflater layoutInflater;
+
+  /** List of the original version of {@link PhoneNumberInApp}s at the time of object creation. */
+  private final ArrayList<PhoneNumberInApp> originalPhoneNumbers;
+
+  public NotFormattableRvAdapter(ArrayList<PhoneNumberInApp> phoneNumbers, Context context) {
+    this.originalPhoneNumbers = phoneNumbers;
+    this.layoutInflater = LayoutInflater.from(context);
+  }
+
+  @NonNull
+  @Override
+  public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
+    View view = layoutInflater.inflate(R.layout.not_formattable_list_item, parent, false);
+    return new ViewHolder(view);
+  }
+
+  @Override
+  public void onBindViewHolder(@NonNull ViewHolder viewHolder, int position) {
+    if (position >= 0 && position < getItemCount()) {
+      viewHolder.setFromPhoneNumberInAppRepresentation(originalPhoneNumbers.get(position));
+    }
+  }
+
+  @Override
+  public int getItemCount() {
+    return originalPhoneNumbers.size();
+  }
+
+  /**
+   * {@link RecyclerView.ViewHolder} specifically for a list item of a not formattable phone number.
+   */
+  public static class ViewHolder extends RecyclerView.ViewHolder {
+
+    private final TextView tvContactName;
+    private final TextView tvReason;
+    private final TextView tvOriginalPhoneNumber;
+
+    public ViewHolder(View view) {
+      super(view);
+      tvContactName = view.findViewById(R.id.tv_contact_name);
+      tvReason = view.findViewById(R.id.tv_reason);
+      tvOriginalPhoneNumber = view.findViewById(R.id.tv_original_phone_number);
+    }
+
+    /**
+     * Sets the content of the view to the information of param {@code
+     * phoneNumberInAppRepresentation}.
+     *
+     * @param phoneNumberInAppRepresentation PhoneNumberInApp to set content of the view from
+     */
+    public void setFromPhoneNumberInAppRepresentation(
+        PhoneNumberInApp phoneNumberInAppRepresentation) {
+      tvContactName.setText(phoneNumberInAppRepresentation.getContactName());
+
+      switch (phoneNumberInAppRepresentation.getFormattingState()) {
+        case PARSING_ERROR:
+          tvReason.setText(R.string.not_formattable_parsing_error_text);
+          break;
+        case NUMBER_IS_SHORT_NUMBER:
+          tvReason.setText(R.string.not_formattable_short_number_text);
+          break;
+        case NUMBER_IS_ALREADY_IN_E164:
+          tvReason.setText(R.string.not_formattable_already_e164_text);
+          break;
+        case NUMBER_IS_NOT_VALID:
+          tvReason.setText(R.string.not_formattable_invalid_number_text);
+          break;
+        default:
+          tvReason.setText(R.string.not_formattable_unknown_error_text);
+          break;
+      }
+
+      tvOriginalPhoneNumber.setText(phoneNumberInAppRepresentation.getOriginalPhoneNumber());
+    }
+  }
+}