ssanderson released this
Jul 17, 2018
· 18 commits to master since this release
This release includes several enhancements and performance improvements along with a small number of bug fixes. We recommend that all users upgrade to this version.
NOTE: This will likely be the last minor release in the Zipline 1.x series. The release next will be Zipline 2.0, which will include a number of small breaking changes required to support international equities.
Zipline has historically been very conservative when updating versions of numpy, pandas, and other "PyData" ecosystem packages. This conservatism is primarily due to the fact that Zipline is used as the backtesting engine for Quantopian, which means that updating package versions risks breaking a large installed codebase. Of course, many Zipline users don't have the backwards compatibility requirements that Quantopian has, and they'd like to be able to use the latest and greatest package versions.
As part of this release, we're now building and testing Zipline with two package configurations:
Other combinations of numpy and pandas may work, but these package sets will be built and tested during our normal development cycle.
Moving forward, our goal is to continue to maintain support for two sets of packages at any given time. The "stable" package set will change relatively infrequently, and will contain the versions of numpy and pandas supported on Quantopian. The "latest" package set will change regularly, and will contain recently-released versions of numpy and pandas.
Our hope with these changes is to strike a balance between stability and novelty without taking on too great a maintenance burden by supporting every possible combination of packages.
One of the most popular features of Zipline is its collection of trading calendars, which provide information about holidays and trading hours of various markets. As part of this release, Zipline's calendar-related functionality has been moved to a separate trading-calendars_ package, allowing users that only needed access to the calendars to use them without taking on the rest of Zipline's dependencies.
For backwards compability, Zipline will continue to re-export calendar-related functions. For example, zipline.get_calendar still exists, but is now an alias for trading_calendars.get_calendar. Users that depend on this functionality are encouraged to update their imports to the new locations in trading_calendars.
This release adds experimental support for running Zipline with user-defined subclasses of ~zipline.finance.blotter.blotter.Blotter. The primary motivation for this change is to make it easier to run live algorithms from the Zipline CLI.
There are two primary ways to configure a custom blotter:
An example usage of (2) might look like this:
from zipline.extensions import register
from zipline.finance.blotter import Blotter, SimulationBlotter
from zipline.finance.cancel_policy import EODCancel
"""Create a SimulationBlotter with a non-default cancel policy.
To use this factory when running zipline from the command line, we would invoke zipline like this:
$ zipline run --blotter my-blotter <...other-args...>
As part of this change, the zipline.finance.blotter.blotter.Blotter class has been converted to an abstract base class. The default blotter used in simulations is now named zipline.finance.blotter.SimulationBlotter.
This release adds support for passing custom arguments to the zipline command-line interface. Custom command-line arguments are passed via the -x flag followed by a key=value pair. Arguments passed this way can be accessed from Python code (e.g., an algorithm or an extension) via attributes of zipline.extension_args. For example, if zipline is invoked like this:
$ zipline -x argle=bargle run ...
then the result of zipline.extension_args.argle would be the string "bargle".
Custom arguments can be grouped into namespaces by including . characters in keys. For example, if zipline is invoked like this:
$ zipline -x argle.bargle=foo
then zipline.extension_args.argle will contain an object with a bargle attribute containing the string "foo". Keys can contain multiple dots to create nested namespaces.
Fixed a bug in zipline.pipeline.Factor.winsorize where NaN values were incorrectly included in value counts when determining cutoff thresholds for winsorization.
Fixed a crash in zipline.pipeline.Factor.top with a count of 1 and no groupby.
Fixed a bug where calling data.history with a negative lookback would fetch prices from the future.
Fixed a bug where StopOrder, LimitOrder, and StopLimitOrder prices were being rounded to the nearest penny regardless of asset tick size. Prices are now rounded based on the tick_size attribute of the asset being ordered.
freddiev4 released this
Apr 4, 2018
Merge pull request #2136 from quantopian/release-1.2.0
MAINT: Update Python stub files