isoc-ams 0.1.0__tar.gz → 0.1.2__tar.gz

{isoc_ams-0.1.0 → isoc_ams-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: isoc-ams
-Version: 0.1.0
+Version: 0.1.2
 Summary: A Python 3 module to cope with ISOC-AMS.
 Author-email: Klaus Birkenbihl <klaus.birkenbihl@isoc.de>
 Maintainer: Klaus Birkenbihl
@@ -13,7 +13,7 @@ Project-URL: Home, https://github.com/birkenbihl/isoc-ams
 
 # isoc-ams
 
-A Python Interface to access the 'Advanced Members Administration System' (AMS) of the 'Internet Society' (ISOC). This is especially useful for ISOC Chapter Admins who want to synchronize their Chapter Database with AMS (semi)automatically.
+A Python Interface to access the 'Advanced Members Administration System' (AMS) of the 'Internet Society' (ISOC). This is especially useful for ISOC Chapter Admins who want to synchronize their own Chapter Database with AMS (semi)automatically.
 
 After 10 years+  of sorrow, millions minutes of waiting for answers from the AMS web interface, tons of useless clicks, many (in fact) rejected requests to provide an API access: the author decided to build an API himself. Even if it might not be more than a demonstrator for the functionality needed. Anyhow (see below): for now it is running on a weekly basis doing a great job in avoiding manual work. 
 
@@ -43,8 +43,20 @@ Don't forget: it takes time and you may see many kinds of errors. Often the cure
 Anyhow, after running it some time now it seems to work better than expected.
 So here we go:
 
-## Installation
+## Preparing
+### Prerequisites
+isoc-ams was tested under Linux (Ubuntu 22.04) and Windows 11.
 
+**While rather stable under Linux, Windows 11 produced mixed results. Under powershell you may need to set the ExecutionPolicy**
+```
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+Firefox or Chrome Webbrowser with Webdriver (usually included) is required.
+
+A full installation of Python 3.9+ is required.
+
+### Installation
 Install (or update) isoc-ams with pip.
 
 ```bash
@@ -71,9 +83,9 @@ Output:
 Username:xyz
 Password: 
 
-************************************* 
-2025-07-13 19:25:54 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-13 19:25:54 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-13 19:25:54 - INFO - logging in 
 
@@ -86,9 +98,9 @@ OK, probably your fault. After fixing:
 Username: xxx
 Password: 
 
-************************************* 
-2025-07-13 19:26:27 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-13 19:26:27 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-13 19:26:27 - INFO - logging in 
 2025-07-13 19:26:45 - INFO - Now on Chapter Leader portal 
@@ -143,9 +155,9 @@ Output:
 Username: xxx
 Password: 
 
-******************************************** 
-2025-07-15 10:35:57 - INFO - START DRYRUN 
-******************************************** 
+****************************************************************** 
+2025-07-15 10:35:57 - INFO - START DRYRUN: Webdriver is firefox 
+*****************************************************************
 
 2025-07-15 10:35:57 - INFO - logging in 
 2025-07-15 10:36:12 - INFO - Now on Chapter Leader portal 
@@ -202,9 +214,9 @@ isoc_ams unleashes its full power when used as API to make things happen without
 Here the output:
 ```
 
-************************************* 
-2025-07-15 14:13:36 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-15 14:13:30 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-15 14:13:36 - INFO - logging in 
 2025-07-15 14:13:53 - INFO - Now on Chapter Leader portal 
@@ -286,6 +298,6 @@ Thank you,
 
 Your ISOC.DE MAS support team
 
-See file [isoc_ams.html](https://github.com/birkenbihl/isoc-ams/blob/main/isoc_ams.html) for doc on the API interface.
+See file [isoc_ams.html](https://html-preview.github.io/?url=https://github.com/birkenbihl/isoc-ams/blob/main/isoc_ams.html) for doc on the API interface.
 
 

{isoc_ams-0.1.0 → isoc_ams-0.1.2}/README.md

@@ -1,7 +1,7 @@
 
 # isoc-ams
 
-A Python Interface to access the 'Advanced Members Administration System' (AMS) of the 'Internet Society' (ISOC). This is especially useful for ISOC Chapter Admins who want to synchronize their Chapter Database with AMS (semi)automatically.
+A Python Interface to access the 'Advanced Members Administration System' (AMS) of the 'Internet Society' (ISOC). This is especially useful for ISOC Chapter Admins who want to synchronize their own Chapter Database with AMS (semi)automatically.
 
 After 10 years+  of sorrow, millions minutes of waiting for answers from the AMS web interface, tons of useless clicks, many (in fact) rejected requests to provide an API access: the author decided to build an API himself. Even if it might not be more than a demonstrator for the functionality needed. Anyhow (see below): for now it is running on a weekly basis doing a great job in avoiding manual work. 
 
@@ -31,8 +31,20 @@ Don't forget: it takes time and you may see many kinds of errors. Often the cure
 Anyhow, after running it some time now it seems to work better than expected.
 So here we go:
 
-## Installation
+## Preparing
+### Prerequisites
+isoc-ams was tested under Linux (Ubuntu 22.04) and Windows 11.
 
+**While rather stable under Linux, Windows 11 produced mixed results. Under powershell you may need to set the ExecutionPolicy**
+```
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+Firefox or Chrome Webbrowser with Webdriver (usually included) is required.
+
+A full installation of Python 3.9+ is required.
+
+### Installation
 Install (or update) isoc-ams with pip.
 
 ```bash
@@ -59,9 +71,9 @@ Output:
 Username:xyz
 Password: 
 
-************************************* 
-2025-07-13 19:25:54 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-13 19:25:54 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-13 19:25:54 - INFO - logging in 
 
@@ -74,9 +86,9 @@ OK, probably your fault. After fixing:
 Username: xxx
 Password: 
 
-************************************* 
-2025-07-13 19:26:27 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-13 19:26:27 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-13 19:26:27 - INFO - logging in 
 2025-07-13 19:26:45 - INFO - Now on Chapter Leader portal 
@@ -131,9 +143,9 @@ Output:
 Username: xxx
 Password: 
 
-******************************************** 
-2025-07-15 10:35:57 - INFO - START DRYRUN 
-******************************************** 
+****************************************************************** 
+2025-07-15 10:35:57 - INFO - START DRYRUN: Webdriver is firefox 
+*****************************************************************
 
 2025-07-15 10:35:57 - INFO - logging in 
 2025-07-15 10:36:12 - INFO - Now on Chapter Leader portal 
@@ -190,9 +202,9 @@ isoc_ams unleashes its full power when used as API to make things happen without
 Here the output:
 ```
 
-************************************* 
-2025-07-15 14:13:36 - INFO - START 
-************************************* 
+*********************************************************** 
+2025-07-15 14:13:30 - INFO - START: Webdriver is firefox 
+*********************************************************** 
 
 2025-07-15 14:13:36 - INFO - logging in 
 2025-07-15 14:13:53 - INFO - Now on Chapter Leader portal 
@@ -274,5 +286,5 @@ Thank you,
 
 Your ISOC.DE MAS support team
 
-See file [isoc_ams.html](https://github.com/birkenbihl/isoc-ams/blob/main/isoc_ams.html) for doc on the API interface.
+See file [isoc_ams.html](https://html-preview.github.io/?url=https://github.com/birkenbihl/isoc-ams/blob/main/isoc_ams.html) for doc on the API interface.
 

{isoc_ams-0.1.0 → isoc_ams-0.1.2}/isoc_ams.py

@@ -85,8 +85,12 @@ CHANGELOG
     Version 0.1.0
         Improved logging
         minor bug fixes
+    Version 0.1.1
+        minor bug fixes
+    Version 0.1.2
+        eliminate not required checks in difference_from_expected()
 """
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 from selenium import webdriver
 from selenium.webdriver.common.by import By
@@ -232,13 +236,13 @@ ARGUMENTS
         _init_logging(logfile, debuglog)
         self._ams = _ISOC_AMS()
         if self._dryrun:
-            strong_msg("START DRYRUN")
+            strong_msg("START DRYRUN:", "Version:", __version__, "Webdriver is", _dr)
         else:
-            strong_msg("START")
+            strong_msg("START:", "Version:", __version__, "Webdriver is", _dr)
         self._ams.login((user, password))
         self._members_list = self._ams.build_members_list()
         self._pending_applications_list = self._ams.build_pending_applicants_list()
-
+        self.approve_list = self.delete_list = self.deny_list = None
 
     @property
     def members_list(self) -> dict:
@@ -298,6 +302,7 @@ ARGUMENTS
         """
         if type(delete_list) in (str, int):
             delete_list = [delete_list]
+        self.delete_list = delete_list
         for deletee in map(str, delete_list):
             if deletee in self._members_list:
                 deletee = str(deletee)
@@ -325,6 +330,7 @@ ARGUMENTS
         """
         if type(approve_list) in (int, str):
             approve_list = [approve_list]
+        self.approve_list = approve_list
         for approvee in map(str, approve_list):
             if approvee in self._pending_applications_list:
                 if approvee not in self._members_list:
@@ -358,6 +364,7 @@ ARGUMENTS
         """
         if type(deny_list) in (str, int):
             deny_list = [deny_list],
+        self.deny_list = deny_list
         for denyee in map(str, deny_list):
             if denyee in self._pending_applications_list:
                 if not self._dryrun:
@@ -404,29 +411,36 @@ RETURNS
             not_deleted = {}
             not_approved = {}
             not_removed_from_pending = {}
-            new_members_list = self._ams.build_members_list()
+
+            if self.approve_list or self.delete_list:
+                new_members_list = self._ams.build_members_list()
+            if self.deny_list or self.approve_list:
+                new_pending_applications_list = self._ams.build_pending_applicants_list()
+
             dlog("Check members list")
-            for nm in new_members_list:
-                if nm not in self._members_list:
-                    dlog(new_members_list[nm]["first name"],
-                         new_members_list[nm]["last name"],
-                         "("+nm+")",
-                         "was not deleted")
-                    not_deleted[nm] = new_members_list[nm]
-            for nm in self._members_list:
-                if nm not in new_members_list:
-                    dlog(self._members_list[nm]["first name"],
-                         self._members_list[nm]["last name"],
-                         "("+nm+")",
-                         "was not approved")
-                    not_approved[nm] = self._members_list[nm]
-            new_pending_applications_list = self._ams.build_pending_applicants_list()
-            for np in new_pending_applications_list:
-                if np not in self._pending_applications_list:
-                    dlog(self._members_list[nm]["name"],
-                         "("+nm+")",
-                         "was not removed from pending aoolications")
-                    not_removed_from_pending[np] = new_pending_applications_list[np]
+            if self.delete_list:
+                for nm in new_members_list:
+                    if nm not in self._members_list:
+                        dlog(new_members_list[nm]["first name"],
+                             new_members_list[nm]["last name"],
+                             "("+nm+")",
+                             "was not deleted")
+                        not_deleted[nm] = new_members_list[nm]
+            if self.approve_list:
+                for nm in self._members_list:
+                    if nm not in new_members_list:
+                        dlog(self._members_list[nm]["first name"],
+                             self._members_list[nm]["last name"],
+                             "("+nm+")",
+                             "was not approved")
+                        not_approved[nm] = self._members_list[nm]
+            if self.deny_list:
+                for np in new_pending_applications_list:
+                    if np not in self._pending_applications_list:
+                        dlog(self._members_list[nm]["name"],
+                             "("+nm+")",
+                             "was not removed from pending aoolications")
+                        not_removed_from_pending[np] = new_pending_applications_list[np]
 
             result = {}
             if not_deleted:
@@ -943,8 +957,8 @@ if __name__ == "__main__":
             password,
             headless=headless,
             dryrun=dryrun,
-            logfile=None,
-            debuglog=sys.stderr,
+            logfile=sys.stdout,
+            debuglog=None,
             )
     else:
         ams = ISOC_AMS(