From f6266103a1015374748ee2d9010e659673426f2c Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Fri, 9 Jun 2023 04:09:54 +0000 Subject: automatic import of python-bb-rest-helper --- python-bb-rest-helper.spec | 201 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 201 insertions(+) create mode 100644 python-bb-rest-helper.spec (limited to 'python-bb-rest-helper.spec') diff --git a/python-bb-rest-helper.spec b/python-bb-rest-helper.spec new file mode 100644 index 0000000..b87097f --- /dev/null +++ b/python-bb-rest-helper.spec @@ -0,0 +1,201 @@ +%global _empty_manifest_terminate_build 0 +Name: python-Bb-rest-helper +Version: 3.0.0 +Release: 1 +Summary: A library to simplify requests to the Blackboard REST APIs for Anthology Blackboard products, alongside a bunch of convenience methods. +License: Other/Proprietary License +URL: https://github.com/JgregoriBb/Bb_rest_helper +Source0: https://mirrors.aliyun.com/pypi/web/packages/8b/05/6d07a6e491493375490bbbd5725953983c6df0a707ef122f97d715f62ee1/Bb_rest_helper-3.0.0.tar.gz +BuildArch: noarch + + +%description +# Bb_rest_helper + +This library is intended to explore Blackboard´s REST APIs and to help create POCs for integrations. **Please note this tool is not oficially supported by Anthology and no warranties of any kind are provided.** + +## DESCRIPTION + +The Bb Rest Helper includes 4 classes to simpilfy common API operations with Blackboard APIs; + +1. **Get_Config.** This class is used to get configuration variables (url,key,secret)from an external configuration file in Json format. If you are authenticating for more than one API (i.e. Learn and Collaborate) you will need separate configuration files (i.e. learn_config.json and collab_config.json). + +2. **Auth_Helper.** This class is used to get the token that then will be used in the API calls. Provides different methods for the different APIs. + +3. **Bb_Requests.** This class is used to simplify calls to the Blackboard Rest APIs. Provides methods for GET, POST, PUT, PATCH and DELETE requests. It also provides some other convenience methods to upload and download files from Blackboard Learn. + +4. **Bb_Utils.** A set of convenience functions (Logging, printing...), this will be extended over time. + +## Changes in V3 --Current version. + +>⚠️ **DEPRECATION NOTE FOR COLLABORATE RELATED FEATURES IN BB REST HELPER LIBRARY** +>Blackboard Collaborate has been aquired by Class technologies in June 2022. The product is now "Class collaborate" and no longer part of the Anthology portfolio. All methods and documentation references to Collaborate have now been removed for V3. If you still need those, consider using a previous version of the library (2.0.5) but please note that functionality as deprecated. + +>⚠️ **REMOVAL OF THE ALLY HELPER CLASS** +>A decision was made to remove the Ally helper class in order to keep the library generalistic and more manageable. This will likely published as a separate repository in the future. + +## Main features in this release + +1. Documentation has been updated and moved to the wiki in github. An effort has been made to provide better and more clear documentation, also making sure that only one version has to be maintained. +2. Includes **Unittest tests** to ensure that the code will not break due to changes and updates in the library. Tests are run before each commit. +3. Improvements to the **Auth_Helper** method to automatically request a new token upon expiration.While this will not affect many use cases, it is important for scripts that take longer to run, just note that it will be needed to call the **learn_auth** frequently. A new token will only be requested if the previous one is 1 second from expiring. +4. Implements **log rotation** to avoid log files affecting script performance in long runs. +5. Implements **connection check**. This comes in handy to pause scripts when connectivty is lost. +6. Added methods to **write and read csv files** in **Bb_utils**. These use the Python csv methods in the standard library. +7. Updated the **starter template** and provided an **starter notebook** for jupyter. +8. As part of this release a **github repository template** is provided to make starting a new project easy and convenient. +9. Provides fixes and updates for different methods in the library, these are + * Fix a bug in Bb_PUT + * Update **check_course_id** to use library methods instead of using requests directly + * Update **learn_convert_external_id** to use library methods instead of using requests directly + + +## Usage + +Find the documentation and examples for this library in the [wiki](https://github.com/JgregoriBb/Bb_rest_helper/wiki) + + +%package -n python3-Bb-rest-helper +Summary: A library to simplify requests to the Blackboard REST APIs for Anthology Blackboard products, alongside a bunch of convenience methods. +Provides: python-Bb-rest-helper +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-Bb-rest-helper +# Bb_rest_helper + +This library is intended to explore Blackboard´s REST APIs and to help create POCs for integrations. **Please note this tool is not oficially supported by Anthology and no warranties of any kind are provided.** + +## DESCRIPTION + +The Bb Rest Helper includes 4 classes to simpilfy common API operations with Blackboard APIs; + +1. **Get_Config.** This class is used to get configuration variables (url,key,secret)from an external configuration file in Json format. If you are authenticating for more than one API (i.e. Learn and Collaborate) you will need separate configuration files (i.e. learn_config.json and collab_config.json). + +2. **Auth_Helper.** This class is used to get the token that then will be used in the API calls. Provides different methods for the different APIs. + +3. **Bb_Requests.** This class is used to simplify calls to the Blackboard Rest APIs. Provides methods for GET, POST, PUT, PATCH and DELETE requests. It also provides some other convenience methods to upload and download files from Blackboard Learn. + +4. **Bb_Utils.** A set of convenience functions (Logging, printing...), this will be extended over time. + +## Changes in V3 --Current version. + +>⚠️ **DEPRECATION NOTE FOR COLLABORATE RELATED FEATURES IN BB REST HELPER LIBRARY** +>Blackboard Collaborate has been aquired by Class technologies in June 2022. The product is now "Class collaborate" and no longer part of the Anthology portfolio. All methods and documentation references to Collaborate have now been removed for V3. If you still need those, consider using a previous version of the library (2.0.5) but please note that functionality as deprecated. + +>⚠️ **REMOVAL OF THE ALLY HELPER CLASS** +>A decision was made to remove the Ally helper class in order to keep the library generalistic and more manageable. This will likely published as a separate repository in the future. + +## Main features in this release + +1. Documentation has been updated and moved to the wiki in github. An effort has been made to provide better and more clear documentation, also making sure that only one version has to be maintained. +2. Includes **Unittest tests** to ensure that the code will not break due to changes and updates in the library. Tests are run before each commit. +3. Improvements to the **Auth_Helper** method to automatically request a new token upon expiration.While this will not affect many use cases, it is important for scripts that take longer to run, just note that it will be needed to call the **learn_auth** frequently. A new token will only be requested if the previous one is 1 second from expiring. +4. Implements **log rotation** to avoid log files affecting script performance in long runs. +5. Implements **connection check**. This comes in handy to pause scripts when connectivty is lost. +6. Added methods to **write and read csv files** in **Bb_utils**. These use the Python csv methods in the standard library. +7. Updated the **starter template** and provided an **starter notebook** for jupyter. +8. As part of this release a **github repository template** is provided to make starting a new project easy and convenient. +9. Provides fixes and updates for different methods in the library, these are + * Fix a bug in Bb_PUT + * Update **check_course_id** to use library methods instead of using requests directly + * Update **learn_convert_external_id** to use library methods instead of using requests directly + + +## Usage + +Find the documentation and examples for this library in the [wiki](https://github.com/JgregoriBb/Bb_rest_helper/wiki) + + +%package help +Summary: Development documents and examples for Bb-rest-helper +Provides: python3-Bb-rest-helper-doc +%description help +# Bb_rest_helper + +This library is intended to explore Blackboard´s REST APIs and to help create POCs for integrations. **Please note this tool is not oficially supported by Anthology and no warranties of any kind are provided.** + +## DESCRIPTION + +The Bb Rest Helper includes 4 classes to simpilfy common API operations with Blackboard APIs; + +1. **Get_Config.** This class is used to get configuration variables (url,key,secret)from an external configuration file in Json format. If you are authenticating for more than one API (i.e. Learn and Collaborate) you will need separate configuration files (i.e. learn_config.json and collab_config.json). + +2. **Auth_Helper.** This class is used to get the token that then will be used in the API calls. Provides different methods for the different APIs. + +3. **Bb_Requests.** This class is used to simplify calls to the Blackboard Rest APIs. Provides methods for GET, POST, PUT, PATCH and DELETE requests. It also provides some other convenience methods to upload and download files from Blackboard Learn. + +4. **Bb_Utils.** A set of convenience functions (Logging, printing...), this will be extended over time. + +## Changes in V3 --Current version. + +>⚠️ **DEPRECATION NOTE FOR COLLABORATE RELATED FEATURES IN BB REST HELPER LIBRARY** +>Blackboard Collaborate has been aquired by Class technologies in June 2022. The product is now "Class collaborate" and no longer part of the Anthology portfolio. All methods and documentation references to Collaborate have now been removed for V3. If you still need those, consider using a previous version of the library (2.0.5) but please note that functionality as deprecated. + +>⚠️ **REMOVAL OF THE ALLY HELPER CLASS** +>A decision was made to remove the Ally helper class in order to keep the library generalistic and more manageable. This will likely published as a separate repository in the future. + +## Main features in this release + +1. Documentation has been updated and moved to the wiki in github. An effort has been made to provide better and more clear documentation, also making sure that only one version has to be maintained. +2. Includes **Unittest tests** to ensure that the code will not break due to changes and updates in the library. Tests are run before each commit. +3. Improvements to the **Auth_Helper** method to automatically request a new token upon expiration.While this will not affect many use cases, it is important for scripts that take longer to run, just note that it will be needed to call the **learn_auth** frequently. A new token will only be requested if the previous one is 1 second from expiring. +4. Implements **log rotation** to avoid log files affecting script performance in long runs. +5. Implements **connection check**. This comes in handy to pause scripts when connectivty is lost. +6. Added methods to **write and read csv files** in **Bb_utils**. These use the Python csv methods in the standard library. +7. Updated the **starter template** and provided an **starter notebook** for jupyter. +8. As part of this release a **github repository template** is provided to make starting a new project easy and convenient. +9. Provides fixes and updates for different methods in the library, these are + * Fix a bug in Bb_PUT + * Update **check_course_id** to use library methods instead of using requests directly + * Update **learn_convert_external_id** to use library methods instead of using requests directly + + +## Usage + +Find the documentation and examples for this library in the [wiki](https://github.com/JgregoriBb/Bb_rest_helper/wiki) + + +%prep +%autosetup -n Bb_rest_helper-3.0.0 + +%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-Bb-rest-helper -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri Jun 09 2023 Python_Bot - 3.0.0-1 +- Package Spec generated -- cgit v1.2.3