ACL creation: change how mode arguments are used

Currently, initialising from a mode is done by looking at the keywords
arguments that were passed and seeing if mode was part of them. For
some reason, this causes a segfault under PyPy (my fault, probably),
so let's switch to check based on whether the mode argument was
initialised. To do so, switch the type of mode to int and the Python
format char, since the 'H' is defined as "without overflow checking"
anyway, so we don't get any real checks. Document that invalid values
will cause errors.

Remove use of PyString/PyUnicode *AndDel() function

These are not documented in Python 3, so let's switch to plain
Concat() for it with explicit delete of original strings. This makes
the code buildable with pypy3.

Travis: really test 3.7

This version seems to work. Sigh…

Travis: more reworking of Py3.7 support…

Travis: rework build matrix

Apparently python 3.7 is not available on the default Trusty
distribution, so let's add Xenial for the newer Python versions. More
builds!

Drop Python 2.6 and earlier support

While the C extension doesn't need anything to support it, simply
running the tests becomes more and more difficult with such old
versions. Given upcoming Python 2 deprecation, let's drop support for
older versions and simplify the test suite.

Disable pypy tests in Makefile

With my current pypy, ACL_init triggers a SEGFAULT in pypy. Until I
can debug what's up, let's remove this test.

Increase test coverage

These are old changes from October 2016 which I forgot to commit. I
think they're related to test coverage, although a few changes (object
structure) seems a bit different.

Well, anyway, here they are.

Travis: add python 3.5/3.6 to build matrix

Travis: remove "sudo:false"

