PyFunceble-dev 4.3.0a5__py3-none-any.whl → 4.3.0a10__py3-none-any.whl

PyFunceble/query/requests/adapter/http.py

@@ -55,7 +55,6 @@ import urllib.parse
 import requests
 
 import PyFunceble.facility
-import PyFunceble.storage
 from PyFunceble.query.requests.adapter.base import RequestAdapterBase
 
 
@@ -117,10 +116,10 @@ class RequestHTTPAdapter(RequestAdapterBase):
             request.headers["Host"] = parsed_url.hostname
         else:
             self.poolmanager.connection_pool_kw.pop(
-                "server_hostname", PyFunceble.storage.NOT_RESOLVED_STD_HOSTNAME
+                "server_hostname", self.NOT_RESOLVED_STD_HOSTNAME
             )
             self.poolmanager.connection_pool_kw.pop(
-                "assert_hostname", PyFunceble.storage.NOT_RESOLVED_STD_HOSTNAME
+                "assert_hostname", self.NOT_RESOLVED_STD_HOSTNAME
             )
 
             return self.fake_response()

PyFunceble/query/requests/adapter/https.py

@@ -125,10 +125,10 @@ class RequestHTTPSAdapter(RequestAdapterBase):
             request.headers["Host"] = parsed_url.hostname
         else:
             self.poolmanager.connection_pool_kw.pop(
-                "server_hostname", PyFunceble.storage.NOT_RESOLVED_STD_HOSTNAME
+                "server_hostname", self.NOT_RESOLVED_STD_HOSTNAME
             )
             self.poolmanager.connection_pool_kw.pop(
-                "assert_hostname", PyFunceble.storage.NOT_RESOLVED_STD_HOSTNAME
+                "assert_hostname", self.NOT_RESOLVED_STD_HOSTNAME
             )
 
             self.poolmanager.connection_pool_kw.pop(

PyFunceble/query/requests/requester.py

@@ -58,8 +58,8 @@ from typing import Optional, Union
 import requests
 import requests.exceptions
 import urllib3.exceptions
+from box import Box
 
-import PyFunceble.facility
 import PyFunceble.storage
 from PyFunceble.dataset.user_agent import UserAgentDataset
 from PyFunceble.query.dns.query_tool import DNSQueryTool
@@ -132,6 +132,8 @@ class Requester:
     _max_redirects: int = 60
     _proxy_pattern: dict = {}
 
+    config: Optional[Box] = None
+
     session: Optional[requests.Session] = None
     dns_query_tool: Optional[DNSQueryTool] = None
 
@@ -144,7 +146,13 @@ class Requester:
         max_redirects: Optional[int] = None,
         dns_query_tool: Optional[DNSQueryTool] = None,
         proxy_pattern: Optional[dict] = None,
+        config: Optional[Box] = None,
     ) -> None:
+        if config is not None:
+            self.config = config
+        else:
+            self.config = Box({}, default_box=True)
+
         if max_retries is not None:
             self.max_retries = max_retries
         else:
@@ -207,27 +215,45 @@ class Requester:
             @functools.wraps(func)
             def wrapper(self, *args, **kwargs):
                 # pylint: disable=no-member
-                PyFunceble.facility.Logger.debug(
-                    "Started %r request to %r with %r",
-                    verb.upper(),
-                    args[0],
-                    kwargs,
-                )
                 req = getattr(self.session, verb.lower())(*args, **kwargs)
-
-                PyFunceble.facility.Logger.debug(
-                    "Finished %r request to %r with %r",
-                    verb.upper(),
-                    args[0],
-                    kwargs,
-                )
-
                 return req
 
             return wrapper
 
         return request_method
 
+    @property
+    def headers(self) -> dict:
+        """
+        Provides the headers to use.
+        """
+
+        return self.session.headers
+
+    @headers.setter
+    @recreate_session
+    def headers(self, value: dict) -> None:
+        """
+        Sets the headers to use.
+
+        :param value:
+            The headers to set.
+        """
+
+        self.session.headers.update(value)
+
+    def set_config(self, config: Box) -> "Requester":
+        """
+        Sets the configuration to work with.
+
+        :param config:
+            The configuration to work with.
+        """
+
+        self.config = config
+
+        return self
+
     @property
     def max_retries(self) -> int:
         """
@@ -276,13 +302,12 @@ class Requester:
         Try to guess the value from the configuration and set it.
         """
 
