Skip to main content

Anyblok is a dynamic injection blok framework

Project description

Version status Build status Coverage Documentation Status gitter Python versions Dialects compatibility


AnyBlok is a Python framework allowing to create highly dynamic and modular applications on top of SQLAlchemy.

AnyBlok is released under the terms of the Mozilla Public License.

AnyBlok is hosted on github - the main project page is at or source code is tracked here using git.

Releases and project status are available on Pypi at

The most recent published version of the documentation should be at

There is a tutorial to teach you how to develop applications with AnyBlok at

Project Status

AnyBlok is expected to be stable. Some early partners are using it on production and are involved in the project development. We are aiming to make a stable release as soon as possible.

Users should take care to report bugs and missing features on an as-needed basis.

It should be expected that the development version may be required for proper implementation of recently repaired issues in between releases; the latest master is always available at


Install released versions of AnyBlok from the Python package index with pip or a similar tool:

pip install anyblok

Installation via source distribution is via the script:

python install

Installation will add the anyblok commands to the environment.

Running Tests

To run framework tests with pytest:

pip install pytest
ANYBLOK_DATABASE_DRIVER=postgresql ANYBLOK_DATABASE_NAME=test_anyblok py.test anyblok/tests

To run tests of all installed bloks with demo data:

anyblok_createdb --db-name test_anyblok --db-driver-name postgresql --install-all-bloks --with-demo
ANYBLOK_DATABASE_DRIVER=postgresql ANYBLOK_DATABASE_NAME=test_anyblok py.test anyblok/bloks

AnyBlok is tested continuously using Travis CI

Contributing (hackers needed!)

AnyBlok is ready for production usage even though it can be improved and enriched. Feel free to fork, talk with core dev, and spread the word !


Jean-Sébastien Suzanne


  • Jean-Sébastien Suzanne

  • Georges Racinet

  • Pierre Verkest

  • Franck Bret

  • Denis Viviès

  • Alexis Tourneux

  • Hugo Quezada

  • Simon André

  • Florent Jouatte

  • Christophe Combelles

  • Sébastien Chazallet


Bugs and features enhancements to AnyBlok should be reported on the Issue tracker.


1.2.0 (2021-04-14)

  • Adapted to SQLAlchemy >= 1.4

  • Fixed Many2One with pycountry as primary key

  • Fixed Many2One with primary_key=True, when primary key is True, this nullable is forced to False

  • Refactored hybrid_property to use the decorator mecanisme

  • Adapted SQLA.URL manipulation, which was became immutable

  • Used the inspect method, not the deprecated Inspector

  • Refactored View, need the latest version of sqlalchemy-views

  • Removed old sqlalchemy interfaces for MySQL, replaced it by entry points

  • Added engine.event entry point to define action on engine

  • Added engine.event.**dialect name** entry point to define action on the engine for the dialect

  • Added session.event.**dialect name** entry point to define action on the session for the dialect

  • Added entries in configuration to ignore migration for Schema or Model

  • Fixed the configuration of the documentation build on readthedoc

1.1.0 (2021-03-22)

  • Fixed version of SQLAlchemy < 1.4.0, The next version of AnyBlok will be adapted to SQLAlchemy >= 1.4.0 < 2.0.0, and will prepare to SQLAlchemy >= 2.0, See issue #168

  • SQLAlchemy 1.4.0 add a new attribut in the model registry, this attribute conflicts with the registry of AnyBlok. A new attribute anyblok is created on the model to call the registry of AnyBlok. A modification of the attribute registry is done to use both attributes with the same name. A deprecation warning is added on the attibute registry of AnyBlok

