apksearch 1.0.0__tar.gz

apksearch-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Abhi
+
+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.

apksearch-1.0.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.1
+Name: apksearch
+Version: 1.0.0
+Summary: Search for apks on varius websites
+Author-email: Abhi <allinoneallinone00@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 Abhi
+        
+        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.
+        
+Project-URL: homepage, https://github.com/AbhiTheModder/apksearch.git
+Project-URL: source, https://github.com/AbhiTheModder/apksearch.git
+Project-URL: issues, https://github.com/AbhiTheModder/apksearch.git/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Natural Language :: English
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: General
+Classifier: Topic :: Utilities
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: requests>=2.32.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: black>=23.12.1; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+
+# apksearch
+
+`apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
+
+**The Inspiration:**
+There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+
+# Features
+
+- **Search APKs:** The library provides methods to search for APKs using package names.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
+
+## Installation
+
+To install the `apksearch` library, use the following command:
+
+```sh
+pip install git+https://github.com/AbhiTheModder/apksearch.git
+```
+
+OR, through pip:
+
+```sh
+pip install apksearch
+```
+
+## Usage
+
+### Command-Line Interface
+
+To use the CLI, run the following command:
+
+```sh
+apksearch <package_name> [--version <version>]
+```
+
+Example:
+
+```sh
+apksearch com.roblox.client --version 2.652.765
+```
+
+### Library Usage
+
+You can also use the library programmatically in your Python code:
+
+```python
+from apksearch import APKPure, APKMirror
+
+# Searching on APKPure
+apkpure = APKPure("com.roblox.client")
+result = apkpure.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKPure: {title} - {link}")
+
+# Searching on APKMirror
+apkmirror = APKMirror("com.roblox.client")
+result = apkmirror.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKMirror: {title} - {link}")
+```
+
+### Classes and Methods
+
+#### `APKPure`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
+
+#### `APKMirror`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
+
+### Testing
+
+The project includes tests for the `sites` classes. To run the tests, use the following command:
+
+```sh
+pytest
+```
+
+## TODO
+
+- [ ] Add more websites to search for APKs.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/AbhiTheModder/apksearch).

apksearch-1.0.0/README.md

@@ -0,0 +1,98 @@
+# apksearch
+
+`apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
+
+**The Inspiration:**
+There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+
+# Features
+
+- **Search APKs:** The library provides methods to search for APKs using package names.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
+
+## Installation
+
+To install the `apksearch` library, use the following command:
+
+```sh
+pip install git+https://github.com/AbhiTheModder/apksearch.git
+```
+
+OR, through pip:
+
+```sh
+pip install apksearch
+```
+
+## Usage
+
+### Command-Line Interface
+
+To use the CLI, run the following command:
+
+```sh
+apksearch <package_name> [--version <version>]
+```
+
+Example:
+
+```sh
+apksearch com.roblox.client --version 2.652.765
+```
+
+### Library Usage
+
+You can also use the library programmatically in your Python code:
+
+```python
+from apksearch import APKPure, APKMirror
+
+# Searching on APKPure
+apkpure = APKPure("com.roblox.client")
+result = apkpure.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKPure: {title} - {link}")
+
+# Searching on APKMirror
+apkmirror = APKMirror("com.roblox.client")
+result = apkmirror.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKMirror: {title} - {link}")
+```
+
+### Classes and Methods
+
+#### `APKPure`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
+
+#### `APKMirror`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
+
+### Testing
+
+The project includes tests for the `sites` classes. To run the tests, use the following command:
+
+```sh
+pytest
+```
+
+## TODO
+
+- [ ] Add more websites to search for APKs.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/AbhiTheModder/apksearch).

apksearch-1.0.0/apksearch/__init__.py

@@ -0,0 +1,4 @@
+from .sites.apkpure import APKPure
+from .sites.apkmirror import APKMirror
+
+__all__ = ["APKPure", "APKMirror"]

apksearch-1.0.0/apksearch/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

apksearch-1.0.0/apksearch/cli.py

@@ -0,0 +1,79 @@
+import argparse
+
+from apksearch import APKPure, APKMirror
+from requests.exceptions import ConnectionError, ConnectTimeout
+
+# Color codes
+BOLD = "\033[1m"
+RED = "\033[91m"
+GREEN = "\033[92m"
+YELLOW = "\033[93m"
+NC = "\033[0m"
+
+
+def search_apkpure(pkg_name: str, version: str | None) -> None:
+    apkpure = APKPure(pkg_name)
+    try:
+        result_apkpure: tuple[str, str] | None = apkpure.search_apk()
+    except (ConnectionError, ConnectTimeout):
+        result_apkpure = None
+        print(f"{RED}Failed to resolve 'apkpure.net'!{NC}")
+    if result_apkpure:
+        title, apk_link = result_apkpure
+        print(f"{BOLD}APKPure:{NC} Found {GREEN}{title}{NC}") if title else None
+        print(f"      ╰─> {BOLD}Link: {YELLOW}{apk_link}{NC}") if not version else None
+        versions: list[tuple[str, str]] = apkpure.find_versions(apk_link)
+        if version:
+            for version_tuple in versions:
+                if version_tuple[0] == version:
+                    print(
+                        f"      ╰─> {BOLD}Version: {GREEN}{version}{NC} - {YELLOW}{version_tuple[1]}{NC}"
+                    )
+                    break
+            else:
+                print(f"{BOLD}APKPure:{NC} Version {RED}{version}{NC} not found!")
+    else:
+        print(f"{BOLD}APKPure:{NC} No Results!")
+
+
+def search_apkmirror(pkg_name: str, version: str | None) -> None:
+    apkmirror = APKMirror(pkg_name)
+    try:
+        result_apkpure: tuple[str, str] | None = apkmirror.search_apk()
+    except (ConnectionError, ConnectTimeout):
+        result_apkpure = None
+        print(f"{RED}Failed to resolve 'apkmirror.com'!{NC}")
+    if result_apkpure:
+        title, apk_link = result_apkpure
+        print(f"{BOLD}APKMirror:{NC} Found {GREEN}{title}{NC}") if title else None
+        print(f"      ╰─> {BOLD}Link: {YELLOW}{apk_link}{NC}") if not version else None
+        if version:
+            download_link = apkmirror.find_version(apk_link, version)
+            if download_link:
+                print(
+                    f"      ╰─> {BOLD}Version: {GREEN}{version}{NC} - {YELLOW}{download_link}{NC}"
+                )
+            else:
+                print(f"{BOLD}APKMirror:{NC} Version {RED}{version}{NC} not found!")
+    else:
+        print(f"{BOLD}APKMirror:{NC} No Results!")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="APKSearch", description="Search for APKs on various websites"
+    )
+    parser.add_argument("pkg_name", help="The package name of the APK")
+    parser.add_argument("--version", help="The version of the APK", required=False)
+    args = parser.parse_args()
+
+    pkg_name = args.pkg_name
+    version = args.version
+    print(f"{BOLD}Searching for {YELLOW}{pkg_name}{NC}...")
+    # Initiate search on apkpure
+    search_apkpure(pkg_name, version)
+    # Initiate search on apkmirror
+    search_apkmirror(pkg_name, version)
+
+if __name__ == "__main__":
+    main()

apksearch-1.0.0/apksearch/sites/apkmirror.py

@@ -0,0 +1,79 @@
+import requests
+
+
+class APKMirror:
+    """
+    This class provides methods to search for an APK on APKMirror based on package name,
+    and to find available versions and their download links for a given APK link.
+
+    Parameters:
+        pkg_name (str): The package name of the APK to search for.
+
+    Attributes:
+        pkg_name (str): The package name of the APK to search for.
+        base_url (str): The base URL of the APKMirror website.
+        search_url (str): The URL used to search for APKs on APKMirror.
+        headers (dict): The headers used for making HTTP requests.
+        session (requests.Session): The session object used for making HTTP requests.
+
+    Methods:
+        search_apk() -> None | tuple[str, str]:
+            Searches for the APK on APKMirror and returns the title and link if found.
+
+        find_versions(apk_link: str) -> list[tuple[str, str]]:
+            Finds and returns a list of versions and their download links for the given APK link.
+    """
+
+    def __init__(self, pkg_name: str):
+        self.pkg_name = pkg_name
+        self.base_url = "https://www.apkmirror.com"
+        self.api_url = self.base_url + "/wp-json/apkm/v1"
+        # https://github.com/rumboalla/apkupdater/blob/3.x/app/src/main/kotlin/com/apkupdater/service/ApkMirrorService.kt
+        self.headers = {
+            "User-Agent": "APKUpdater-v3.0.3",
+            "Authorization": "Basic YXBpLWFwa3VwZGF0ZXI6cm01cmNmcnVVakt5MDRzTXB5TVBKWFc4",
+            "Content-Type": "application/json",
+        }
+        self.session = requests.Session()
+
+    def search_apk(self) -> None | tuple[str, str]:
+        """
+        Searches for the APK on APKMirror and returns the title and link if found.
+
+        Returns:
+            None: If no matching APK is found.
+            tuple[str, str]: A tuple containing the title and link of the matching APK if found.
+        """
+        pkg_name = self.pkg_name
+        url = self.api_url + "/app_exists"
+        json = {"pnames": pkg_name}
+        response: requests.Response = self.session.post(
+            url, json=json, headers=self.headers
+        )
+        result = response.json()["data"][0]
+        if result and result["exists"]:
+            pname = result["pname"]
+            if pname == pkg_name:
+                title = result["app"]["name"]
+                apk_link = self.base_url + result["app"]["link"]
+                return title, apk_link
+        return None
+
+    def find_version(self, apk_link: str, version: str) -> str:
+        """
+        Finds and returns the download link for the given APK link and version.
+
+        Parameters:
+            apk_link (str): The link to the APK on the APKMirror website.
+            version (str): The version number of the APK to find.
+
+        Returns:
+            str: The download link for the specified version of the APK.
+        """
+        name = apk_link.split("/")[-2]
+        version = version.replace(".", "-")
+        url = apk_link + name + "-" + version + "-release"
+        response = self.session.get(url, headers=self.headers)
+        if response.status_code == 404:
+            return None
+        return url