-        if PyFunceble.facility.ConfigLoader.is_already_loaded() and bool(
-            PyFunceble.storage.CONFIGURATION.max_http_retries
-        ):
-            self.set_max_retries(
-                bool(PyFunceble.storage.CONFIGURATION.max_http_retries)
-            )
-        else:
+        try:
+            if isinstance(self.config.max_http_retries, int):
+                self.set_max_retries(self.config.max_http_retries)
+            else:
+                self.set_max_retries(self.STD_MAX_RETRIES)
+        except:  # pylint: disable=bare-except
             self.set_max_retries(self.STD_MAX_RETRIES)
 
         return self
@@ -373,14 +398,13 @@ class Requester:
         Try to guess the value from the configuration and set it.
         """
 
-        if PyFunceble.facility.ConfigLoader.is_already_loaded() and bool(
-            PyFunceble.storage.CONFIGURATION.verify_ssl_certificate
-        ):
-            self.set_verify_certificate(
-                bool(PyFunceble.storage.CONFIGURATION.verify_ssl_certificate)
-            )
-        else:
-            self.set_verify_certificate(self.STD_VERIFY_CERTIFICATE)
+        try:
+            if isinstance(self.config.verify_ssl_certificate, bool):
+                self.set_verify_certificate(self.config.verify_ssl_certificate)
+            else:
+                self.set_verify_certificate(self.STD_VERIFY_CERTIFICATE)
+        except:  # pylint: disable=bare-except
+            self.set_max_retries(self.STD_MAX_RETRIES)
 
         return self
 
@@ -433,11 +457,12 @@ class Requester:
         Try to guess the value from the configuration and set it.
         """
 
-        if PyFunceble.facility.ConfigLoader.is_already_loaded() and bool(
-            PyFunceble.storage.CONFIGURATION.lookup.timeout
-        ):
-            self.set_timeout(PyFunceble.storage.CONFIGURATION.lookup.timeout)
-        else:
+        try:
+            if isinstance(self.config.lookup.timeout, (int, float)):
+                self.set_timeout(self.config.lookup.timeout)
+            else:
+                self.set_timeout(self.STD_TIMEOUT)
+        except:  # pylint: disable=bare-except
             self.set_timeout(self.STD_TIMEOUT)
 
         return self
@@ -485,11 +510,12 @@ class Requester:
         Try to guess the value from the configuration and set it.
         """
 
-        if PyFunceble.facility.ConfigLoader.is_already_loaded() and bool(
-            PyFunceble.storage.CONFIGURATION.proxy
-        ):
-            self.set_proxy_pattern(PyFunceble.storage.CONFIGURATION.proxy)
-        else:
+        try:
+            if self.config.proxy:
+                self.set_proxy_pattern(self.config.proxy)
+            else:
+                self.set_proxy_pattern({})
+        except:  # pylint: disable=bare-except
             self.set_proxy_pattern({})
 
         return self
@@ -551,7 +577,10 @@ class Requester:
             ),
         )
 
-        custom_headers = {"User-Agent": UserAgentDataset().get_latest()}
+        if PyFunceble.storage.USER_AGENTS:
+            custom_headers = {"User-Agent": UserAgentDataset().get_latest()}
+        else:
+            custom_headers = {}
 
         session.headers.update(custom_headers)
 

PyFunceble/storage.py

@@ -52,7 +52,6 @@ License:
 """
 
 import os
-import secrets
 from typing import Optional
 
 from box import Box
@@ -61,7 +60,7 @@ from dotenv import load_dotenv
 from PyFunceble.storage_facility import get_config_directory
 
 PROJECT_NAME: str = "PyFunceble"
-PROJECT_VERSION: str = "4.3.0a5.dev (Blue Duckling: Tulip)"
+PROJECT_VERSION: str = "4.3.0a10.dev (Blue Duckling: Tulip)"
 
 DISTRIBUTED_CONFIGURATION_FILENAME: str = ".PyFunceble_production.yaml"
 
@@ -73,8 +72,6 @@ ENV_FILENAME: str = ".pyfunceble-env"
 SHORT_REPO_LINK: str = "https://pyfunceble.github.io"
 REPO_LINK: str = "https://github.com/funilrys/PyFunceble"
 
-NOT_RESOLVED_STD_HOSTNAME: str = f"{secrets.token_hex(12)}.mock-resolver.pyfunceble.com"
-
 IANA: Optional[dict] = {}
 PUBLIC_SUFFIX: Optional[dict] = {}
 USER_AGENTS: Optional[dict] = {}

