ladok3 4.15__py3-none-any.whl → 4.17__py3-none-any.whl

ladok3/cli.nw

@@ -299,21 +299,17 @@ the user.
 Manages the user's LADOK login credentials. There are three ways to supply the 
 login credentials, in order of priority:
 
-1) Through the system keyring: Just run `ladok login` and you'll be asked to 
-   enter the credentials and they will be stored in the keyring. Note that for 
-   this to work on the WSL platform (and possibly on Windows), you need to 
-   install the `keyrings.alt` package: `python3 -m pip install keyrings.alt`.
+1) Through the environment: Just set the environment variables
 
-2) Through the environment: Just set the environment variables
+   a) LADOK_INST, the name of the institution, e.g. KTH Royal Institute of
+      Technology;
 
-  a) LADOK_INST, the name of the institution, e.g. KTH Royal Institute of 
-  Technology;
-  b) LADOK_VARS, a colon-separated list of environment variables, similarly to 
-  what's done in `ladok login` --- most don't need this, but can rather set
-  LADOK_USER (the username, e.g. dbosk@ug.kth.se) and
-  LADOK_PASS (the password) instead.
+   b) LADOK_VARS, a colon-separated list of environment variables, similarly to
+      what's done in `ladok login` --- most don't need this, but can rather set 
+      LADOK_USER (the username, e.g. dbosk@ug.kth.se) and LADOK_PASS (the 
+      password) instead.
 
-3) Through the configuration file: Just write
+2) Through the configuration file: Just write
 
       {{
         "institution": "the name of the university"
@@ -325,6 +321,17 @@ login credentials, in order of priority:
    option). (The keys 'username' and 'password' can be renamed to correspond to 
    the necessary values if the university login system uses other names.)
 
+3) Through the system keyring: Just run `ladok login` and you'll be asked to
+   enter the credentials and they will be stored in the keyring. Note that for 
+   this to work on the WSL platform (and possibly on Windows), you need to 
+   install the `keyrings.alt` package: `python3 -m pip install keyrings.alt`.
+
+The keyring is the most secure. However, sometimes one want to try different 
+credentials, so the environment should override the keyring. Also, on WSL the 
+keyring might require you to enter a password in the terminal---this is very 
+inconvenient in scripts. However, when logging in, we first try to store the 
+credentials in the keyring.
+
 <<add subparsers to subp>>=
 login_parser = subp.add_parser("login",
   help="Manage login credentials",
@@ -510,52 +517,17 @@ def load_credentials(filename="config.json"):
   can be passed to `LadokSession(instiution, credential dictionary)`.
   """
 
-  <<fetch vars from keyring>>
-  <<fetch username and password from keyring>>
   <<fetch institution from environment>>
   <<fetch username and password from environment>>
   <<fetch vars from environment>>
   <<fetch vars from config file>>
+  <<fetch vars from keyring>>
+  <<fetch username and password from keyring>>
 
   return None, None
 @
 
-First we try the newest format.
-We try to fetch the institution and vars from the keyring.
-
-Note that [[keyring]] returns [[None]] if the key doesn't exist, it doesn't 
-raise an exception.
-<<fetch vars from keyring>>=
-try:
-  institution = keyring.get_password("ladok3", "institution")
-  vars_keys = keyring.get_password("ladok3", "vars")
-
-  vars = {}
-  for key in vars_keys.split(";"):
-    value = keyring.get_password("ladok3", key)
-    if value:
-      vars[key] = value
-
-  if institution and vars:
-    return institution, vars
-except:
-  pass
-@
-
-However, if that fails, we fall back on the previous format, that only 
-supported KTH.
-<<fetch username and password from keyring>>=
-try:
-  institution = "KTH Royal Institute of Technology"
-  username = keyring.get_password("ladok3", "username")
-  password = keyring.get_password("ladok3", "password")
-  if username and password:
-    return institution, {"username": username, "password": password}
-except:
-  pass
-@
-
-Next in priority is to read from the environment.
+First in priority is to read from the environment.
 We try to read the institution.
 If that fails, we assume we're using the old format that only supported KTH.
 <<fetch institution from environment>>=
@@ -563,7 +535,6 @@ try:
   institution = os.environ["LADOK_INST"]
 except:
   institution = "KTH Royal Institute of Technology"
-
 <<fetch username and password from environment>>=
 try:
   vars = {
@@ -578,6 +549,8 @@ except:
 
 If we couldn't read the old [[LADOK_USER]] and [[LADOK_PASS]], we try to read 
 the [[vars]] from the environment using [[LADOK_VARS]].
+Note that we need the [[institution]] to be set from [[LADOK_INST]] above for 
+this.
 <<fetch vars from environment>>=
 try:
   vars_keys = os.environ["LADOK_VARS"]
@@ -605,8 +578,7 @@ it doesn't exist.
 warn(f"Variable {key} not set, ignoring.")
 @
 
-If none of the above worked, the last resort is to try to read the 
-configuration file.
+If none of the above worked, we try the config file next.
 We pop the institution from the configuration file (a dictionary), because then 
 the remaining entries will be used as [[vars]].
 <<fetch vars from config file>>=
@@ -621,6 +593,40 @@ except:
   pass
 @
 
+Lastly, if nothing else worked, we try to fetch the institution and vars from 
+the keyring.
+Note that [[keyring]] returns [[None]] if the key doesn't exist, it doesn't 
+raise an exception.
+<<fetch vars from keyring>>=
+try:
+  institution = keyring.get_password("ladok3", "institution")
+  vars_keys = keyring.get_password("ladok3", "vars")
+
+  vars = {}
+  for key in vars_keys.split(";"):
+    value = keyring.get_password("ladok3", key)
+    if value:
+      vars[key] = value
+
+  if institution and vars:
+    return institution, vars
+except:
+  pass
+@
+
+However, if that fails, we fall back on the previous format, that only 
+supported KTH.
+<<fetch username and password from keyring>>=
+try:
+  institution = "KTH Royal Institute of Technology"
+  username = keyring.get_password("ladok3", "username")
+  password = keyring.get_password("ladok3", "password")
+  if username and password:
+    return institution, {"username": username, "password": password}
+except:
+  pass
+@
+
 
 \section{Managing the cache: the \texttt{cache} command and subcommands}
 

ladok3/cli.py

@@ -223,33 +223,10 @@ def load_credentials(filename="config.json"):
     can be passed to `LadokSession(instiution, credential dictionary)`.
     """
 
-    try:
-        institution = keyring.get_password("ladok3", "institution")
-        vars_keys = keyring.get_password("ladok3", "vars")
-
-        vars = {}
-        for key in vars_keys.split(";"):
-            value = keyring.get_password("ladok3", key)
-            if value:
-                vars[key] = value
-
-        if institution and vars:
-            return institution, vars
-    except:
-        pass
-    try:
-        institution = "KTH Royal Institute of Technology"
-        username = keyring.get_password("ladok3", "username")
-        password = keyring.get_password("ladok3", "password")
-        if username and password:
-            return institution, {"username": username, "password": password}
-    except:
-        pass
     try:
         institution = os.environ["LADOK_INST"]
     except:
         institution = "KTH Royal Institute of Technology"
-
     try:
         vars = {
             "username": os.environ["LADOK_USER"],
@@ -283,6 +260,28 @@ def load_credentials(filename="config.json"):
         return institution, config
     except:
         pass
+    try:
+        institution = keyring.get_password("ladok3", "institution")
+        vars_keys = keyring.get_password("ladok3", "vars")
+
+        vars = {}
+        for key in vars_keys.split(";"):
+            value = keyring.get_password("ladok3", key)
+            if value:
+                vars[key] = value
+
+        if institution and vars:
+            return institution, vars
+    except:
+        pass
+    try:
+        institution = "KTH Royal Institute of Technology"
+        username = keyring.get_password("ladok3", "username")
+        password = keyring.get_password("ladok3", "password")
+        if username and password:
+            return institution, {"username": username, "password": password}
+    except:
+        pass
 
     return None, None
 
@@ -319,21 +318,17 @@ def main():
   Manages the user's LADOK login credentials. There are three ways to supply the 
   login credentials, in order of priority:
 
-  1) Through the system keyring: Just run `ladok login` and you'll be asked to 
-     enter the credentials and they will be stored in the keyring. Note that for 
-     this to work on the WSL platform (and possibly on Windows), you need to 
-     install the `keyrings.alt` package: `python3 -m pip install keyrings.alt`.
+  1) Through the environment: Just set the environment variables
 