apksearch-1.0.0/apksearch/sites/apkpure.py

@@ -0,0 +1,108 @@
+import re
+from bs4 import BeautifulSoup
+import requests
+
+
+class APKPure:
+    """
+    This class provides methods to search for an APK on APKPure based on package name,
+    and to find available versions and their download links for a given APK link.
+
+    Parameters:
+        pkg_name (str): The package name of the APK to search for.
+
+    Attributes:
+        pkg_name (str): The package name of the APK to search for.
+        base_url (str): The base URL of the APKPure website.
+        search_url (str): The URL used to search for APKs on APKPure.
+        headers (dict): The headers used for making HTTP requests.
+        session (requests.Session): The session object used for making HTTP requests.
+
+    Methods:
+        search_apk() -> None | tuple[str, str]:
+            Searches for the APK on APKPure and returns the title and link if found.
+
+        find_versions(apk_link: str) -> list[tuple[str, str]]:
+            Finds and returns a list of versions and their download links for the given APK link.
+    """
+
+    def __init__(self, pkg_name: str):
+        self.pkg_name = pkg_name
+        self.base_url = "https://apkpure.net"
+        self.search_url = self.base_url + "/search?q="
+        self.headers = {
+            "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+            "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "cache-control": "no-cache",
+            "dnt": "1",
+            "pragma": "no-cache",
+            "priority": "u=0, i",
+            "referer": "https://apkpure.net/",
+            "sec-ch-ua": '"Microsoft Edge";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
+            "sec-ch-ua-mobile": "?0",
+            "sec-ch-ua-platform": '"Windows"',
+            "sec-fetch-dest": "document",
+            "sec-fetch-mode": "navigate",
+            "sec-fetch-site": "same-origin",
+            "sec-fetch-user": "?1",
+            "upgrade-insecure-requests": "1",
+            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Edg/131.0.0.0",
+        }
+        self.session = requests.Session()
+
+    def search_apk(self) -> None | tuple[str, str]:
+        """
+        Searches for the APK on APKPure and returns the title and link if found.
+
+        Returns:
+            None: If no matching APK is found.
+            tuple[str, str]: A tuple containing the title and link of the matching APK if found.
+        """
+        pkg_name = self.pkg_name
+        url = self.search_url + pkg_name
+        response: requests.Response = self.session.get(url, headers=self.headers)
+        soup = BeautifulSoup(response.text, "html.parser")
+        search_results = soup.find("div", {"class": "apk-list"})
+        if search_results:
+            apk_items = search_results.find_all("a", {"class": "apk-item"})
+            if apk_items:
+                for apk_item in apk_items:
+                    apk_link = self.base_url + apk_item["href"]
+                    apk_title = apk_item["title"]
+                    apk_package_name = apk_item["data-dt-pkg"]
+                    if apk_package_name == pkg_name:
+                        return apk_title, apk_link
+        return None
+
+    def find_versions(self, apk_link: str) -> list[tuple[str, str]]:
+        """
+        Finds and returns a list of versions and their download links for the given APK link.
+
+        Parameters:
+            apk_link (str): The link to the APK on the APKPure website.
+
+        Returns:
+            list[tuple[str, str]]: A list of tuples, where each tuple contains the version number
+            and its corresponding download link. If no versions are found, an empty list is returned.
+        """
+        url = apk_link + "/versions"
+        response: requests.Response = self.session.get(url, headers=self.headers)
+        soup = BeautifulSoup(response.text, "html.parser")
+        versions_list = soup.find("ul", {"class": "version-list"})
+        versions_info = []
+
+        if versions_list:
+            versions = versions_list.find_all(
+                "li", {"class": re.compile("^version dt-version-item.*")}
+            )
+            for version in versions:
+                version_icon = version.find("a", {"class": "dt-version-icon"})
+                version_info = version.find("div", {"class": "version-info"})
+                if version_icon and version_info:
+                    version_number = version_info.find(
+                        "span", {"class": "name one-line"}
+                    ).text
+                    download_url = self.base_url + version_icon["href"]
+                    versions_info.append((version_number, download_url))
+
+        return versions_info

