- guid: 3177C958-9473-41BA-9918-A56A18CF20E8
- author: Mihael Pranjić
- pubDate: Thu, 10 Mar 2022 07:40:35 +0100
- shortDesc: Bug Fixes, Java Plugins, Elektra 1.0 Decisions
We are proud to release Elektra 0.9.9.
What is Elektra?
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.
You can try out the latest Elektra release using our docker image elektra/elektra. This is the quickest way to get started with Elektra without compiling and other obstacles, simply run:
docker pull elektra/elektra
docker run -it elektra/elektra
Highlights
- Bug fixing in FLOSS course
- Java plugins
- 1.0 decisions
Bug Fixing in FLOSS Course
As you will read in this release notes, a massive amount of bugs were fixed within this release. Many of them were resolved from students participating in a university course about FLOSS This demonstrates that homework of students can be very useful and in public service.
In the upcoming term there will be a course about configuration management in which Elektra will also be used and improved upon.
Java Plugins
The version of the process
plugin, makes it much easier to implement plugins in Java. You can now call an implementation org.libelektra.Plugin
via process
and the org.libelektra.process.PluginProcess
class. To mount Java plugins the new helper script kdb mount-java
can be used.
For more information take a look at the updated tutorial and the new man page for `kdb mount-java`.
1.0 Decisions
With this release we greatly updated our decisions for the 1.0 release. This brings us one big step closer to 1.0.
Plugins
The following section lists news about the plugins we updated in this release.
filecheck
- Removed unused variable that threw an error in filecheck.c. _(Vaibhav Ganesh @flackojr)_
mmapstorage
- Removed unused variable that threw an error in mmapstorage.c. _(Vaibhav Ganesh @flackojr)_
csvstorage
- Add
array
metakey to the parentKey of imported Keys _(@muskater)_ _(@4ydan)_ _(@lawli3t)_
specload
- Change and move
keyCompareMeta (const Key * k1, const Key * k2)
from src/libs/elektra/keytest.c
to src/plugins/specload/specload.c
and integrate functionality of keyCompare (const Key _ key1, const Key _ key2) into isChangeAllowed (Key * oldKey, Key * newKey)
, because that is the only place where it was used. _(@flo91)_
uname
- Minor improvement of source code readability in uname.c _(@lawli3t)_
quickdump
- Fixed an issue with type-limits on ARM32 (see issue #4217). _(Klemens Böswirth @kodebach)_
dump
- The exported functions
serialize
and unserialize
have been renamed to serialize
and unserialize
. _(Klemens Böswirth @kodebach)_
- New exported functions
int fserialize(KeySet * ks, FILE * file, Key * errorKey)
and int funserialize(KeySet * ks, FILE * file, Key * errorKey)
have been added. These are wrappers around serialize
and unserialize
that allow calling from C with a standard FILE *
. _(Klemens Böswirth @kodebach)_
process
- The plugin was completely rewritten. The new version is incompatible with the old version. The new plugin that uses a simple protocol to allow an external application to act as a plugin. This can for example be used to write plugins in Java without going through JNI. _(Klemens Böswirth @kodebach)_
Libraries
The text below summarizes updates to the C (and C++)-based libraries of Elektra.
Compatibility
- Remove the deprecated flags
KEY_NAME
and KEY_COMMENT
(closes issue #3152) _(Florian Lindner @flo91)_
Core
KeySet
now also has a reference counter like Key
. The new functions ksIncRef
and ksDecRef
behave like their counterparts keyIncRef
and keyDecRef
. ksDel
also behaves like keyDel
in regard to reference counting, i.e. it does nothing unless the reference count is 0. The reference counting is very useful for bindings (especially with automatic garbage collection). _(Klemens Böswirth)_
- Clarified that our reference counting mechanism is more related to a shared lock than to the concept of shared ownership. _(Klemens Böswirth)_
- Both the reference count for
Key
and for KeySet
now use uint16_t
to reduce memory usage. Key
previously used size_t
. _(Klemens Böswirth)_
- Reorder
Key
and KeySet
struct members to aviod padding and make space for a new uint16_t
member, reserved for future use. _(Mihael Pranjić @mpranj)_
- Improve
keyReplacePrefix
by using new keyCopy
function instead of manually copying the name of the Key
_(@lawli3t)_
- Added else error to core for elektraGetCheckUpdateNeeded _(Aydan Ghazani @4ydan)_
- Include NULL terminators in hashing to avoid collisions _(@lawli3t)_
- Fix check for valid namespace in keyname creation _(@JakobWonisch)_
- Fix
keyCopyMeta
not deleting non existant keys in destination (see #3981) _(@JakobWonisch)_
- The
ELEKTRA_ERROR_*_NAME
and ELEKTRA_WARNING_*_NAME
constants have been removed from the public API. Use ELEKTRA_ERROR_*
and ELEKTRA_WARNING_*
instead. _(Klemens Böswirth @kodebach)_
- Fixed a bug that prevented the creation of cascading keys whose name contains a colon (
:
). _(Klemens Böswirth @kodebach)_
Bindings
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.
Java binding
- Integrated the
HelloElektra
example as Gradle subproject to allow it to directly depend on the current binding _(Michael Tucek)_
- Extend
HelloElektra
example with cutpoint and value setting example _(@JakobWonisch)_
- Updated Gradle to 7.4. _(Mihael Pranjić @mpranj)_
- Added integration with the new
process
plugin. _(Klemens Böswirth @kodebach)_
- Integrated the
HelloElektra
example as gradle subproject to allow it to directly depend on the current binding _(Michael Tucek)_
- Add
LinkChecker
Java Plugin. _(@aaronabebe)_
FUSE Binding
- Added check for existence of accessed path before opening new file descriptor _(@lawli3t)_
Python Binding
- Added examples for append, extend and remove keysets in python. _(@4ydan)_
Tools
- Implement
kdb validate <key>
, collect warnings and errors while kdb.get() and kdb.set(), see #3674 _(@flo91)_, _(@JakobWonisch)_
- Remove names from kdb mount _(@JakobWonisch)_
- Add
kdb mount-java
helper script for mounting Java plugins _(Klemens Böswirth @kodebach)_
Scripts
- Updated
reformat-c
script to use clang-format version 13. _(Mihael Pranjić @mpranj)_
- Fix bug where the PATH environment variable would get overwritten in some of the Docker images. Reduce image size _(Ivaylo Ivanov)_
- Allow JSON to be also written as json. _(@muskater)_
Documentation
- Integrate missing pages to website _(Ivaylo Ivanov)_
- Improved compilation documentation _(Ivaylo Ivanov)_
- Fix Links in README.md and add small clarifications. _(Markus Raab)_
- Remove previous authors. _(Markus Raab)_
- Add pre/postconditions and invariants to module keytest _(@lawli3t)_
- Updated the news template. _(Mihael Pranjić @mpranj)_
- Update and improve tutorial and in-code comments for high-level API _(Tobias Schubert @qwepoizt)_
- Improve documentation of opts library _(Tobias Schubert @qwepoizt)_
- Update tutorial "High-level API (with code-generation)" to reflect change of
loadConfiguration()
's signature in release 0.9.5 _(Tobias Schubert @qwepoizt)_
- Add pre/postconditions and invariants to module keyvalue _(@lawli3t)_
- Update and improve inline documentation of
kdb gen
. _(Tobias Schubert @qwepoizt)_
- Fix broken links. _(Robert Sowula)_
- Emphasize that
type
is required when the HL API is used. _(Tobias Schubert @qwepoizt)_
- Add debugging tutorial. _(Tobias Schubert @qwepoizt)_
- Improve wording and formatting of DESIGN.md _(@lawli3t)_
- Correct various typing-, spelling- and grammar-errors in the .md-files in the directory doc and its subdirectories. _(Florian Lindner @flo91)_
- Make version description in key names man page consistent _(@JakobWonisch)_
- Fix typo in elektra-backends man page _(@JakobWonisch)_
- Fix readability in bootstrapping man page _(JakobWonisch)_
- Explained in the docker test tutorial how to run the container with podman instead of docker. _(@muskater)_
- Add a new example on how to use keyCopy. _(@muskater)_
- Fix small error in the "Get Started" guide: the build and test command used a wrong directory and would not work if they were copy and pasted. _(@muskater)_
- Added verification to the "Arrays" tutorial _(Ivaylo Ivanov)_
- Remove deprecated
type=int
from .ini
files _(Ivaylo Ivanov)_
- Added verification to the "Validation" tutorial _(Ivaylo Ivanov)_
- Fix some typos in the "Getting Started" page _(Ivaylo Ivanov)_
- Added debian buster tutorial to python bindings tutorial _(@4ydan)_
- Made the debian tutorial a bit more precise and removed sudo command _(@4ydan)_
- Fixed some typos in the "namespaces.md" documentation _(@muskater)_
- Fix an error and some overmatching problems in scripts/spelling.sed and fix errors in documentation (by running the scripts/dev/fix-spelling script) _(Florian Lindner @flo91)_
- Added some improvements to the core API documentation _(@muskater)_
- Update and improve the CLion tutorial (doc/tutorials/contributing-clion.md), add screenshots _(@flo91)_
- Improve documentation for storage plugins _(@lawli3t)_
- Add list of sources mentioning or linking to Elektra _(@JakobWonisch)_
- Linked to the installation instruction of the webui in its README file and added references to Docker in the get-started-guide. _(@muskater)_ _(@lawli3t)_ _(Aydan Ghazani @4ydan)_
- Added screenshots and a quick walk through in the Qt-GUI README. _(@muskater)_ _(@lawli3t)_ _(Aydan Ghazani @4ydan)_
- Improve example for kdb-restore man page and fix typos _(@JakobWonisch)_
- Fix some typos in the "Getting Started" page _(Ivaylo Ivanov)_
- Add screenshots with hints to CLion PR tutorial _(@JakobWonisch)_
- Fix typo in elektra-backends man page _(@JakobWonisch)_
- Expanded the webside guide for easier understanding and linked to cmake.org. _(Philipp Nirnberger @nirnberger)_
- Fix small error in CLion tutorial: CMake options would create a directory named
~
in home directory _(Maximilian Irlinger @atmaxinger)_
Tests
- Cleanup tests/linkchecker.whitelist and fix off-by-1 bug of the counter in the scripts/link-checker script (increase counter before printf) _(Florian Lindner @flo91)_
- Add tests for the intercept/env binding _(Ivaylo Ivanov)_
- add and improve checks in scripts/sed _(Florian Lindner @flo91)_
- Change the cpp Key-class (key.hpp) to check the return values of the called c-functions and throw exceptions if values that indicate an error are returned + add tests that check for this exceptions _(Florian Lindner @flo91)_
- Added more test cases for the keyCopy function _(@muskater)_
- Add exception tests for key C++ bindings _(Ivaylo Ivanov)_
- Added a shell script and a task that checks whether the filenames of newly added files are compliant with the convention. It is executed by the cirrus CI as well as the Jenkins CI _(@muskater)_
- Add a new shellrecoder test to
doc/tutorials/merge.md
_(Florian Lindner @flo91)_
- Added the possibility to enable all the shell recorder test cases for all plugins and fixed some plugin README files in process _(@muskater)_
- Convert example in doc/help/kdb-test.md to shell recorder test _(@JakobWonisch)_
Packaging
- Add initial flatpak package. See
scripts/flatpak/README.md
and scripts/flatpak/org.libelektra.kdb.yaml
for more info _(Ivaylo Ivanov)_
- Remove hard coded SWIG 3.0 paths. _(Mihael Pranjić @mpranj)_
Build
CMake
- Marked certain variables as advanced and separate user-modifiable and unaccessible variables. _(Vaibhav Ganesh @flackojr)_
Docker
- Add Fedora 35 images. _(Mihael Pranjić @mpranj)_
Infrastructure
Jenkins
- Replace Fedora 33 builds with Fedora 34, and Fedora 34 builds with Fedora 35. _(Mihael Pranjić @mpranj)_
Website
The website is generated from the repository, so all information about plugins, bindings and tools are always up-to-date. Furthermore, we changed:
- Update npm dependencies, add forked and update angular-marked module. _(Mihael Pranjić @mpranj)_
- Remove links to Travis CI and replace them with GitHub Actions (with badge). _(Mihael Pranjić @mpranj)_
Other
- Make Elektra reuse reuse compliant _(Ivaylo Ivanov)_
Outlook
We are working on following new topics since the last release:
- Ansible-Elektra _(Lukas Hartl)_
- Recording Configuration _(Maximilian Irlinger)_
Furthermore, we are still working on following topics:
- 1.0 API _(Stefan Hanreich)_ and _(Klemens Böswirth)_
- Improve Java Development Experience _(Michael Tucek)_
- KDB access using FUSE _(Alexander Firbas)_
- Shell completion _(Ulrike Schäfer)_
- Elektrify KDE and GNOME _(Mihael Pranjić)_
Statistics
We closed 90 issues for this release.
About 29 authors changed 491 files with 17997 insertions(+) and 6089 deletions(-) in 648 commits.
Thanks to all authors for making this release possible!
Join the Initiative!
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.
Get the Release!
You can download the release from here or GitHub
The hashsums are:
- name: elektra-0.9.9.tar.gz
- size: 8878567
- md5sum: f5109eb0c96fb4164a5437bdebc3bf79
- sha1: a08df79301d56dd8f3711efa1b78b5a4d003d42f
- sha256: 834da360170daa632bbb46dd2e819271327dce1c51be1d7bb2ec22311ded54cb
The release tarball is also available signed using GnuPG from here or on GitHub
The following GPG Key was used to sign this release: 12CC44541E1B8AD9B66AFAD55262E7353324914A
Already built API documentation can be found here or on GitHub.
Stay tuned!
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.
Permalink to this NEWS entry
For more information, see https://libelektra.org.
Best regards, Elektra Initiative