-  2) Through the environment: Just set the environment variables
+     a) LADOK_INST, the name of the institution, e.g. KTH Royal Institute of
+        Technology;
 
-    a) LADOK_INST, the name of the institution, e.g. KTH Royal Institute of 
-    Technology;
-    b) LADOK_VARS, a colon-separated list of environment variables, similarly to 
-    what's done in `ladok login` --- most don't need this, but can rather set
-    LADOK_USER (the username, e.g. dbosk@ug.kth.se) and
-    LADOK_PASS (the password) instead.
+     b) LADOK_VARS, a colon-separated list of environment variables, similarly to
+        what's done in `ladok login` --- most don't need this, but can rather set 
+        LADOK_USER (the username, e.g. dbosk@ug.kth.se) and LADOK_PASS (the 
+        password) instead.
 
-  3) Through the configuration file: Just write
+  2) Through the configuration file: Just write
 
         {{
           "institution": "the name of the university"
@@ -345,6 +340,17 @@ def main():
      option). (The keys 'username' and 'password' can be renamed to correspond to 
      the necessary values if the university login system uses other names.)
 
+  3) Through the system keyring: Just run `ladok login` and you'll be asked to
+     enter the credentials and they will be stored in the keyring. Note that for 
+     this to work on the WSL platform (and possibly on Windows), you need to 
+     install the `keyrings.alt` package: `python3 -m pip install keyrings.alt`.
+
+  The keyring is the most secure. However, sometimes one want to try different 
+  credentials, so the environment should override the keyring. Also, on WSL the 
+  keyring might require you to enter a password in the terminal---this is very 
+  inconvenient in scripts. However, when logging in, we first try to store the 
+  credentials in the keyring.
+
   """,
     )
 

{ladok3-4.15.dist-info → ladok3-4.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ladok3
-Version: 4.15
+Version: 4.17
 Summary: Python wrapper and CLI for the LADOK3 REST API.
 Home-page: https://github.com/dbosk/ladok3
 License: MIT
@@ -28,7 +28,7 @@ Requires-Dist: cryptography (>=41.0.3,<42.0.0)
 Requires-Dist: keyring (>=24.2.0,<25.0.0)
 Requires-Dist: requests (>=2.31.0,<3.0.0)
 Requires-Dist: urllib3 (>=1.26.9,<2.0.0)
-Requires-Dist: weblogin (>=1.10,<2.0)
+Requires-Dist: weblogin (>=1.11,<2.0)
 Project-URL: Bug Tracker, https://github.com/dbosk/ladok3/issues
 Project-URL: Repository, https://github.com/dbosk/ladok3
 Project-URL: Releases, https://github.com/dbosk/ladok3/releases

{ladok3-4.15.dist-info → ladok3-4.17.dist-info}/RECORD

@@ -1,10 +1,10 @@
-doc/ltxobj/ladok3.pdf,sha256=Mpv9NyWe5m8WuVZVqHlknkYDROcHGrpMhj7r4ktLdVY,1415579
+doc/ltxobj/ladok3.pdf,sha256=pBUZeoGiKAzEdNc1fHCfL8Krzxgj8essAbpglIfruYQ,1415370
 ladok3/.gitignore,sha256=QOcCshtjIsFasi4vaqFcooBWPJkxVWaoYEWOBBtdY_w,81
 ladok3/Makefile,sha256=Jy6OFjoVLU9YivnVxctxI_zrUOK9ysEOiistJ3ST6Nw,557
 ladok3/__init__.py,sha256=9bZ_ktF7mg8QvQZcdN3t2AzY_k7g-9Zm-pPh-edMB3Y,246543
 ladok3/api.nw,sha256=P5MQa3AqaUVv-xL3R-AHcFnBWTpAAvzfwlCDKoNFw-M,43422
-ladok3/cli.nw,sha256=SD75vD-uSn-0yo6aOIUY4lgx9EjQf4M-HPHFZrNHMG0,22449
-ladok3/cli.py,sha256=1oUlrI9N7ooGfB-pYt1rkCCX9YKatb4MwP9ivGniK00,12186
+ladok3/cli.nw,sha256=sA5kevvAWBkzZHZ3UBkPEHoWvPw5yYtGYiPEnWMmjus,22864
+ladok3/cli.py,sha256=6R7B0XVvYFlHcMbv6E73KOeI3ZGQFeQN2-ojz12H1vU,12555
 ladok3/data.nw,sha256=3o6-kmeMtCGoSJ5yL8qFCuIINQeym_WtW_2mhItuR-s,11785
 ladok3/data.py,sha256=kPRO9l5DTQb9lGnN2kU-YYPSyg31t0bq5HCw986hbPk,6747
 ladok3/ladok.bash,sha256=zGfTFdtos2zLjV13pzfK-1uCy2b_lF2qUKMoL2ExW7c,1441
@@ -14,8 +14,8 @@ ladok3/report.py,sha256=1K7cRaedemiOGDDAMI9wqnctLeic5ZlMYHw5hzhnvQw,5627
 ladok3/student.nw,sha256=zayn9_b9jCKeMnZxSGS_EuSmF3ojOBHQDMUMMkpRssI,3747
 ladok3/student.py,sha256=TaYn2rpbQnzummB-8xz-sUEV31Gh0CUmU0QkF6VgEic,1703
 ladok3/undoc.nw,sha256=NyHuVIzrRqJPM39MyAlZNEE7PbXdUDJFQ2kJ0NfdwQI,180333
-ladok3-4.15.dist-info/LICENSE,sha256=v8tr5LW7KHBDRqGt1qInr7_jhWrIlkVxO8EqOyrc7AE,1155
-ladok3-4.15.dist-info/METADATA,sha256=PvtIUzIvz06Hv0zKjmByrAZZgzBGERB3FH3e_yn1rDU,8826
-ladok3-4.15.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-ladok3-4.15.dist-info/entry_points.txt,sha256=pi-KKP5Obo0AyuDjXQUpadS9kIvAY2_5ORhPgEYlJv8,41
-ladok3-4.15.dist-info/RECORD,,
+ladok3-4.17.dist-info/LICENSE,sha256=v8tr5LW7KHBDRqGt1qInr7_jhWrIlkVxO8EqOyrc7AE,1155
+ladok3-4.17.dist-info/METADATA,sha256=ZxruPVGrER8Mg-XfY0mqBc3ZKCgJdUZskeHcYtbfBlM,8826
+ladok3-4.17.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+ladok3-4.17.dist-info/entry_points.txt,sha256=pi-KKP5Obo0AyuDjXQUpadS9kIvAY2_5ORhPgEYlJv8,41
+ladok3-4.17.dist-info/RECORD,,