!feat: allow multiple versions of one application (#215)

* feat: allow multiple versions of one application

* test: update test, add version in mock functions

* !chore: remove deprecated code

* chore(deps): update dependecies

* chore: make version optional

* chore: reorder parameters checks

* docs: update doc strings

Co-authored-by: PabloVasconez <[email protected]>

* chore: remove redundant type checks

* test(client): test valid version error

---------

Co-authored-by: PabloVasconez <[email protected]>

docs/tree/getting_started.rst

@@ -72,17 +72,23 @@ The :class:`~.NucleiClient` can provide you with a list of `Nuclei` applications
 
     print(client.applications)
 
+And can also fetch the available versions for an application for you:
+
+.. ipython:: python
+
+    versions = print(client.get_versions(app="PileCore"))
+
 And can also fetch the available endpoints for an application for you:
 
 .. ipython:: python
 
-    endpoints = print(client.get_endpoints("PileCore"))
+    endpoints = print(client.get_endpoints(app="PileCore", version="latest"))
 
 You can also check the applications to which you have full access:
 
 .. ipython:: python
 
-    endpoints = print(client.user_permissions)
+    permissions = print(client.user_permissions)
 
 If an application is not listed here, your usage of the app is limited. Check the
 documentation of the specific apps to see the limitations.

requirements.txt

@@ -4,25 +4,25 @@
 #
 #    pip-compile --extra=client --extra=docs --extra=lint --extra=test --output-file=requirements.txt pyproject.toml
 #
-alabaster==0.7.13
+alabaster==0.7.16
     # via sphinx
 asteroid-sphinx-theme==0.0.3
     # via cems-nuclei (pyproject.toml)
 asttokens==2.4.1
     # via stack-data
-babel==2.13.1
+babel==2.15.0
     # via sphinx
-black==23.11.0
+black==24.4.2
     # via cems-nuclei (pyproject.toml)
-certifi==2023.11.17
+certifi==2024.7.4
     # via requests
 charset-normalizer==3.3.2
     # via requests
 click==8.1.7
     # via black
-coverage==6.5.0
+coverage[toml]==7.6.0
     # via coveralls
-coveralls==3.3.1
+coveralls==4.0.1
     # via cems-nuclei (pyproject.toml)
 decorator==5.1.1
     # via ipython
@@ -33,72 +33,72 @@ docutils==0.18.1
     #   m2r2
     #   sphinx
     #   sphinx-rtd-theme
-exceptiongroup==1.2.0
+exceptiongroup==1.2.2
     # via
     #   ipython
     #   pytest
 executing==2.0.1
     # via stack-data
-idna==3.4
+idna==3.7
     # via requests
 imagesize==1.4.1
     # via sphinx
-importlib-metadata==6.8.0
+importlib-metadata==8.0.0
     # via sphinx
 iniconfig==2.0.0
     # via pytest
-ipython==8.17.2
+ipython==8.18.1
     # via cems-nuclei (pyproject.toml)
-isort==5.12.0
+isort==5.13.2
     # via cems-nuclei (pyproject.toml)
 jedi==0.19.1
     # via ipython
-jinja2==3.1.2
+jinja2==3.1.4
     # via sphinx
 m2r2==0.3.2
     # via cems-nuclei (pyproject.toml)
-markupsafe==2.1.3
+markupsafe==2.1.5
     # via jinja2
-matplotlib-inline==0.1.6
+matplotlib-inline==0.1.7
     # via ipython
 mistune==0.8.4
     # via m2r2
 mypy-extensions==1.0.0
     # via black
-numpy==1.26.2
+numpy==1.26.4
     # via cems-nuclei (pyproject.toml)
-orjson==3.9.10
+orjson==3.10.6
     # via cems-nuclei (pyproject.toml)
-packaging==23.2
+packaging==24.1
     # via
     #   black
     #   pytest
     #   sphinx
-parso==0.8.3
+parso==0.8.4
     # via jedi
-pathspec==0.11.2
+pathspec==0.12.1
     # via black
-pexpect==4.8.0
+pexpect==4.9.0
     # via ipython
-platformdirs==4.0.0
+platformdirs==4.2.2
     # via black
-pluggy==1.3.0
+pluggy==1.5.0
     # via pytest
-prompt-toolkit==3.0.41
+prompt-toolkit==3.0.47
     # via ipython
 ptyprocess==0.7.0
     # via pexpect
 pure-eval==0.2.2
     # via stack-data
-pygments==2.17.1
+pygments==2.18.0
     # via
     #   ipython
     #   sphinx
 pyjwt==2.6.0
     # via cems-nuclei (pyproject.toml)
-pytest==7.4.3
+pytest==8.2.2
     # via cems-nuclei (pyproject.toml)
-requests==2.31.0
+requests==2.32.3
     # via
     #   cems-nuclei (pyproject.toml)
     #   coveralls
@@ -113,47 +113,43 @@ sphinx==6.1.3
     #   cems-nuclei (pyproject.toml)
     #   sphinx-autodoc-typehints
     #   sphinx-rtd-theme
-    #   sphinxcontrib-applehelp
-    #   sphinxcontrib-devhelp
-    #   sphinxcontrib-htmlhelp
     #   sphinxcontrib-jquery
-    #   sphinxcontrib-qthelp
-    #   sphinxcontrib-serializinghtml
 sphinx-autodoc-typehints==1.22
     # via cems-nuclei (pyproject.toml)
 sphinx-rtd-theme==1.2.0
     # via cems-nuclei (pyproject.toml)
-sphinxcontrib-applehelp==1.0.7
+sphinxcontrib-applehelp==1.0.8
     # via sphinx
-sphinxcontrib-devhelp==1.0.5
+sphinxcontrib-devhelp==1.0.6
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.4
+sphinxcontrib-htmlhelp==2.0.5
     # via sphinx
 sphinxcontrib-jquery==4.1
     # via sphinx-rtd-theme
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
-sphinxcontrib-qthelp==1.0.6
+sphinxcontrib-qthelp==1.0.7
     # via sphinx
-sphinxcontrib-serializinghtml==1.1.9
+sphinxcontrib-serializinghtml==1.1.10
     # via sphinx
 stack-data==0.6.3
     # via ipython
 tomli==2.0.1
     # via
     #   black
+    #   coverage
     #   pytest
-traitlets==5.13.0
+traitlets==5.14.3
     # via
     #   ipython
     #   matplotlib-inline
-typing-extensions==4.8.0
+typing-extensions==4.12.2
     # via
     #   black
     #   ipython
-urllib3==2.1.0
+urllib3==2.2.2
     # via requests
-wcwidth==0.2.11
+wcwidth==0.2.13
     # via prompt-toolkit
-zipp==3.17.0
+zipp==3.19.2
     # via importlib-metadata