#######################################
Welcome to Python Code Validator's Docs
#######################################

**Python Code Validator** is a flexible, AST-based framework for the static
validation of Python code using declarative JSON rules. It is designed for
educational platforms and automated testing systems to ensure code quality and
adherence to specific requirements.

This documentation provides a comprehensive guide for users, curriculum
developers, and contributors.

.. grid:: 1 1 1 1
   :gutter: 1

   .. grid-item-card:: ⬇️ Installation
      :link: installation
      :link-type: doc

      Quick installation of the package through the pip manager or installation for contribute to the project


.. grid:: 1 2 2 2
   :gutter: 2

   .. grid-item-card:: 🚀 Getting Started
      :link: user_guide/index
      :link-type: doc

      New to the validator? Start here! This guide covers installation and a
      quick tutorial to get you up and running in minutes.

   .. grid-item-card:: 📖 Validation Rule Specification
      :link: validation_spec/index
      :link-type: doc

      The complete reference for the JSON validation format. Learn about every
      selector, constraint, and rule type available.

   .. grid-item-card:: 💻 API Reference
      :link: api_reference/index
      :link-type: doc

      Auto-generated documentation from the source code. A deep dive into the
      modules, classes, and functions for developers.

   .. grid-item-card:: 🤝 Contributing
      :link: contributing
      :link-type: doc

      Want to help improve the project? Find out how to contribute code, report
      issues, and get involved with the community.

.. toctree::
   :hidden:
   :maxdepth: 2
   :caption: Documentation

   installation
   user_guide/index
   validation_spec/index

.. toctree::
   :hidden:
   :maxdepth: 2
   :caption: API Reference

   api_reference/index

.. toctree::
   :hidden:
   :maxdepth: 1
   :caption: Project Information

   contributing
   changelog
   faq
   glossary