docs: Added new sphinx docs (#726)

### Changes included in this PR 

- Upgraded all dependencies to latest compatible versions
- Removed old docs and replaced with new sphinx based documentation
- Added docs for installation, debugging, basic server and client setup.
- Updated type checking in `ocpp/message.py`. Previously, we were using
`type(message) == Call`, now we are using `isinstance(message, Call)` to
compare the types.

### Current behavior

- Old docs not compatible with existing codebase

### New behavior

- New docs compatible with existing codebase with more structured and
complete documentation
- For local development, we now need Python 3.11 or more.

### Impact

- Easier user onboarding
- Using sphinx_rtd_theme for better UI and UX


### Checklist

1. [x] Does your submission pass the existing tests?
2. [ ] Are there new tests that cover these additions/changes? 
3. [x] Have you linted your code locally before submission?

Author: jainmohit2001

.readthedocs.yaml

@@ -6,7 +6,7 @@ version: 2
 
 # Set the OS, Python version and other tools you might need
 build:
-  os: ubuntu-lts-latest
+  os: ubuntu-22.04
   tools:
     python: "3.12"
     # You can also specify other tool versions:

docs/source/README.rst

@@ -1,56 +1,31 @@
 # Configuration file for the Sphinx documentation builder.
 #
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
-# http://www.sphinx-doc.org/en/master/config
-
-# -- Path setup --------------------------------------------------------------
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-import os
-import sys
-
-sys.path.insert(0, os.path.abspath("../../"))
-
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 # -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = "OCPP"
-copyright = "2024, Auke Willem Oosterhoff"
-author = "Auke Willem Oosterhoff"
-
-# The full version, including alpha/beta/rc tags
-release = "2.0.0"
-
+project = 'ocpp'
+copyright = '2025, Mohit Jain'
+author = 'Mohit Jain'
+release = '3.0.0'
 
 # -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = ["sphinx.ext.autodoc"]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ["_templates"]
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.napoleon', 'sphinx.ext.viewcode']
 
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
+templates_path = ['_templates']
 exclude_patterns = []
 
-master_doc = "index"
 
-# -- Options for HTML output -------------------------------------------------
 
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = "alabaster"
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+html_theme = 'sphinx_rtd_theme'
+html_static_path = ['_static']
+html_theme_options = {
+    'collapse_navigation': False,
+}

docs/source/central_system.rst

@@ -0,0 +1,22 @@
+Debugging
+=========
+
+Python's default log level is ``logging.WARNING``. As a result most of the logs generated by this package are discarded.
+
+To see the log output of this package lower the log level to ``logging.DEBUG``.
+
+.. code-block:: python
+
+    import logging
+    logging.basicConfig(level=logging.DEBUG)
+
+However, this approach defines the log level for the complete logging system.
+In other words: the log level of all dependencies is set to ``logging.DEBUG``.
+
+To lower the logs for this package only use the following code:
+
+.. code-block:: python
+
+    import logging
+    logging.getLogger('ocpp').setLevel(level=logging.DEBUG)
+    logging.getLogger('ocpp').addHandler(logging.StreamHandler())

docs/source/client.rst

@@ -1,15 +1,20 @@
-.. OCPP documentation master file, created by
-   sphinx-quickstart on Tue May 28 20:40:32 2019.
+.. ocpp documentation master file, created by
+   sphinx-quickstart on Sun May  4 14:28:47 2025.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-.. include:: ../../README.rst
+ocpp documentation
+==================
+
+Add your content using ``reStructuredText`` syntax. See the
+`reStructuredText <https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`_
+documentation for details.
 
-Index
------
 
 .. toctree::
    :maxdepth: 2
+   :caption: Contents:
 
-   README
-   central_system
+   installation
+   usage/index
+   debugging

docs/source/conf.py

@@ -0,0 +1,25 @@
+Installation
+============
+
+You can either install the project from Pypi:
+
+.. code-block:: bash
+
+   pip install ocpp
+
+Or clone the project and install it manually using:
+
+.. code-block:: bash
+
+   pip install .
+
+**Dependencies**
+
+- Python 3.7 or higher
+- The project also requires a websocket library. We recommend using `websockets`_:
+
+    .. code-block:: bash
+
+        pip install websockets
+
+.. _websockets: https://pypi.org/project/websockets/