Metadata-Version: 2.1
Name: Online-W3C-Validator
Version: 0.3.20
Summary: UNKNOWN
Home-page: https://github.com/nad2000/W3C-Validator
Author: Radomirs Cirskis
Author-email: nad2000@gmail.com
License: MIT
Project-URL: Source Code, https://github.com/nad2000/W3C-Validator
Keywords: html validator,html,validator,checker,html5,w3
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE
License-File: AUTHORS

Online W3C Validator
====================

Pure Python command line for HTML validation using W3C online validator.
It could be very handy for using it in a CI pipline.

Installation
------------

.. code:: bash

   pip install -U Online-W3C-Validator

How to use
----------

You can user the CLI command:

.. code:: bash

   w3c_validator http://www.google.com some_file.html

Example output:

::

   INFO:w3c_validator.validator:Files to validate:
     http://www.google.com
   INFO:w3c_validator.validator:Number of files: 1
   INFO:w3c_validator.validator:validating: http://www.google.com ...
   error: line 2: CSS: “display”: “inline-box” is not a “display” value in “inline-box” in “.ds”.
   error: line 2: The “bgcolor” attribute on the “body” element is obsolete. Use CSS instead.
   error: line 5: Element “nobr” not allowed as child of element “div” in this context. (Suppressing further errors from this subtree.)
   error: line 5: Attribute “width” not allowed on element “div” at this point.
   error: line 5: Element “nobr” not allowed as child of element “div” in this context. (Suppressing further errors from this subtree.)
   error: line 5: The “center” element is obsolete. Use CSS instead.
   error: line 5: The “clear” attribute on the “br” element is obsolete. Use CSS instead.

Or you can use the fuction **validdate** provied by the package, that
thakes either HTML file name or URL as a single parameter an returns
JSON object with the validation output.

.. code:: py

   from w3c_validator import validate

   messages = validate("http://www.google.com")["messages"]
   for m in messages:
       print("Type: %(type)s, Line: %(lastLine)d, Description: %(message)s" % m)

Example output:

::

   Type: error, Line: 2, Description: CSS: “display”: “inline-box” is not a “display” value in “inline-box” in “.ds”.
   Type: error, Line: 2, Description: The “bgcolor” attribute on the “body” element is obsolete. Use CSS instead.
   Type: error, Line: 5, Description: Element “nobr” not allowed as child of element “div” in this context. (Suppressing further errors from this subtree.)
   Type: error, Line: 5, Description: Attribute “width” not allowed on element “div” at this point.
   Type: error, Line: 5, Description: Element “nobr” not allowed as child of element “div” in this context. (Suppressing further errors from this subtree.)
   Type: error, Line: 5, Description: The “center” element is obsolete. Use CSS instead.
   Type: error, Line: 5, Description: The “clear” attribute on the “br” element is obsolete. Use CSS instead.
   Type: error, Line: 5, Description: The “align” attribute on the “div” element is obsolete. Use CSS instead.
   Type: error, Line: 5, Description: Attribute “nowrap” not allowed on element “div” at this point.
   ...

Contact
-------

For bugs please use `GitHub issues`_. For other matters feel free to
contact me at nad2000@gmail.com.

.. _GitHub issues: https://github.com/RonenNess/html_validator/issues