1.0.0 (2020-12-03)

  • Added Sequence with no gap to provide functional sequence without gaps.

  • OrderList class_collection can be defined on x2Many

  • Added plugins system for migration of column type

  • Bug Fix on registry loading sequence. The apply_model_schema_on_table method called at registry initialisation has been splitted to make sqlalchemy ORM events registration independent from migration.

  • Added undefined blok behaviour. It is an important behaviour needed and written in the roadmap where the goal is to defined blok which need another inexisting blok. this blok is installabled only if the blok exist. A package can defined a group of bloks that depend of another packages. They bloks are installabled if the another package is installed

  • It is now possible to place a “Model” in another schema on the SGDB

    class MyModelInOtherSchema:
        __db_schema__ = 'my_schema'
  • Now the Email, Selection, Country, Json, Decimal, Interval, LargeBinary columns can be crypted

  • Removed compatibility with Python 3.4 and python 3.5, because these versions are deprecated

  • Added TimeStamp column

  • Added Enum column

  • Added ignore_migration to protect the existing table or column again auto migration when then schema and this definition are diferents

  • Added capability with mssql+pyodbc

  • Fixed View: allow to add Many2One to a View

  • Added flag_modified method on SQLModel #72

  • Add in extra dependencies drivers used in unit tests for dialects tested with cPython

    • postgres: psycopg2-binary

    • mysql: mysqlclient

    • mariadb: mysqlclient

    • mssql: pymssql

    • pyodbc

  • System.Parameter.get do not raise if a default value is provided

  • Add --with-demo parameter while creating a database (anyblok_createdb) in order to load demo data while installing bloks on that database.

  • Fixed issue #45: System.Sequence: inconsistency in ‘number’ field

  • Fixed issue #134: is now possible to validate if the type at each part of foreign key are the same

0.22.5 (2019-06-24)

  • Reverted console script anyblok_nose: to keep compatibility

  • Fixed minimum version of SQLalchemy >= 1.3 in package dependencies

  • Removed some deprecation warning

0.22.2 (2019-06-23)

  • Fixed configfile with pytest with blok tests

0.22.1 (2019-06-22)

  • Fixed configfile with pytest

0.22.0 (2019-06-21)

  • Replaced the nose test by pytest. All the test was converted.

  • Moved and renamed to The file import only the TestCase class to continue to maintain the compatibility with older tests. PR #67

  • the console script anyblok_nose raise an exception. Because this runner can’t execute pytest tests. The goal is to use the nose plugin.

  • Removed the behviour test-bloks-at-install

  • Added compatibility with MySQL and MariaDB. PR #85

0.21.3 (2019-03-19)

  • Fixed issue #83, the name of constraint create by anyblok is truncated to check if the name is the same as the reflected name

0.21.2 (2019-03-18)

  • Fixed truncated constraint, the sqltext is different in function of the DB type

0.21.1 (2019-03-18)

  • Fixed pypi upload

0.21.0 (2019-03-15)

  • Fixed alias. The Model.aliased method now binds the registry to the alias. The goal is to use hybrid_method with alias in AnyBlok.

  • Fixed Column.Country, The latest version of pycountry does not raise a lookup exception When the countries does not exist. Now AnyBlok takes this change into consideration to raise the exception and keep the main behaviour

  • Fixed alias. Now the Model.aliased method links the registry instance into the aliased model. The goal is to use hybrid_method decorator with alias in AnyBlok.

  • Fixed #60: Now DateTime plugins verify also the DateTime columns of the dependencies of the Model

  • Removed Python 3.3 compatibility

  • Improved the NoResultFound Exception for and query.dictone. Now the registry name of the model is added to the exception’s message

  • Fixed compatitibility with SQLAlchemy > 1.3

0.20.0 (2018-09-10)

  • Refactor the plugins MODEL and VIEW to become factory, rename type attribute by factory attribute.

  • issue #53: added primary join for mapping relationship of SQL views to themselves

  • issue #54: on Blok methods pre_migration(), post_migration() and update() the latest_version parameter is now instance of pkg_resources Version class, or None

  • new tests base class: SharedDataTestCase, allowing to share costly fixtures among tests of the same class

  • scripts: removed useless and too magic need_blok

  • fixed Travis configuration for python 3.7

  • plugins sytem optimization: removed stub implementations for all possible methods in base class (gives a substantial speedup in Travis tests).

  • issue #55: Now, the auto migration engine of the Blok is entirely executed between pre_migration() and post_migration().

0.19.3 (2018-09-03)

  • FIX #52, bad naming convention for type of model

0.19.2 (2018-09-01)

  • Fix phone number with an empty string value

  • Fix migration with added more than one new required columns with default values

  • Fix Sql View can define Many2One relationship

  • Fix SQL View, The __mapper__ is put in the Model

  • FIX SQL View, For Sql view the mapping of the field must be find with anyblok prefix column

  • The build of the Model class come from plugin model, The objectif is to implement other than Model or View

0.19.1 (2018-06-07)

  • Remove useless method, because this was move on distribution anyblok_io

  • In Many2Many the generated join table add fieldname to get two M2M with the same models

  • Fix load_namespace_first_step, the bug merged properties between Mixin

0.19.0 (2018-05-29)

  • Remove All mixins, put them in another distribution anyblok_mixins

  • remove bloks anyblok-io, anyblok-io-csv, anyblok-io-xml, they are put in another distribution anyblok_io

  • improve unit test + coverage

0.18.0 (2018-05-22)

  • Refactor of the nose’s plugin by Georges Racinet

  • Add mixin ConditionalForbidUpdate, ConditionalForbidDelete, ConditionalReadOnly, BooleanForbidUpdate, BooleanForbidDelete, BooleanReadOnly, StateReadOnly

0.17.4 (2018-05-16)

  • [FIX] autodoc

0.17.3 (2018-05-16)

  • [FIX] fix remove field

  • [FIX] io formater model with external id. The error forbidden the none / empty value.

  • [FIX] option install_or_update_bloks, if one blok is marked as toupdate, then this blok will be not marked as toinstall

  • [FIX] Blok.import_file have not raise if does not found error_found in the result of the import

  • [FIX] Model.get_primary_keys with polymorphism (single table)

  • Remove column.uText, column.uString, column.SmallInteger

  • [ADD] column.PhoneNumber

  • [ADD] column.Email

  • [ADD] column.Country

0.17.2 (2018-02-27)

  • [FIX] hasattr on field.Function

  • [IMP] Improve rich Many2Many to allow to have got a rich Many2Many with the same model on the both side, Add also a new attribute join_model to compute the real join table from the table name defined on the Model, In the case of join_model with column based on Many2One. Add an option to force recompute secondaryjoin and primaryjoin in the case where the model join have more than one foreign key to one of the both model. the m2m_local_columns and m2m_remote_columns become required attribute

  • [ADD] New field.JsonRelated. The goal is to manipulate a json entry as a column

0.17.1 (2018-02-24)

  • [FIX] repr when no value for relationship

0.17.0 (2018-02-23)

  • [FIX] SQLAlchemy_Utils changed the import path of EncryptedType in version 0.33.0

  • [REF] Add default_time on configuration and DateTime column. Before this change a naive datetime get the timezone of server host, now it possible to add the attibute default_timezone on each column or default_timezone on configuration for all the column. For each DateTime column the default timezone use is define by the order:

    1. default_timezone on column (if defined)

    2. default_timezone in configuration (if defined)

    3. timezone of the server

  • [REF] add a function in config to get the name of the database from Configuration db_name or db_url. The script anyblok_createdb and the plugin use this function.

  • [IMP] Add option –anyblok-db-url in plugin nose options. the options can have default value from environment variable ANYBLOK_DATABASE_URL

  • [IMP] add primary_key attibute on Many2One and One2One. Only when the column is created by the relationship Many2One or One2One. The column created get the attribute primary_key gave to relationship and apply it.

  • [IMP] add repr default method on all SqlModel and ViewSqlModel

  • [FIX] Encrypt columns, the custom type from anyblok did not implement the process_result_value need for decrypt value

  • [REF] Simplify Configuration, old and unused code are removed

0.16.2 (2018-02-12)

  • [FIX] Add column with an unique constraint. Alembic declare now two changes: add column and add unique constraint . Then the migration operation add column must not create the constraint

  • [IMP] add index constraint operation. Alembic declare now add unique constraint, the migration operation create the constraint on an existing and an unexisting columns

  • [IMP] add index attibute on Many2One and One2One. Only when the column is created by the relationship Many2One or One2One. The column created get the attribute index gave to relationship and apply it.

  • [FIX] raise an ConfigurationException on wrong path if an inexisting configuration file is given the the exception is raised

  • [REF] update anyblok.start The configuration is now loaded when configuration_group is none

  • [ADD] isolation_level configuration The isolation level can be passed by anyblok.start or by the Configuration The default value is READ_COMMITTED, In the case or console script and Configuration add isolation level, the isolation used is always the isolation came from anyblok.start

  • [REF] The nose plugins take the tests directories in any location in the blok not only at the root of the blok

  • [REF] The options test-blok-at-install take the tests directory in any location in the blok not only at the root of the blok

  • [REF] The anyblok_nose console script to take the tests directories in any location in the blok not only at the root of the blok

0.16.1 (2018-01-29)

  • [FIX] Many2Many on the same Model

  • [FIX] Many2One with multi primary key

  • [FIX] add specific exception when the number of column in join table for many2many is not the same that primary key

0.16.0 (2018-01-25)

  • [REF] Json field, use the Json field from SQLAlchemy, because it is implemented by the db

  • [FIX] check constraint on selection to get a name without number of entry

0.15.0 (2018-01-17)

  • [REF] column Selection add check constraint to forbid other value than the wanted

0.14.0 (2018-01-15)

  • [REF] change log level, the instalation become less verbose

  • [REF] change namimg convention, dont check in function of table and column name to know if it is an AnyBlok constraint

  • [FIX] check if a drop check constraint is not a add check constraint truncated

  • [ADD] raise an exception if the primary changed, this action is too complexe to know how transform the relationship and keep the real value

0.13.0 (2018-01-09)

  • [FIX] check constraint must not be create at the same time that the column, because the column of the constraint could have not exist yet

  • [REF] change namimg convention

  • [FIX] detect and apply drop check constraint in the migration

  • [FIX] detect and apply add check constraint in the migration

0.12.2 (2018-01-04)

  • [FIX] name of the created class, before the fix anyblok use the tablename. In the case of polymorphism on single table, sqlalchemy found two two or more mappers for a single mapper name. Now the class name is the registry name without dot. This change have consequence only if the primary join is forced. In the case:

    Test = registry.Test

    you need to change:

    primaryjoin = ' == ...'


    primaryjoin = ' == ...'
  • [FIX] name of the fakecolumn when a Many2One is added whitout existing column names. This action allow to create two Many2One to the same remote Model.

  • [FIX] In the One2Many when two foreign keys found to the same primary key the primary join of the relation ship is now a or_ not a and_

  • [FIX] One2Many detect also the Many2One to get the FakeColumn to do primary join

0.12.1 (2017-12-23)

  • [FIX] not invalidate cache on an uninstalled model

0.12.0 (2017-12-23)

  • [FIX] Declare Field Function in Polymophic subclass

  • [FIX] Declare Field Function in Polymophic

  • [ADD] auto register of sqlalchemy ORM event

  • [ADD] Mixin to do readonly

  • [REMOVE] cron functionality, it will be add in another package anyblok_dramatiq

  • [FIX] Field.DateTime documentation, add is auto updated

  • [REF] add entry point anyblok.session.event and additional_setting anyblok.session.event to add some events on the session

  • [FIX] clean foreign_key in some column type, now the foreign_key is made by Column class

  • [FIX] remove for System.Field and System.Model the removed fields

0.11.1 (2017-11-28)

  • [ADD] in DBTestCase add init_registry_with_bloks, this method is similar at init_registry, it install the bloks after add the new model

  • [FIX] create precommit_hooks in the EnvironnementManager if it does not exist

  • [FIX] create postcommit_hooks in the EnvironnementManager if it does not exist

0.11.0 (2017-11-20)

  • [ADD] log debug for commit / rollback

  • [REF] precommit_hook, can also be on no SQL Model

  • [ADD] postcommit_hook

  • [FIX] UUID inheritance

0.10.1 (2017-11-14)

  • [FIX] change log

0.10.0 (2017-11-14)

  • [ADD] anyblok_configuration.post_load to initialize some services in function of configuration

  • [REF] Update configuration groups to add dramatiq-broker by default. This configuration groups is filled by anyblok_dramatiq package

  • [FIX] when the applications configuration has not configuration_groups then the configuration use the configuration_groups of the default application

  • [ADD] Add configuration group preload definition, but not used

  • [ADD] Entry point anyblok.model.plugin to add behaviour on the model

  • [REF] hybrid_method become an anyblok.model.plugin

  • [REF] adapter of mapper_args and table_args become an anyblok.model.plugin

  • [REF] event become an anyblok.model.plugin

  • [REF] sqlachemy event become an anyblok.model.plugin

  • [REF] cache and classmethod_cache become an anyblok.model.plugin

  • [IMP] Configuration.add_configuration_group need to add a new group for a console script

  • [IMP] add new anyblok.model.plugin to update datetime columns when the auto_update is True

0.9.10 (2017-09-23)

  • [FIX] type Paramater => Parameter

  • [IMP] add the the author in autodoc

  • [IMP] in the script blok the exclude and include model can use .* to take children in the namespace

  • [FIX] anyblok_doc with UML, don ‘t make agregation when the model doesn’t exist

0.9.9 (2017-09-19)

  • [FIX]: add logo in the

0.9.8 (2017-09-19)

  • [IMP] fields_description add remote_name

  • [Update] doc, add foreign_key_option and unique for Many2One

  • [IMP] add expire_all and expunge registry methods, expire all the instance in the session

  • [IMP] add expunge method on the instance

  • FIX]: expire attribute must use also all the fields which come from polymorphic model

  • [FIX] if ondelete=cascade in foreign keu options, then the many2one force the delete directely in the session

  • [FIX] delete method can be also be que session.query, mapping.remove can use this session.query.delete to remove in case of recursivity

  • [IMP] IO.Mapping save the blok name when use the Blok.import_file method

  • [IMP] IO blok overload Model.delete and Query.delete to delete mapping with instances of the Models

  • [FIX] create new session make must commit and remove all old session instances

  • [IMP] add Mapping.clean method to clean unlinked mapping

  • [IMP] add Mapping.remove_for_blokname method to remove mapping and obj

  • [IMP] add new field in Model.System.Blok author and logo

0.9.7 (2017-07-03)

  • [FIX] field_description get also the polymorphique fields from inherit model

0.9.6 (2017-07-03)

  • [FIX] in One2Many and Many2Many field, the attribute model can be used on record node. Used for Polymorphisme

0.9.5 (2016-12-05)

  • [ADD] Python 3.6 support

  • Flake8

0.9.4 (2016-10-27)

  • [FIX] Nose test pluggins load the configuration need for unit test

  • [ADD] getFieldType on SQLBase, this method return the type of the column

0.9.3 (2016-10-12)

  • [FIX] SQLAlchemy 1.1.* add autoincrement=’auto’, or AnyBlok wait Boolean. If the field is an Integer and a primary_key with autoincrement=’auto’ then the value is True else False

  • [FIX] SQLAlchemy 1.1.*, primary_key attribute don’t define autoincrement. The column Integer with a primary_key=True whithout autoincrement declaration use autoincrement=True

  • [FIX] SQLAlchemy 1.1.*, backref property check if the collection_class has __emulates__ attributes. InstrumentedList haven’t to have this attribute

  • [FIX] SQLAlchemy 1.1.*, Session State changed, update the update method of the registry to install / update / uninstall bloks

  • [FIX] SQLAlchemy 1.1.*, Hybrid property don’t propagate the relationship info attribute. The propagate is forced for Many2One and One2One. The only both relationships to be wrapped by hybrid_property

  • [FIX] SQLAlchemy 1.1.*, Hybrid property wrap the fget result in the case of the fget is called on the class (not the instance). Adapt the unit test, don’t check if the result id of column are the same, check if the expression give by this results are the same.

  • [FIX] SQLAlchemy 1.1.*, listen can not be used with a hybrid_property. In the case of a listen, the mapper returned is not the hybrid_property but the real wrapped field

0.9.2 (2016-10-12)

  • [FIX] error with pip

0.9.1 (2016-10-3)

  • [FIX] migration testcase

  • [FIX] graphviz FORMATS

  • [FIX] travis configuration

0.9.0 (2016-07-11)

  • [REF] add Configuration.has method

  • [FIX] test migration, force to load registry with unittest=True

  • [FIX] test event

  • [FIX] test blok

  • [FIX] mapper with None parameter

  • [FIX] add set_defaults in parser to update configuration dict

  • [FIX] one2many remote columns

  • [FIX] load anyblok.init in the unit test

  • [IMP] Add plugins by configuration for:

    • Registry

    • Migration

    • get_url

  • [IMP] add LogCapture

  • [IMP] TestCase.Configuration, use to update Configuration only in a context manager

  • [IMP] add Registry.db_exists class method, check with the configuration and the db_name if the connection is possible

0.8.5 (2016-06-20)

  • [FIX] utf-8 encoding

  • [REF] move bitbucket (mergurial) to github (git)

0.8.4 (2016-06-14)

  • [FIX] io/xml/importer one2many field

  • [FIX] install blok, who are not in the blok list yet. But the blok is loaded

0.8.3 (2016-04-18)

  • [FIX] cache and classmethod_cache on SQL model

  • [ADD] is_installed classmethod cache

0.8.2 (2016-04-06)

  • [REF] IO.Mapping methods delete and multi_delete can remove entry

  • [FIX] datetime with timezone use timezone.localize, better than datetime.replace(tzinfo=…)

  • [ADD] update sphinx extension

0.8.1 (2016-03-15)

  • [FIX] #21 Improve Decimal column setter

  • [FIX] #22 String, uString, Text and uText write ‘’ in database for False value

  • [FIX] Change the external_id save in a two way

  • [FIX] #23 Column.Selection with None value, don’t return ‘None’ value by the getter

0.8.0 (2016-02-05)

  • [REF] session expire is now on the attribute, the update method is refactored too.

  • [FIX] blok: update version if the version change

  • [REF] add required blok, this bloks is installed and updated by the scripts anyblok_updatedb and anyblok_createdb

  • [ADD] Add Color Column

  • [REF] column can be encrypted

  • [REF] DataTime column is not a naive datatime value

  • [ADD] Add Password Column

  • [ADD] Add UUID Column

  • [ADD] Add URL Column

0.7.2 (2016-01-14)

  • [FIX] delete flush after remove of the session

  • [FIX] nose plugins

  • [FIX] does’nt destroy automaticly constraints (not created by anyblok), indexes (not created by anyblok), columns, tables by automigration, add options to force the delete of its.

  • [REF] standardize the constraint and index names

  • [FIX] Multi declaration of the same foreign key in the case of M2O and O2O

  • [REF] SqlBase.update, become hight level meth

0.7.1 (2016-01-08)

  • [FIX] didn’t cast the config data from the config file

  • [IMP] copy init entry point from anyblok_pyramid

0.7.0 (2016-01-07)

  • [REF] Add options to give database url, No break compatibility

  • [REF] the argument of ArgumentParser can be add in the configuration
    • Improve the help of the application

    • Improve the type of the configuration, Work also with config file.

    • Adapt current configuration

  • [REF] start to use sqlalchemy-utils, replace the database management

  • [IMP] #18 Forbidden the declaration of SQLAchemy column or relationship

  • [REF] #15 Refactor unittest case to not create/drop database for each test

  • [FIX] #19 During migration if an unique constraint must be apply without unique value, then the constraint will be ignore and log a warning. No break the instalation of the blok

  • [FIX] #20 Update meth: expire the instance cause of relationship

  • [IMP] refresh and expire meth on model

  • [REF] delete obj, flush the session and delete the instance of obj of the session, before expire all the session, the goal is to reload the relation ship.

  • [REF] #13 Remove association model, replace it by call at the Blok definition

  • [IMP] #14 Add conflicting link between blok, two blok who are in conflict can be installed if the other is installed

0.6.0 (2016-01-07)

  • [REF] unittest isolation

  • [IMP] possibility to apply an extension for sqlalchemy

  • [ADD] pool configuration

0.5.2 (2015-09-28)

  • [IMP] extension for Sphinx and autodoc

  • [ADD] API doc in doc

  • [ADD] add foreign key option in relation ship

  • [CRITICAL FIX] the EnvironnementManager didn’t return the good scoped method for SQLAlchemy

  • [CRITICAL FIX] the precommit_hook was not isolated by session

  • [REF] add a named argument must_be_loaded_by_unittest, by dafault False, in Configuration.add to indicate if the function must be call during the initialisation of the unittest, generally for the configuration initialized by Environ variable

0.5.1 (2015-08-29)

  • [IMP] unload declaration type callback

0.5.0 (2015-08-28)

  • [IMP] add pop behaviour on Model.System.Parameter

  • [REF] Load configuration befoare load bloks, to use Configuration during the declaration

  • [FIX] all must return InstrumentedList, also when the result is empty

  • [FIX] to_dict must not cast column

  • [REF] add third entry in foreign key declaration to add options

  • [IMP] ModelAttribute used to declarate the need of specific attribute and get the attribute or the foreign key from this attribute

  • [IMP] ModelAttributeAdapter, get a ModelAttribute from ModelAttribute or str

  • [IMP] ModelRepr, Speudo representation of a Model

  • [IMP] ModelAdapter, get a ModelRepr from ModelRepr or str

  • [IMP] ModelMapper and ModelAttributeMapper

  • [REF] Event, the declaration of an event can be an anyblok or a sqlalchemy event

  • [REF] the foreign key must be declared with ModelAttribute

  • [REF] Use Adapter for Model and attribute in relation ship

  • [REF] hybrid_method, cache and classmethod_cache are now only impotable decorator function

  • [IMP] in column the default can be a classmethod name

  • [REF] replace all the field (prefix, suffic, …) by a formater field. It is a python formater string

  • [IMP] Sequence column

  • [IMP] add the default system or user configuration file

0.4.1 (2015-07-22)

  • [FIX] Field.Function, fexp is now a class method

  • [REF] reduce flake8 complexity

  • [REF] refactor field function

  • [FIX] inherit relation ship from another model, thank Simon ANDRÉ for the bug report

  • [REF] table/mapper args definition

  • [REF] Refactor Field, Column, RelationShip use now polymophic inherit

  • [FIX] Foreign key constraint, allow to add and drop constraint on more than one foreign key

  • [ADD] update-all-bloks option

  • [ADD] pre / post migration

  • [REF] UML Diagram is now with autodoc script

  • [REF] SQL Diagram is now with autodoc script

  • [REF] Add extend key word in configuration file to extend an existing configuration

0.4.0 (2015-06-21)

  • [REF] Add the possibility to add a logging file by argparse

  • [ADD] No auto migration option

  • [ADD] Plugin for nose to run unit test of the installed bloks

  • [REF] The relation ship can be reference more than one foreign key

  • [IMP] Add define_table/mapper_args methods to fill __table/mapper_args__ class attribute need to configure SQLAlachemy models

  • [REF] Limit the commit in the registry only when the SQLA Session factory is recreated

  • [REF] Commit and re-create the SQLA Session Factory, at installation, only if the number of Session inheritance of the number of Query inheritance change, else keep the same session

  • [REF] Exception is not a Declarations type

  • [FIX] Reload fonctionnality in python 3.2

  • [REF] Remove the Declarations typs Field, Column, RelationShip, they are replaced by python import

  • [REF] rename ArgsParseManager by Configuration

  • [REF] rename reload_module_if_blok_is_reloaded by reload_module_if_blok_is_reloading method on blok

  • [REF] rename import_cfg_file by import_file method on blok

  • [REF] Consistency the argsparse configuration

  • [REF] refactor part_to_load, the entry points loaded is bloks

  • [IMP] Allow to define another column name in the table versus model

  • [FIX] add importer for import configuration file

  • [FIX] x2M importer without field just, external id

0.3.5 (2015-05-10)

  • [IMP] When a new column is add, if the column have a default value, then this value will be added in all the entries where the value is null for this column

  • [REF] import_cfg_file remove the importer when import has done

0.3.4 (2015-05-10)

  • [ADD] on migration script to indicate what is changed

  • [IMP] Add sequence facility in the declaration of Column

  • [ADD] ADD XML Importer

0.3.3 (2015-05-04)

  • [FIX] createdb script

0.3.2 (2015-05-04)

  • [IMP] doc

  • [REF] Use logging.config.configFile

0.3.1 (2015-05-04)

  • [IMP] Update setup to add documentation files and blok’s README

0.3.0 (2015-05-03)

  • [IMP] Update Doc

  • [FIX] Remove nullable column, the nullable constraint is removed not the column

  • [ADD] Formater, convert value 2 str or str 2 value, with or without mapping

  • [ADD] CSV Importer

  • [REF] CSV Exporter to use Formater

0.2.12 (2015-04-29)

  • [IMP] CSV Exporter

  • [IMP] Exporter Model give external ID behaviour

  • [ADD] Sequence model (Model.System.Sequence)

  • [ADD] fields_description cached_classmethod with invalidation

  • [ADD] Parameter Model (Model.System.Parameter)

  • [FIX] environnement variable for test unitaire

0.2.11 (2015-04-26)

  • [FIX] UNIT test createdb with prefix

0.2.10 (2015-04-26)

  • [IMP] add enviroment variable for database information

  • [ADD] argsparse option install all bloks

  • [FIX] Python 3.2 need that bloks directory are python modules, add empty __init__ file

0.2.9 (2015-04-18)

  • [FIX] Add all rst at the main path of all the bloks

0.2.8 (2015-04-16)

  • [IMP] unittest on SQLBase

  • [IMP] add delete method on SQLBase to delete une entry from an instance of the model

  • [REF] rename get_primary_keys to get_mapping_primary_keys, cause of get_primary_keys already exist in SQLBase

0.2.7 (2015-04-15)

  • [IMP] Add IPython support for interpreter

  • [REF] Update and Standardize the method to field the models (Field, Column, RelationShip) now all the type of the column go on the ftype and comme from the name of the class

0.2.6 (2015-04-11)

  • [FIX] use the backref name to get the label of the remote relation ship

  • [FIX] add type information of the simple field

0.2.5 (2015-03-23)

  • [FIX] In the parent / children relationship, where the pk is on a mixin or from inherit

  • [FIX] How to Environment

  • [FIX] Many2Many declared in Mixin

  • [IMP] Many2One can now declared than the local column must be unique ( only if the local column is not declared in the model)

0.2.3 (2015-03-23)

  • [FIX] Allow to add a relationship on the same model, the main use is to add parent / children relation ship on a model, They are any difference with the declaration of ta relation ship on another model

  • [REF] standardize foreign_key and relation ship, if the str which replace the Model Declarations is now the registry name

0.2.2 (2015-03-15)

  • [REF] Unittest
    • TestCase and DBTestCase are only used for framework

    • BlokTestCase is used:
      • by run_exit function to test all the installed bloks

      • at the installation of a blok if wanted

0.2.0 (2015-02-13)

  • [REF] Import and reload are more explicite

  • [ADD] IO:
    • Mapping: Link between Model instance and (Model, str key)

  • [ADD] Env in registry_base to access at EnvironmentManager without to import it at each time

  • [IMP] doc add how to on the environment

0.1.3 (2015-02-03)

  • [FIX] setup long description, good for pypi but not for easy_install

0.1.2 (2015-02-02)

  • [REFACTOR] Allow to declare Core components

  • [ADD] Howto declare Core / Type

  • [FIX] Model can only inherit simple python class, Mixin or Model

  • [FIX] Mixin inherit chained

  • [FIX] Flake8

0.1.1 (2015-01-23)

  • [FIX] version, documentation, setup

0.1.0 (2015-01-23)

Main version of AnyBlok. You can with this version

  • Create your own application

  • Connect to a database

  • Define bloks

  • Install, Update, Uninstall the blok

  • Define field types

  • Define Column types

  • Define Relationship types

  • Define Core

  • Define Mixin

  • Define Model (SQL or not)

  • Define SQL view

  • Define more than one Model on a specific table

  • Write unittest for your blok

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

AnyBlok-1.2.0.tar.gz (257.8 kB view hashes)

Uploaded Source

Built Distribution

AnyBlok-1.2.0-py3-none-any.whl (292.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page