--- /dev/null
+=============================
+What's New in SQLAlchemy 1.3?
+=============================
+
+.. admonition:: About this Document
+
+ This document describes changes between SQLAlchemy version 1.2
+ and SQLAlchemy version 1.3.
+
+Introduction
+============
+
+This guide introduces what's new in SQLAlchemy version 1.23
+and also documents changes which affect users migrating
+their applications from the 1.2 series of SQLAlchemy to 1.3.
+
+Please carefully review the sections on behavioral changes for
+potentially backwards-incompatible changes in behavior.
+
+New Features and Improvements - ORM
+===================================
+
+Key Behavioral Changes - ORM
+=============================
+
+New Features and Improvements - Core
+====================================
+
+Key Behavioral Changes - Core
+=============================
+
+Dialect Improvements and Changes - PostgreSQL
+=============================================
+
+Dialect Improvements and Changes - MySQL
+=============================================
+
+Dialect Improvements and Changes - SQLite
+=============================================
+
+Dialect Improvements and Changes - Oracle
+=============================================
+
+Dialect Improvements and Changes - SQL Server
+=============================================
--- /dev/null
+Individual per-changelog files go here
+in .rst format, which are pulled in by
+changelog (version 0.4.0 or higher) to
+be rendered into the changelog_xx.rst file.
+At release time, the files here are removed and written
+directly into the changelog.
+
+Rationale is so that multiple changes being merged
+into gerrit don't produce conflicts. Note that
+gerrit does not support custom merge handlers unlike
+git itself.
+
# built documents.
#
# The short X.Y version.
-version = "1.2"
+version = "1.3"
# The full version, including alpha/beta/rc tags.
-release = "1.2.4"
+release = "1.3.0b1"
-release_date = "February 22, 2018"
+release_date = None
site_base = os.environ.get("RTD_SITE_BASE", "http://www.sqlalchemy.org")
site_adapter_template = "docs_adapter.mako"
=============
-A quick check to verify that we are on at least **version 1.2** of SQLAlchemy:
+A quick check to verify that we are on at least **version 1.3** of SQLAlchemy:
.. sourcecode:: pycon+sql
>>> import sqlalchemy
>>> sqlalchemy.__version__ # doctest: +SKIP
- 1.2.0
+ 1.3.0
Connecting
==========
Checking the Installed SQLAlchemy Version
------------------------------------------
-This documentation covers SQLAlchemy version 1.2. If you're working on a
+This documentation covers SQLAlchemy version 1.3. If you're working on a
system that already has SQLAlchemy installed, check the version from your
Python prompt like this:
>>> import sqlalchemy
>>> sqlalchemy.__version__ # doctest: +SKIP
- 1.2.0
+ 1.3.0
.. _migration:
-1.1 to 1.2 Migration
+1.2 to 1.3 Migration
=====================
-Notes on what's changed from 1.1 to 1.2 is available here at :doc:`changelog/migration_12`.
+Notes on what's changed from 1.2 to 1.3 is available here at :doc:`changelog/migration_13`.
Version Check
=============
-A quick check to verify that we are on at least **version 1.2** of SQLAlchemy::
+A quick check to verify that we are on at least **version 1.3** of SQLAlchemy::
>>> import sqlalchemy
>>> sqlalchemy.__version__ # doctest:+SKIP
- 1.2.0
+ 1.3.0
Connecting
==========
from .inspection import inspect
from .engine import create_engine, engine_from_config
-__version__ = '1.2.5'
+__version__ = '1.3.0b1'
def __go(lcls):