vulners 2.3.2__tar.gz → 2.3.4__tar.gz

vulners-2.3.4/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.1
+Name: vulners
+Version: 2.3.4
+Summary: Python library and command-line utility for Vulners (https://vulners.com)
+Keywords: security,network,vulners,vulnerability,CVE
+Author: Vulners Team
+Requires-Python: >=3.8
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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 :: Software Development :: Version Control
+Classifier: Topic :: Utilities
+Requires-Dist: appdirs (>=1.4.4,<2.0.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: six (>=1.16.0,<2.0.0)
+Description-Content-Type: text/markdown
+
+# [Vulners API v3](https://vulners.com) Python wrapper
+
+
+# Description
+Python 3 library for the [Vulners Database](https://vulners.com).
+It provides *search, data retrieval, archive and vulnerability scanning* API's for the integration purposes.
+With this library you can create powerful security tools and get access to the world largest security database.
+
+## How to install
+
+Package is available with [PyPI](https://pypi.python.org/pypi) 
+
+You can use pip for the installation
+
+```bash
+pip install -U vulners
+```
+
+## Obtaining Vulners API key
+
+Please, register at [Vulners website](https://vulners.com).
+Go to the personal menu by clicking at your name at the right top corner.
+Follow "API KEYS" tab.
+Generate API key with scope "api" and use it with the library.
+
+# Documentation
+The full API methods description, usage examples, and integration guide are available in the official documentation: [API Reference](https://vulners.com/docs/api_reference/api/).
+
+

vulners-2.3.4/README.md

@@ -0,0 +1,28 @@
+# [Vulners API v3](https://vulners.com) Python wrapper
+
+
+# Description
+Python 3 library for the [Vulners Database](https://vulners.com).
+It provides *search, data retrieval, archive and vulnerability scanning* API's for the integration purposes.
+With this library you can create powerful security tools and get access to the world largest security database.
+
+## How to install
+
+Package is available with [PyPI](https://pypi.python.org/pypi) 
+
+You can use pip for the installation
+
+```bash
+pip install -U vulners
+```
+
+## Obtaining Vulners API key
+
+Please, register at [Vulners website](https://vulners.com).
+Go to the personal menu by clicking at your name at the right top corner.
+Follow "API KEYS" tab.
+Generate API key with scope "api" and use it with the library.
+
+# Documentation
+The full API methods description, usage examples, and integration guide are available in the official documentation: [API Reference](https://vulners.com/docs/api_reference/api/).
+

{vulners-2.3.2 → vulners-2.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vulners"
-version = "2.3.2"
+version = "2.3.4"
 description = "Python library and command-line utility for Vulners (https://vulners.com)"
 readme = "README.md"
 authors = ["Vulners Team"]

{vulners-2.3.2 → vulners-2.3.4}/vulners/base.py

@@ -261,7 +261,6 @@ class Any(Param):
                 return _param.validate(param, value)
             except ParamError as e:
                 errs.append(e)
-                pass
 
         raise ParamError(
             "Expect %s but got '%s'",

{vulners-2.3.2 → vulners-2.3.4}/vulners/vulners.py

@@ -249,10 +249,24 @@ class VulnersApi(VulnersApiBase):
             (
                 "software",
                 List(
-                    item=Dict(),
+                    item=Any(Dict, String),
                     description="List of dicts. E.g., [{'product': 'curl', 'version': '8.11.1', ...}, ...]",
                 ),
             ),
+            (
+                "match",
+                String(
+                    required=False,
+                    description="'partial' (default) or 'full'",
+                ),
+            ),
+            (
+                "fields",
+                List(
+                    required=False,
+                    description="List of fields to retrieve about each vulnerability",
+                ),
+            ),
         ],
         content_handler=lambda c, _: c["result"],
     )
@@ -264,13 +278,27 @@ class VulnersApi(VulnersApiBase):
             (
                 "software",
                 List(
-                    item=Dict(),
+                    item=Any(Dict, String),
                     description="List of dicts. E.g., [{'product': 'curl', 'version': '8.11.1', ...}, ...]",
                 ),
             ),
             ("application", Any(String, Dict, required=False)),
             ("operation_system", Any(String, Dict, required=False)),
             ("hardware", Any(String, Dict, required=False)),
+            (
+                "match",
+                String(
+                    required=False,
+                    description="'partial' (default) or 'full'",
+                ),
+            ),
+            (
+                "fields",
+                List(
+                    required=False,
+                    description="List of fields to retrieve about each vulnerability",
+                ),
+            ),
         ],
         content_handler=lambda c, _: c["result"],
     )
@@ -299,6 +327,15 @@ class VulnersApi(VulnersApiBase):
             only_ids,
         )
 
+    search_cpe = Endpoint(
+        method="get",
+        url="/api/v4/search/cpe/",
+        params=[
+            ("product", String(required=True, description="Product string to search CPE for")),
+            ("vendor", String(required=False, description="Optional vendor to include in CPE")),
+        ],
+    )
+
     get_multiple_bulletins = Endpoint(
         method="post",
         url="/api/v3/search/id/",

vulners-2.3.2/PKG-INFO

@@ -1,204 +0,0 @@
-Metadata-Version: 2.1
-Name: vulners
-Version: 2.3.2
-Summary: Python library and command-line utility for Vulners (https://vulners.com)
-Keywords: security,network,vulners,vulnerability,CVE
-Author: Vulners Team
-Requires-Python: >=3.8
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-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 :: Software Development :: Version Control
-Classifier: Topic :: Utilities
-Requires-Dist: appdirs (>=1.4.4,<2.0.0)
-Requires-Dist: requests (>=2.31.0,<3.0.0)
-Requires-Dist: six (>=1.16.0,<2.0.0)
-Description-Content-Type: text/markdown
-
-# [Vulners API v3](https://vulners.com) Python wrapper
-
-
-# Description
-Python 2/3 library for the [Vulners Database](https://vulners.com).
-It provides *search, data retrieval, archive and vulnerability scanning* API's for the integration purposes.
-With this library you can create powerful security tools and get access to the world largest security database.
-
-## Python version
-Library was tested on a *python2* and *python3*.
-
-## How to install
-
-Package is available with [PyPI](https://pypi.python.org/pypi) 
-
-You can use pip for the installation
-
-```bash
-pip install -U vulners
-```
-
-## Obtaining Vulners API key
-
-Please, register at [Vulners website](https://vulners.com).
-Go to the personal menu by clicking at your name at the right top corner.
-Follow "API KEYS" tab.
-Generate API key with scope "api" and use it with the library.
-
-# Functions and methods
-
-All the callable methods are using [Vulners REST API](https://vulners.com/docs).
-
-### Search in database
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-heartbleed_related = vulners_api.find_all("heartbleed", limit=10)
-```
-### Get information about document by identificator
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-CVE_2017_14174 = vulners_api.get_bulletin("CVE-2017-14174")
-```
-### Get information about multiple documents by identificators
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-CVE_DATA = vulners_api.get_multiple_bulletins(["CVE-2017-14174", "CVE-2016-1175"])
-```
-### Search for the public available exploits
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-wordpress_exploits = vulners_api.find_exploit_all("wordpress 4.7.0")
-```
-### Get vulnerabilities and exploits by software name and version
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-results = vulners_api.get_software_vulnerabilities("httpd", "1.3")
-vulnerabilities_list = [results[key] for key in results if key not in ("info", "blog", "bugbounty")]
-```
-### Get vulnerabilities by CPE product and version string
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-cpe_results = vulners_api.get_cpe_vulnerabilities("cpe:/a:cybozu:garoon:4.2.1")
-cpe_vulnerabilities_list = [cpe_results[key] for key in cpe_results if key not in ("info", "blog", "bugbounty")]
-```
-### Get references for the vulnerability
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-references = vulners_api.get_bulletin_references("CVE-2014-0160")
-```
-### Get Windows KB superseeding and parentseeding information
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-# Superseeding information will be returned as a dict
-# with two keys: "superseeds" and "parentseeds".
-# Superseeds means "what KB are covered by this KB".
-# Parentseeds means "what KB are covering this KB".
-superseeds = vulners_api.get_kb_seeds("KB4524135")
-```
-### Get Windows KB updates list and download urls
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-microsoft_updates_for_kb = vulners_api.get_kb_updates("KB4524135")
-updates_download_links = [update["href"] for update in microsoft_updates_for_kb]
-```
-### Score any vulnerability description using [Vulners AI](https://lab.wallarm.com/new-from-wallarm-research-first-ai-based-tool-to-predict-vulnerability-risk-2d0a7e9b3474)
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-text_ai_score = vulners_api.get_ai_score("My cool vulnerability description")
-```
-### Get possible query autocompletions
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-possible_autocomplete = vulners_api.query_autocomplete("heartbleed")
-
-```
-### Download whole database collection and work with data locally
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-all_cve = vulners_api.get_collection("cve")
-```
-### Audit Windows hosts for installed security KB
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-win_vulners = vulners_api.kb_audit(os="Windows Server 2012 R2", kb_list=["KB4072650", "KB2959936", "KB2894856", "KB2896496"])
-need_2_install_kb = win_vulners["kbMissed"]
-affected_cve = win_vulners["cvelist"]
-```
-### Audit Linux hosts for vulnerabilities (RPM/DEB based)
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-# Example for CentOS 7
-# You can use it for any RPM based OS
-# Execute command: rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\\n'
-# Use it as package variable input
-
-centos_vulnerabilities = vulners_api.os_audit(os="centos", version="7", packages=["glibc-common-2.17-157.el7_3.5.x86_64"])
-vulnerable_packages = centos_vulnerabilities.get("packages")
-missed_patches_ids = centos_vulnerabilities.get("vulnerabilities")
-cve_list = centos_vulnerabilities.get("cvelist")
-how_to_fix = centos_vulnerabilities.get("cumulativeFix")
-
-# Example for Debian 8
-# You can use it for any DEB based OS
-# Execute command: dpkg-query -W -f='${Package} ${Version} ${Architecture}\\n'
-# Use it as package variable input
-
-debian_vulnerabilities = vulners_api.os_audit(os="debian", version="8", packages=['uno-libs3 4.3.3-2+deb8u7 amd64'])
-```
-
-### Download Linux (RPM/DEB based) vulnerability assessment data for local processing
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-# Example for CentOS 7
-centos_vulnerabilities_data = vulners_api.get_distributive("CentOS", "7")
-```
-### Download web application vulnerability detection regex collection
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-rules = vulners_api.get_web_application_rules()
-```
-

vulners-2.3.2/README.md

@@ -1,176 +0,0 @@
-# [Vulners API v3](https://vulners.com) Python wrapper
-
-
-# Description
-Python 2/3 library for the [Vulners Database](https://vulners.com).
-It provides *search, data retrieval, archive and vulnerability scanning* API's for the integration purposes.
-With this library you can create powerful security tools and get access to the world largest security database.
-
-## Python version
-Library was tested on a *python2* and *python3*.
-
-## How to install
-
-Package is available with [PyPI](https://pypi.python.org/pypi) 
-
-You can use pip for the installation
-
-```bash
-pip install -U vulners
-```
-
-## Obtaining Vulners API key
-
-Please, register at [Vulners website](https://vulners.com).
-Go to the personal menu by clicking at your name at the right top corner.
-Follow "API KEYS" tab.
-Generate API key with scope "api" and use it with the library.
-
-# Functions and methods
-
-All the callable methods are using [Vulners REST API](https://vulners.com/docs).
-
-### Search in database
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-heartbleed_related = vulners_api.find_all("heartbleed", limit=10)
-```
-### Get information about document by identificator
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-CVE_2017_14174 = vulners_api.get_bulletin("CVE-2017-14174")
-```
-### Get information about multiple documents by identificators
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-CVE_DATA = vulners_api.get_multiple_bulletins(["CVE-2017-14174", "CVE-2016-1175"])
-```
-### Search for the public available exploits
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-wordpress_exploits = vulners_api.find_exploit_all("wordpress 4.7.0")
-```
-### Get vulnerabilities and exploits by software name and version
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-results = vulners_api.get_software_vulnerabilities("httpd", "1.3")
-vulnerabilities_list = [results[key] for key in results if key not in ("info", "blog", "bugbounty")]
-```
-### Get vulnerabilities by CPE product and version string
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-cpe_results = vulners_api.get_cpe_vulnerabilities("cpe:/a:cybozu:garoon:4.2.1")
-cpe_vulnerabilities_list = [cpe_results[key] for key in cpe_results if key not in ("info", "blog", "bugbounty")]
-```
-### Get references for the vulnerability
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-references = vulners_api.get_bulletin_references("CVE-2014-0160")
-```
-### Get Windows KB superseeding and parentseeding information
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-# Superseeding information will be returned as a dict
-# with two keys: "superseeds" and "parentseeds".
-# Superseeds means "what KB are covered by this KB".
-# Parentseeds means "what KB are covering this KB".
-superseeds = vulners_api.get_kb_seeds("KB4524135")
-```
-### Get Windows KB updates list and download urls
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-microsoft_updates_for_kb = vulners_api.get_kb_updates("KB4524135")
-updates_download_links = [update["href"] for update in microsoft_updates_for_kb]
-```
-### Score any vulnerability description using [Vulners AI](https://lab.wallarm.com/new-from-wallarm-research-first-ai-based-tool-to-predict-vulnerability-risk-2d0a7e9b3474)
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-text_ai_score = vulners_api.get_ai_score("My cool vulnerability description")
-```
-### Get possible query autocompletions
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-possible_autocomplete = vulners_api.query_autocomplete("heartbleed")
-
-```
-### Download whole database collection and work with data locally
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-all_cve = vulners_api.get_collection("cve")
-```
-### Audit Windows hosts for installed security KB
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-win_vulners = vulners_api.kb_audit(os="Windows Server 2012 R2", kb_list=["KB4072650", "KB2959936", "KB2894856", "KB2896496"])
-need_2_install_kb = win_vulners["kbMissed"]
-affected_cve = win_vulners["cvelist"]
-```
-### Audit Linux hosts for vulnerabilities (RPM/DEB based)
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-# Example for CentOS 7
-# You can use it for any RPM based OS
-# Execute command: rpm -qa --qf '%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}\\n'
-# Use it as package variable input
-
-centos_vulnerabilities = vulners_api.os_audit(os="centos", version="7", packages=["glibc-common-2.17-157.el7_3.5.x86_64"])
-vulnerable_packages = centos_vulnerabilities.get("packages")
-missed_patches_ids = centos_vulnerabilities.get("vulnerabilities")
-cve_list = centos_vulnerabilities.get("cvelist")
-how_to_fix = centos_vulnerabilities.get("cumulativeFix")
-
-# Example for Debian 8
-# You can use it for any DEB based OS
-# Execute command: dpkg-query -W -f='${Package} ${Version} ${Architecture}\\n'
-# Use it as package variable input
-
-debian_vulnerabilities = vulners_api.os_audit(os="debian", version="8", packages=['uno-libs3 4.3.3-2+deb8u7 amd64'])
-```
-
-### Download Linux (RPM/DEB based) vulnerability assessment data for local processing
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-
-# Example for CentOS 7
-centos_vulnerabilities_data = vulners_api.get_distributive("CentOS", "7")
-```
-### Download web application vulnerability detection regex collection
-```python
-import vulners
-
-vulners_api = vulners.VulnersApi(api_key="YOUR_API_KEY_HERE")
-rules = vulners_api.get_web_application_rules()
-```