معرفی شرکت ها
django-html-xml-validator-1.0.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Django middleware to validate HTML and XML responses
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-html-xml-validator-1.0.0 |
| نام | django-html-xml-validator |
| نسخه کتابخانه | 1.0.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | ITELL.SOLUTIONS GmbH |
| ایمیل نویسنده | - |
| آدرس صفحه اصلی | https://github.com/itell-solutions/django_html_xml_validator |
| آدرس اینترنتی | https://pypi.org/project/django-html-xml-validator/ |
| مجوز | MIT |
[](https://pypi.org/project/django_html_xml_validator/)
[](https://www.python.org/downloads/)
[](https://github.com/itell-solutions/django_html_xml_validator/actions/workflows/build.yaml)
[](https://github.com/psf/black)
[](https://opensource.org/licenses/MIT)
# Django HTML and XML Validator
`Django_html_xml_validator` is a Django middleware to validate HTML and XML
responses generated by your application. This includes but is not limited to
Django views using `render()` and Django HTML templates.
Features:
- **Specific error locations** in case validation finds issues.
- **Runs locally** without the need to upload your page to an external
validation service.
- **Uses only Python packages** without the need to install external tools
from other ecosystems.
- **Fast** because based on [lxml](https://lxml.de/) and its native components.
This makes it feasible to perform validation while running your test suite.
## Installation
To install, depending on your package manager, run:
```bash
pip install --update django_html_xml_validator
```
or
```bash
poetry add django_html_xml_validator
```
## Usage
To add validation to your project, add it to `settings.MIDDLEWARE`.
```python
MIDDLEWARE = [
...,
"django_html_xml_validator.middleware.HtmlXmlValidatorMiddleware",
]
```
In most cases you only want it to validate the HTML generated by your views
directly, so it would be the last entry. Especially if you have other
middleware installed that modifies your HTML like adding the Django Debug
toolbar or minifying it.
For example:
```python
MIDDLEWARE = [
# Possible middleware your project requires.
...,
# Example middleware that modifies the HTML.
"django_minify_html.middleware.MinifyHtmlMiddleware",
"debug_toolbar.middleware.DebugToolbarMiddleware",
...,
# Put validation middleware toward the end to ensure only your HTML/XML is validated.
"django_html_xml_validator.middleware.HtmlXmlValidatorMiddleware",
]
```
After that, responses with a matching content type are validated:
- HTML:
- application/xhtml+xml
- text/html
- XML:
- application/xml
- text/xml
In case the response is valid, the middleware returns the original response
and HTTP status code verbatim.
In case errors have been found, the response includes an HTML page detailing
the errors with an HTTP status code of 500 (internal server error).
## Configuration
By default, validation is active when the Django `DEBUG` mode is enabled in
`settings.py`. In a reasonably configured project this means during local
development and while running the test suite, but not once deployed to a
server.
For more granular control, add the following to `settings.py`:
```python
VALIDATE_HTML = True
VALIDATE_XML = True
```
If you are sure all your HTML pages are actually XHTML (which sadly will not
be the case as soon as your code contains forms based on standard Django
forms), you can enforce HTML to be validated as XHTML:
```python
VALIDATE_HTML_AS_XHTML = True # WARNING: Will fail with standard form templates
```
## Disabling validation for specific tests
In case validation is not useful for selected tests (for example when
processing deliberately huge documents), it can be disabled with the
[override_settings](https://docs.djangoproject.com/en/4.0/topics/testing/tools/#django.test.override_settings)
annotation. For example:
```python
from django.test import override_settings
@override_settings(VALIDATE_XML=False)
def test_can_build_huge_xml():
...
```
## Limitations
- Validation does not apply to stream responses.
- Validation of HTML5 uses a hack to ignore errors about invalid tags on
sectioning elements like `<nav>` or `<article>`.
- Validation of XML only checks if the document is well-formed but does not
validate against a schema or DTD. Technically lxml could do all this but
would require more setup. If you need such a feature, feel free to submit a
pull request.
## License
Copyright (c) 2022 ITELL.SOLUTIONS GmbH, Graz, Austria.
Distributed under the
[MIT license](https://en.wikipedia.org/wiki/MIT_License). For details refer to
the file `LICENSE`.
The source code is available from
<https://github.com/itell-solutions/django_html_xml_validator>.
نیازمندی
| مقدار | نام |
|---|---|
| >=4,<5 | lxml |
| >=3,<5 | Django |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7,<4.0 | Python |
نحوه نصب
نصب پکیج whl django-html-xml-validator-1.0.0:
pip install django-html-xml-validator-1.0.0.whl
نصب پکیج tar.gz django-html-xml-validator-1.0.0:
pip install django-html-xml-validator-1.0.0.tar.gz