about summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--gn3/api/llm.py64
1 files changed, 39 insertions, 25 deletions
diff --git a/gn3/api/llm.py b/gn3/api/llm.py
index 7d860d8..91779a5 100644
--- a/gn3/api/llm.py
+++ b/gn3/api/llm.py
@@ -1,24 +1,26 @@
-"""API for data used to generate menus"""
-
-# pylint: skip-file
+"""Api endpoints for gnqa"""
+from datetime import timedelta
+from functools import wraps
+import json
+import sqlite3
+from redis import Redis
 
-from flask import jsonify, request, Blueprint, current_app
+from flask import Blueprint
+from flask import current_app
+from flask import jsonify
+from flask import request
 
-from functools import wraps
 from gn3.llms.process import get_gnqa
 from gn3.llms.process import get_user_queries
 from gn3.llms.process import fetch_query_results
 from gn3.auth.authorisation.oauth2.resource_server import require_oauth
 from gn3.auth import db
-from redis import Redis
-import json
-import sqlite3
-from datetime import timedelta
 
 GnQNA = Blueprint("GnQNA", __name__)
 
 
 def handle_errors(func):
+    """general error handling decorator function"""
     @wraps(func)
     def decorated_function(*args, **kwargs):
         try:
@@ -30,7 +32,7 @@ def handle_errors(func):
 
 @GnQNA.route("/gnqna", methods=["POST"])
 def gnqa():
-    # todo  add auth
+    """Main gnqa endpoint"""
     query = request.json.get("querygnqa", "")
     if not query:
         return jsonify({"error": "querygnqa is missing in the request"}), 400
@@ -38,7 +40,8 @@ def gnqa():
     try:
         fahamu_token = current_app.config.get("FAHAMU_AUTH_TOKEN")
         if fahamu_token is None:
-            return jsonify({"query": query, "error": "Use of invalid fahamu auth token"}), 500
+            return jsonify({"query": query,
+                            "error": "Use of invalid fahamu auth token"}), 500
         task_id, answer, refs = get_gnqa(
             query, fahamu_token, current_app.config.get("DATA_DIR"))
         response = {
@@ -49,19 +52,22 @@ def gnqa():
         }
         with (Redis.from_url(current_app.config["REDIS_URI"],
                              decode_responses=True) as redis_conn):
-            # The key will be deleted after 60 seconds
-            redis_conn.setex(f"LLM:random_user-{query}", timedelta(days=10), json.dumps(response))
+            redis_conn.setex(
+                f"LLM:random_user-{query}",
+                timedelta(days=10), json.dumps(response))
         return jsonify({
             **response,
             "prev_queries": get_user_queries("random_user", redis_conn)
         })
     except Exception as error:
-        return jsonify({"query": query, "error": f"Request failed-{str(error)}"}), 500
+        return jsonify({"query": query,
+                        "error": f"Request failed-{str(error)}"}), 500
 
 
 @GnQNA.route("/rating/<task_id>", methods=["POST"])
 @require_oauth("profile")
 def rating(task_id):
+    """Endpoint for rating qnqa query and answer"""
     try:
         llm_db_path = current_app.config["LLM_DB_PATH"]
         with (require_oauth.acquire("profile") as token,
@@ -81,14 +87,16 @@ def rating(task_id):
                   task_id TEXT NOT NULL UNIQUE
                   )"""
             cursor.execute(create_table)
-            cursor.execute("""INSERT INTO Rating(user_id,query,answer,weight,task_id)
+            cursor.execute("""INSERT INTO Rating(user_id,query,
+            answer,weight,task_id)
             VALUES(?,?,?,?,?)
             ON CONFLICT(task_id) DO UPDATE SET
             weight=excluded.weight
             """, (str(user_id), query, answer, weight, task_id))
         return {
-                "message": "You have successfully rated this query:Thank you!!"
-            }, 200
+            "message":
+            "You have successfully rated this query:Thank you!!"
+        }, 200
     except sqlite3.Error as error:
         return jsonify({"error": str(error)}), 500
     except Exception as error:
@@ -99,9 +107,10 @@ def rating(task_id):
 @require_oauth("profile user")
 @handle_errors
 def fetch_user_hist(query):
-
-    with (require_oauth.acquire("profile user") as the_token, Redis.from_url(current_app.config["REDIS_URI"],
-                                                                             decode_responses=True) as redis_conn):
+    """"Endpoint to fetch previos searches for User"""
+    with (require_oauth.acquire("profile user") as the_token,
+          Redis.from_url(current_app.config["REDIS_URI"],
+          decode_responses=True) as redis_conn):
         return jsonify({
             **fetch_query_results(query, the_token.user.id, redis_conn),
             "prev_queries": get_user_queries("random_user", redis_conn)
@@ -111,9 +120,12 @@ def fetch_user_hist(query):
 @GnQNA.route("/historys/<query>", methods=["GET"])
 @handle_errors
 def fetch_users_hist_records(query):
-    """method to fetch all users hist:note this is a test functionality to be replaced by fetch_user_hist"""
+    """method to fetch all users hist:note this is a test functionality
+    to be replaced by fetch_user_hist
+    """
 
-    with Redis.from_url(current_app.config["REDIS_URI"], decode_responses=True) as redis_conn:
+    with Redis.from_url(current_app.config["REDIS_URI"],
+                        decode_responses=True) as redis_conn:
         return jsonify({
             **fetch_query_results(query, "random_user", redis_conn),
             "prev_queries": get_user_queries("random_user", redis_conn)
@@ -123,6 +135,8 @@ def fetch_users_hist_records(query):
 @GnQNA.route("/get_hist_names", methods=["GET"])
 @handle_errors
 def fetch_prev_hist_ids():
-
-    with (Redis.from_url(current_app.config["REDIS_URI"], decode_responses=True)) as redis_conn:
-        return jsonify({"prev_queries": get_user_queries("random_user", redis_conn)})
+    """Test method for fetching history for Anony Users"""
+    with (Redis.from_url(current_app.config["REDIS_URI"],
+                         decode_responses=True)) as redis_conn:
+        return jsonify({"prev_queries": get_user_queries("random_user",
+                                                         redis_conn)})