Per the deprecation of container-based
builds (https://blog.travis-ci.com/2018-11-19-required-linux-infrastructure-migration),
remove the sudo:false setting.

Add a makefile coverage target

… which says that current test coverage is pretty bad - 55% line-based
and only 67% functions :(

Also run tests with debug interpreters

And bump up Python 3.x versions.

Add travis config file

This can be done now that travis environment has whitelisted the
libacl1-dev package.

Invert get_tag_qualifier() return value meaning

Returning negative value on error (rather than zero) makes the
function more friendly for cpychecker, and allows the code to be
cpychecker clean.

Add cpychecker macro for exception negative results

Per http://gcc-python-plugin.readthedocs.org/en/latest/cpychecker.html#errors-in-exception-handling.

Add cpychecker annotations for type/object correspondence

Per http://gcc-python-plugin.readthedocs.org/en/latest/cpychecker.html#associating-pytypeobject-instances-with-compile-time-types.

Bump copyright years

Rename README→README.rst

This should give better formatting, e.g. in github project page.

Add the release date to NEWS files entries

Bump version for 0.5.3 release

Update my email address

Small style change in setup.py

Merge remote-tracking branch 'github/master'

Merge pull request made on GitHub.

Cleanup all .so files on 'make clean'

Otherwise 'make test' can result in very weird error messages, if
hitting https://bugs.python.org/issue7559 (don't ask…).

tests: ignore IOErrors during operations invalid ACLs

It seems that FreeBSD at least returns EINVAL from calc_mask() and
other calls if the ACL is invalid, so let's ignore such IOErrors.

This should hopefully fix #6 and #7.

Merge pull request #8 from yaneurabeya/master

Handle FreeBSD versions greater than or equal to 7.x

tests: don't call acl_to_text on an invalid ACL

While Linux is happy to convert it to text, it seems that under
FreeBSD this doesn't (always? sometimes?) work, so let's use a proper
ACL in the str() test.

Closes #5.

Handle FreeBSD versions greater than or equal to 7.x

Sponsored by: EMC / Isilon Storage Division

Simplify a bit the module initialization

A few constants are more nicely defined.

Try to fix uid_t/gid_t usage in entry qualifiers

The current code is very broken with regards to the casting between
Python's integer type (either int in Py2 or the magic int/long in Py3)
and the uid_t/gid_t POSIX types. This means that the code is broken
outside "small" integer values.

By using uid_t/gid_t as appropriate, we can fix most of the problem
(at least as far as the new unittests are concerned). There's still no
automatic printf format modifier for them, so the code hardcodes
unsigned (which is what Linux/glibc defines them to), and also there's
a unittest that expects negative values to fail when set.

This should fix issue #3 (github).

First step towards fixing qualifier overflow

This is still a work-in-progress, since it only deals with
Python-level overflows, but it's a step forward.

Fix error message in Entry_set_qualifier

This closes #1 (github issue).

Fix download link in README

… since github no longer provides downloads.

Add a 'dist' target

Bump version for a trivial 0.5.2 release

Fix some indentation issues in tests

Fix homepage URL

Fix copyright years and intent to (not) test Solaris

Unify env and python variable TEST_DIR

The difference is just confusing.

Enable testing on more Python versions and PyPy

… except for the refcount test which doesn't work (and makes no sense)
under PyPy as it has a non-reference count model).

Rename tests → test and distribute test files too

The rename is done for consistency with other projects, and
distributing the tests is of course useful.

Fix manifest file after reorganisations

Forgot this after the doc changes…

Update NEWS and bump version number for 0.5.1 release

Expand the range of Python versions for unittests

3.3 has some issues (refuses to recognise 'test-suite') on my machine,
not yet enabled.

Integrate old web site index file into README

… and include the README into the main docs page.

Extend the refcount leak tests

This also exercises the str() more in general, to test/detect the py3k
str() compatibility issue more easily.

Fix html too-often rebuild

Workaround another py3k compatibility issue

str() must return unicode in py3k, so we add another layer of macro
names…

Replace deprecated names in test suite

Reorganise documentation

Lots of changes so that all docs are buildable by Sphinx.

Rework documentation style to RST/Sphinx custom

Hrmm, editing it in C source code is ugly… but the docs are pretty!

Cleanups for RST/sphinx correctness

This makes sphix build without errors.

Switch from epydoc to sphinx

It seems sphinx's autodoc extension can investigate the docstrings
from extensions modules too, so let's just use that.

Use Py_RETURN_(TRUE|FALSE) instead of explicit code

This makes it a bit more safe.

Rework a long if/else if statement

The switch/case method seems much clearer (it shows that we case on a
single expression).

Fix more warning found by static checker

These are not critical, but they can be clean up so let's do it.

Fix critical issues found by static analyser

Fix issues found per https://bugzilla.redhat.com/800126, thanks Dave
Malcolm! Upon inspection, indeed all were cases of bad refcounting or
other significant issues.

Add test for refcount leak

Not very solid, but it detects a wrong reference count.

Rename the README file

Since it's anyway mark-down compatible.

Update NEWS file and release 0.5.0

Fix a warning with Python 2.6

… which already defined Py_TYPE.

Update copyright years

Accept both unicode and string objects

This converts PyArg functions from "s" to "et" and also adds check for
PyUnicode object in methods that accept generic objects (previously only
PyBytes checks were done).

Unittest fixes for python 3

More python 3 changes

This gets the module to compile without warnings, but the unittest suite
still needs modifications.

Import the PyInt_* defines from 3.0's intobject.h

This is a stopgap measure to get the code to work under python 3.x.

Change PyString usage to work with py3k

This is one of the many steps needed to enable python 3 support: the
string/unicode changes.

Fix unittest suite compatibility with python2.6

It turns out imports by filename were never supposed to work, and
python2.6 just errors out explicitly.

Minor change in homepage url

Added copyright notice in the README

Increase version to 0.4.0

Include the makefile in the generated archive

This will help with building the epydoc-generated documentation.

Also remove obsolete 'log' target from the makefile.

Small whitespace change

Add license text to source files

Update documentation and license for version 0.4

Note that this patch changes the license from GPL to LGPL (2.1 or
later).

Docstring updates for epydoc compatibility

By just changing a few docstrings, epydoc can generate much better
documentation - the docstrings were half-compatible already with the
epytext format.

Also the makefile and manifest were updated not to include and build the
default pydoc documentation.

Fix MANIFEST.in after os_linux.c removal

Imple the acl_equiv_mode function

This is another Linux-specific function, but very easy to implement.

Implement the acl_extended_* functions

This patch adds support for the Linux-specific acl_extended_fd and
acl_extended_file function, both exposed at module level through the
has_extended function name.

unittests: generalize the skip decorators

Since there could be many extensions, it's better to generalize to a
single, parametrized decorator than to repeat the same code in multiple
ones.

unittests: abstract basic acl text into a constant

This patch just moved the basic acl text from being hardcoded in
multiple functions to a constant that can be easily modified, and
changes slightly the ACL.

Try to enhance the FreeBSD support

FreeBSD 7.0 supports more functions, so we split some Linux-only
functions out from the HAVE_LEVEL2 defs and into a HAVE_ACL_COPY_EXT so
FreeBSD can define HAVE_LEVEL2 too.

Enhance the unittest

The patch adds more unittests and renames the HAS_* constants for easier
usage.

Allow use of a diferent path for temporary files

This patch allows temporary files and directories created during the
test to live somewhere else (override with TESTDIR env. var).

Add some simple unittests

This patch adds some unittests for creation of ACLs. Based on the
platform, the from octal mode creation is skipped.

Export features as a module attributes

Currently it's hard to check from python if the current build of the
library has support for X or Y (e.g. acl from mode, etc.). So we export
this as module-level constants and this will allow users to check:
  if posix1e.HAS_ACL_FROM_MODE:
    acl = posix1e.ACL(mode=0644)

Switch from distutils to setuptools

Setuptools has some nice features (unittest targets and other), so it
makes sense to use it.

Add a .gitignore file

Update version numbers for release 0.3.0

Disallow cmp on ACLs

Use the acl_cmp to implement eq and ne for ACLs

Implement the acl_check function

Add constants for the acl_check function

Add to_any_text function

Export the libacl TEXT_* constants under Linux

Fix a compilation warning with python2.4

It seems python2.4 expects the format argument to
PyArg_ParseTupleAndKeywords to be "char*" and thus the compiler emits a
warning when passing "const char*" (python2.5 is betteri here). Remove
the const from format in ACL_init to fix this.

Add a Darwin build option

This is untested by me, reported (a long while ago) by Murali Vadivelu
<mkv22@cam.ac.uk>.

Style changes only

The comments were reformatted to fit in 80-columns when using pydoc, and
the indenting was changed in for the comments.

Implement acl_from_mode

When using the Linux libacl, there is another method to construct an ACL
object: from a mode_t. This patch adds a new parameter (mode) to the ACL
constructor (when HAVE_LINUX is defined) that uses this function to
create the ACL.

Wrap lines to fit in 80-columns