updated

sumithemmadi · Apr 20, 2022 · 3a9abbe · 3a9abbe
commit 3a9abbe
Show file tree

Hide file tree

Showing 14 changed files with 1,294 additions and 0 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,11 @@
+truecallerpy-venv
+
+truecallerpy/__pycache__
+
+build
+
+dist
+
+truecallerpy.egg-info
+
+./bott.json
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Emmadi Sumith Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -0,0 +1,28 @@
+# ==================================================================================
+# MIT License
+
+# Copyright (c) 2022 Emmadi Sumith Kumar
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#====================================================================================
+
+
+include README.md
+include setup.cfg
+include LICENSE
diff --git a/Makefile b/Makefile
@@ -0,0 +1,39 @@
+# ==================================================================================
+# MIT License
+
+# Copyright (c) 2022 Emmadi Sumith Kumar
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#====================================================================================
+
+venv:
+	pip install virtualenv
+	virtualenv truecallerpy-venv
+	@ echo "source truecallerpy-venv/bin/activate"
+
+install:
+	pip install -r requirements.txt              
+
+build:
+	python3 -m pip install --upgrade build
+	python3 -m build
+	pip install twine
+
+.PHONY: install build venv
+
diff --git a/README.md b/README.md
@@ -0,0 +1,206 @@
+<h1 id="truecallerpy">
+    <a href="https://github.com/sumithemmadi/truecallerpy">Truecallerpy</a>
+</h1>
+
+[![PyPI - Implementation](https://img.shields.io/pypi/v/truecallerpy?style=flat-square)](https://pypi.org/project/truecallerpy)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/truecallerpy?style=flat-square)](https://pypi.org/project/truecallerpy)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/truecallerpy?style=flat-square)](https://pypistats.org/packages/truecallerpy)
+[![PyPI - License](https://img.shields.io/pypi/l/truecallerpy?style=flat-square)](https://github.com/sumithemmadi/truecallerpy/edit/main/LICENSE.md)
+
+
+<p>A  package to search phone number details.</p>
+
+
+# Requirements
+
+* Valid Mobile Number(Phone number verification for truecaller)
+* [Truecaller InstallationId](https://github.com/sumithemmadi/truecallerpy#InstallationId)
+
+## [Command Line Usage](https://github.com/sumithemmadi/truecallerpy)
+
+### Installation
+
+Install this pip package
+
+```bash
+pip install truecallerpy
+```
+
+### Login
+
+Then  login to your truecaller account .
+
+```bash
+~$ truecallerpy --login
+```
+
+> If you get any error try running '**sudo truecallerpy --login**'. If you are using Windows try the command with **Adminitrative Privilege**.
+
+> If you still facing problems in login then try below steps.
+
+   1. On Truecaller Android, tap on the 3 line menu on top left
+   2. Tap on `Privacy Center` and then click on `Download my data`.
+   3. Now a json file is downloaded. 
+   4. Save the json file on your PC at any location e.g /home/HP/1234567890-99123456789.json
+   5. On you terminal or command prompt enter below command.
+   ```
+   ~$ truecallerpy --login -f /home/HP/1234567890-99123456789.json
+   ```
+   6. Now you are successfully logged in.
+
+
+### InstallationId
+
+Enter the below command to see your **InstallationId**.
+
+```bash
+~$ truecallerpy --installationid
+```
+
+Print only installation Id.
+
+```bash
+~$ truecallerpy -i -r
+```
+
+### Searching a number
+
+```bash
+~$ truecallerpy -s [number]
+```
+
+```yaml
+{
+   "data": [
+      {
+         "id": "jsiebejebbeebhee/dnss00w==",
+         "name": "Sumith Emmadi",
+         "imId": "1g7rm006b356o",
+         "gender": "UNKNOWN",
+         "image": "https://storage.googleapis.com/tc-images-noneu/myview/1/jdvdidbdhvdjdvddbkdbeiebeieb",
+         "score": 0.9,
+         "access": "PUBLIC",
+         "enhanced": true,
+         "phones": [
+            {
+               "e164Format": "+000000000000",
+               "numberType": "MOBILE",
+               "nationalFormat": "+000000000000",
+               "dialingCode": 91,
+               "countryCode": "IN",
+               "carrier": "Airtel",
+               "type": "openPhone"
+            }
+         ],
+         "addresses": [
+            {
+               "city": "Andhra Pradesh",
+               "countryCode": "IN",
+               "timeZone": "+05:30",
+               "type": "address"
+            }
+         ],
+         "internetAddresses": [
+            {
+               "id": "[email protected]",
+               "service": "email",
+               "caption": "Sumith Emmadi",
+               "type": "internetAddress"
+            }
+         ],
+         "badges": [
+            "verified",
+            "user"
+         ],
+         "cacheTtl": "",
+         "sources": [],
+         "searchWarnings": [],
+         "surveys": []
+      }
+   ],
+   "provider": "ss-nu",
+   "stats": {
+      "sourceStats": []
+   }
+}
+```
+
+To get raw output.
+
+```bash
+~$ truecallerpy -s [number] -r
+{"data":[{"id":"jsiebejebbeebhee/dnss00w==","name":"Sumith Emmadi","imId":"1g7rm006b356o","gender":"UNKNOWN","image":"https://storage.googleapis.com/tc-images-noneu/myview/1/jdvdidbdhvdjdvddbkdbeiebeieb","score":0.9,"access":"PUBLIC","enhanced":true,
+"phones":[{"e164Format":"+000000000000","numberType":"MOBILE","nationalFormat":"+000000000000","dialingCode":91,"countryCode":"IN","carrier":"Airtel","type":"openPhone"}],"addresses":[{"city":"Andhra Pradesh","countryCode":"IN","timeZone":"+05:30","type":"address"}],
+"internetAddresses":[{"id":"[email protected]","service":"email","caption":"Sumith Emmadi","type":"internetAddress"}],"badges":["verified","user"],"cacheTtl":"","sources":[],"searchWarnings":[],"surveys":[]}],"provider":"ss-nu","stats":{"sourceStats":[]}}
+```
+
+To print only name.
+
+```bash
+~$ truecallerpy -s [number] --name
+Name : Sumith Emmadi
+```
+
+Other command's
+
+```bash
+~$ truecallerpy -s [number] -r --name
+
+Sumith Emmadi
+```
+
+#### To get only JSON output
+
+```bash
+~$ truecallerpy -s [number] --json
+```
+```bash
+~$ truecallerpy -s [number] -r --json
+{"data":[{"id":"jsiebejebbeebhee/dnss00w==","name":"Sumith Emmadi","imId":"1g7rm006b356o","gender":"UNKNOWN","image":"https://storage.googleapis.com/tc-images-noneu/myview/1/jdvdidbdhvdjdvddbkdbeiebeieb","score":0.9,"access":"PUBLIC","enhanced":true,
+"phones":[{"e164Format":"+000000000000","numberType":"MOBILE","nationalFormat":"+000000000000","dialingCode":91,"countryCode":"IN","carrier":"Airtel","type":"openPhone"}],"addresses":[{"city":"Andhra Pradesh","countryCode":"IN","timeZone":"+05:30","type":"address"}],
+"internetAddresses":[{"id":"[email protected]","service":"email","caption":"Sumith Emmadi","type":"internetAddress"}],"badges":["verified","user"],"cacheTtl":"","sources":[],"searchWarnings":[],"surveys":[]}],"provider":"ss-nu","stats":{"sourceStats":[]}}
+```
+
+
+## Usage 
+```python
+from truecallerpy import search_phonenumber
+
+id = "Your installationId at here"
+# To know your installation id run `truecallerpy -i` on terminal or command prompt
+
+# search_phonenumber( "PHONE_NUMBER","COUNTRY_CODE","INSTALLATION_ID")
+
+search_phonenumber("9912345678","IN", id)
+
+# ==> search_phonenumber("+12093031250","IN", id)
+
+```
+
+* **PHONE_NUMBER** : Number you want to search.
+* **COUNTRY_CODE** : Country code you want to use by default . If mobile number is not in **E164**(International Format) Format then **COUNTRY_CODE** will be considered as a country code of that Mobile Number.
+* **INSTALLATION_ID** : To know your InstallationId , install the package globally.
+
+## License
+
+MIT License
+
+Copyright (c) 2022 Emmadi Sumith Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/bin/truecallerpy b/bin/truecallerpy
@@ -0,0 +1,30 @@
+#!/usr/bin/python
+
+# ==================================================================================
+# MIT License
+
+# Copyright (c) 2022 Emmadi Sumith Kumar
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#====================================================================================
+
+import truecallerpy 
+
+if __name__ == '__main__':
+    truecallerPy.ExecuteTrurcallerPy()
diff --git a/pyproject.toml b/pyproject.toml
@@ -0,0 +1,27 @@
+# ==================================================================================
+# MIT License
+
+# Copyright (c) 2022 Emmadi Sumith Kumar
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#====================================================================================
+
+[build-system]
+requires = ["setuptools>=42","wheel"]
+build-backend = "setuptools.build_meta"