Changelog

[0.17.0] - 2025-01-14

Added

• New setup extra test which installs the dependencies for testing.
• The Container class has a new member function filter_by_identity which is based on _filter_entity_list.
• The Entity properties _cuid and _flags are now available for read-only access as cuid and flags, respectively.

Changed

• Renamed the filter function of Container, ParentList and PropertyList to filter_by_identity.

Deprecated

• ParentList.filter and PropertyList.filter functions, use filter_by_identity instead.

Removed

• Support for Python 3.8

Fixed

• #73 Entity.to_xml now detects potentially infinite recursion and prevents an error
• #89 to_xml does not add noscript or TransactionBenchmark tags anymore
• #103 authentication/interface/on_response() does not overwrite auth_token if new value is None
• #119 The diff returned by compare_entities now uses id instead of name as key if either property does not have a name
• #87 XMLSyntaxError messages when parsing (incomplete) responses in case of certain connection timeouts. The diff returned by compare_entities now uses id instead of name as key if either property does not have a name
• #127 pylinkahead.ini now supports None and tuples as values for the timeout keyword

Changelog

[0.16.0] - 2024-11-13

Added

• ParentList and PropertyList now have a filter function that allows to select a subset of the contained elements by ID and/or name.
• Official support for Python 3.13
• Added arguments to describe_diff that allow customizing the labels for the 'old' and the 'new' diffs.
• Optional realm argument for linkahead_admin.py set_user_password which defaults to None, i.e., the server's default realm.

Changed

• compare_entities is now case insensitive with respect to property and recordtype names
• _ParentList is now called ParentList
• _Properties is now called PropertyList
• ParentList.remove is now case insensitive when a name is used.

Deprecated

• the use of the arguments old_entity and new_entity in compare_entities is now deprecated. Please use entity0 and entity1 respectively instead.

Fixed

• gitlab.indiscale.com#200 linkahead_admin.py prints reasonable error messages when users or roles don't exist.

Changelog

[0.15.1] - 2024-08-21

Deprecated

• connection.get_username. Use la.Info().user_info.name instead.

Fixed

• #128 Assign datetime.date or datetime.datetime values to DATETIME properties.

Documentation

• Added docstrings for linkahead.models.Info and linkahead.models.UserInfo.

Changelog

[0.15.0] - 2024-07-09

Added

• Support for Python 3.12
• The linkahead module now opts into type checking and supports mypy.
• #112 Entity.update_acl now supports optional **kwargs that are passed to the Entity.update method that is called internally, thus allowing, e.g., updating the ACL despite possible naming collisions with unique=False.
• a role argument for get_entity_by_name and get_entity_by_id

Changed

• Using environment variable PYLINKAHEADINI instead of PYCAOSDBINI.

Removed

• Support for Python 3.7

Fixed

• #104 Selecting parts of a Container with a slice used to return a list object instead of a Container, removing all useful methods of the Container class. This has been fixed and using a slice such as [:2] now returns a new Container.
• #120 Unwanted subproperties in reference properties.

Documentation

• Added documentation and a tutorial example for the usage of the page_length argument of execute_query.

Changelog

[0.14.0] - 2024-02-20

Added

• utils.merge_entities now has a merge_id_with_resolved_entity keyword which allows to identify property values with each other in case that one is an id and the other is an Entity with this id. Default is False, so no change to the default behavior.
• apiutils.escape_quoted_text for escaping text in queries.

Changed

• cached_query() now also caches uniqueness related exceptions.

Changelog

[0.13.2] - 2023-12-15

Fixed

• #113 Container could fail to delete when there were reference properties.
• HTTP status 431 (Headers too long) now also raises an URI too long exception.

Changelog

[0.13.1] - 2023-10-11

Fixed

• no Error when no configuration file is used Issue

[0.13.0] - 2023-10-10

Added

• New page_length parameter for caosdb.execute_query and caosdb.Query.execute. See docstrings for more details.
• Entity.remove_value_from_property function that removes a given value from a property and optionally removes the property if it is empty afterwards.

Changed

• _Messages is now Messages and inherits from list instead of dict
• Message.__init__ signature changed and type defaults to "Info" now.
• Message.__eq__ changed. Equality is equality of type, code, and description now.
• Rename from CaosDB to LinkAhead. For proper migration, follow the instructions in migration_to_linkahead.md and check the documentation at docs.indiscale.com.

Deprecated

• The API of Messages has been simplified and some ways to interact with messages have been deprecated. Warnings are raised correspondingly.
• Message.get_code. Use the code property instead.

Fixed

• Detection for cyclic references when converting entites using the high level API.

Changelog

[0.12.0] - 2023-06-02

Added

• Added location argument to src/caosdb/utils/checkFileSystemConsistency.py
• Entity getters: get_entity_by_<name/id/path>
• Cached versions of entity getters and of execute_query (cached_query)

Deprecated

• getOriginUrlIn, getDiffIn, getBranchIn, getCommitIn (formerly apiutils) have been moved to caosdb.utils.git_utils

Fixed

• Fixed src/caosdb/utils/checkFileSystemConsistency.py

Documentation

• #83 - Improved documentation on adding REFERENCE properties, both in the docstring of Entity.add_property and in the data-insertion tutorial.

[0.11.2] - 2023-03-14

Fixed

• root logger is no longer used to create warnings. Fixes undesired output in stderr