diff options
author | CoprDistGit <infra@openeuler.org> | 2023-06-20 08:05:11 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-06-20 08:05:11 +0000 |
commit | cb337464ba132eb3bb824888bd2a52c2460455a5 (patch) | |
tree | 114ab3bb2a73c78f66eddeb1f4b06e1221902d15 | |
parent | 6920e8601364462bc64562e96e1ff2c9f15be195 (diff) |
automatic import of python-sutimeopeneuler20.03
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-sutime.spec | 529 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 531 insertions, 0 deletions
@@ -0,0 +1 @@ +/sutime-1.0.1.tar.gz diff --git a/python-sutime.spec b/python-sutime.spec new file mode 100644 index 0000000..8d33492 --- /dev/null +++ b/python-sutime.spec @@ -0,0 +1,529 @@ +%global _empty_manifest_terminate_build 0 +Name: python-sutime +Version: 1.0.1 +Release: 1 +Summary: A Python wrapper for Stanford CoreNLP's SUTime +License: GPL-3.0-or-later +URL: https://github.com/FraBle/python-sutime +Source0: https://mirrors.aliyun.com/pypi/web/packages/c6/c9/ddce2da756db37e990379efadf17e3117364a63c7ca97bc50a6824d5f0f0/sutime-1.0.1.tar.gz +BuildArch: noarch + +Requires: python3-JPype1 + +%description +# sutime +*Python wrapper for Stanford CoreNLP's [SUTime](http://nlp.stanford.edu/software/sutime.shtml) Java library.* +Docs are also hosted on [GitHub Pages](https://frable.github.io/python-sutime/). + +## Build Status + +#### Travis CI Builds +[](https://travis-ci.com/FraBle/python-sutime) + +#### PyPI +[](https://pypi.org/project/sutime/) +[](https://pypi.org/project/sutime/) + +#### Code Quality +[](https://app.codacy.com/gh/FraBle/python-sutime?utm_source=github.com&utm_medium=referral&utm_content=FraBle/python-sutime&utm_campaign=Badge_Grade) +[](https://scrutinizer-ci.com/g/FraBle/python-sutime/) +[](https://scan.coverity.com/projects/python-sutime) +[](https://codeclimate.com/github/FraBle/python-sutime/maintainability) +[](https://www.codefactor.io/repository/github/frable/python-sutime) +[](https://requires.io/github/FraBle/python-sutime/requirements/?branch=master) + +## Installation + +```bash +>> # Ideally, create a virtual environment before installing any dependencies +>> pip install sutime +>> # Install Java dependencies +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python3 -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') +``` + +Append `-P spanish` to the `mvn` command to include the Spanish language model. + +## Supported Languages + +SUTime currently supports only English, British and Spanish ([Source](https://github.com/stanfordnlp/CoreNLP/tree/master/src/edu/stanford/nlp/time/rules)). +This Python wrapper is prepared to support the other CoreNLP languages (e.g. German) as well as soon as they get added to SUTime. +The following command can be used to download the language models for `arabic`, `chinese`, `english`, `french`, `german`, and `spanish`: + +```bash +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') -P <language> +``` + +*However, SUTime only supports a subset (default model and `spanish`) of CoreNLP's languages and the other language models will get ignored.* + +## Example + +```python +import json +from sutime import SUTime + +if __name__ == '__main__': + test_case = 'I need a desk for tomorrow from 2pm to 3pm' + sutime = SUTime(mark_time_ranges=True, include_range=True) + print(json.dumps(sutime.parse(test_case), sort_keys=True, indent=4)) +``` + +Result: + +```json +[ + { + "end": 26, + "start": 18, + "text": "tomorrow", + "timex-value": "2020-11-03", + "type": "DATE", + "value": "2020-11-03" + }, + { + "end": 42, + "start": 27, + "text": "from 2pm to 3pm", + "type": "DURATION", + "value": { + "begin": "T14:00", + "end": "T15:00" + } + } +] +``` + +Other examples can be found in the [test](https://github.com/FraBle/python-sutime/blob/master/sutime/test) directory. + +## Functions + +```python +SUTime( + jars: Optional[str] = None, + jvm_started: Optional[bool] = False, + mark_time_ranges: Optional[bool] = False, + include_range: Optional[bool] = False, + jvm_flags: Optional[List[str]] = None, + language: Optional[str] = 'english', +): + """ + Args: + jars (Optional[str]): Path to previously downloaded SUTime Java + dependencies. Defaults to False. + jvm_started (Optional[bool]): Flag to indicate that JVM has been + already started (with all Java dependencies loaded). Defaults + to False. + mark_time_ranges (Optional[bool]): SUTime flag for + sutime.markTimeRanges. Defaults to False. + "Whether or not to recognize time ranges such as 'July to + August'" + include_range (Optional[bool]): SUTime flag for + sutime.includeRange. Defaults to False. + "Whether or not to add range info to the TIMEX3 object" + jvm_flags (Optional[List[str]]): List of flags passed to JVM. For + example, this may be used to specify the maximum heap size + using '-Xmx'. Has no effect if `jvm_started` is set to True. + Defaults to None. + language (Optional[str]): Selected language. Currently supported + are: english (/en), british, spanish (/es). Defaults to + `english`. + """ + +sutime.parse(input_str: str, reference_date: Optional[str] = '') -> List[Dict]: + """Parse datetime information out of string input. + + It invokes the SUTimeWrapper.annotate() function in Java. + + Args: + input_str (str): The input as string that has to be parsed. + reference_date (Optional[str]): Optional reference data for SUTime. + Defaults to `''`. + + Returns: + A list of dicts with the result from the `SUTimeWrapper.annotate()` + call. + + Raises: + RuntimeError: An error occurs when CoreNLP is not loaded. + """ +``` + +## Credit + +- [The team behind Stanford CoreNLP](http://stanfordnlp.github.io/CoreNLP/) for their awesome work and tools for the NLP community +- [Luis Nell (Github: originell) and team](https://github.com/originell/jpype/) for maintaining JPype as interface between Python and Java + +## Contributions + +- [René Springer](https://github.com/r-springer): Support for reference date +- [Constantine Lignos](https://github.com/ConstantineLignos): Support for JVM flags, adoption of CircleCI 2.0, fix for mutable default argument, fix for test execution +- [Cole Robertson](https://github.com/cbjrobertson): Updated instructions, JAR requirements, and SUTime JAR imports +- [Ludovico Pestarino](https://github.com/arkeane): Modified json.loads for compatibility with json data (string handling) + +## License + +- GPLv3+ (check the LICENSE file) + + + +%package -n python3-sutime +Summary: A Python wrapper for Stanford CoreNLP's SUTime +Provides: python-sutime +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-sutime +# sutime +*Python wrapper for Stanford CoreNLP's [SUTime](http://nlp.stanford.edu/software/sutime.shtml) Java library.* +Docs are also hosted on [GitHub Pages](https://frable.github.io/python-sutime/). + +## Build Status + +#### Travis CI Builds +[](https://travis-ci.com/FraBle/python-sutime) + +#### PyPI +[](https://pypi.org/project/sutime/) +[](https://pypi.org/project/sutime/) + +#### Code Quality +[](https://app.codacy.com/gh/FraBle/python-sutime?utm_source=github.com&utm_medium=referral&utm_content=FraBle/python-sutime&utm_campaign=Badge_Grade) +[](https://scrutinizer-ci.com/g/FraBle/python-sutime/) +[](https://scan.coverity.com/projects/python-sutime) +[](https://codeclimate.com/github/FraBle/python-sutime/maintainability) +[](https://www.codefactor.io/repository/github/frable/python-sutime) +[](https://requires.io/github/FraBle/python-sutime/requirements/?branch=master) + +## Installation + +```bash +>> # Ideally, create a virtual environment before installing any dependencies +>> pip install sutime +>> # Install Java dependencies +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python3 -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') +``` + +Append `-P spanish` to the `mvn` command to include the Spanish language model. + +## Supported Languages + +SUTime currently supports only English, British and Spanish ([Source](https://github.com/stanfordnlp/CoreNLP/tree/master/src/edu/stanford/nlp/time/rules)). +This Python wrapper is prepared to support the other CoreNLP languages (e.g. German) as well as soon as they get added to SUTime. +The following command can be used to download the language models for `arabic`, `chinese`, `english`, `french`, `german`, and `spanish`: + +```bash +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') -P <language> +``` + +*However, SUTime only supports a subset (default model and `spanish`) of CoreNLP's languages and the other language models will get ignored.* + +## Example + +```python +import json +from sutime import SUTime + +if __name__ == '__main__': + test_case = 'I need a desk for tomorrow from 2pm to 3pm' + sutime = SUTime(mark_time_ranges=True, include_range=True) + print(json.dumps(sutime.parse(test_case), sort_keys=True, indent=4)) +``` + +Result: + +```json +[ + { + "end": 26, + "start": 18, + "text": "tomorrow", + "timex-value": "2020-11-03", + "type": "DATE", + "value": "2020-11-03" + }, + { + "end": 42, + "start": 27, + "text": "from 2pm to 3pm", + "type": "DURATION", + "value": { + "begin": "T14:00", + "end": "T15:00" + } + } +] +``` + +Other examples can be found in the [test](https://github.com/FraBle/python-sutime/blob/master/sutime/test) directory. + +## Functions + +```python +SUTime( + jars: Optional[str] = None, + jvm_started: Optional[bool] = False, + mark_time_ranges: Optional[bool] = False, + include_range: Optional[bool] = False, + jvm_flags: Optional[List[str]] = None, + language: Optional[str] = 'english', +): + """ + Args: + jars (Optional[str]): Path to previously downloaded SUTime Java + dependencies. Defaults to False. + jvm_started (Optional[bool]): Flag to indicate that JVM has been + already started (with all Java dependencies loaded). Defaults + to False. + mark_time_ranges (Optional[bool]): SUTime flag for + sutime.markTimeRanges. Defaults to False. + "Whether or not to recognize time ranges such as 'July to + August'" + include_range (Optional[bool]): SUTime flag for + sutime.includeRange. Defaults to False. + "Whether or not to add range info to the TIMEX3 object" + jvm_flags (Optional[List[str]]): List of flags passed to JVM. For + example, this may be used to specify the maximum heap size + using '-Xmx'. Has no effect if `jvm_started` is set to True. + Defaults to None. + language (Optional[str]): Selected language. Currently supported + are: english (/en), british, spanish (/es). Defaults to + `english`. + """ + +sutime.parse(input_str: str, reference_date: Optional[str] = '') -> List[Dict]: + """Parse datetime information out of string input. + + It invokes the SUTimeWrapper.annotate() function in Java. + + Args: + input_str (str): The input as string that has to be parsed. + reference_date (Optional[str]): Optional reference data for SUTime. + Defaults to `''`. + + Returns: + A list of dicts with the result from the `SUTimeWrapper.annotate()` + call. + + Raises: + RuntimeError: An error occurs when CoreNLP is not loaded. + """ +``` + +## Credit + +- [The team behind Stanford CoreNLP](http://stanfordnlp.github.io/CoreNLP/) for their awesome work and tools for the NLP community +- [Luis Nell (Github: originell) and team](https://github.com/originell/jpype/) for maintaining JPype as interface between Python and Java + +## Contributions + +- [René Springer](https://github.com/r-springer): Support for reference date +- [Constantine Lignos](https://github.com/ConstantineLignos): Support for JVM flags, adoption of CircleCI 2.0, fix for mutable default argument, fix for test execution +- [Cole Robertson](https://github.com/cbjrobertson): Updated instructions, JAR requirements, and SUTime JAR imports +- [Ludovico Pestarino](https://github.com/arkeane): Modified json.loads for compatibility with json data (string handling) + +## License + +- GPLv3+ (check the LICENSE file) + + + +%package help +Summary: Development documents and examples for sutime +Provides: python3-sutime-doc +%description help +# sutime +*Python wrapper for Stanford CoreNLP's [SUTime](http://nlp.stanford.edu/software/sutime.shtml) Java library.* +Docs are also hosted on [GitHub Pages](https://frable.github.io/python-sutime/). + +## Build Status + +#### Travis CI Builds +[](https://travis-ci.com/FraBle/python-sutime) + +#### PyPI +[](https://pypi.org/project/sutime/) +[](https://pypi.org/project/sutime/) + +#### Code Quality +[](https://app.codacy.com/gh/FraBle/python-sutime?utm_source=github.com&utm_medium=referral&utm_content=FraBle/python-sutime&utm_campaign=Badge_Grade) +[](https://scrutinizer-ci.com/g/FraBle/python-sutime/) +[](https://scan.coverity.com/projects/python-sutime) +[](https://codeclimate.com/github/FraBle/python-sutime/maintainability) +[](https://www.codefactor.io/repository/github/frable/python-sutime) +[](https://requires.io/github/FraBle/python-sutime/requirements/?branch=master) + +## Installation + +```bash +>> # Ideally, create a virtual environment before installing any dependencies +>> pip install sutime +>> # Install Java dependencies +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python3 -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') +``` + +Append `-P spanish` to the `mvn` command to include the Spanish language model. + +## Supported Languages + +SUTime currently supports only English, British and Spanish ([Source](https://github.com/stanfordnlp/CoreNLP/tree/master/src/edu/stanford/nlp/time/rules)). +This Python wrapper is prepared to support the other CoreNLP languages (e.g. German) as well as soon as they get added to SUTime. +The following command can be used to download the language models for `arabic`, `chinese`, `english`, `french`, `german`, and `spanish`: + +```bash +>> mvn dependency:copy-dependencies -DoutputDirectory=./jars -f $(python -c 'import importlib; import pathlib; print(pathlib.Path(importlib.util.find_spec("sutime").origin).parent / "pom.xml")') -P <language> +``` + +*However, SUTime only supports a subset (default model and `spanish`) of CoreNLP's languages and the other language models will get ignored.* + +## Example + +```python +import json +from sutime import SUTime + +if __name__ == '__main__': + test_case = 'I need a desk for tomorrow from 2pm to 3pm' + sutime = SUTime(mark_time_ranges=True, include_range=True) + print(json.dumps(sutime.parse(test_case), sort_keys=True, indent=4)) +``` + +Result: + +```json +[ + { + "end": 26, + "start": 18, + "text": "tomorrow", + "timex-value": "2020-11-03", + "type": "DATE", + "value": "2020-11-03" + }, + { + "end": 42, + "start": 27, + "text": "from 2pm to 3pm", + "type": "DURATION", + "value": { + "begin": "T14:00", + "end": "T15:00" + } + } +] +``` + +Other examples can be found in the [test](https://github.com/FraBle/python-sutime/blob/master/sutime/test) directory. + +## Functions + +```python +SUTime( + jars: Optional[str] = None, + jvm_started: Optional[bool] = False, + mark_time_ranges: Optional[bool] = False, + include_range: Optional[bool] = False, + jvm_flags: Optional[List[str]] = None, + language: Optional[str] = 'english', +): + """ + Args: + jars (Optional[str]): Path to previously downloaded SUTime Java + dependencies. Defaults to False. + jvm_started (Optional[bool]): Flag to indicate that JVM has been + already started (with all Java dependencies loaded). Defaults + to False. + mark_time_ranges (Optional[bool]): SUTime flag for + sutime.markTimeRanges. Defaults to False. + "Whether or not to recognize time ranges such as 'July to + August'" + include_range (Optional[bool]): SUTime flag for + sutime.includeRange. Defaults to False. + "Whether or not to add range info to the TIMEX3 object" + jvm_flags (Optional[List[str]]): List of flags passed to JVM. For + example, this may be used to specify the maximum heap size + using '-Xmx'. Has no effect if `jvm_started` is set to True. + Defaults to None. + language (Optional[str]): Selected language. Currently supported + are: english (/en), british, spanish (/es). Defaults to + `english`. + """ + +sutime.parse(input_str: str, reference_date: Optional[str] = '') -> List[Dict]: + """Parse datetime information out of string input. + + It invokes the SUTimeWrapper.annotate() function in Java. + + Args: + input_str (str): The input as string that has to be parsed. + reference_date (Optional[str]): Optional reference data for SUTime. + Defaults to `''`. + + Returns: + A list of dicts with the result from the `SUTimeWrapper.annotate()` + call. + + Raises: + RuntimeError: An error occurs when CoreNLP is not loaded. + """ +``` + +## Credit + +- [The team behind Stanford CoreNLP](http://stanfordnlp.github.io/CoreNLP/) for their awesome work and tools for the NLP community +- [Luis Nell (Github: originell) and team](https://github.com/originell/jpype/) for maintaining JPype as interface between Python and Java + +## Contributions + +- [René Springer](https://github.com/r-springer): Support for reference date +- [Constantine Lignos](https://github.com/ConstantineLignos): Support for JVM flags, adoption of CircleCI 2.0, fix for mutable default argument, fix for test execution +- [Cole Robertson](https://github.com/cbjrobertson): Updated instructions, JAR requirements, and SUTime JAR imports +- [Ludovico Pestarino](https://github.com/arkeane): Modified json.loads for compatibility with json data (string handling) + +## License + +- GPLv3+ (check the LICENSE file) + + + +%prep +%autosetup -n sutime-1.0.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-sutime -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 1.0.1-1 +- Package Spec generated @@ -0,0 +1 @@ +0a2521a81c2c2adc15984ac75822e355 sutime-1.0.1.tar.gz |