Update to Jokeapi V2.1.2

Author: benjhar

.circleci/.config.yml.kate-swp

@@ -80,7 +80,8 @@ The format in which the API should respond.
 Options are:
 `json`,
 `yaml`,
-`xml`
+`xml`,
+`txt`
 
 If left blank it will default to `json`.
 
@@ -173,7 +174,7 @@ A succesful API call will return:
 
 A succesful API call will return:
 
-```python
+```xml
 <?xml version='1.0'?>
 <data>
     <category>Dark</category>
@@ -196,7 +197,7 @@ A succesful API call will return:
 
 A succesful API call will return:
 
-```python
+```yaml
 category: "Programming"
 type: "single"
 joke: "Your momma is so fat, you need to switch to NTFS to store a picture of her."
@@ -210,6 +211,17 @@ id: 56
 error: false
 ```
 
+
+### txt
+
+A succesful API call will return:
+
+```
+Why does no one like SQLrillex?
+
+He keeps dropping the database.
+```
+
 ---
 
 ## Errors

README.md

@@ -22,7 +22,7 @@ def build_request(
         if len(category) > 0:
             for c in category:
                 if not c.lower() in ["programming", "miscellaneous", "dark"]:
-                    raise Exception(
+                    raise ValueError(
                         '''Invalid category selected. Available categories are:
                             "programming"
                             "miscellaneous"
@@ -43,7 +43,7 @@ def build_request(
                             "racist",
                             "sexist"
                             ]:
-                    raise Exception(
+                    raise ValueError(
                         '''\n\n
                         You have blacklisted flags which are not available.
                         Available flags are:
@@ -59,13 +59,13 @@ def build_request(
         else:
             blacklistFlags = None
 
-        if response_format not in ["json", "xml", "yaml"]:
+        if response_format not in ["json", "xml", "yaml", "txt"]:
             raise Exception(
                 "Response format must be either json, xml or yaml."
             )
         if type:
             if type not in ["single", "twopart"]:
-                raise Exception(
+                raise ValueError(
                     '''Invalid joke type.
                     Available options are "single" or "twopart".'''
                 )
@@ -75,7 +75,7 @@ def build_request(
 
         if search_string:
             if not isinstance(search_string, str):
-                raise Exception("search_string must be a string.")
+                raise ValueError("search_string must be a string.")
                 return
             else:
                 search_string = urllib.parse.quote(search_string)
@@ -89,13 +89,13 @@ def build_request(
             range_limit = dict["jokes"]["totalCount"]
 
             if len(id_range) > 2:
-                raise Exception("id_range must be no longer than 2 items.")
+                raise ValueError("id_range must be no longer than 2 items.")
             elif id_range[0] < 0:
-                raise Exception(
+                raise ValueError(
                              "id_range[0] must be greater than or equal to 0."
                                )
             elif id_range[1] > range_limit:
-                raise Exception(
+                raise ValueError(
                  f"id_range[1] must be less than or equal to {range_limit-1}."
                 )