apksearch-1.0.0/apksearch.egg-info/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.1
+Name: apksearch
+Version: 1.0.0
+Summary: Search for apks on varius websites
+Author-email: Abhi <allinoneallinone00@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 Abhi
+        
+        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.
+        
+Project-URL: homepage, https://github.com/AbhiTheModder/apksearch.git
+Project-URL: source, https://github.com/AbhiTheModder/apksearch.git
+Project-URL: issues, https://github.com/AbhiTheModder/apksearch.git/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Natural Language :: English
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: General
+Classifier: Topic :: Utilities
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: requests>=2.32.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.3; extra == "dev"
+Requires-Dist: black>=23.12.1; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+
+# apksearch
+
+`apksearch` is a Python library designed to search for APK files on different APK websites, such as APKPure and APKMirror. It allows users to find APKs, check for available versions, and retrieve download links.
+
+**The Inspiration:**
+There were countless occasions when I needed a specific APK for a package name, only to find it unavailable on popular platforms. This led to the tedious task of manually visiting multiple websites and searching one by one.
+
+# Features
+
+- **Search APKs:** The library provides methods to search for APKs using package names.
+- **Retrieve APK Versions and Download Links:** It can fetch available versions and their download links for a given APK from APKPure and APKMirror.
+- **Command-Line Interface:** A CLI is available for users to search for APKs directly from the command line.
+
+## Installation
+
+To install the `apksearch` library, use the following command:
+
+```sh
+pip install git+https://github.com/AbhiTheModder/apksearch.git
+```
+
+OR, through pip:
+
+```sh
+pip install apksearch
+```
+
+## Usage
+
+### Command-Line Interface
+
+To use the CLI, run the following command:
+
+```sh
+apksearch <package_name> [--version <version>]
+```
+
+Example:
+
+```sh
+apksearch com.roblox.client --version 2.652.765
+```
+
+### Library Usage
+
+You can also use the library programmatically in your Python code:
+
+```python
+from apksearch import APKPure, APKMirror
+
+# Searching on APKPure
+apkpure = APKPure("com.roblox.client")
+result = apkpure.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKPure: {title} - {link}")
+
+# Searching on APKMirror
+apkmirror = APKMirror("com.roblox.client")
+result = apkmirror.search_apk()
+if result:
+    title, link = result
+    print(f"Found on APKMirror: {title} - {link}")
+```
+
+### Classes and Methods
+
+#### `APKPure`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKPure and returns the title and link if found.
+- **`find_versions(self, apk_link: str) -> list[tuple[str, str]]`**: Finds and returns a list of versions and their download links for the given APK link.
+
+#### `APKMirror`
+
+- **`__init__(self, pkg_name: str)`**: Initializes with the package name.
+- **`search_apk(self) -> None | tuple[str, str]`**: Searches for the APK on APKMirror and returns the title and link if found.
+- **`find_version(self, apk_link: str, version: str) -> str`**: Finds and returns the download link for the given APK link and version.
+
+### Testing
+
+The project includes tests for the `sites` classes. To run the tests, use the following command:
+
+```sh
+pytest
+```
+
+## TODO
+
+- [ ] Add more websites to search for APKs.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](https://github.com/AbhiTheModder/apksearch/blob/main/LICENSE) file for more details.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/AbhiTheModder/apksearch).

apksearch-1.0.0/apksearch.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+apksearch/__init__.py
+apksearch/__main__.py
+apksearch/cli.py
+apksearch.egg-info/PKG-INFO
+apksearch.egg-info/SOURCES.txt
+apksearch.egg-info/dependency_links.txt
+apksearch.egg-info/entry_points.txt
+apksearch.egg-info/requires.txt
+apksearch.egg-info/top_level.txt
+apksearch/sites/__init__.py
+apksearch/sites/apkmirror.py
+apksearch/sites/apkpure.py
+tests/test_apkmirror.py
+tests/test_apkpure.py

apksearch-1.0.0/apksearch.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

apksearch-1.0.0/apksearch.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+apksearch = apksearch.cli:main

apksearch-1.0.0/apksearch.egg-info/requires.txt

@@ -0,0 +1,7 @@
+beautifulsoup4>=4.12.3
+requests>=2.32.3
+
+[dev]
+pytest>=7.4.3
+black>=23.12.1
+flake8>=6.1.0

apksearch-1.0.0/apksearch.egg-info/top_level.txt

@@ -0,0 +1 @@
+apksearch

apksearch-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "apksearch"
+version = "1.0.0"
+description = "Search for apks on varius websites"
+authors = [{ name = "Abhi", email = "allinoneallinone00@gmail.com" }]
+license = { file = "LICENSE" }
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["beautifulsoup4>=4.12.3", "requests>=2.32.3"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Natural Language :: English",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: General",
+    "Topic :: Utilities",
+    "Operating System :: OS Independent",
+]
+
+
+[project.urls]
+homepage = "https://github.com/AbhiTheModder/apksearch.git"
+source = "https://github.com/AbhiTheModder/apksearch.git"
+issues = "https://github.com/AbhiTheModder/apksearch.git/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=7.4.3", "black>=23.12.1", "flake8>=6.1.0"]
+
+[tool.pytest.ini_options]
+minversion = "7.4.3"
+testpaths = ["tests"]
+
+[project.scripts]
+apksearch = "apksearch.cli:main"
+
+[tool.setuptools]
+packages = ["apksearch", "apksearch.sites"]

