NEWS

   1 News
   2 ====
   3
   4 Version 0.6.0
   5 -------------
   6
   7 *unreleased*
   8
   9 Major release removing Python 2 support. This allow both code cleanup
  10 and new features, such as:
  11
  12 - Support for pathlib objects in `apply_to` and `has_extended`
  13   functions when running with Python 3.6 and newer.
  14 - Use of built-in C API functions for bytes/unicode/pathlib conversion
  15   when dealing with file names, removing custom code (with the
  16   associated benefits).
  17
  18 Important API changes/bug fixes:
  19
  20 - Initialisation protocol has been changed, to disallow uninitialised
  21   objects; this means that `__new__` will always create valid objects,
  22   to prevent the need for checking initialisation status in all code
  23   paths; this also (implicitly) fixes memory leaks on re-initialisation
  24   (calling `__init__(…)` on an existing object) and segfaults (!) on
  25   non-initialised object attribute access.
  26
  27 Minor improvements:
  28
  29 - When available, add the file path to I/O error messages, which should
  30   lead to easier debugging.
  31 - The test suite has changed to `pytest`, which allows increased
  32   coverage via parameterisation.
  33
  34
  35 Version 0.5.4
  36 -------------
  37
  38 *released Thu, 14 Nov 2019*
  39
  40 Maintenance release:
  41
  42 - Switch build system to Python 3 by default (can be overridden if
  43   needed).
  44 - Internal improvements for better cpychecker support.
  45 - Fix compatibility with PyPy.
  46 - Test improvements (both local and on Travis), testing more variations
  47   (debug, PyPy).
  48 - Improve test coverage, and allow gathering test coverage results.
  49 - Drop support (well, drop testing) for Python lower than 2.7.
  50 - Minor documentation improvements (closes #9, #12).
  51
  52 Version 0.5.3
  53 -------------
  54
  55 *released Thu, 30 Apr 2015*
  56
  57 FreeBSD fixes:
  58
  59 - Enable all FreeBSD versions after 7.x at level 2 (thanks to Garrett
  60   Cooper).
  61 - Make test suite pass under FreeBSD, which has a stricter behaviour
  62   with regards to invalid ACLs (which we do exercise in the test suite),
  63   thanks again to Garret for the bug reports.
  64
  65 Version 0.5.2
  66 -------------
  67
  68 *released Sat, 24 May 2014*
  69
  70 No visible changes release: just fix tests when running under pypy.
  71
  72 Version 0.5.1
  73 -------------
  74
  75 *released Sun, 13 May 2012*
  76
  77 A bug-fix only release. Critical bugs (memory leaks and possible
  78 segmentation faults) have been fixed thanks to Dave Malcolm and his
  79 ``cpychecker`` tool. Additionally, some compatibility issues with Python
  80 3.x have been fixed (str() methods returning bytes).
  81
  82 The documentation has been improved and changed from epydoc to sphinx;
  83 note however that the documentation is still auto-generated from the
  84 docstrings.
  85
  86 Project reorganisation: the project home page has been moved from
  87 SourceForge to GitHub.
  88
  89
  90 Version 0.5
  91 -----------
  92
  93 *released Sun, 27 Dec 2009*
  94
  95 Added support for Python 3.x and improved support for Unicode filenames.
  96
  97 Version 0.4
  98 -----------
  99
 100 *released Sat, 28 Jun 2008*
 101
 102 License
 103 ~~~~~~~
 104
 105 Starting with this version, pylibacl is licensed under LGPL 2.1,
 106 Febryary 1999 or any later versions (see README.rst and COPYING).
 107
 108 Linux support
 109 ~~~~~~~~~~~~~
 110
 111 A few more Linux-specific functions:
 112
 113 - add the ACL.equiv_mode() method, which will return the equivalent
 114   octal mode if this is a basic ACL and raise an IOError exception
 115   otherwise
 116
 117 - add the acl_extended(...) function, which will check if an fd or path
 118   has an extended ACL
 119
 120 FreeBSD support
 121 ~~~~~~~~~~~~~~~
 122
 123 FreeBSD 7.x will have almost all the acl manipulation functions that
 124 Linux has, with the exception of __getstate__/__setstate__. As a
 125 workaround, use the str() and ACL(text=...) methods to pass around
 126 textual representations.
 127
 128 Interface
 129 ~~~~~~~~~
 130
 131 At module level there are now a few constants exported for easy-checking
 132 at runtime what features have been compiled in:
 133
 134 - HAS_ACL_FROM_MODE, denoting whether the ACL constructor supports the
 135   mode=0xxx parameter
 136
 137 - HAS_ACL_CHECK, denoting whether ACL instances support the check()
 138   method
 139
 140 - HAS_ACL_ENTRY, denoting whether ACL manipulation is possible and the
 141   Entry and Permset classes are available
 142
 143 - HAS_EXTENEDED_CHECK, denoting whether the acl_extended function is
 144   supported
 145
 146 - HAS_EQUIV_MODE, denoting whether ACL instances support the
 147   equiv_mode() method
 148
 149 Internals
 150 ~~~~~~~~~
 151
 152 Many functions have now unittests, which is a good thing.
 153
 154
 155 Version 0.3
 156 -----------
 157
 158 *released Sun, 21 Oct 2007*
 159
 160 Linux support
 161 ~~~~~~~~~~~~~
 162
 163 Under Linux, implement more functions from libacl:
 164
 165 - add ACL(mode=...), implementing acl_from_mode
 166 - add ACL().to_any_text, implementing acl_to_any_text
 167 - add ACL comparison, using acl_cmp
 168 - add ACL().check, which is a more descriptive function than validate
 169
 170 .. Local Variables:
 171 .. mode: rst
 172 .. fill-column: 72
 173 .. End: