%global _empty_manifest_terminate_build 0
Name: python-boilerpy3
Version: 1.0.6
Release: 1
Summary: Python port of Boilerpipe, for HTML boilerplate removal and text extraction
License: Apache 2.0
URL: https://github.com/jmriebold/BoilerPy3
Source0: https://mirrors.nju.edu.cn/pypi/web/packages/2c/34/7b7433f4b07c27d28b126d6d6876b442500df1caa32e5c191fe05d1c2f44/boilerpy3-1.0.6.tar.gz
BuildArch: noarch
%description
# BoilerPy3
## About
BoilerPy3 is a native Python [port](https://github.com/natural/java2python) of Christian Kohlschütter's [Boilerpipe](https://github.com/kohlschutter/boilerpipe) library, released under the Apache 2.0 Licence.
This package is based on [sammyer's](https://github.com/sammyer) [BoilerPy](https://github.com/sammyer/BoilerPy), specifically [mercuree's](https://github.com/mercuree) [Python3-compatible fork](https://github.com/mercuree/BoilerPy). This fork updates the codebase to be more Pythonic (proper attribute access, docstrings, type-hinting, snake case, etc.) and make use Python 3.6 features (f-strings), in addition to switching testing frameworks from Unittest to PyTest.
**Note**: This package is based on Boilerpipe 1.2 (at or before [this commit](https://github.com/kohlschutter/boilerpipe/tree/b0816590340f4317f500c64565b23beb4fb9a827)), as that's when the code was originally ported to Python. I experimented with updating the code to match Boilerpipe 1.3, however because it performed worse in my tests, I ultimately decided to leave it at 1.2-equivalent.
## Installation
To install the latest version from PyPI, execute:
```shell
pip install boilerpy3
```
If you'd like to try out any unreleased features you can install directly from GitHub like so:
```shell
pip install git+https://github.com/jmriebold/BoilerPy3
```
## Usage
### Text Extraction
The top-level interfaces are the Extractors. Use the `get_content()` methods to extract the filtered text.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_content_from_url('http://example.com/')
# From a file
content = extractor.get_content_from_file('tests/test.html')
# From raw HTML
content = extractor.get_content('Example
')
```
### Marked HTML Extraction
To extract the HTML chunks containing filtered text, use the `get_marked_html()` methods.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_marked_html_from_url('http://example.com/')
# From a file
content = extractor.get_marked_html_from_file('tests/test.html')
# From raw HTML
content = extractor.get_marked_html('Example
')
```
### Other
Alternatively, use `get_doc()` to return a Boilerpipe document from which you can get more detailed information.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
doc = extractor.get_doc_from_url('http://example.com/')
content = doc.content
title = doc.title
```
## Extractors
All extractors have a `raise_on_failure` parameter (defaults to `True`). When set to `False`, the `Extractor` will handle exceptions raised during text extraction and return any text that was successfully extracted. Leaving this at the default setting may be useful if you want to fall back to another algorithm in the event of an error.
### DefaultExtractor
Usually worse than ArticleExtractor, but simpler/no heuristics. A quite generic full-text extractor.
### ArticleExtractor
A full-text extractor which is tuned towards news articles. In this scenario it achieves higher accuracy than DefaultExtractor. Works very well for most types of Article-like HTML.
### ArticleSentencesExtractor
A full-text extractor which is tuned towards extracting sentences from news articles.
### LargestContentExtractor
A full-text extractor which extracts the largest text component of a page. For news articles, it may perform better than the DefaultExtractor but usually worse than ArticleExtractor
### CanolaExtractor
A full-text extractor trained on [krdwrd](http://krdwrd.org) [Canola](https://krdwrd.org/trac/attachment/wiki/Corpora/Canola/CANOLA.pdf). Works well with SimpleEstimator, too.
### KeepEverythingExtractor
Dummy extractor which marks everything as content. Should return the input text. Use this to double-check that your problem is within a particular Extractor or somewhere else.
### NumWordsRulesExtractor
A quite generic full-text extractor solely based upon the number of words per block (the current, the previous and the next block).
## Notes
### Getting Content from URLs
While BoilerPy3 provides `extractor.*_from_url()` methods as a convenience, these are intended for testing only. For more robust functionality, in addition to full control over the request itself, it is strongly recommended to use the [Requests package](https://docs.python-requests.org/) instead, calling `extractor.get_content()` with the resulting HTML.
```python
import requests
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# Make request to URL
resp = requests.get('http://example.com/')
# Pass HTML to Extractor
content = extractor.get_content(resp.text)
```
%package -n python3-boilerpy3
Summary: Python port of Boilerpipe, for HTML boilerplate removal and text extraction
Provides: python-boilerpy3
BuildRequires: python3-devel
BuildRequires: python3-setuptools
BuildRequires: python3-pip
%description -n python3-boilerpy3
# BoilerPy3
## About
BoilerPy3 is a native Python [port](https://github.com/natural/java2python) of Christian Kohlschütter's [Boilerpipe](https://github.com/kohlschutter/boilerpipe) library, released under the Apache 2.0 Licence.
This package is based on [sammyer's](https://github.com/sammyer) [BoilerPy](https://github.com/sammyer/BoilerPy), specifically [mercuree's](https://github.com/mercuree) [Python3-compatible fork](https://github.com/mercuree/BoilerPy). This fork updates the codebase to be more Pythonic (proper attribute access, docstrings, type-hinting, snake case, etc.) and make use Python 3.6 features (f-strings), in addition to switching testing frameworks from Unittest to PyTest.
**Note**: This package is based on Boilerpipe 1.2 (at or before [this commit](https://github.com/kohlschutter/boilerpipe/tree/b0816590340f4317f500c64565b23beb4fb9a827)), as that's when the code was originally ported to Python. I experimented with updating the code to match Boilerpipe 1.3, however because it performed worse in my tests, I ultimately decided to leave it at 1.2-equivalent.
## Installation
To install the latest version from PyPI, execute:
```shell
pip install boilerpy3
```
If you'd like to try out any unreleased features you can install directly from GitHub like so:
```shell
pip install git+https://github.com/jmriebold/BoilerPy3
```
## Usage
### Text Extraction
The top-level interfaces are the Extractors. Use the `get_content()` methods to extract the filtered text.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_content_from_url('http://example.com/')
# From a file
content = extractor.get_content_from_file('tests/test.html')
# From raw HTML
content = extractor.get_content('Example
')
```
### Marked HTML Extraction
To extract the HTML chunks containing filtered text, use the `get_marked_html()` methods.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_marked_html_from_url('http://example.com/')
# From a file
content = extractor.get_marked_html_from_file('tests/test.html')
# From raw HTML
content = extractor.get_marked_html('Example
')
```
### Other
Alternatively, use `get_doc()` to return a Boilerpipe document from which you can get more detailed information.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
doc = extractor.get_doc_from_url('http://example.com/')
content = doc.content
title = doc.title
```
## Extractors
All extractors have a `raise_on_failure` parameter (defaults to `True`). When set to `False`, the `Extractor` will handle exceptions raised during text extraction and return any text that was successfully extracted. Leaving this at the default setting may be useful if you want to fall back to another algorithm in the event of an error.
### DefaultExtractor
Usually worse than ArticleExtractor, but simpler/no heuristics. A quite generic full-text extractor.
### ArticleExtractor
A full-text extractor which is tuned towards news articles. In this scenario it achieves higher accuracy than DefaultExtractor. Works very well for most types of Article-like HTML.
### ArticleSentencesExtractor
A full-text extractor which is tuned towards extracting sentences from news articles.
### LargestContentExtractor
A full-text extractor which extracts the largest text component of a page. For news articles, it may perform better than the DefaultExtractor but usually worse than ArticleExtractor
### CanolaExtractor
A full-text extractor trained on [krdwrd](http://krdwrd.org) [Canola](https://krdwrd.org/trac/attachment/wiki/Corpora/Canola/CANOLA.pdf). Works well with SimpleEstimator, too.
### KeepEverythingExtractor
Dummy extractor which marks everything as content. Should return the input text. Use this to double-check that your problem is within a particular Extractor or somewhere else.
### NumWordsRulesExtractor
A quite generic full-text extractor solely based upon the number of words per block (the current, the previous and the next block).
## Notes
### Getting Content from URLs
While BoilerPy3 provides `extractor.*_from_url()` methods as a convenience, these are intended for testing only. For more robust functionality, in addition to full control over the request itself, it is strongly recommended to use the [Requests package](https://docs.python-requests.org/) instead, calling `extractor.get_content()` with the resulting HTML.
```python
import requests
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# Make request to URL
resp = requests.get('http://example.com/')
# Pass HTML to Extractor
content = extractor.get_content(resp.text)
```
%package help
Summary: Development documents and examples for boilerpy3
Provides: python3-boilerpy3-doc
%description help
# BoilerPy3
## About
BoilerPy3 is a native Python [port](https://github.com/natural/java2python) of Christian Kohlschütter's [Boilerpipe](https://github.com/kohlschutter/boilerpipe) library, released under the Apache 2.0 Licence.
This package is based on [sammyer's](https://github.com/sammyer) [BoilerPy](https://github.com/sammyer/BoilerPy), specifically [mercuree's](https://github.com/mercuree) [Python3-compatible fork](https://github.com/mercuree/BoilerPy). This fork updates the codebase to be more Pythonic (proper attribute access, docstrings, type-hinting, snake case, etc.) and make use Python 3.6 features (f-strings), in addition to switching testing frameworks from Unittest to PyTest.
**Note**: This package is based on Boilerpipe 1.2 (at or before [this commit](https://github.com/kohlschutter/boilerpipe/tree/b0816590340f4317f500c64565b23beb4fb9a827)), as that's when the code was originally ported to Python. I experimented with updating the code to match Boilerpipe 1.3, however because it performed worse in my tests, I ultimately decided to leave it at 1.2-equivalent.
## Installation
To install the latest version from PyPI, execute:
```shell
pip install boilerpy3
```
If you'd like to try out any unreleased features you can install directly from GitHub like so:
```shell
pip install git+https://github.com/jmriebold/BoilerPy3
```
## Usage
### Text Extraction
The top-level interfaces are the Extractors. Use the `get_content()` methods to extract the filtered text.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_content_from_url('http://example.com/')
# From a file
content = extractor.get_content_from_file('tests/test.html')
# From raw HTML
content = extractor.get_content('Example
')
```
### Marked HTML Extraction
To extract the HTML chunks containing filtered text, use the `get_marked_html()` methods.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# From a URL
content = extractor.get_marked_html_from_url('http://example.com/')
# From a file
content = extractor.get_marked_html_from_file('tests/test.html')
# From raw HTML
content = extractor.get_marked_html('Example
')
```
### Other
Alternatively, use `get_doc()` to return a Boilerpipe document from which you can get more detailed information.
```python
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
doc = extractor.get_doc_from_url('http://example.com/')
content = doc.content
title = doc.title
```
## Extractors
All extractors have a `raise_on_failure` parameter (defaults to `True`). When set to `False`, the `Extractor` will handle exceptions raised during text extraction and return any text that was successfully extracted. Leaving this at the default setting may be useful if you want to fall back to another algorithm in the event of an error.
### DefaultExtractor
Usually worse than ArticleExtractor, but simpler/no heuristics. A quite generic full-text extractor.
### ArticleExtractor
A full-text extractor which is tuned towards news articles. In this scenario it achieves higher accuracy than DefaultExtractor. Works very well for most types of Article-like HTML.
### ArticleSentencesExtractor
A full-text extractor which is tuned towards extracting sentences from news articles.
### LargestContentExtractor
A full-text extractor which extracts the largest text component of a page. For news articles, it may perform better than the DefaultExtractor but usually worse than ArticleExtractor
### CanolaExtractor
A full-text extractor trained on [krdwrd](http://krdwrd.org) [Canola](https://krdwrd.org/trac/attachment/wiki/Corpora/Canola/CANOLA.pdf). Works well with SimpleEstimator, too.
### KeepEverythingExtractor
Dummy extractor which marks everything as content. Should return the input text. Use this to double-check that your problem is within a particular Extractor or somewhere else.
### NumWordsRulesExtractor
A quite generic full-text extractor solely based upon the number of words per block (the current, the previous and the next block).
## Notes
### Getting Content from URLs
While BoilerPy3 provides `extractor.*_from_url()` methods as a convenience, these are intended for testing only. For more robust functionality, in addition to full control over the request itself, it is strongly recommended to use the [Requests package](https://docs.python-requests.org/) instead, calling `extractor.get_content()` with the resulting HTML.
```python
import requests
from boilerpy3 import extractors
extractor = extractors.ArticleExtractor()
# Make request to URL
resp = requests.get('http://example.com/')
# Pass HTML to Extractor
content = extractor.get_content(resp.text)
```
%prep
%autosetup -n boilerpy3-1.0.6
%build
%py3_build
%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .
%files -n python3-boilerpy3 -f filelist.lst
%dir %{python3_sitelib}/*
%files help -f doclist.lst
%{_docdir}/*
%changelog
* Thu Jun 08 2023 Python_Bot - 1.0.6-1
- Package Spec generated