$darkmode
Elektra 0.11.0
|
We are proud to release Elektra 0.9.1.
Elektra serves as a universal and secure framework to access configuration settings in a global, hierarchical key database. For more information, visit https://libelektra.org.
You can also read the news on our website
kconfig
was added which can read KDE's kconfig ini files. Additionally we are working on a fork of KDE's KConfig
configuration system and patching it to use libelektra. _(Dardan Haxhimustafa)_ and _(Felix Resch)_While the new kdb gen
was already included in the last release, it is now fully functional and ready for productive use. To get started take a look at the new man-page for kdb-gen(1)
.
If you specifically want to use it with the High-Level API take a look at this tutorial.
We also created a new CMake function that will be available, if you include Elektra via CMake's find_package
. The function is called elektra_kdb_gen
and can be used to tell CMake about files that are generated via kdb gen
. _(Klemens Böswirth)_
The following section lists news about the plugins we updated in this release.
boolean
,cachefilter
,cpptype
,dini
,enum
,regexstore
,required
,haskell
,simplespeclang
,regexdispatcher
,typechecker
,struct
. _(Markus Raab, René Schwaiger)_nameOfPluginCheckConf
. Before this update some plugins used the name nameOfPluginCheckConfig
instead. _(René Schwaiger)_crypto
, fcrypt
, and gpgme
plugins. _(Peter Nirschl)_execv
in the GPG module. _(Peter Nirschl)_ksAppendKey
regarding ownership of keys. _(Raphael Gruber)_gopts
specload
. _(Klemens Böswirth)_kconfig
. _(Dardan Haxhimustafa)_We removed the experimental plugin. For a plugin that is able to parse similar syntax, please take a look at the
plugins. _(René Schwaiger)_
argv
from the system, was added. _(Klemens Böswirth)_elektraGetOpts
was added. It simply checks, whether --help
is one of the string in argv
. _(Klemens Böswirth)_parentKey
. It therefore now supports set calls. _(Klemens Böswirth)_missing/log
that allows logging of all missing require
d keys. _(Klemens Böswirth)_spec
now internally handles errors differently. There should be no external impact apart from better performance. _(Klemens Böswirth)_KDB_DB_SPEC
instead of the current working directory. _(Klemens Böswirth)_default
or type
metadata are no longer supported, since they are not safe in every case. _(Klemens Böswirth)_experimental
status. _(Klemens Böswirth)_3.15.3
) and Boost (1.71
). _(René Schwaiger)_type
plugin. For example, setting on
, enable
or true
all map to JSONs native true
value. See the type plugin for more details about boolean types. _(Philipp Gackstatter)_The text below summarizes updates to the C (and C++)-based libraries of Elektra.
We introduced several incompatible changes:
libelektra
, which is a collection of different elektra libraries, is now removed. Users of CMake or pkg-config should not be affected. Otherwise change -lelektra
to -lelektra-core -lelektra-kdb
or whatever parts of Elektra your application uses. _(Markus Raab)_elektraKeyTo*
and elektra*ToString
are now part of the elektra-ease
library instead of the elektra-highlevel
library. This should not cause any breaking changes since elektra-highlevel
already depends on elektra-ease
. In addition the header elektra/conversion.h
is kept for compatibility. _(Klemens Böswirth)_keyRel
and keyRel2
since it can be easily replaced by other existing functions. _(Philipp Gackstatter)_We changed the following symbols:
kdbCommit
, was implemented. The function is carried out in the commit
phase of kdbSet
and separates the commit functionality from the kdbSet()
function. _(Vid Leskovar)_kdbconfig.h
is no longer included in the installed headers. This is because it could cause conflicts with other config.h
-type headers from applications. _(Klemens Böswirth)_ksAppendKey
: state that it only fail on memory problems. _(Markus Raab)_kdbGet
. _(Markus Raab)_kdberrors.h
directly without generation of the specification
file because of drastically reduced error code count _(Michael Zronek)_keyIsDirectBelow
was renamed to keyIsDirectlyBelow
. _(Philipp Gackstatter)_keyMeta
was added to provide access to a key's underlying KeySet that holds its metadata keys. _(Philipp Gackstatter)_ksLookupByString
and ksLookupByBinary
, as well as deprecated KDB_O_*
options. _(Philipp Gackstatter)_keyLock
and keyIsLocked
. _(Manuel Mausz)_keyVInit
. _(Manuel Mausz)_-h
is no longer used to indicate help mode. Only --help
, will invoke help mode. _(Klemens Böswirth)_kdbproposal.h
:elektraKsToMemArray
was moved to kdbease.h
,elektraLookupOptions
was moved to kdbprivate.h
,keySetStringF
was moved to kdbinternal.h
,ksPrev
and elektraKsPrev
,elektraRenameKeys
and replaced it with ksRenameKeys
. _(Philipp Gackstatter)_Bindings allow you to utilize Elektra using various programming languages. This section keeps you up-to-date with the multi-language support provided by Elektra.
Key::is{Name,Value,Meta}Locked
. _(Manuel Mausz)_gelektra_keyset_resize
. _(Manuel Mausz)_gelektra_keyset_rewind
, gelektra_keyset_next
, gelektra_keyset_current
, gelektra_keyset_getcursor
, gelektra_keyset_setcursor
. _(Manuel Mausz)_gelektra_keyset_atcursor
to gelektra_keyset_at
. _(Manuel Mausz)_KeyNotFoundException
exception. _(Manuel Mausz)_hash(key)
will throw unless the key name is locked. _(Manuel Mausz)_len(Key)
, repr(Key)
, str(KeySet)
, repr(KeySet)
. _(Manuel Mausz)_Key(name, value, [dict])
. _(Manuel Mausz)_KeySet.extend([key1, key2,...])
and KeySet.append(key1, key2, ...)
. _(Manuel Mausz)_KeySet.append(key_name, key_value, key_opts)
which directly creates and appends a key. _(Manuel Mausz)_KeySet.unpack_names()
, KeySet.unpack_basenames()
, KeySet.filter(func)
, KeySet.filter_below(where)
, Key.array_elements()
. _(Manuel Mausz)_elektra-sys
crate which contains raw bindings to libelektra for Rust. _(Philipp Gackstatter)_elektra
crate which contains safe wrapper methods for the raw bindings. The crate contains bindings for the low-level API, which means that the data types Key
and KeySet
can now safely be used from Rust. The Rust version of the API has been designed to take advantage of Rust's type system and to be in accordance with the memory safety of Rust. For instance, the Key has been divided into StringKey
and BinaryKey
, to prevent type mismatches at compile-time. With the binding for KDB
, one can take advantage of the elektra ecosystem from Rust. See the Readme for more. _(Philipp Gackstatter)_KDBError
to follow the specification fully and in particular allow catching out of memory errors by catching resource errors. _(Philipp Gackstatter)_keyset!
macro to easily create a keyset with many keys in a single invocation. _(Philipp Gackstatter)_KDB_EXEC_PATH
, which can be used to add further external tools to kdb
, now supports :
to separate paths. kdb list-tools
and run_env
were improved to take advantage of this. _(Markus Raab)_kdbCommit
have been added to kdb plugin-check. _(Vid Leskovar)_kdb meta-show
command which prints out all metadata along with its values for a given key. _(Michael Zronek)_kdb vset
as it does not properly put metadata to the spec namespace. _(Michael Zronek)_kdb info
is now kdb plugin-info
, kdb check
is now kdb plugin-check
and kdb list
is now kdb plugin-list
. We also removed the obsolete kdb fstab
. _(Philipp Gackstatter)_kdb getmeta
is now kdb meta-get
kdb lsmeta
is now kdb meta-ls
kdb showmeta
is now kdb meta-show
kdb rmmeta
is now kdb meta-rm
kdb setmeta
is now kdb meta-set
_(Philipp Gackstatter)_gen-gpg-testkey
by giving a narrower GPG key description. Fixes mismatches with existing GPG keys that contain "elektra.org" as e-mail address. _(Peter Nirschl)_kdb list-commands
and kdb plugins-list
now sort their output in an alphabetical order _(Anton Hößl)_kdb plugin-list
does now mention in the helptext that with option -v
the output is sorted by the plugin status _(Anton Hößl)_kdb import
, kdb export
and kdb editor
now search the plugin database for suitig plugins so it's now possible to run kdb export /hello json
instead of having to specify the plugin for the desired format directly. _(Anton Hößl)_get
and mount
: Remove dependency on kdbprivate.h
_(Philipp Gackstatter)_scripts/elektra-merge
,scripts/elektra-mount
,scripts/elektra-umount
,convert-fstab
,convert-hosts
,convert-inittab
,convert-users
,scripts/benchmark_libsplit.sh
,scripts/zsh
andexample-xorg
. _(Markus Raab)_scripts/run_dev_env
to scripts/dev/run_env
. _(Markus Raab)_pre-commit-check-formatting
now lives in `scripts/dev/pre-commit-check-formatting`. _(Klemens Böswirth)_reformat-javascript
formats the JavaScript code of the repository using the tool prettier
. _(René Schwaiger)_reformat-source
to reformat-c
, andreformat-shfmt
to reformat-shell
. _(René Schwaiger)_cmake-format
0.6. _(René Schwaiger)_reformat-java
formats the Java code in the repository using clang-format
. _(René Schwaiger)_make
or gcc
to build Elektra anymore. _(René Schwaiger)_formatting test
detects code differences. This update should get rid of transient errors as reported here. _(René Schwaiger)_testmod_zeromqsend
from the command kdb run_all
, since it caused timeouts in high load scenarios. _(Mihael Pranjić)_kdbtypes.h
is now generated directly via a CMake configure_file
call. _(Klemens Böswirth)_ELEKTRA_STAT_ST_SIZE_F
now contains the correct format specifier for the st_size
member of the stat
struct on macOS. _(René Schwaiger)_conditionals
and yamlcpp
plugin any more. After this update, the code compiles without any warnings, even though we now use the compiler switch -Wconversion
. _(René Schwaiger)_cmake-format
is used. _(Klemens Böswirth, René Schwaiger)_range
plugin error message. _(Michael Zronek)_sudo
. _(Michael Zronek)_🔗 Check
build job now merges PRs before checking links. _(Klemens Böswirth)_🍎 Clang
. This update makes sure that Elektra’s logging code compiles without warnings on macOS. _(René Schwaiger)_11.1
instead of Xcode 10.1
. _(René Schwaiger)_2.6
. _(René Schwaiger)_ninja
directly anymore. Instead we use cmake --build
. This has the advantage that we do not have to care about the Generator used by CMake. _(René Schwaiger)_😈 ASAN
, which builds and executes Elektra on FreeBSD with enabled AddressSanitizer. _(René Schwaiger)_📚 Check
checks🐧 Fedora
builds and tests Elektra on Fedora Linux. _(René Schwaiger)_master
branch anymore. _(René Schwaiger)_🍏 GCC
now uses the Travis Homebrew addon to install dependencies. _(René Schwaiger)_18.04
(Bionic Beaver) instead of Ubuntu 16.04
(Xenial Xerus). _(René Schwaiger)_The website is generated from the repository, so all information about plugins, bindings and tools are always up-to-date. Furthermore, we changed:
We are currently working on following topics:
We closed 75 issues for this release.
About 29 authors changed 1651 files with 82267 insertions(+) and 41690 deletions(-) in 1623 commits.
Thanks to all authors for making this release possible!
mmap()
system call to read and write data. Our cache implementation for Elektra's data structures makes the access to the KDB more than 80 times faster for larger data sets. The penalty for cache misses is below 20 percent for reasonably sized data sets.We welcome new contributors! Read here about how to get started.
As first step, you could give us feedback about these release notes. Contact us via our issue tracker.
You can download the release from here or GitHub
The hashsums are:
The release tarball is also available signed by Mihael Pranjic using GnuPG from here or on GitHub
Already built API documentation can be found here or on GitHub.
Subscribe to the RSS feed to always get the release notifications.
If you also want to participate, or for any questions and comments please contact us via our issue tracker on GitHub.
For more information, see https://libelektra.org
Best regards, Elektra Initiative