{"id":22824388,"url":"https://github.com/opt-nc/phonenumber-validator","last_synced_at":"2025-08-10T13:32:43.347Z","repository":{"id":42157947,"uuid":"510137728","full_name":"opt-nc/phonenumber-validator","owner":"opt-nc","description":"SDK java permettant de valider et qualifier un numéro de téléphone calédonien.","archived":false,"fork":false,"pushed_at":"2023-06-12T03:19:39.000Z","size":122,"stargazers_count":2,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-06-12T04:24:44.997Z","etag":null,"topics":["java","mobile-phone","new-caledonia","nouvelle-caledonie","oeuvrerpourtous","phone-number","phonenumber-validator","sdk","sdk-java"],"latest_commit_sha":null,"homepage":"https://dev.to/adriens/series/19561","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opt-nc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-03T21:19:33.000Z","updated_at":"2023-06-12T04:24:44.998Z","dependencies_parsed_at":"2022-08-12T08:20:20.231Z","dependency_job_id":null,"html_url":"https://github.com/opt-nc/phonenumber-validator","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opt-nc%2Fphonenumber-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opt-nc%2Fphonenumber-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opt-nc%2Fphonenumber-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opt-nc%2Fphonenumber-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opt-nc","download_url":"https://codeload.github.com/opt-nc/phonenumber-validator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229421558,"owners_count":18070351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","mobile-phone","new-caledonia","nouvelle-caledonie","oeuvrerpourtous","phone-number","phonenumber-validator","sdk","sdk-java"],"created_at":"2024-12-12T17:06:30.943Z","updated_at":"2024-12-12T17:06:36.000Z","avatar_url":"https://github.com/opt-nc.png","language":"Java","readme":"[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![🪶 Java CI with Maven](https://github.com/opt-nc/phonenumber-validator/actions/workflows/maven-build.yml/badge.svg?branch=main)](https://github.com/opt-nc/phonenumber-validator/actions/workflows/maven-build.yml)\n[![](https://jitpack.io/v/opt-nc/phonenumber-validator.svg)](https://jitpack.io/#opt-nc/phonenumber-validator)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\n⚠️ Repository archivé : le sdk a été intégré à [api-phonenumber-validator](https://github.com/opt-nc/api-phonenumber-validator)\n\n# ❔ phonenumber-validator\n\nSDK Java permettant de valider, qualifier un numéro de téléphone calédonien.\n\n# 👶 Découvrir\n\nPour mieux comprendre comment est né ce projet, ce qu'il permet et les réalisations qu'il permet,\nallez sur la [série dédiée PhoneNumber Validator sur DEV.to](https://dev.to/adriens/series/19561).\n\n## ⬇️ Import de la dépendance publique\n\nCette dépendance est disponible publiquement via [Jitpack](https://jitpack.io/#opt-nc/phonenumber-validator).\n\n### 🪶 Maven\n\nAjouter la repo [Jitpack](https://jitpack.io/) :\n\n```xml\n\u003crepositories\u003e\n  \u003crepository\u003e\n    \u003cid\u003ejitpack.io\u003c/id\u003e\n    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n```\n\nPuis la dépendance :\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.opt-nc\u003c/groupId\u003e\n  \u003cartifactId\u003ephonenumber-validator\u003c/artifactId\u003e\n  \u003cversion\u003eTag\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### 🐘 Gradle\n\nAjouter la repo :\n\n```\nallprojects {\n  repositories {\n    maven { url 'https://jitpack.io' }\n  }\n}\n````\n\nPuis la dépendance :\n\n```\ndependencies {\n  implementation 'com.github.opt-nc:phonenumber-validator:Tag'\n}\n```\n\n\n## ✍️ Exemples de code\n\nPlusieurs exemples sont disponibles dans la classe [Main](https://github.com/opt-nc/phonenumber-validator/blob/main/src/main/java/nc/opt/telecom/sdk/phonenumber/validator/Main.java) du projet.\nPour lancer l'exemple:\n```shell\nmvn compile exec:java\n```\n\n\nLa classe utilitaire `PhoneNumberValidator` ne prend en entrée que des chaines de caractères respectant la norme `E.164`, i.e de la forme \"+687123456\".\n\nLa méthode `format`, permet de convertir un numéro de téléphone sur 6 digits dans la norme `E.164`.\n\n#### Connaitre le type de numéro de téléphone\n\n```java\nSystem.out.println(\"Type de numéro : \" + PhoneNumberValidator.getPhoneType(\"+687514243\").name());\nSystem.out.println(\"Mobile ? : \" + (PhoneNumberValidator.isMobile(\"+687514243\") ? \"oui\" : \"non\"));\nSystem.out.println(\"Fixe ? : \" + (PhoneNumberValidator.isFixe(\"+687514243\") ? \"oui\" : \"non\"));\nSystem.out.println(\"Special ? : \" + (PhoneNumberValidator.isSpecial(\"+687514243\") ? \"oui\" : \"non\"));\n```\n\n```shell\nType de numéro : Mobile\nMobile ? : oui\nFixe ? : non\nSpecial ? : non\n```\n\n\n#### Formater un numéro de téléphone en respectant la norme E.164\n\n```java\nString mobilePhoneNumber = PhoneNumberValidator.format(\"514243\");\nSystem.out.println(\"Numéro de téléphone formaté : \" + mobilePhoneNumber);\n```\n```shell\nNuméro de téléphone formaté : +687514243\n```\n\n## 🧰 Script J'Bang!\n\nUn script Java est disponible dans le [catalogue J'Bang de l'OPT-NC](https://github.com/opt-nc/jbang-catalog).\nCe script permet d'utiliser le sdk sous forme de `CLI` [Picocli](https://picocli.info/).\n\n### 👉 Pré-requis\n\n- Installer J'Bang : \n  - [Tuto complet sur Killercoda](https://killercoda.com/opt-labs/course/jbang)\n\n### 🕹️ Commandes\n\n#### check\n\nLe numéro est-il un numéro de mobile ?\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -c is-mobile +687832583\n```\n\nLe numéro est-il un numéro de fixe\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -c is-fixe +687832583\n```\n\nLe numéro est-il un numéro spécial (urgences, services OPT-NC, SOS)\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -c is-special +68715\n```\n\nLe numéro est-il un numéro de téléphone possible/valide\n\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -c is-valid +687832583\n```\n\nAvoir les infos du numéro de téléphone\n\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -c info +687832583\n```\n\n### format\n\nFormate le numéro de téléphone non formaté en numéro formaté en suivant la norme E.164\n```shell\njbang  phonenumber-validator@opt-nc/jbang-catalog -f 83-25-83\n```\n\n\n:warning: Ne pas oublier de refraîchir regulièrement le cache J'Bang!\n\n```shell\njbang cache clear\n```\n\n\n## 🙏 Remerciements\n\nCe projet a débuté suite à une [idée](https://github.com/orgs/opt-nc/discussions/13) lancée par [@MarketingCollectif ](https://github.com/MarketingCollectif) sur le [forum de discussion de opt-nc](https://github.com/orgs/opt-nc/discussions).\n\n![image](https://user-images.githubusercontent.com/1823161/187096202-602060e3-2778-44a2-a487-b9b75e55ef3f.png)\n\nMerci à [@MarketingCollectif ](https://github.com/MarketingCollectif) de nous avoir soumis sa demande, qui nous l'espérons, profitera àu plus grand nombre.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopt-nc%2Fphonenumber-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopt-nc%2Fphonenumber-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopt-nc%2Fphonenumber-validator/lists"}