apksearch-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

apksearch-1.0.0/tests/test_apkmirror.py

@@ -0,0 +1,45 @@
+from apksearch import APKMirror
+
+
+def test_search_apk():
+    query = "com.roblox.client"
+    apkmirror = APKMirror(query)
+    result = apkmirror.search_apk()
+
+    assert result is not None, "No APK found for the query."
+    assert isinstance(result, tuple), "Result should be a tuple."
+    assert len(result) == 2, "Tuple should contain two elements."
+    assert isinstance(result[0], str), "First element of the tuple should be a string."
+    assert isinstance(result[1], str), "Second element of the tuple should be a string."
+
+
+def test_find_versions_nfound():
+    query = "com.roblox.client"
+    version = "1.2.3"
+    apkmirror = APKMirror(query)
+    result = apkmirror.search_apk()
+
+    if result:
+        apk_link = result[1]
+
+        assert apk_link.startswith("https://"), "APK link should be a valid URL."
+
+        download_link = apkmirror.find_version(apk_link, version)
+
+        assert download_link is None, "Version not found."
+
+
+def test_find_versions_found():
+    query = "com.roblox.client"
+    version = "2.652.765"
+    apkmirror = APKMirror(query)
+    result = apkmirror.search_apk()
+
+    if result:
+        apk_link = result[1]
+        download_link = apkmirror.find_version(apk_link, version)
+
+        assert isinstance(download_link, str), "Download link should be a string."
+        assert download_link.startswith(
+            "https://"
+        ), "Download link should be a valid URL."

apksearch-1.0.0/tests/test_apkpure.py

@@ -0,0 +1,38 @@
+from apksearch.sites.apkpure import APKPure
+
+
+def test_search_apk():
+    query = "com.roblox.client"
+    apkpure = APKPure(query)
+    result = apkpure.search_apk()
+
+    assert result is not None, "No APK found for the query."
+    assert isinstance(result, tuple), "Result should be a tuple."
+    assert len(result) == 2, "Tuple should contain two elements."
+    assert isinstance(result[0], str), "First element of the tuple should be a string."
+    assert isinstance(result[1], str), "Second element of the tuple should be a string."
+
+
+def test_find_versions():
+    query = "com.roblox.client"
+    apkpure = APKPure(query)
+    result = apkpure.search_apk()
+
+    if result:
+        apk_link = result[1]
+        versions = apkpure.find_versions(apk_link)
+
+        assert isinstance(versions, list), "Versions should be a list."
+        assert len(versions) > 0, "No versions found."
+        assert all(
+            isinstance(version, tuple) for version in versions
+        ), "Each version should be a tuple."
+        assert all(
+            len(version) == 2 for version in versions
+        ), "Each version tuple should contain two elements."
+        assert all(
+            isinstance(version[0], str) for version in versions
+        ), "First element of each version tuple should be a string."
+        assert all(
+            isinstance(version[1], str) for version in versions
+        ), "Second element of each version tuple should be a string."