diff options
author | CoprDistGit <infra@openeuler.org> | 2023-04-11 21:08:09 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-04-11 21:08:09 +0000 |
commit | e9ff566159713cc0eac3707d24eb39636c75e0c5 (patch) | |
tree | 417e867b4f1e1d121645fccbde87dc117b692b4f | |
parent | cfbd06a29c8cc212ba1e9b655c6ef88b8aadad9f (diff) |
automatic import of python-referer-parser
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-referer-parser.spec | 366 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 368 insertions, 0 deletions
@@ -0,0 +1 @@ +/referer-parser-0.4.1.tar.gz diff --git a/python-referer-parser.spec b/python-referer-parser.spec new file mode 100644 index 0000000..996a49b --- /dev/null +++ b/python-referer-parser.spec @@ -0,0 +1,366 @@ +%global _empty_manifest_terminate_build 0 +Name: python-referer-parser +Version: 0.4.1 +Release: 1 +Summary: please add a summary manually as the author left a blank one +License: None +URL: https://pypi.org/project/referer-parser/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/b1/eb/8ca613509079c662b7521118e097b11ea232090dd5c0e16c1201dcc9ce16/referer-parser-0.4.1.tar.gz +BuildArch: noarch + + +%description +# referer-parser Python library + +This is the Python implementation of [referer-parser] [referer-parser], the library for extracting search marketing data from referer _(sic)_ URLs. + +The implementation uses the shared 'database' of known referers found in [`referers.yml`] [referers-yml]. + +The Python version of referer-parser is maintained by [Don Spaulding] [donspaulding]. + +## Installation + + $ pip install referer_parser + +## Usage + +Create a new instance of a Referer object by passing in the url you want to parse: + +```python +from referer_parser import Referer + +referer_url = 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari' + +r = Referer(referer_url) +``` + +The `r` variable now holds a Referer instance. The important attributes are: + +```python +print(r.known) # True +print(r.referer) # 'Google' +print(r.medium) # 'search' +print(r.search_parameter) # 'q' +print(r.search_term) # 'gateway oracle cards denise linn' +print(r.uri) # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='') +``` + +Optionally, pass in the current URL as well, to handle internal referers + +```python +from referer_parser import Referer + +referer_url = 'http://www.snowplowanalytics.com/about/team' +curr_url = 'http://www.snowplowanalytics.com/account/profile' + +r = Referer(referer_url, curr_url) +``` + +The attributes would be + +```python +print(r.known) # True +print(r.referer) # None +print(r.medium) # 'internal' +print(r.search_parameter) # None +print(r.search_term) # None +print(r.uri) # ParseResult(scheme='http', netloc='www.snowplowanalytics.com', path='/about/team', params='', query='', fragment='') +``` + +The `uri` attribute is an instance of ParseResult from the standard library's `urlparse` module. + + +## Contributing + +1. Fork it +2. Create your feature branch (`git checkout -b my-new-feature`) +3. Commit your changes (`git commit -am 'Add some feature'`) +4. Push to the branch (`git push origin my-new-feature`) +5. Create new Pull Request + + +## Distribution +The distribution process for Python looks like this: + + $ ./sync_data.py + $ # Make changes to codebase. + $ # Bump version number in setup.py + $ pushd python + $ python setup.py sdist bdist_wheel --universal + $ twine upload dist/referer-parser-X.Y.Z.tar.gz + $ popd + +## Copyright and license + +The referer-parser Python library is copyright 2012-2016 Don Spaulding. + +Licensed under the [Apache License, Version 2.0] [license] (the "License"); +you may not use this software except in compliance with the License. + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +[referer-parser]: https://github.com/snowplow/referer-parser +[referers-yml]: https://github.com/snowplow/referer-parser/blob/master/referers.yml + +[donspaulding]: https://github.com/donspaulding + +[license]: http://www.apache.org/licenses/LICENSE-2.0 + +%package -n python3-referer-parser +Summary: please add a summary manually as the author left a blank one +Provides: python-referer-parser +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-referer-parser +# referer-parser Python library + +This is the Python implementation of [referer-parser] [referer-parser], the library for extracting search marketing data from referer _(sic)_ URLs. + +The implementation uses the shared 'database' of known referers found in [`referers.yml`] [referers-yml]. + +The Python version of referer-parser is maintained by [Don Spaulding] [donspaulding]. + +## Installation + + $ pip install referer_parser + +## Usage + +Create a new instance of a Referer object by passing in the url you want to parse: + +```python +from referer_parser import Referer + +referer_url = 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari' + +r = Referer(referer_url) +``` + +The `r` variable now holds a Referer instance. The important attributes are: + +```python +print(r.known) # True +print(r.referer) # 'Google' +print(r.medium) # 'search' +print(r.search_parameter) # 'q' +print(r.search_term) # 'gateway oracle cards denise linn' +print(r.uri) # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='') +``` + +Optionally, pass in the current URL as well, to handle internal referers + +```python +from referer_parser import Referer + +referer_url = 'http://www.snowplowanalytics.com/about/team' +curr_url = 'http://www.snowplowanalytics.com/account/profile' + +r = Referer(referer_url, curr_url) +``` + +The attributes would be + +```python +print(r.known) # True +print(r.referer) # None +print(r.medium) # 'internal' +print(r.search_parameter) # None +print(r.search_term) # None +print(r.uri) # ParseResult(scheme='http', netloc='www.snowplowanalytics.com', path='/about/team', params='', query='', fragment='') +``` + +The `uri` attribute is an instance of ParseResult from the standard library's `urlparse` module. + + +## Contributing + +1. Fork it +2. Create your feature branch (`git checkout -b my-new-feature`) +3. Commit your changes (`git commit -am 'Add some feature'`) +4. Push to the branch (`git push origin my-new-feature`) +5. Create new Pull Request + + +## Distribution +The distribution process for Python looks like this: + + $ ./sync_data.py + $ # Make changes to codebase. + $ # Bump version number in setup.py + $ pushd python + $ python setup.py sdist bdist_wheel --universal + $ twine upload dist/referer-parser-X.Y.Z.tar.gz + $ popd + +## Copyright and license + +The referer-parser Python library is copyright 2012-2016 Don Spaulding. + +Licensed under the [Apache License, Version 2.0] [license] (the "License"); +you may not use this software except in compliance with the License. + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +[referer-parser]: https://github.com/snowplow/referer-parser +[referers-yml]: https://github.com/snowplow/referer-parser/blob/master/referers.yml + +[donspaulding]: https://github.com/donspaulding + +[license]: http://www.apache.org/licenses/LICENSE-2.0 + +%package help +Summary: Development documents and examples for referer-parser +Provides: python3-referer-parser-doc +%description help +# referer-parser Python library + +This is the Python implementation of [referer-parser] [referer-parser], the library for extracting search marketing data from referer _(sic)_ URLs. + +The implementation uses the shared 'database' of known referers found in [`referers.yml`] [referers-yml]. + +The Python version of referer-parser is maintained by [Don Spaulding] [donspaulding]. + +## Installation + + $ pip install referer_parser + +## Usage + +Create a new instance of a Referer object by passing in the url you want to parse: + +```python +from referer_parser import Referer + +referer_url = 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari' + +r = Referer(referer_url) +``` + +The `r` variable now holds a Referer instance. The important attributes are: + +```python +print(r.known) # True +print(r.referer) # 'Google' +print(r.medium) # 'search' +print(r.search_parameter) # 'q' +print(r.search_term) # 'gateway oracle cards denise linn' +print(r.uri) # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='') +``` + +Optionally, pass in the current URL as well, to handle internal referers + +```python +from referer_parser import Referer + +referer_url = 'http://www.snowplowanalytics.com/about/team' +curr_url = 'http://www.snowplowanalytics.com/account/profile' + +r = Referer(referer_url, curr_url) +``` + +The attributes would be + +```python +print(r.known) # True +print(r.referer) # None +print(r.medium) # 'internal' +print(r.search_parameter) # None +print(r.search_term) # None +print(r.uri) # ParseResult(scheme='http', netloc='www.snowplowanalytics.com', path='/about/team', params='', query='', fragment='') +``` + +The `uri` attribute is an instance of ParseResult from the standard library's `urlparse` module. + + +## Contributing + +1. Fork it +2. Create your feature branch (`git checkout -b my-new-feature`) +3. Commit your changes (`git commit -am 'Add some feature'`) +4. Push to the branch (`git push origin my-new-feature`) +5. Create new Pull Request + + +## Distribution +The distribution process for Python looks like this: + + $ ./sync_data.py + $ # Make changes to codebase. + $ # Bump version number in setup.py + $ pushd python + $ python setup.py sdist bdist_wheel --universal + $ twine upload dist/referer-parser-X.Y.Z.tar.gz + $ popd + +## Copyright and license + +The referer-parser Python library is copyright 2012-2016 Don Spaulding. + +Licensed under the [Apache License, Version 2.0] [license] (the "License"); +you may not use this software except in compliance with the License. + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +[referer-parser]: https://github.com/snowplow/referer-parser +[referers-yml]: https://github.com/snowplow/referer-parser/blob/master/referers.yml + +[donspaulding]: https://github.com/donspaulding + +[license]: http://www.apache.org/licenses/LICENSE-2.0 + +%prep +%autosetup -n referer-parser-0.4.1 + +%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-referer-parser -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 0.4.1-1 +- Package Spec generated @@ -0,0 +1 @@ +b8a4787d87fb832e7236b2e8af3f19be referer-parser-0.4.1.tar.gz |