bitarray 3.7.1__tar.gz → 3.8.0__tar.gz

{bitarray-3.7.1 → bitarray-3.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bitarray
-Version: 3.7.1
+Version: 3.8.0
 Summary: efficient arrays of booleans -- C extension
 Home-page: https://github.com/ilanschnell/bitarray
 Author: Ilan Schnell
@@ -19,6 +19,8 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Free Threading :: 1 - Unstable
 Classifier: Topic :: Utilities
 License-File: LICENSE
 Dynamic: author
@@ -76,7 +78,7 @@ Key features
 Installation
 ------------
 
-Python wheels are are available on PyPI for all mayor platforms and Python
+Python wheels are are available on PyPI for all major platforms and Python
 versions.  Which means you can simply:
 
 .. code-block:: shell-session
@@ -89,7 +91,7 @@ Once you have installed the package, you may want to test it:
 
     $ python -c 'import bitarray; bitarray.test()'
     bitarray is installed in: /Users/ilan/bitarray/bitarray
-    bitarray version: 3.7.1
+    bitarray version: 3.8.0
     sys.version: 3.13.5 (main, Jun 16 2025) [Clang 18.1.8]
     sys.prefix: /Users/ilan/miniforge
     pointer size: 64 bit
@@ -98,13 +100,14 @@ Once you have installed the package, you may want to test it:
     HAVE_BUILTIN_BSWAP64: 1
     default bit-endianness: big
     machine byte-order: little
+    Py_GIL_DISABLED: 0
     Py_DEBUG: 0
     DEBUG: 0
     .........................................................................
     .........................................................................
     ................................................................
     ----------------------------------------------------------------------
-    Ran 597 tests in 0.165s
+    Ran 595 tests in 0.165s
 
     OK
 
@@ -351,7 +354,7 @@ and can therefore be used as a dictionary key:
 Reference
 =========
 
-bitarray version: 3.7.1 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
+bitarray version: 3.8.0 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
 
 In the following, ``item`` and ``value`` are usually a single bit -
 an integer 0 or 1.
@@ -587,6 +590,7 @@ bitarray methods:
 
 ``tobytes()`` -> bytes
    Return the bitarray buffer (pad bits are set to zero).
+   ``a.tobytes()`` is equivalent to ``bytes(a)``
 
 
 ``tofile(f, /)``
@@ -657,8 +661,6 @@ Functions defined in the `bitarray` module:
 
 ``get_default_endian()`` -> str
    Return the default bit-endianness for new bitarray objects being created.
-   Unless ``_set_default_endian('little')`` was called, the default
-   bit-endianness is ``big``.
 
    New in version 1.3
 
@@ -729,6 +731,11 @@ This sub-module was added in version 1.2.
    Also, ``a`` may be any object that exposes a writable buffer.
    Nothing about this function is specific to bitarray objects.
 
+   We should mention that Python's ``array.array`` object has a
+   method ``.byteswap()`` with similar functionality.  However, unlike
+   bitarray's ``util.byteswap()`` function, this method is limited to
+   swapping 2, 4, or 8 consecutive bytes.
+
    New in version 3.4
 
 
@@ -870,11 +877,7 @@ This sub-module was added in version 1.2.
    set to one.  Mathematically equivalent to setting (in a bitarray of
    length ``n``) all bits at indices ``random.sample(range(n), k)`` to one.
    The random bitarrays are reproducible when giving Python's ``random.seed()``
-   with a specific seed value.
-
-   This function requires Python 3.9 or higher, as it depends on the standard
-   library function ``random.randbytes()``.  Raises ``NotImplementedError``
-   when Python version is too low.
+   a specific seed value.
 
    New in version 3.6
 

{bitarray-3.7.1 → bitarray-3.8.0}/README.rst

@@ -44,7 +44,7 @@ Key features
 Installation
 ------------
 
-Python wheels are are available on PyPI for all mayor platforms and Python
+Python wheels are are available on PyPI for all major platforms and Python
 versions.  Which means you can simply:
 
 .. code-block:: shell-session
@@ -57,7 +57,7 @@ Once you have installed the package, you may want to test it:
 
     $ python -c 'import bitarray; bitarray.test()'
     bitarray is installed in: /Users/ilan/bitarray/bitarray
-    bitarray version: 3.7.1
+    bitarray version: 3.8.0
     sys.version: 3.13.5 (main, Jun 16 2025) [Clang 18.1.8]
     sys.prefix: /Users/ilan/miniforge
     pointer size: 64 bit
@@ -66,13 +66,14 @@ Once you have installed the package, you may want to test it:
     HAVE_BUILTIN_BSWAP64: 1
     default bit-endianness: big
     machine byte-order: little
+    Py_GIL_DISABLED: 0
     Py_DEBUG: 0
     DEBUG: 0
     .........................................................................
     .........................................................................
     ................................................................
     ----------------------------------------------------------------------
-    Ran 597 tests in 0.165s
+    Ran 595 tests in 0.165s
 
     OK
 
@@ -319,7 +320,7 @@ and can therefore be used as a dictionary key:
 Reference
 =========
 
-bitarray version: 3.7.1 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
+bitarray version: 3.8.0 -- `change log <https://github.com/ilanschnell/bitarray/blob/master/doc/changelog.rst>`__
 
 In the following, ``item`` and ``value`` are usually a single bit -
 an integer 0 or 1.
@@ -555,6 +556,7 @@ bitarray methods:
 
 ``tobytes()`` -> bytes
    Return the bitarray buffer (pad bits are set to zero).
+   ``a.tobytes()`` is equivalent to ``bytes(a)``
 
 
 ``tofile(f, /)``
@@ -625,8 +627,6 @@ Functions defined in the `bitarray` module:
 
 ``get_default_endian()`` -> str
    Return the default bit-endianness for new bitarray objects being created.
-   Unless ``_set_default_endian('little')`` was called, the default
-   bit-endianness is ``big``.
 
    New in version 1.3
 
@@ -697,6 +697,11 @@ This sub-module was added in version 1.2.
    Also, ``a`` may be any object that exposes a writable buffer.
    Nothing about this function is specific to bitarray objects.
 
+   We should mention that Python's ``array.array`` object has a
+   method ``.byteswap()`` with similar functionality.  However, unlike
+   bitarray's ``util.byteswap()`` function, this method is limited to
+   swapping 2, 4, or 8 consecutive bytes.
+
    New in version 3.4
 
 
@@ -838,11 +843,7 @@ This sub-module was added in version 1.2.
    set to one.  Mathematically equivalent to setting (in a bitarray of
    length ``n``) all bits at indices ``random.sample(range(n), k)`` to one.
    The random bitarrays are reproducible when giving Python's ``random.seed()``
-   with a specific seed value.
-
-   This function requires Python 3.9 or higher, as it depends on the standard
-   library function ``random.randbytes()``.  Raises ``NotImplementedError``
-   when Python version is too low.
+   a specific seed value.
 
    New in version 3.6
 

{bitarray-3.7.1 → bitarray-3.8.0}/bitarray/__init__.py

@@ -9,14 +9,12 @@ Please find a description of this package at:
 
 Author: Ilan Schnell
 """
-from __future__ import absolute_import
 from collections import namedtuple
 
-from bitarray._bitarray import (bitarray, decodetree, _sysinfo,
-                                bits2bytes, _bitarray_reconstructor,
-                                get_default_endian, _set_default_endian,
-                                __version__)
-
+from bitarray._bitarray import (
+    bitarray, decodetree, bits2bytes, _bitarray_reconstructor,
+    get_default_endian, _sysinfo, BITARRAY_VERSION as __version__
+)
 
 __all__ = ['bitarray', 'frozenbitarray', 'decodetree', 'bits2bytes']
 

{bitarray-3.7.1 → bitarray-3.8.0}/bitarray/__init__.pyi

@@ -162,7 +162,6 @@ __version__: str
 def bits2bytes(n: int) -> int: ...
 def get_default_endian() -> str: ...
 def test(verbosity: int = ...) -> TextTestResult: ...
-def _set_default_endian(endian: str) -> None: ...
 def _sysinfo(key: str) -> int: ...
 def _bitarray_reconstructor(cls: type,
                             buffer: bytes,

{bitarray-3.7.1 → bitarray-3.8.0}/bitarray/_bitarray.c

@@ -16,9 +16,6 @@
 /* size used when reading / writing blocks from files (in bytes) */
 #define BLOCKSIZE  65536
 
-/* default bit-endianness */
-static int default_endian = ENDIAN_BIG;
-
 /* translation table - setup during module initialization */
 static char reverse_trans[256];
 
@@ -1323,9 +1320,8 @@ bitarray_invert(bitarrayobject *self, PyObject *args)
             return NULL;
         }
         self->ob_item[i / 8] ^= BITMASK(self, i);
-        Py_RETURN_NONE;
     }
-    if (PySlice_Check(arg)) {
+    else if (PySlice_Check(arg)) {
         Py_ssize_t start, stop, step, slicelength;
 
         if (PySlice_GetIndicesEx(arg, self->nbits,
@@ -1333,15 +1329,15 @@ bitarray_invert(bitarrayobject *self, PyObject *args)
             return NULL;
         adjust_step_positive(slicelength, &start, &stop, &step);
         invert_range(self, start, stop, step);
-        Py_RETURN_NONE;
     }
-    if (arg == Py_None) {
+    else if (arg == Py_None) {
         invert_span(self, 0, self->nbits);
-        Py_RETURN_NONE;
     }
-
-    return PyErr_Format(PyExc_TypeError, "index expect, not '%s' object",
-                        Py_TYPE(arg)->tp_name);
+    else {
+        return PyErr_Format(PyExc_TypeError, "index expect, not '%s' object",
+                            Py_TYPE(arg)->tp_name);
+    }
+    Py_RETURN_NONE;
 }
 
 PyDoc_STRVAR(invert_doc,
@@ -1577,7 +1573,8 @@ bitarray_tobytes(bitarrayobject *self)
 PyDoc_STRVAR(tobytes_doc,
 "tobytes() -> bytes\n\
 \n\
-Return the bitarray buffer (pad bits are set to zero).");
+Return the bitarray buffer (pad bits are set to zero).\n\
+`a.tobytes()` is equivalent to `bytes(a)`");
 
 
 /* Extend self with bytes from f.read(n).  Return number of bytes actually
@@ -3117,7 +3114,7 @@ decodetree_todict(decodetreeobject *self)
     if ((dict = PyDict_New()) == NULL)
         return NULL;
 
-    prefix = newbitarrayobject(&Bitarray_Type, 0, default_endian);
+    prefix = newbitarrayobject(&Bitarray_Type, 0, ENDIAN_DEFAULT);
     if (prefix == NULL)
         goto error;
 
@@ -3566,6 +3563,8 @@ static PyMethodDef bitarray_methods[] = {
      to01_doc},
     {"tobytes",      (PyCFunction) bitarray_tobytes,     METH_NOARGS,
      tobytes_doc},
+    {"__bytes__",    (PyCFunction) bitarray_tobytes,     METH_NOARGS,
+     tobytes_doc},
     {"tofile",       (PyCFunction) bitarray_tofile,      METH_O,
      tofile_doc},
     {"tolist",       (PyCFunction) bitarray_tolist,      METH_NOARGS,
@@ -3601,10 +3600,8 @@ static PyMethodDef bitarray_methods[] = {
 static int
 endian_from_string(const char *str)
 {
-    assert(default_endian == ENDIAN_LITTLE || default_endian == ENDIAN_BIG);
-
     if (str == NULL)
-        return default_endian;
+        return ENDIAN_DEFAULT;
 
     if (strcmp(str, "little") == 0)
         return ENDIAN_LITTLE;
@@ -3613,7 +3610,7 @@ endian_from_string(const char *str)
         return ENDIAN_BIG;
 
     PyErr_Format(PyExc_ValueError, "bit-endianness must be either "
-                                   "'little' or 'big', not '%s'", str);
+                 "'little' or 'big', not '%s'", str);
     return -1;
 }
 
@@ -4127,39 +4124,13 @@ reconstructor(PyObject *module, PyObject *args)
 static PyObject *
 get_default_endian(PyObject *module)
 {
-    return PyUnicode_FromString(ENDIAN_STR(default_endian));
+    return PyUnicode_FromString(ENDIAN_STR(ENDIAN_DEFAULT));
 }
 
 PyDoc_STRVAR(get_default_endian_doc,
 "get_default_endian() -> str\n\
 \n\
-Return the default bit-endianness for new bitarray objects being created.\n\
-Unless `_set_default_endian('little')` was called, the default\n\
-bit-endianness is `big`.");
-
-
-static PyObject *
-set_default_endian(PyObject *module, PyObject *args)
-{
-    char *endian_str;
-    int t;
-
-    if (!PyArg_ParseTuple(args, "s:_set_default_endian", &endian_str))
-        return NULL;
-
-    /* As endian_from_string() might return -1, we have to store its value
-       in a temporary variable before setting default_endian. */
-    if ((t = endian_from_string(endian_str)) < 0)
-        return NULL;
-    default_endian = t;
-
-    Py_RETURN_NONE;
-}
-
-PyDoc_STRVAR(set_default_endian_doc,
-"_set_default_endian(endian, /)\n\
-\n\
-Set the default bit-endianness for new bitarray objects being created.");
+Return the default bit-endianness for new bitarray objects being created.");
 
 
 static PyObject *
@@ -4182,6 +4153,11 @@ sysinfo(PyObject *module, PyObject *args)
     R("PY_LITTLE_ENDIAN", PY_LITTLE_ENDIAN);
     R("PY_BIG_ENDIAN", PY_BIG_ENDIAN);
     R("HAVE_BUILTIN_BSWAP64", HAVE_BUILTIN_BSWAP64);
+#ifdef Py_GIL_DISABLED   /* Python configured using --disable-gil */
+    R("Py_GIL_DISABLED", 1);
+#else
+    R("Py_GIL_DISABLED", 0);
+#endif
 #ifdef Py_DEBUG          /* Python configured using --with-pydebug  */
     R("Py_DEBUG", 1);
 #else
@@ -4193,7 +4169,8 @@ sysinfo(PyObject *module, PyObject *args)
     R("DEBUG", 0);
 #endif
 
-    return PyErr_Format(PyExc_KeyError, "%s", key);
+    PyErr_SetString(PyExc_KeyError, key);
+    return NULL;
 #undef R
 }
 
@@ -4211,8 +4188,6 @@ static PyMethodDef module_functions[] = {
      reduce_doc},
     {"get_default_endian",  (PyCFunction) get_default_endian, METH_NOARGS,
      get_default_endian_doc},
-    {"_set_default_endian", (PyCFunction) set_default_endian, METH_VARARGS,
-     set_default_endian_doc},
     {"_sysinfo",            (PyCFunction) sysinfo,            METH_VARARGS,
      sysinfo_doc},
     {NULL,                  NULL}  /* sentinel */
@@ -4260,6 +4235,10 @@ PyInit__bitarray(void)
     if ((m = PyModule_Create(&moduledef)) == NULL)
         return NULL;
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     if (PyType_Ready(&Bitarray_Type) < 0)
         return NULL;
     Py_SET_TYPE(&Bitarray_Type, &PyType_Type);
@@ -4287,8 +4266,8 @@ PyInit__bitarray(void)
         return NULL;
     Py_SET_TYPE(&SearchIter_Type, &PyType_Type);
 
-    PyModule_AddObject(m, "__version__",
-                       PyUnicode_FromString(BITARRAY_VERSION));
+    if (PyModule_AddStringMacro(m, BITARRAY_VERSION) < 0)
+        return NULL;
 
     return m;
 }

{bitarray-3.7.1 → bitarray-3.8.0}/bitarray/_util.c

@@ -2249,12 +2249,17 @@ PyInit__util(void)
     if ((m = PyModule_Create(&moduledef)) == NULL)
         return NULL;
 
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
     if (PyType_Ready(&CHDI_Type) < 0)
         return NULL;
     Py_SET_TYPE(&CHDI_Type, &PyType_Type);
 
 #ifndef NDEBUG  /* expose segment size in debug mode for testing */
-    PyModule_AddObject(m, "_SEGSIZE", PyLong_FromSsize_t(SEGSIZE));
+    if (PyModule_AddIntConstant(m, "_SEGSIZE", SEGSIZE) < 0)
+        return NULL;
 #endif
 
     return m;

{bitarray-3.7.1 → bitarray-3.8.0}/bitarray/bitarray.h

@@ -4,7 +4,7 @@
 
    Author: Ilan Schnell
 */
-#define BITARRAY_VERSION  "3.7.1"
+#define BITARRAY_VERSION  "3.8.0"
 
 #ifdef STDC_HEADERS
 #  include <stddef.h>
@@ -52,6 +52,8 @@ typedef struct {
 /* --- bit-endianness --- */
 #define ENDIAN_LITTLE  0
 #define ENDIAN_BIG     1
+/* default bit-endianness */
+#define ENDIAN_DEFAULT  ENDIAN_BIG
 
 #define IS_LE(self)  ((self)->endian == ENDIAN_LITTLE)
 #define IS_BE(self)  ((self)->endian == ENDIAN_BIG)
@@ -233,7 +235,7 @@ setup_table(char *table, char kop)
     for (k = 0; k < 256; k++) {
         char t = 0, j;
         for (j = 0; j < 8; j++) {
-            if (k & 1 << j)
+            if (k & 1 << j) {
                 /* j are the indices of active bits in k (little endian) */
                 switch (kop) {
                 case 'a': t += j;        break;  /* add active indices */
@@ -249,6 +251,7 @@ setup_table(char *table, char kop)
                 case 'r': t |= 128 >> j; break;  /* reverse bits */
                 default: Py_UNREACHABLE();
                 }
+            }
         }
         table[k] = t;
     }