Skip to main content

Anyblok is a dynamic injection blok framework

Project description

.. This file is a part of the AnyBlok project
..
.. Copyright (C) 2014 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
..
.. This Source Code Form is subject to the terms of the Mozilla Public License,
.. v. 2.0. If a copy of the MPL was not distributed with this file,You can
.. obtain one at http://mozilla.org/MPL/2.0/.

.. image:: https://travis-ci.org/AnyBlok/AnyBlok.svg?branch=master
:target: https://travis-ci.org/AnyBlok/AnyBlok
:alt: Build status

.. image:: https://coveralls.io/repos/github/AnyBlok/AnyBlok/badge.svg?branch=master
:target: https://coveralls.io/github/AnyBlok/AnyBlok?branch=master
:alt: Coverage

.. image:: https://img.shields.io/pypi/v/AnyBlok.svg
:target: https://pypi.python.org/pypi/AnyBlok/
:alt: Version status

.. image:: https://readthedocs.org/projects/anyblok/badge/?version=latest
:alt: Documentation Status
:scale: 100%
:target: https://doc.anyblok.org/en/latest/?badge=latest

AnyBlok
=======

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`.

See the `latest documentation <http://doc.anyblok.org/>`_

.. This file is a part of the AnyBlok project
..
.. Copyright (C) 2015 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
.. Copyright (C) 2016 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
..
.. This Source Code Form is subject to the terms of the Mozilla Public License,
.. v. 2.0. If a copy of the MPL was not distributed with this file,You can
.. obtain one at http://mozilla.org/MPL/2.0/.

.. AnyBlok documentation master file, created by
sphinx-quickstart on Mon Feb 24 10:12:33 2014.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.

.. contents::

Front Matter
============

Information about the AnyBlok project.

Project Homepage
----------------

AnyBlok is hosted on `github <http://github.com>`_ - the main project
page is at http://github.com/AnyBlok/AnyBlok or
http://code.anyblok.org. Source code is tracked here
using `GIT <https://git-scm.com>`_.

Releases and project status are available on Pypi at
http://pypi.python.org/pypi/anyblok.

The most recent published version of this documentation should be at
http://doc.anyblok.org.

Project Status
--------------

AnyBlok is currently in alpha status and is expected to be fairly
stable. 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 https://github.com/AnyBlok/AnyBlok/archive/master.zip.

Installation
------------

Install released versions of AnyBlok from the Python package index with
`pip <http://pypi.python.org/pypi/pip>`_ or a similar tool::

pip install anyblok

Installation via source distribution is via the ``setup.py`` script::

python setup.py install

Installation will add the ``anyblok`` commands to the environment.

.. note:: AnyBlok use Python version >= 3.3

Running Tests
-------------

.. seealso:: the :ref:`section about testing of AnyBlok applications
<basedoc_tests>`.


To run framework tests with ``nose``::

pip install nose
nosetests anyblok/tests

To run tests of all installed bloks::

anyblok_nose -c config.file.cfg

To run Blok tests during their installation::

anyblok_updatedb -c config.file.cfg --install_bloks myblok --test-blok-at-install

AnyBlok is tested continuously using `Travis CI
<https://travis-ci.org/AnyBlok/AnyBlok>`_

Dependencies
------------

AnyBlok works with **Python 3.3** and later. The install process will
ensure that `SQLAlchemy <http://www.sqlalchemy.org>`_,
`Alembic <http://alembic.readthedocs.org/>`_,
`SQLAlchemy-Utils <http://sqlalchemy-utils.readthedocs.org/>`_ are installed,
in addition to other dependencies.

AnyBlok works with SQLAlchemy from version **1.0.11**,
Alembic from version **0.8.4** and SQLAlchemy-Utils from version **0.31.4**.
The latest version of them is strongly recommended.


Contributing (hackers needed!)
------------------------------

Anyblok is at a very early stage, feel free to fork, talk with core dev, and spread the word!

Author
------

Jean-Sébastien Suzanne

Contributors
------------

`Anybox <http://anybox.fr>`_ team:

* Georges Racinet
* Christophe Combelles
* Jean-Sébastien Suzanne
* Florent Jouatte
* Simon André
* Pierre Verkest

other:

* Sébastien Chazallet
* Franck Bret

Bugs
----

Bugs and feature enhancements to AnyBlok should be reported on the `Issue
tracker <http://issue.anyblok.org>`_.

.. This file is a part of the AnyBlok project
..
.. Copyright (C) 2014 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
.. Copyright (C) 2015 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
.. Copyright (C) 2016 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
.. Copyright (C) 2017 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
.. Copyright (C) 2018 Jean-Sebastien SUZANNE <jssuzanne@anybox.fr>
..
.. This Source Code Form is subject to the terms of the Mozilla Public License,
.. v. 2.0. If a copy of the MPL was not distributed with this file,You can
.. obtain one at http://mozilla.org/MPL/2.0/.

CHANGELOG
=========

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

.. warning::

This options are only use for naive datetime, to save them with a timezone.
In the case of a datetime with timezone, this datetime keep their own datetime.

* [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
Test.id

you need to change::

primaryjoin = 'test.id == ...'

by::

primaryjoin = 'ModelTest.id == ...'

* [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.

.. warning::

This change have a big consequence on existing table, because a new column
is added and the origin column is mark as unknown. You have to rename the column
by SQL migration or add the column in Model or force the name in Many2One.

* [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 MANIFEST.in

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] setup.py: 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 <https://bitbucket.org/jssuzanne/anyblok/issues/21/update-setter-for-decimal>`_
Improve Decimal column setter
* [FIX] `#22 <https://bitbucket.org/jssuzanne/anyblok/issues/22/string-ustring-text-utext-columns-save>`_
String, uString, Text and uText write '' in database for False value
* [FIX] Change the external_id save in a two way
* [FIX] `#23 <https://bitbucket.org/jssuzanne/anyblok/issues/23/selection-field-when-nullable-true-doesnt>`_
Column.Selection with None value, don't return 'None' value by the getter

0.8.0 (2016-02-05)
------------------

.. warning::

Break the compatibility with the previous version of anyblok

* update method on the model
replace ::

obj.update({field1: val1, ...})

by::

obj.update(field1=val1, ...)

* [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)
------------------

.. warning::

Python 3.2 is not supported

* [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 <https://bitbucket.org/jssuzanne/anyblok/issues/18/forbidden-the-declaration-of-sqlachemy>`_
Forbidden the declaration of SQLAchemy column or relationship
* [REF] `#15 <https://bitbucket.org/jssuzanne/anyblok/issues/15/speed-up-the-unittest>`_
Refactor unittest case to not create/drop database for each test
* [FIX] `#19 <https://bitbucket.org/jssuzanne/anyblok/issues/19/migration-contrainte>`_
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 <https://bitbucket.org/jssuzanne/anyblok/issues/20/update-meth-must-refresh-the-instance-when>`_
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 <https://bitbucket.org/jssuzanne/anyblok/issues/13/refactor-inheritance-tree>`_
Remove association model, replace it by call at the Blok definition
* [IMP] `#14 <https://bitbucket.org/jssuzanne/anyblok/issues/14/add-conflicting-link-between-bloks>`_
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)
------------------

.. warning::

Break the compatibility with the previous version of anyblok

* cache, classmethod_cache, hybrid_method and listen
replace::

from anyblok import Declarations
cache = Declarations.cache
classmethod_cache = Declarations.classmethod_cache
hybrid_method = Declarations.hybrid_method
addListener = Declarations.addListener

by::

from anyblok.declarations import (cache, classmethod_cache,
hybrid_method, listen)

.. note::

The listener can declare SQLAlchemy event

* declaration of the foreign key
replace::

@register(Model):
class MyClass:

myfield = Integer(foreign_key=(Model.System.Blok, 'name'))
myotherfield = Integer(foreign_key=('Model.System.Blok', 'name'))

by::

@register(Model):
class MyClass:

myfield = Integer(foreign_key=Model.System.Blok.use('name'))
myotherfield = Integer(foreign_key="Model.System.Blok=>name")

* [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)
------------------

.. warning::

Field Function change, fexp is required if you need filter

* [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)
------------------

.. warning::

Break the compatibility with the previous version of anyblok

* [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] logger.info 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)
------------------

.. warning::

This version can be not compatible with the version **0.2.2**. Because
in the foregn key model is a string you must replace the tablename by
the registry name

* [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)
------------------

.. warning::

This version is not compatible with the version **0.1.3**

* [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-0.17.3.tar.gz (224.6 kB view hashes)

Uploaded Source

Built Distribution

AnyBlok-0.17.3-py3-none-any.whl (276.9 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