From: Mike Bayer Date: Tue, 27 Nov 2018 03:58:50 +0000 (-0500) Subject: Move links etc. to github, new alembic links X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9b73a8c4dc80f3b5dfd29ba786734b00ec02b7a2;p=thirdparty%2Fsqlalchemy%2Fsqlalchemy.git Move links etc. to github, new alembic links Change-Id: I59392d355a216ae59552a04c5508f548b901aa7b (cherry picked from commit 50417cf758508e970f3fccc99af6a501ceac8eb2) (cherry picked from commit d04575c55467da57ad7091615b313db2486908b6) (cherry picked from commit fcb4c96cd8d83f31ea86c09c18c075e14d348dd3) (cherry picked from commit c25af2257f037e5a3b34aa5b79dcbb7f85ebc85d) --- diff --git a/.gitreview b/.gitreview index 155b3304a2..d9575ff6ae 100644 --- a/.gitreview +++ b/.gitreview @@ -1,4 +1,4 @@ [gerrit] host=gerrit.sqlalchemy.org -project=zzzeek/sqlalchemy +project=sqlalchemy/sqlalchemy defaultbranch=rel_0_9 diff --git a/doc/build/changelog/changelog_08.rst b/doc/build/changelog/changelog_08.rst index 5d74af71c3..c9b1dd4af2 100644 --- a/doc/build/changelog/changelog_08.rst +++ b/doc/build/changelog/changelog_08.rst @@ -127,7 +127,6 @@ .. change:: :tags: bug, ext :versions: 0.9.5, 1.0.0b1 - :pullreq: bitbucket:24 :tickets: 3093, 3051 Fixed bug where :meth:`.MutableDict.setdefault` didn't return the @@ -137,7 +136,6 @@ .. change:: :tags: bug, mysql :versions: 0.9.5, 1.0.0b1 - :pullreq: bitbucket:15 Added support for reflecting tables where an index includes KEY_BLOCK_SIZE using an equal sign. Pull request courtesy @@ -165,7 +163,6 @@ .. change:: :tags: bug, postgresql - :pullreq: bitbucket:13 :versions: 0.9.5, 1.0.0b1 Added a new "disconnect" message "connection has been closed unexpectedly". @@ -311,7 +308,6 @@ :tags: bug, mysql :versions: 0.9.3 :tickets: 2966 - :pullreq: bitbucket:12 Added support for the ``PARTITION BY`` and ``PARTITIONS`` MySQL table keywords, specified as ``mysql_partition_by='value'`` and @@ -339,7 +335,6 @@ .. change:: :tags: bug, sqlite - :pullreq: github:72 Restored a change that was missed in the backport of unique constraint reflection to 0.8, where :class:`.UniqueConstraint` @@ -392,7 +387,6 @@ .. change:: :tags: bug, mysql - :pullreq: github:61 :versions: 0.9.2 Some missing methods added to the cymysql dialect, including @@ -401,7 +395,6 @@ .. change:: :tags: bug, py3k - :pullreq: github:63 Fixed Py3K bug where a missing import would cause "literal binary" mode to fail to import "util.binary_type" when rendering a bound @@ -411,7 +404,6 @@ .. change:: :tags: bug, orm :versions: 0.9.2 - :pullreq: github:58 Fixed error message when an iterator object is passed to :func:`.class_mapper` or similar, where the error would fail to @@ -444,7 +436,6 @@ .. change:: :tags: bug, mssql, pymssql :versions: 0.9.0 - :pullreq: github:51 Added "Net-Lib error during Connection reset by peer" message to the list of messages checked for "disconnect" within the @@ -571,7 +562,6 @@ .. change:: :tags: bug, mssql :versions: 0.9.0 - :pullreq: bitbucket:7 Fixed bug introduced in 0.8.0 where the ``DROP INDEX`` statement for an index in MSSQL would render incorrectly if the @@ -1202,7 +1192,6 @@ .. change:: :tags: bug, engine - :pullreq: github:6 :versions: 0.9.0b1 Fixed bug where the ``reset_on_return`` argument to various :class:`.Pool` @@ -1334,7 +1323,6 @@ .. change:: :tags: bug, postgresql - :pullreq: github:2 :tickets: 2735 Fixed the HSTORE type to correctly encode/decode for unicode. diff --git a/doc/build/changelog/changelog_09.rst b/doc/build/changelog/changelog_09.rst index a0e9d2cf00..f05011e449 100644 --- a/doc/build/changelog/changelog_09.rst +++ b/doc/build/changelog/changelog_09.rst @@ -158,7 +158,6 @@ .. change:: :tags: bug, py3k, mysql :tickets: 3333 - :pullreq: github:158 :versions: 1.0.0b2 Fixed the :class:`.mysql.BIT` type on Py3K which was not using the @@ -193,7 +192,6 @@ .. change:: :tags: feature, postgresql - :pullreq: bitbucket:45 :versions: 1.0.0b1 Added support for the ``CONCURRENTLY`` keyword with Postgresql @@ -206,7 +204,6 @@ .. change:: :tags: bug, ext, py3k - :pullreq: github:154 :versions: 1.0.0b1 Fixed bug where the association proxy list class would not interpret @@ -215,7 +212,6 @@ .. change:: :tags: feature, sqlite - :pullreq: bitbucket:42 :versions: 1.0.0b1 Added support for partial indexes (e.g. with a WHERE clause) on @@ -251,7 +247,6 @@ .. change:: :tags: bug, orm - :pullreq: github:147 :versions: 1.0.0b1 Fixed bug where TypeError raised when :meth:`.Query.join` called @@ -324,7 +319,6 @@ .. change:: :tags: bug, postgresql - :pullreq: github:145 :versions: 1.0.0b1 Added support for the :class:`postgresql.JSONB` datatype when @@ -400,7 +394,6 @@ .. change:: :tags: bug, sql :versions: 1.0.0b1 - :pullreq: bitbucket:41 Added the ``native_enum`` flag to the ``__repr__()`` output of :class:`.Enum`, which is mostly important when using it with @@ -718,7 +711,6 @@ .. change:: :tags: bug, ext :versions: 1.0.0b1 - :pullrequest: bitbucket:28 Fixed bug where :class:`.ext.mutable.MutableDict` failed to implement the ``update()`` dictionary method, thus @@ -727,7 +719,6 @@ .. change:: :tags: bug, ext :versions: 1.0.0b1 - :pullrequest: bitbucket:27 Fixed bug where a custom subclass of :class:`.ext.mutable.MutableDict` would not show up in a "coerce" operation, and would instead @@ -748,7 +739,6 @@ .. change:: :tags: feature, postgresql, pg8000 :versions: 1.0.0b1 - :pullreq: github:125 Support is added for "sane multi row count" with the pg8000 driver, which applies mostly to when using versioning with the ORM. @@ -819,7 +809,6 @@ :tags: bug, postgresql :versions: 1.0.0b1 :tickets: 3141 - :pullreq: github:124 Fixed bug in :class:`.postgresql.array` object where comparison to a plain Python list would fail to use the correct array constructor. @@ -979,7 +968,6 @@ .. change:: :tags: feature, postgresql :versions: 1.0.0b1 - :pullreq: bitbucket:22 :tickets: 3078 Added kw argument ``postgresql_regconfig`` to the @@ -990,14 +978,12 @@ .. change:: :tags: feature, postgresql :versions: 1.0.0b1 - :pullreq: github:101 Added support for Postgresql JSONB via :class:`.JSONB`. Pull request courtesy Damian Dimmich. .. change:: :tags: feature, mssql - :pullreq: github:98 :versions: 1.0.0b1 Enabled "multivalues insert" for SQL Server 2008. Pull request @@ -1126,7 +1112,6 @@ .. change:: :tags: feature, examples - :pullreq: bitbucket:21 :versions: 1.0.0b1 Added a new example illustrating materialized paths, using the @@ -1134,7 +1119,6 @@ .. change:: :tags: bug, testsuite - :pullreq: github:95 :versions: 1.0.0b1 In public test suite, shanged to use of ``String(40)`` from @@ -1158,7 +1142,6 @@ .. change:: :tags: feature, postgresql :versions: 1.0.0b1 - :pullreq: github:88 Added support for AUTOCOMMIT isolation level when using the pg8000 DBAPI. Pull request courtesy Tony Locke. @@ -1167,7 +1150,6 @@ :tags: bug, postgresql :tickets: 3021 :versions: 1.0.0b1 - :pullreq: github:87 The psycopg2 ``.closed`` accessor is now consulted when determining if an exception is a "disconnect" error; ideally, this should remove @@ -1230,7 +1212,6 @@ .. change:: :tags: feature, postgresql :tickets: 2785 - :pullreq: bitbucket:18 :versions: 1.0.0b1 Added a new flag :paramref:`.ARRAY.zero_indexes` to the Postgresql @@ -1322,7 +1303,6 @@ .. change:: :tags: bug, py3k, tests :tickets: 2830 - :pullreq: bitbucket:2830 :versions: 1.0.0b1 Corrected for some deprecation warnings involving the ``imp`` @@ -1509,7 +1489,6 @@ .. change:: :tags: bug, sql :tickets: 2988 - :pullreq: github:78 Fixed an 0.9 regression where a :class:`.Table` that failed to reflect correctly wouldn't be removed from the parent @@ -1588,7 +1567,6 @@ .. change:: :tags: feature, oracle :tickets: 2911 - :pullreq: github:74 Added a new engine option ``coerce_to_unicode=True`` to the cx_Oracle dialect, which restores the cx_Oracle outputtypehandler @@ -1809,7 +1787,6 @@ .. change:: :tags: sqlite, bug - :pullreq: github:65 Support has been added to SQLite type reflection to fully support the "type affinity" contract specified at http://www.sqlite.org/datatype3.html. @@ -1823,14 +1800,12 @@ .. change:: :tags: postgresql, feature - :pullreq: github:64 Added the :attr:`.TypeEngine.python_type` convenience accessor onto the :class:`.postgresql.ARRAY` type. Pull request courtesy Alexey Terentev. .. change:: :tags: examples, feature - :pullreq: github:41 Added optional "changed" column to the versioned rows example, as well as support for when the versioned :class:`.Table` has an explicit @@ -1870,7 +1845,6 @@ .. change:: :tags: bug, mysql, cymysql :tickets: 2934 - :pullreq: github:69 Fixed bug in cymysql dialect where a version string such as ``'33a-MariaDB'`` would fail to parse properly. Pull request @@ -1899,7 +1873,6 @@ .. change:: :tags: bug, sql - :pullreq: github:67 Fixed regression in new "naming convention" feature where conventions would fail if the referred table in a foreign key contained a schema @@ -2190,7 +2163,6 @@ .. change:: :tags: bug, sql - :pullreq: bitbucket:11 A :class:`.UniqueConstraint` created inline with a :class:`.Table` that has no columns within it will be skipped. Pullreq courtesy @@ -2198,7 +2170,6 @@ .. change:: :tags: feature, mssql - :pullreq: bitbucket:11 Added an option ``mssql_clustered`` to the :class:`.UniqueConstraint` and :class:`.PrimaryKeyConstraint` constructs; on SQL Server, this adds @@ -2340,7 +2311,6 @@ .. change:: :tags: bug, py3k, cextensions - :pullreq: github:55 Fixed an issue where the C extensions in Py3K are using the wrong API to specify the top-level module function, which breaks @@ -2351,7 +2321,6 @@ .. change:: :tags: bug, schema - :pullreq: github:57 Restored :class:`sqlalchemy.schema.SchemaVisitor` to the ``.schema`` module. Pullreq courtesy Sean Dague. @@ -2420,7 +2389,6 @@ .. change:: :tags: bug, orm - :pullreq: bitbucket:9 Fixed bug where using new :attr:`.Session.info` attribute would fail if the ``.info`` argument were only passed to the :class:`.sessionmaker` @@ -2500,7 +2468,6 @@ .. change:: :tags: feature, postgresql :tickets: 2581 - :pullreq: github:50 Support for Postgresql JSON has been added, using the new :class:`.JSON` type. Huge thanks to Nathan Rice for @@ -2550,7 +2517,6 @@ .. change:: :tags: feature, postgresql - :pullreq: bitbucket:8 Added support for Postgresql TSVECTOR via the :class:`.postgresql.TSVECTOR` type. Pull request courtesy @@ -2611,7 +2577,6 @@ .. change:: :tags: bug, orm, collections, py3k - :pullreq: github:40 Added support for the Python 3 method ``list.clear()`` within the ORM collection instrumentation system; pull request @@ -2654,7 +2619,6 @@ .. change:: :tags: feature, sql - :pullreq: github:42 A new API for specifying the ``FOR UPDATE`` clause of a ``SELECT`` is added with the new :meth:`.GenerativeSelect.with_for_update` method. @@ -2671,7 +2635,6 @@ .. change:: :tags: feature, orm - :pullreq: github:42 A new API for specifying the ``FOR UPDATE`` clause of a ``SELECT`` is added with the new :meth:`.Query.with_for_update` method, diff --git a/doc/build/conf.py b/doc/build/conf.py index d2757846dc..c1dcfa5a17 100644 --- a/doc/build/conf.py +++ b/doc/build/conf.py @@ -64,9 +64,8 @@ changelog_inner_tag_sort = ["feature", "bug", "moved", "changed", "removed"] changelog_render_ticket = "http://www.sqlalchemy.org/trac/ticket/%s" changelog_render_pullreq = { - "bitbucket": "https://bitbucket.org/zzzeek/sqlalchemy/pull-request/%s", - "default": "https://bitbucket.org/zzzeek/sqlalchemy/pull-request/%s", - "github": "https://github.com/zzzeek/sqlalchemy/pull/%s", + "default": "https://github.com/sqlalchemy/sqlalchemy/pull/%s", + "github": "https://github.com/sqlalchemy/sqlalchemy/pull/%s", } changelog_render_changeset = "http://www.sqlalchemy.org/trac/changeset/%s" diff --git a/doc/build/core/constraints.rst b/doc/build/core/constraints.rst index f5ea0e4b1c..2d79f51817 100644 --- a/doc/build/core/constraints.rst +++ b/doc/build/core/constraints.rst @@ -291,7 +291,7 @@ parameters which create :class:`.UniqueConstraint` and :class:`.Index` objects without an explicit name being specified. The use case of alteration of existing tables and constraints can be handled -by schema migration tools such as `Alembic `_. +by schema migration tools such as `Alembic `_. However, neither Alembic nor SQLAlchemy currently create names for constraint objects where the name is otherwise unspecified, leading to the case where being able to alter existing constraints means that one must reverse-engineer @@ -426,7 +426,7 @@ name as follows:: :paramref:`.MetaData.naming_convention` - for additional usage details as well as a listing of all available naming components. - :ref:`alembic:tutorial_constraint_names` - in the Alembic documentation. + `The Importance of Naming Constraints `_ - in the Alembic documentation. .. versionadded:: 0.9.2 Added the :paramref:`.MetaData.naming_convention` argument. diff --git a/doc/build/core/metadata.rst b/doc/build/core/metadata.rst index 9b231010b2..5c3f7d3487 100644 --- a/doc/build/core/metadata.rst +++ b/doc/build/core/metadata.rst @@ -243,16 +243,14 @@ database schemas in relation to application code using schema migration tools. There are two major migration tools available for SQLAlchemy: -* `Alembic `_ - Written by the author of SQLAlchemy, +* `Alembic `_ - Written by the author of SQLAlchemy, Alembic features a highly customizable environment and a minimalistic usage pattern, supporting such features as transactional DDL, automatic generation of "candidate" migrations, an "offline" mode which generates SQL scripts, and support for branch resolution. * `SQLAlchemy-Migrate `_ - The original - migration tool for SQLAlchemy, SQLAlchemy-Migrate is widely used and continues - under active development. SQLAlchemy-Migrate includes features such as - SQL script generation, ORM class generation, ORM model comparison, and extensive - support for SQLite migrations. + migration tool for SQLAlchemy, SQLAlchemy-Migrate is still used by projects + such as Openstack, however is being superseded by Alembic. Specifying the Schema Name diff --git a/doc/build/faq/metadata_schema.rst b/doc/build/faq/metadata_schema.rst index 9697399dcf..395b21392e 100644 --- a/doc/build/faq/metadata_schema.rst +++ b/doc/build/faq/metadata_schema.rst @@ -88,7 +88,7 @@ metadata creation sequence, using this recipe:: engine = create_engine('postgresql://', strategy='mock', executor=dump) metadata.create_all(engine, checkfirst=False) -The `Alembic `_ tool also supports +The `Alembic `_ tool also supports an "offline" SQL generation mode that renders database migrations as SQL scripts. How can I subclass Table/Column to provide certain behaviors/configurations?