Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/go-xmlfmt/htmlextract
HTML Extraction Tool
https://github.com/go-xmlfmt/htmlextract
command-line-tool commandline extract go golang html outline scrape structure
Last synced: about 2 months ago
JSON representation
HTML Extraction Tool
- Host: GitHub
- URL: https://github.com/go-xmlfmt/htmlextract
- Owner: go-xmlfmt
- License: mit
- Created: 2018-01-01T19:24:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-02-17T19:07:59.000Z (over 6 years ago)
- Last Synced: 2024-07-22T04:36:16.014Z (2 months ago)
- Topics: command-line-tool, commandline, extract, go, golang, html, outline, scrape, structure
- Language: HTML
- Homepage:
- Size: 169 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.e.md
- License: LICENSE
Awesome Lists containing this project
README
# {{.Name}}
{{render "license/shields" . "License" "MIT"}}
{{template "badge/godoc" .}}
{{template "badge/goreport" .}}
{{template "badge/travis" .}}
[](http://godoc.org/github.com/go-easygen/wireframe)
## {{toc 5}}
## {{.Name}} - HTML Extraction Tool
The `htmlextract` makes it easy to look at the HTML files from different aspects.
- **`htmlextract outline`** will extract HTML structure as outline so as to focus more easily on the structure, not the details.
- **`htmlextract clean`** will clean up HTML tags & attributes as much as possible, so as to go back to the plain text version as easy as possible.
- **`htmlextract h2md`** will convert HTML to .md file on top of above clean up.
# Usage
### $ {{exec "htmlextract" | color "sh"}}
### $ {{shell "htmlextract outline" | color "sh"}}
### $ {{shell "htmlextract clean" | color "sh"}}
### $ {{shell "htmlextract h2md" | color "sh"}}
# Examples
## Outline
### $ {{shell "htmlextract outline -i test/sample0.html -o" | color "json"}}
### Advantages
- By extracting HTML structure as outline, the `htmlextract outline` will make it easier to analyze the file structure, by eliminating all the glory details out of the way, which is most often needed when doing web scrapping or WebDriver code developing.
- The output is mindfully chosen as the JSON format so as to easily take advantage of the dynamic folding feature that the text editors provide. Or you can use the [jsonformatter.org](https://jsonformatter.org/) online as well, even without a text editor.
Here is a screenshot of viewing the result of `htmlextract outline -i test/sample0.html`:
### Usage
#### Specifying more attributes
If the predefined attribute selection is not enough, the it is easily to add your own by the `-a, --attributes` switch. Note that you can use the switch as many times as you wish, to provide as many attributes as you need:
```sh
$ htmlextract outline -a dojotype -a style -i test/sample0.html -o | grep -1 dojotype | head -3
"div": {
"=": "id=pluginList dojotype=PluginTable style=float:right; ",
"_": {}},
```
#### Work with URL directly
Starting with version `0.2.0`, `htmlextract` can extract from URL directly:
```sh
$ htmlextract outline -i http://demoaut.katalon.com/profile.php -o | head -35
...
"body": {
"=": "",
"_": {
"a": {
"=": "id=menu-toggle css=.btn.btn-dark.btn-lg.toggle ",
"_": {
"i": {
"=": "css=.fa.fa-bars ",
"_": {}},
}},
"nav": {
"=": "id=sidebar-wrapper ",
"_": {
"ul": {
"=": "css=.sidebar-nav ",
"_": {
"a": {
"=": "id=menu-close css=.btn.btn-light.btn-lg.pull-right.toggle ",
"_": {
"i": {
"=": "css=.fa.fa-times ",
"_": {}},
...
```
# Download binaries
- The latest binary executables are available under
https://bintray.com/antoniosun/bin/{{.Name}}/latest, or directly under
https://bintray.com/version/files/antoniosun/bin/{{.Name}}/latest
as the result of the Continuous-Integration process.
- I.e., they are built during every git push, automatically by [travis-ci](https://travis-ci.org/), right from the source code, truly WYSIWYG.
- Pick & choose the binary executable that suits your OS and its architecture. E.g., for Linux, it would most probably be the `{{.Name}}-linux-amd64` file. If your OS and its architecture is not available in the download list, please let me know and I'll add it.
- You may want to rename it to a shorter name instead, e.g., `{{.Name}}`, after downloading it.
# Debian package
Available at https://bintray.com/antoniosun/deb/{{.Name}},
or directly at https://dl.bintray.com/antoniosun/deb:
```
echo "deb [trusted=yes] https://dl.bintray.com/antoniosun/deb all main" | sudo tee /etc/apt/sources.list.d/antoniosun-debs.list
sudo apt-get update
sudo chmod 644 /etc/apt/sources.list.d/antoniosun-debs.list
apt-cache policy {{.Name}}
sudo apt-get install -y {{.Name}}
```
# Install Source
To install the source code instead:
```
go get github.com/go-xmlfmt/htmlextract
```
## Author(s) & Contributor(s)
- [Antonio SUN](https://github.com/AntonioSun)
_Powered by_ [**WireFrame**](https://github.com/go-easygen/wireframe), [](http://godoc.org/github.com/go-easygen/wireframe), the _one-stop wire-framing solution_ for Go cli based projects, from start to deploy.
All patches welcome.