Skip to main content

htmlcomparator

This is a light-weight python package used to compare two html files and return the differences.

The users can choose whether they want a boolean result or string result that specify the difference. They can also choose the types of differences they want to receive.

Usage

To start using the comparator, first import the package, and make an object.

from htmlcomparator import HTMLComparator
comparator = HTMLComparator()

The method that is used to compare html code is

comparator.compare(html1, html2, quick_compare = True, compare_type = "all")

html1, html2 are the two html to be compared. If they are both strings, it will treat them as two html strings. If they are both io.IOBase objects, then the program will treat them as two opened files. Otherwise the program will raise a TypeError.

quick_compare argument is used to specify whether the user want the method to simply return boolean or to return a detailed information of the differences. If it is set to True, then the method will return False as soon as it encounters the first difference, and return True if there are no difference. If it is set to False, then the two html are compared thoroughly, and the method will return a string to describe the differences. If there are no differences, it will return an empty string.

compare_type argument is used to specify the type of differences to compare. It is ignored if quick_compare is set to True. If it is set to tag, then only tag differences will be returned. If it is set to data then tag and data differences will be returned. If it is set to all, then all differences will be considered, including tags, data, and attributes.

For example,

s1 = "<!DOCTYPE xml> <head> <p> test </p> <p> different here </p> </head>"
s2 = "<!DOCTYPE html> <head> <p> this is different </p> </head>"
comparator = HTMLComparator()
print(comparator.compare(s1,s2, compare_type = "all", quick_compare = False))

will output:

@@ DOCTYPE Difference @@
*DOCTYPE xml
-DOCTYPE html

extra tag <p> in the first html at (1, 36)

@@ (1, 25) , (1, 26) @@
*test
-this is different

The tuples (1, 36), (1, 25), and (1, 25) give the line number and the offset of the differences.

Limitations

Currently doesn't support CSS.

License

Copyright Mengjia Zhao 2020. Distributed under the terms of the Apache 2.0 license.

Release files for htmlcomparator 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for htmlcomparator 0.1.0
File Size Uploaded
htmlcomparator-0.1.0.tar.gz 4.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for htmlcomparator 0.1.0
File Interpreter ABI Platform
htmlcomparator-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 14.6 kB

Release files / htmlcomparator-0.1.0.tar.gz

Download URL htmlcomparator-0.1.0.tar.gz
Size 4.7 kB
Tags Source
SHA-256 checksum
How to use checksums
df49a9e5bed128042795de1982dcf486b4d52de68872fd88756f9f2a096677f1
BLAKE2b-256 checksum
How to use checksums
03ffd7c10373f7bcefcf74ef84708d757e297d349c35190e19a223992beb13a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.6.9

Release files / htmlcomparator-0.1.0-py3-none-any.whl

Download URL htmlcomparator-0.1.0-py3-none-any.whl
Size 9.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8c552afdc2ab2881eeaa0bf693fcb6b35f18a17479b41eb3f988f837dd022d8c
BLAKE2b-256 checksum
How to use checksums
b723726c190d65b6c1982f4ebb0c7f0b5c909c9cdfd7a946071d550fc5a40a99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.6.9

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page