Adds generate_form function to the Shipment object (#208)

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## Next Release
+
+- Add `generate_form()` in Shipment class
+
 ## v7.2.0 (2022-07-11)
 
 - Adds `Billing.retrieve_payment_methods()`, `Billing.fund_wallet()`, and `Billing.delete_payment_method()` functions

easypost/shipment.py

@@ -1,4 +1,9 @@
-from typing import List
+from typing import (
+    Any,
+    Dict,
+    List,
+    Optional,
+)
 
 from easypost import Rate
 from easypost.error import Error
@@ -74,6 +79,18 @@ def lowest_smartrate(self, delivery_days: int, delivery_accuracy: str) -> Rate:
 
         return lowest_smartrate
 
+    def generate_form(self, form_type: str, form_options: Optional[Dict[str, Any]] = {}) -> "Shipment":
+        """Generate a form for a Shipment."""
+        params = {"type": form_type}
+        params.update(form_options)  # type: ignore
+        wrapped_params = {"form": params}
+
+        requestor = Requestor(local_api_key=self._api_key)
+        url = "%s/%s" % (self.instance_url(), "forms")
+        response, api_key = requestor.request(method=RequestMethod.POST, url=url, params=wrapped_params)
+        self.refresh_from(values=response, api_key=api_key)
+        return self
+
     @staticmethod
     def get_lowest_smartrate(smartrates, delivery_days: int, delivery_accuracy: str) -> Rate:
         """Get the lowest smartrate from a list of smartrates."""