v2.5

This release is a minor release (no change were made to the specifications) which contains improvements to the server, to the Python client, to the CLI and to the documentation. A new extension is added to generate ulid identifiers (see details below). The methods of the Python client module now return explicit error codes. An event listener example is provided to listen to the server events using Python and web sockets. The documentation was improved, as well as 2 bugs fixed.

Here is a more detailed list of changes:

Server

• ulid support (https://github.com/remyla/damas-core/wiki/Extensions#ulid)
• socket.io version updated to 4.4.0
• optimization of mongo query in search_mongo
• default now use sha1 passwords instead of md5
• in "authorMode": true, now users can delete their own nodes
• allow multiple node authors with array in author key #271
• server log format is configurable in conf.json under morgan key (short,tiny,combined,dev etc. see morgan module for details)
• moved older legacy code to a different branch

CLI

• support for server redirections
• .sh extension removed from the cli command
• errors are written in stderr. closes #254

Documentation

simplified texts of usages and documentation

• CLI usage rewrite
• Python and CLI README files
• Documentation Wiki

Python

• server error codes are now returned by the client's methods
• explicit server error codes returned by methods in Python client. close #244
• added a socket client example damas_socket.py
• new module is in damas_client.py, previous module moved to damas_legacy.py

Bugfixes

• upsert does not modify author. closes #256
• event are now fired before callbacks. closes #262

2.4.1

This release provide new features and improvements for user management, new features for security and changes in command line interface, along with 2 bug fixes in cli.

user management, authentication and security improvements

• server-nodejs : user node structure changed
• server-nodejs : authenticate users using a remote server
• server-nodejs / jwt : signIn with email
• server-nodejs / jwt : specify token lifespan at signIn
• server-nodejs / jwt : per user unique salt
• server-nodejs : auto-switch between md5/sha1
• server-nodejs : store user last activity time
• server-nodejs : moved dam operations to an extension
• server-nodejs : user accounts can be disabled
• server-nodejs : handle JSON parsing errors, return 400

command line interface improvements

• cli: remove file management commands from damas cli
• cli: add –server long option
• cli: updated help
• cli: make search for .damas/config optional
• cli: support for simultaneous connections (unique token for each conn)

bug fixes

• cli: regression found for option -l and arrays of strings
• cli: fix in stdin argument switch

doc

• wiki specifications / API reference improvements
• repository README.md improvements
• html / css improvements

Credits

Contibutors : Axel Pisani @axl-pis, Remy Lalanne @remyla

v2.4

This release adds an extension system to change the server behavior by loading and configuring extensions from its configuration file. A lot of code has been rewritten as extensions (see server extensions page). Also, the efforts were made to get a server that can be used as a public web server (able to serve files, manage guest access and node-based permissions).

Features

• new extension system to write and add functionalities to extend the server #164 server extensions
• new optional permission rule using node's author key (to prevent users from reading or updating other users nodes) #189
• new option to allow guest access while authentication is enabled #147
• new extension to define static routes to serve files #172
• command line interface now accepts environment variables #194
• new operation upsert in API: update nodes or create nodes if they don't exist yet #155
• support for older NodeJS versions (<ES6) #195
• support for options in regular expressions to allow case insensitive search #86

Documentation

• documentation about the server extensions #188

Credits

• Thibault Allard @zankia
• Julie Aresu @juliearesu
• Remy Lalanne @remyla

v2.3.5 Nov 2016 stable

retro tagging for November 2016 stable

Improvements made to the server-nodejs:

• implementation of class-based permissions (#66)
• CRUD operations accept arrays to process multiple nodes per request (See «specifications» page in Wiki)
• event layer and support for connections through web sockets (not used in production yet though)
• bug fixes (key types, server limits)

v2.3.6

Changelog

Command line interface

• damas-cli improved (#125 #149 #150 #151 #157 #158 #168 )

Specifications

• specifications improved, multiple inputs per request and returned values (#106 #114 #122 #181)

(see «specifications» wiki page)

server-nodejs

• features: regexp option search, server signal handling, server extensions
• introduction to author-based permissions
• bug fixes (#156 #166)

for a complete list of changes please see Github 2.3.6 milestone tagged issues

Credits

Contributors: @juliearesu @zankia @remyla
Thank you @juliearesu and @zankia!

v2.3

The release contains the evolutions from 2014 and is considered as the latest stable. However the Python module is not updated yet. This version is prior to the new implementations we will make during spring 2015.

Changelog

• CRUDs operations convention implemented strictly:
  
  • create, read, update, delete, search
  • REST operations and API methods renamed
• The user authentication scheme is updated
  • passwords are stored as sha1 keys on user nodes
• Removed the MySQL 'type' field in the node table - we use a generic 'type' key
  • types are now defined using regular keys (therefore update-able using the update method)
  • removed deprecated setType() function
  • updated message scheme: messages now have a type=message key
  • updated assets: assets now have a type=asset key
• New search method
  • supports this new operators: =, !=, <, >, <=, .=>, LIKE, BETWEEN...AND, REGEXP
  • operators are placed before the value to test { 'keyname': 'operator value' }
  • example of a search pattern { 'type':'=message', 'time':'>1428366657' } to search messages after Apr 7 2015

v2.2-stable

This is the stable version 2.2.0 (2013) which is the latest production ready version at that time.

We are already working on the next 2.3.x version (branch 2014) with an updated API, so this should be the latest 2.2.x release appart from bug fixes and minor changes.

The 2014 branch (pre-production) will now be merge to the master branch.

Migration of a database from 2.1 to 2.2

(sorry for the french language, this is temporary, please ask for translation if needed)
Requête permettant de sélectionner tout les fils et leurs parents et de les mettre dans la table KEY :

REPLACE INTO `key`(`node_id`, `name`, `value`) SELECT id,"#parent", parent_id FROM node;

Requête permettant la vérification de la présence de tout les fils et leurs parents sur la nouvelle table: (La requête renvoie le tableau des occurrences non trouvées dans la nouvelle table et ne renvoie rien si tout y est.)

SELECT ID, PARENT_ID FROM NODE WHERE (ID, PARENT_ID) NOT IN (SELECT ID, `VALUE` FROM NODE, `KEY` WHERE NAME="#parent" AND ID = NODE_ID);

Requête permettant la suppression de la colonne "parent_id" sur la table node:

ALTER TABLE node DROP COLUMN parent_id;

v2.1-stable

This version is run at Cyber Group Studios in production