From e2fadae5ec2f0d59ebd9893d6b24433829e7eb9a Mon Sep 17 00:00:00 2001
From: dmichalowicz <dmichalowicz@quantopian.com>
Date: Fri, 7 Apr 2017 14:02:36 -0400
Subject: [PATCH] API: Make certain continuous future arguments optional

---
 zipline/algorithm.py | 16 ++++++++--------
 zipline/api.pyi      | 14 +++++++-------
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/zipline/algorithm.py b/zipline/algorithm.py
index b64e7fdc..74587516 100644
--- a/zipline/algorithm.py
+++ b/zipline/algorithm.py
@@ -1203,8 +1203,8 @@ class TradingAlgorithm(object):
     @preprocess(root_symbol_str=ensure_upper_case)
     def continuous_future(self,
                           root_symbol_str,
-                          offset,
-                          roll,
+                          offset=0,
+                          roll='volume',
                           adjustment='mul'):
         """Create a specifier for a continuous contract.
 
@@ -1213,15 +1213,15 @@ class TradingAlgorithm(object):
         root_symbol_str : str
             The root symbol for the future chain.
 
-        offset : int
-            The distance from the primary contract.
+        offset : int, optional
+            The distance from the primary contract. Default is 0.
 
-        roll_style : str
-            How rolls are determined.
+        roll_style : str, optional
+            How rolls are determined. Default is 'volume'.
 
-        adjustment : str
+        adjustment : str, optional
             Method for adjusting lookback prices between rolls. Options are
-            'mul', 'add', and None. Defaults to 'mul'.
+            'mul', 'add', and None. Default is 'mul'.
 
         Returns
         -------
diff --git a/zipline/api.pyi b/zipline/api.pyi
index 821784d5..15c8710a 100644
--- a/zipline/api.pyi
+++ b/zipline/api.pyi
@@ -60,7 +60,7 @@ def cancel_order(order_param):
         The order_id or order object to cancel.
     """
 
-def continuous_future(root_symbol_str, offset, roll, adjustment='mul'):
+def continuous_future(root_symbol_str, offset=0, roll='volume', adjustment='mul'):
     """Create a specifier for a continuous contract.
 
     Parameters
@@ -68,15 +68,15 @@ def continuous_future(root_symbol_str, offset, roll, adjustment='mul'):
     root_symbol_str : str
         The root symbol for the future chain.
 
-    offset : int
-        The distance from the primary contract.
+    offset : int, optional
+        The distance from the primary contract. Default is 0.
 
-    roll_style : str
-        How rolls are determined.
+    roll_style : str, optional
+        How rolls are determined. Default is 'volume'.
 
-    adjustment : str
+    adjustment : str, optional
         Method for adjusting lookback prices between rolls. Options are
-        'mul', 'add', and None. Defaults to 'mul'.
+        'mul', 'add', and None. Default is 'mul'.
 
     Returns
     -------