diff options
Diffstat (limited to 'python-tbtrim.spec')
| -rw-r--r-- | python-tbtrim.spec | 231 |
1 files changed, 231 insertions, 0 deletions
diff --git a/python-tbtrim.spec b/python-tbtrim.spec new file mode 100644 index 0000000..3f1ef15 --- /dev/null +++ b/python-tbtrim.spec @@ -0,0 +1,231 @@ +%global _empty_manifest_terminate_build 0 +Name: python-tbtrim +Version: 0.3.1 +Release: 1 +Summary: A utility to trim Python traceback information. +License: MIT +URL: https://github.com/gousaiyang/tbtrim +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/85/62/89756f5d2d61691591c4293fd4cc1fbb3aab1466251c7319fe60dd08fb27/tbtrim-0.3.1.tar.gz +BuildArch: noarch + + +%description +# tbtrim + +[](https://pepy.tech/count/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://travis-ci.org/gousaiyang/tbtrim) + + +`tbtrim` is a utility to trim Python traceback information. By assigning user-refined [`sys.excepthook`](https://docs.python.org/3/library/sys.html#sys.excepthook), one can easily customize the behavior after an exception is raise and uncaught, and just before the interpreter prints out the given traceback and exception to `sys.stderr`. + +In a more human-readable way, `tbtrim` is to let you handle the last words of a program when it exits because of an exception. + +## Installation + +Simply run the following to install the current version from PyPI: + +```shell +$ pip install tbtrim +``` + +Or install the latest version from the git repository: + +```shell +git clone https://github.com/gousaiyang/tbtrim.git +cd tbtrim +pip install -e . +# and to update at any time +git pull +``` + +## Usage + +> **set_trim_rule**(*predicate*, *target*=BaseException, *exclude*=None, *strict*=False, *exception*=None) + +Set the rule for trimming traceback (will set `sys.excepthook` and `threading.excepthook` if available). + +You can determine whether to start trimming traceback items based on the filename (using `predicate`), and can choose to trim traceback only for some certain exceptions (using `target` and `exclude`). + +**Args:** + +- **predicate** (*function*): a function which takes one `str` parameter (the filename of a traceback item) and returns `bool` (returning `True` indicates that this traceback item and the following items should be trimmed) +- **target** (*class_or_tuple*): an exception or a tuple of exceptions may be given to trim traceback only for those exceptions +- **exclude** (*class_or_tuple*): an exception or a tuple of exceptions may be given to exclude them from traceback trimming +- **strict** (*bool*): indicate whether to check an exception against `target` and `exclude` in a strict mode (setting `True` uses `is` to check, `False` uses `issubclass` to check) +- **exception** (*class_or_tuple*): this is a deprecated alias of `exclude`, retained for backward compatibility + +> **clear_trim_rule**() + +Clear the rule for trimming traceback (restore the excepthooks). + + + + +%package -n python3-tbtrim +Summary: A utility to trim Python traceback information. +Provides: python-tbtrim +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-tbtrim +# tbtrim + +[](https://pepy.tech/count/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://travis-ci.org/gousaiyang/tbtrim) + + +`tbtrim` is a utility to trim Python traceback information. By assigning user-refined [`sys.excepthook`](https://docs.python.org/3/library/sys.html#sys.excepthook), one can easily customize the behavior after an exception is raise and uncaught, and just before the interpreter prints out the given traceback and exception to `sys.stderr`. + +In a more human-readable way, `tbtrim` is to let you handle the last words of a program when it exits because of an exception. + +## Installation + +Simply run the following to install the current version from PyPI: + +```shell +$ pip install tbtrim +``` + +Or install the latest version from the git repository: + +```shell +git clone https://github.com/gousaiyang/tbtrim.git +cd tbtrim +pip install -e . +# and to update at any time +git pull +``` + +## Usage + +> **set_trim_rule**(*predicate*, *target*=BaseException, *exclude*=None, *strict*=False, *exception*=None) + +Set the rule for trimming traceback (will set `sys.excepthook` and `threading.excepthook` if available). + +You can determine whether to start trimming traceback items based on the filename (using `predicate`), and can choose to trim traceback only for some certain exceptions (using `target` and `exclude`). + +**Args:** + +- **predicate** (*function*): a function which takes one `str` parameter (the filename of a traceback item) and returns `bool` (returning `True` indicates that this traceback item and the following items should be trimmed) +- **target** (*class_or_tuple*): an exception or a tuple of exceptions may be given to trim traceback only for those exceptions +- **exclude** (*class_or_tuple*): an exception or a tuple of exceptions may be given to exclude them from traceback trimming +- **strict** (*bool*): indicate whether to check an exception against `target` and `exclude` in a strict mode (setting `True` uses `is` to check, `False` uses `issubclass` to check) +- **exception** (*class_or_tuple*): this is a deprecated alias of `exclude`, retained for backward compatibility + +> **clear_trim_rule**() + +Clear the rule for trimming traceback (restore the excepthooks). + + + + +%package help +Summary: Development documents and examples for tbtrim +Provides: python3-tbtrim-doc +%description help +# tbtrim + +[](https://pepy.tech/count/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://pypi.org/project/tbtrim) +[](https://travis-ci.org/gousaiyang/tbtrim) + + +`tbtrim` is a utility to trim Python traceback information. By assigning user-refined [`sys.excepthook`](https://docs.python.org/3/library/sys.html#sys.excepthook), one can easily customize the behavior after an exception is raise and uncaught, and just before the interpreter prints out the given traceback and exception to `sys.stderr`. + +In a more human-readable way, `tbtrim` is to let you handle the last words of a program when it exits because of an exception. + +## Installation + +Simply run the following to install the current version from PyPI: + +```shell +$ pip install tbtrim +``` + +Or install the latest version from the git repository: + +```shell +git clone https://github.com/gousaiyang/tbtrim.git +cd tbtrim +pip install -e . +# and to update at any time +git pull +``` + +## Usage + +> **set_trim_rule**(*predicate*, *target*=BaseException, *exclude*=None, *strict*=False, *exception*=None) + +Set the rule for trimming traceback (will set `sys.excepthook` and `threading.excepthook` if available). + +You can determine whether to start trimming traceback items based on the filename (using `predicate`), and can choose to trim traceback only for some certain exceptions (using `target` and `exclude`). + +**Args:** + +- **predicate** (*function*): a function which takes one `str` parameter (the filename of a traceback item) and returns `bool` (returning `True` indicates that this traceback item and the following items should be trimmed) +- **target** (*class_or_tuple*): an exception or a tuple of exceptions may be given to trim traceback only for those exceptions +- **exclude** (*class_or_tuple*): an exception or a tuple of exceptions may be given to exclude them from traceback trimming +- **strict** (*bool*): indicate whether to check an exception against `target` and `exclude` in a strict mode (setting `True` uses `is` to check, `False` uses `issubclass` to check) +- **exception** (*class_or_tuple*): this is a deprecated alias of `exclude`, retained for backward compatibility + +> **clear_trim_rule**() + +Clear the rule for trimming traceback (restore the excepthooks). + + + + +%prep +%autosetup -n tbtrim-0.3.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-tbtrim -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu Mar 09 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3.1-1 +- Package Spec generated |