{PyFunceble_dev-4.3.0a5.dist-info → PyFunceble_dev-4.3.0a10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyFunceble-dev
-Version: 4.3.0a5
+Version: 4.3.0a10
 Summary: The tool to check the availability or syntax of domain, IP or URL.
 Home-page: https://github.com/funilrys/PyFunceble
 Author: funilrys
@@ -19,94 +19,172 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved
-Requires-Python: >=3.8, <4
+Requires-Python: >=3.9, <4
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: SQLAlchemy[postgresql_psycopg2binary]~=2.0
 Requires-Dist: python-box[all]~=6.0.0
-Requires-Dist: domain2idna~=1.12.0
+Requires-Dist: colorama
 Requires-Dist: requests[socks]<3
-Requires-Dist: alembic
 Requires-Dist: setuptools>=65.5.1
+Requires-Dist: dnspython[DOH]~=2.6.0
+Requires-Dist: alembic
+Requires-Dist: packaging
 Requires-Dist: python-dotenv
+Requires-Dist: SQLAlchemy~=2.0
 Requires-Dist: inflection
-Requires-Dist: cryptography~=42.0
-Requires-Dist: packaging
 Requires-Dist: shtab
-Requires-Dist: dnspython[doh]~=2.6.0
-Requires-Dist: colorama
+Requires-Dist: domain2idna~=1.12.0
 Requires-Dist: PyYAML
 Requires-Dist: PyMySQL
-Provides-Extra: dev
-Requires-Dist: isort; extra == "dev"
-Requires-Dist: black; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Requires-Dist: flake8; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs-macros-plugin~=1.2; extra == "docs"
+Requires-Dist: mkdocstrings[python]~=0.26; extra == "docs"
 Requires-Dist: pymdown-extensions~=10.9; extra == "docs"
-Requires-Dist: zipp>=3.19.1; extra == "docs"
+Requires-Dist: mkdocs-git-authors-plugin~=0.9; extra == "docs"
+Requires-Dist: mkdocs-gen-files~=0.5; extra == "docs"
 Requires-Dist: mkdocs-material~=9.5; extra == "docs"
+Requires-Dist: mkdocs-section-index~=0.3; extra == "docs"
 Requires-Dist: mkdocs~=1.5; extra == "docs"
-Requires-Dist: mkdocs-git-authors-plugin~=0.9; extra == "docs"
-Requires-Dist: mkdocs-git-revision-date-localized-plugin~=1.2; extra == "docs"
 Requires-Dist: mkdocs-literate-nav~=0.6; extra == "docs"
-Requires-Dist: mkdocs-section-index~=0.3; extra == "docs"
-Requires-Dist: mkdocs-gen-files~=0.5; extra == "docs"
-Requires-Dist: mkdocstrings[python]~=0.26; extra == "docs"
-Provides-Extra: full
-Requires-Dist: zipp>=3.19.1; extra == "full"
-Requires-Dist: inflection; extra == "full"
-Requires-Dist: mkdocs~=1.5; extra == "full"
-Requires-Dist: mkdocs-git-authors-plugin~=0.9; extra == "full"
-Requires-Dist: mkdocs-git-revision-date-localized-plugin~=1.2; extra == "full"
-Requires-Dist: tox; extra == "full"
-Requires-Dist: SQLAlchemy[postgresql_psycopg2binary]~=2.0; extra == "full"
-Requires-Dist: mkdocs-section-index~=0.3; extra == "full"
-Requires-Dist: mkdocstrings[python]~=0.26; extra == "full"
-Requires-Dist: PyMySQL; extra == "full"
-Requires-Dist: python-box[all]~=6.0.0; extra == "full"
-Requires-Dist: flake8; extra == "full"
-Requires-Dist: setuptools>=65.5.1; extra == "full"
-Requires-Dist: python-dotenv; extra == "full"
-Requires-Dist: packaging; extra == "full"
-Requires-Dist: mkdocs-literate-nav~=0.6; extra == "full"
-Requires-Dist: mkdocs-macros-plugin~=1.2; extra == "full"
-Requires-Dist: requests[socks]<3; extra == "full"
-Requires-Dist: domain2idna~=1.12.0; extra == "full"
-Requires-Dist: pymdown-extensions~=10.9; extra == "full"
-Requires-Dist: cryptography~=42.0; extra == "full"
-Requires-Dist: dnspython[doh]~=2.6.0; extra == "full"
-Requires-Dist: black; extra == "full"
-Requires-Dist: coverage; extra == "full"
-Requires-Dist: colorama; extra == "full"
-Requires-Dist: PyYAML; extra == "full"
-Requires-Dist: alembic; extra == "full"
-Requires-Dist: shtab; extra == "full"
-Requires-Dist: mkdocs-material~=9.5; extra == "full"
-Requires-Dist: isort; extra == "full"
-Requires-Dist: mkdocs-gen-files~=0.5; extra == "full"
-Requires-Dist: pylint; extra == "full"
+Requires-Dist: zipp>=3.19.1; extra == "docs"
+Requires-Dist: mkdocs-git-revision-date-localized-plugin~=1.2; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pylint; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Provides-Extra: test
+Requires-Dist: tox; extra == "test"
+Requires-Dist: coverage; extra == "test"
 Provides-Extra: psql
-Requires-Dist: SQLAlchemy[postgresql_psycopg2binary]~=2.0; extra == "psql"
 Requires-Dist: python-box[all]~=6.0.0; extra == "psql"
-Requires-Dist: domain2idna~=1.12.0; extra == "psql"
+Requires-Dist: psycopg2; extra == "psql"
+Requires-Dist: colorama; extra == "psql"
 Requires-Dist: requests[socks]<3; extra == "psql"
-Requires-Dist: alembic; extra == "psql"
 Requires-Dist: setuptools>=65.5.1; extra == "psql"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "psql"
+Requires-Dist: alembic; extra == "psql"
+Requires-Dist: packaging; extra == "psql"
 Requires-Dist: python-dotenv; extra == "psql"
+Requires-Dist: SQLAlchemy~=2.0; extra == "psql"
 Requires-Dist: inflection; extra == "psql"
-Requires-Dist: cryptography~=42.0; extra == "psql"
-Requires-Dist: packaging; extra == "psql"
 Requires-Dist: shtab; extra == "psql"
-Requires-Dist: dnspython[doh]~=2.6.0; extra == "psql"
-Requires-Dist: psycopg2; extra == "psql"
-Requires-Dist: colorama; extra == "psql"
+Requires-Dist: domain2idna~=1.12.0; extra == "psql"
 Requires-Dist: PyYAML; extra == "psql"
 Requires-Dist: PyMySQL; extra == "psql"
-Provides-Extra: test
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: tox; extra == "test"
+Provides-Extra: psql-binary
+Requires-Dist: python-box[all]~=6.0.0; extra == "psql-binary"
+Requires-Dist: colorama; extra == "psql-binary"
+Requires-Dist: requests[socks]<3; extra == "psql-binary"
+Requires-Dist: setuptools>=65.5.1; extra == "psql-binary"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "psql-binary"
+Requires-Dist: alembic; extra == "psql-binary"
+Requires-Dist: packaging; extra == "psql-binary"
+Requires-Dist: python-dotenv; extra == "psql-binary"
+Requires-Dist: psycopg2-binary; extra == "psql-binary"
+Requires-Dist: SQLAlchemy~=2.0; extra == "psql-binary"
+Requires-Dist: inflection; extra == "psql-binary"
+Requires-Dist: shtab; extra == "psql-binary"
+Requires-Dist: domain2idna~=1.12.0; extra == "psql-binary"
+Requires-Dist: PyYAML; extra == "psql-binary"
+Requires-Dist: PyMySQL; extra == "psql-binary"
+Provides-Extra: postgresql
+Requires-Dist: python-box[all]~=6.0.0; extra == "postgresql"
+Requires-Dist: psycopg2; extra == "postgresql"
+Requires-Dist: colorama; extra == "postgresql"
+Requires-Dist: requests[socks]<3; extra == "postgresql"
+Requires-Dist: setuptools>=65.5.1; extra == "postgresql"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "postgresql"
+Requires-Dist: alembic; extra == "postgresql"
+Requires-Dist: packaging; extra == "postgresql"
+Requires-Dist: python-dotenv; extra == "postgresql"
+Requires-Dist: SQLAlchemy~=2.0; extra == "postgresql"
+Requires-Dist: inflection; extra == "postgresql"
+Requires-Dist: shtab; extra == "postgresql"
+Requires-Dist: domain2idna~=1.12.0; extra == "postgresql"
+Requires-Dist: PyYAML; extra == "postgresql"
+Requires-Dist: PyMySQL; extra == "postgresql"
+Provides-Extra: postgresql-binary
+Requires-Dist: python-box[all]~=6.0.0; extra == "postgresql-binary"
+Requires-Dist: colorama; extra == "postgresql-binary"
+Requires-Dist: requests[socks]<3; extra == "postgresql-binary"
+Requires-Dist: setuptools>=65.5.1; extra == "postgresql-binary"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "postgresql-binary"
+Requires-Dist: alembic; extra == "postgresql-binary"
+Requires-Dist: packaging; extra == "postgresql-binary"
+Requires-Dist: python-dotenv; extra == "postgresql-binary"
+Requires-Dist: psycopg2-binary; extra == "postgresql-binary"
+Requires-Dist: SQLAlchemy~=2.0; extra == "postgresql-binary"
+Requires-Dist: inflection; extra == "postgresql-binary"
+Requires-Dist: shtab; extra == "postgresql-binary"
+Requires-Dist: domain2idna~=1.12.0; extra == "postgresql-binary"
+Requires-Dist: PyYAML; extra == "postgresql-binary"
+Requires-Dist: PyMySQL; extra == "postgresql-binary"
+Provides-Extra: full
+Requires-Dist: mkdocs-macros-plugin~=1.2; extra == "full"
+Requires-Dist: mkdocstrings[python]~=0.26; extra == "full"
+Requires-Dist: isort; extra == "full"
+Requires-Dist: packaging; extra == "full"
+Requires-Dist: shtab; extra == "full"
+Requires-Dist: requests[socks]<3; extra == "full"
+Requires-Dist: tox; extra == "full"
+Requires-Dist: mkdocs-gen-files~=0.5; extra == "full"
+Requires-Dist: mkdocs-section-index~=0.3; extra == "full"
+Requires-Dist: alembic; extra == "full"
+Requires-Dist: mkdocs-literate-nav~=0.6; extra == "full"
+Requires-Dist: python-box[all]~=6.0.0; extra == "full"
+Requires-Dist: black; extra == "full"
+Requires-Dist: domain2idna~=1.12.0; extra == "full"
+Requires-Dist: mkdocs-git-authors-plugin~=0.9; extra == "full"
+Requires-Dist: colorama; extra == "full"
+Requires-Dist: python-dotenv; extra == "full"
+Requires-Dist: SQLAlchemy~=2.0; extra == "full"
+Requires-Dist: zipp>=3.19.1; extra == "full"
+Requires-Dist: PyYAML; extra == "full"
+Requires-Dist: coverage; extra == "full"
+Requires-Dist: pymdown-extensions~=10.9; extra == "full"
+Requires-Dist: mkdocs-material~=9.5; extra == "full"
+Requires-Dist: setuptools>=65.5.1; extra == "full"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "full"
+Requires-Dist: flake8; extra == "full"
+Requires-Dist: mkdocs~=1.5; extra == "full"
+Requires-Dist: pylint; extra == "full"
+Requires-Dist: inflection; extra == "full"
+Requires-Dist: mkdocs-git-revision-date-localized-plugin~=1.2; extra == "full"
+Requires-Dist: PyMySQL; extra == "full"
+Provides-Extra: all
+Requires-Dist: mkdocs-macros-plugin~=1.2; extra == "all"
+Requires-Dist: mkdocstrings[python]~=0.26; extra == "all"
+Requires-Dist: isort; extra == "all"
+Requires-Dist: packaging; extra == "all"
+Requires-Dist: shtab; extra == "all"
+Requires-Dist: requests[socks]<3; extra == "all"
+Requires-Dist: tox; extra == "all"
+Requires-Dist: mkdocs-gen-files~=0.5; extra == "all"
+Requires-Dist: mkdocs-section-index~=0.3; extra == "all"
+Requires-Dist: alembic; extra == "all"
+Requires-Dist: mkdocs-literate-nav~=0.6; extra == "all"
+Requires-Dist: python-box[all]~=6.0.0; extra == "all"
+Requires-Dist: black; extra == "all"
+Requires-Dist: domain2idna~=1.12.0; extra == "all"
+Requires-Dist: mkdocs-git-authors-plugin~=0.9; extra == "all"
+Requires-Dist: colorama; extra == "all"
+Requires-Dist: python-dotenv; extra == "all"
+Requires-Dist: SQLAlchemy~=2.0; extra == "all"
+Requires-Dist: zipp>=3.19.1; extra == "all"
+Requires-Dist: PyYAML; extra == "all"
+Requires-Dist: coverage; extra == "all"
+Requires-Dist: pymdown-extensions~=10.9; extra == "all"
+Requires-Dist: mkdocs-material~=9.5; extra == "all"
+Requires-Dist: setuptools>=65.5.1; extra == "all"
+Requires-Dist: dnspython[DOH]~=2.6.0; extra == "all"
+Requires-Dist: psycopg2-binary; extra == "all"
+Requires-Dist: flake8; extra == "all"
+Requires-Dist: mkdocs~=1.5; extra == "all"
+Requires-Dist: pylint; extra == "all"
+Requires-Dist: inflection; extra == "all"
+Requires-Dist: mkdocs-git-revision-date-localized-plugin~=1.2; extra == "all"
+Requires-Dist: PyMySQL; extra == "all"
 
 ![image](https://raw.githubusercontent.com/PyFunceble/logo/dev/Green/HD/RM.png)
 
@@ -156,6 +234,7 @@ Happy testing with PyFunceble!
 - [Installation](#installation)
   - [Packages \& Versioning](#packages--versioning)
   - [PyPi - Python Package Index](#pypi---python-package-index)
+    - [Optional Dependencies](#optional-dependencies)
     - [pyfunceble](#pyfunceble)
     - [pyfunceble-dev](#pyfunceble-dev)
   - [Container Image Registry](#container-image-registry)
@@ -219,10 +298,36 @@ the OS specific packages _(see below)_.
 Here is an overview of the packages and where they are hosted.
 
 | Package        | PyPi Link                                |
-|----------------|------------------------------------------|
+| -------------- | ---------------------------------------- |
 | pyfunceble     | https://pypi.org/project/PyFunceble      |
 | pyfunceble-dev | https://pypi.org/project/PyFunceblee-dev |
 
+### Optional Dependencies
+
+The following dependencies are optional and can be installed if you need them.
+
+| Dependency                         | Description                                                                                                                                                            |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `all`                              | Install all functional dependencies. Basically all but `dev`, `test` and `docs`. _When a binary and non binary version is available, the binary version is installed._ |
+| `full`                             | Install all dependencies listed below. _When a binary and non binary version is available, the binary version is installed._                                           |
+| `psql`, `postgresql`               | **Build** and install the dependencies required to interact with PostgreSQL.                                                                                           |
+| `psql-binary`, `postgresql-binary` | **Install** the dependencies required to interact with PostgreSQL - from binary.                                                                                       |
+| `docs`                             | Install the dependencies required to build the documentation.                                                                                                          |
+| `test`                             | Install the dependencies required to run the tests.                                                                                                                    |
+| `dev`                              | Install the dependencies required to develop PyFunceble.                                                                                                               |
+
+They are intended to be installed through the following syntax:
+
+```shell
+pip3 install --user {pkg}[{dependency}]
+```
+
+As an example if you want to install the `docs` and `test` dependencies, you should run:
+
+```shell
+pip3 install --user pyfunceble[docs,test]
+```
+
 ### pyfunceble
 
 You can install the **pyfunceble** through `pip3`:
@@ -255,7 +360,7 @@ is available. :smile:
 Here is an overview of the packages and where they are hosted.
 
 | Host       | Package        | Link                                                                                                     |
-|------------|----------------|----------------------------------------------------------------------------------------------------------|
+| ---------- | -------------- | -------------------------------------------------------------------------------------------------------- |
 | Docker Hub | pyfunceble     | [https://hub.docker.com/r/pyfunceble/pyfunceble](https://hub.docker.com/r/pyfunceble/pyfunceble)         |
 | Docker Hub | pyfunceble-dev | [https://hub.docker.com/r/pyfunceble/pyfunceble-dev](https://hub.docker.com/r/pyfunceble/pyfunceble-dev) |
 
@@ -305,7 +410,7 @@ this is probably for you.
 Here is an overview of the packages and where they are hosted.
 
 | Host   | Package        | Repository                                                              |
-|--------|----------------|-------------------------------------------------------------------------|
+| ------ | -------------- | ----------------------------------------------------------------------- |
 | GitHub | pyfunceble     | `git+https://github.com/funilrys/PyFunceble.git@master#egg=PyFunceble`  |
 | GitHub | pyfunceble-dev | `git+https://github.com/funilrys/PyFunceble.git@dev#egg=PyFunceble-dev` |
 | GitLab | pyfunceble     | `git+https://gitlab.com/funilrys/PyFunceble.git@master#egg=PyFunceble`  |
@@ -474,7 +579,7 @@ From source:
 
 ```shell
 # Install dependencies.
-pip install --user -r requirements.docs.txt
+pip install --user .[docs]
 # Serve documentation locally.
 mkdocs serve
 # Open Documentation with browser.