]> git.k1024.org Git - pylibacl.git/blob - NEWS
Expand acl_check testing for actual value checks
[pylibacl.git] / 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 - Restore `__setstate__`/`__getstate__` support on Linux; this was
27   inadvertently removed due a typo(!) when adding support for it in
28   FreeBSD. Pickle should work again for ACL instances, although not sure
29   how stable this serialisation format actually is.
30
31 Minor improvements:
32
33 - When available, add the file path to I/O error messages, which should
34   lead to easier debugging.
35 - The test suite has changed to `pytest`, which allows increased
36   coverage via parameterisation.
37
38
39 Version 0.5.4
40 -------------
41
42 *released Thu, 14 Nov 2019*
43
44 Maintenance release:
45
46 - Switch build system to Python 3 by default (can be overridden if
47   needed).
48 - Internal improvements for better cpychecker support.
49 - Fix compatibility with PyPy.
50 - Test improvements (both local and on Travis), testing more variations
51   (debug, PyPy).
52 - Improve test coverage, and allow gathering test coverage results.
53 - Drop support (well, drop testing) for Python lower than 2.7.
54 - Minor documentation improvements (closes #9, #12).
55
56 Version 0.5.3
57 -------------
58
59 *released Thu, 30 Apr 2015*
60
61 FreeBSD fixes:
62
63 - Enable all FreeBSD versions after 7.x at level 2 (thanks to Garrett
64   Cooper).
65 - Make test suite pass under FreeBSD, which has a stricter behaviour
66   with regards to invalid ACLs (which we do exercise in the test suite),
67   thanks again to Garret for the bug reports.
68
69 Version 0.5.2
70 -------------
71
72 *released Sat, 24 May 2014*
73
74 No visible changes release: just fix tests when running under pypy.
75
76 Version 0.5.1
77 -------------
78
79 *released Sun, 13 May 2012*
80
81 A bug-fix only release. Critical bugs (memory leaks and possible
82 segmentation faults) have been fixed thanks to Dave Malcolm and his
83 ``cpychecker`` tool. Additionally, some compatibility issues with Python
84 3.x have been fixed (str() methods returning bytes).
85
86 The documentation has been improved and changed from epydoc to sphinx;
87 note however that the documentation is still auto-generated from the
88 docstrings.
89
90 Project reorganisation: the project home page has been moved from
91 SourceForge to GitHub.
92
93
94 Version 0.5
95 -----------
96
97 *released Sun, 27 Dec 2009*
98
99 Added support for Python 3.x and improved support for Unicode filenames.
100
101 Version 0.4
102 -----------
103
104 *released Sat, 28 Jun 2008*
105
106 License
107 ~~~~~~~
108
109 Starting with this version, pylibacl is licensed under LGPL 2.1,
110 Febryary 1999 or any later versions (see README.rst and COPYING).
111
112 Linux support
113 ~~~~~~~~~~~~~
114
115 A few more Linux-specific functions:
116
117 - add the ACL.equiv_mode() method, which will return the equivalent
118   octal mode if this is a basic ACL and raise an IOError exception
119   otherwise
120
121 - add the acl_extended(...) function, which will check if an fd or path
122   has an extended ACL
123
124 FreeBSD support
125 ~~~~~~~~~~~~~~~
126
127 FreeBSD 7.x will have almost all the acl manipulation functions that
128 Linux has, with the exception of __getstate__/__setstate__. As a
129 workaround, use the str() and ACL(text=...) methods to pass around
130 textual representations.
131
132 Interface
133 ~~~~~~~~~
134
135 At module level there are now a few constants exported for easy-checking
136 at runtime what features have been compiled in:
137
138 - HAS_ACL_FROM_MODE, denoting whether the ACL constructor supports the
139   mode=0xxx parameter
140
141 - HAS_ACL_CHECK, denoting whether ACL instances support the check()
142   method
143
144 - HAS_ACL_ENTRY, denoting whether ACL manipulation is possible and the
145   Entry and Permset classes are available
146
147 - HAS_EXTENEDED_CHECK, denoting whether the acl_extended function is
148   supported
149
150 - HAS_EQUIV_MODE, denoting whether ACL instances support the
151   equiv_mode() method
152
153 Internals
154 ~~~~~~~~~
155
156 Many functions have now unittests, which is a good thing.
157
158
159 Version 0.3
160 -----------
161
162 *released Sun, 21 Oct 2007*
163
164 Linux support
165 ~~~~~~~~~~~~~
166
167 Under Linux, implement more functions from libacl:
168
169 - add ACL(mode=...), implementing acl_from_mode
170 - add ACL().to_any_text, implementing acl_to_any_text
171 - add ACL comparison, using acl_cmp
172 - add ACL().check, which is a more descriptive function than validate
173
174 .. Local Variables:
175 .. mode: rst
176 .. fill-column: 72
177 .. End: