bitstring 4.3.0__tar.gz → 4.4.0__tar.gz

{bitstring-4.3.0/bitstring.egg-info → bitstring-4.4.0}/PKG-INFO

@@ -1,8 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: bitstring
-Version: 4.3.0
+Version: 4.4.0
 Summary: Simple construction, analysis and modification of binary data.
 Author-email: Scott Griffiths <dr.scottgriffiths@gmail.com>
+License: MIT
 Project-URL: homepage, https://github.com/scott-griffiths/bitstring
 Project-URL: documentation, https://bitstring.readthedocs.io/
 Keywords: binary,bitarray,bitvector,bitfield
@@ -16,12 +17,15 @@ 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: License :: OSI Approved :: MIT License
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: bitarray<3.1,>=3.0.0
+Requires-Dist: bitarray<4.0,>=3.0.0
+Requires-Dist: tibs<0.6,>=0.5.6
+Dynamic: license-file
 
 
 
@@ -29,9 +33,6 @@ Requires-Dist: bitarray<3.1,>=3.0.0
 
 **bitstring** is a Python library to help make the creation and analysis of all types of bit-level binary data as simple and efficient as possible. It has been actively maintained since 2006.
 
-The library has has now been downloaded over 100 million times! &nbsp; &nbsp; ✨ [![Pepy Total Downloads](https://img.shields.io/pepy/dt/bitstring?label=Downloads:&labelColor=orange&color=orange)](https://www.pepy.tech/projects/bitstring) ✨
-
-
 
 [![CI badge](https://github.com/scott-griffiths/bitstring/actions/workflows/.github/workflows/ci.yml/badge.svg)](https://github.com/scott-griffiths/bitstring/actions/workflows/ci.yml)
 [![Docs](https://img.shields.io/readthedocs/bitstring?logo=readthedocs&logoColor=white)](https://bitstring.readthedocs.io/en/latest/)
@@ -46,6 +47,14 @@ The library has has now been downloaded over 100 million times! &nbsp; &nbsp;
 > [!NOTE]
 > To see what been added, improved or fixed, and also to see what's coming in the next version, see the [release notes](https://github.com/scott-griffiths/bitstring/blob/main/release_notes.md).
 
+# News
+
+I'm rewriting the core of bitstring in Rust, and have released that cut-down and streamlined interface as the [tibs](https://github.com/scott-griffiths/tibs) package. It's now in beta, and feedback is welcome. Just `pip install tibs` to try it out.
+
+[![tibs](https://raw.githubusercontent.com/scott-griffiths/tibs/main/doc/tibs.png)](https://github.com/scott-griffiths/tibs)
+
+A sleek Python library for your binary data
+
 
 # Overview
 
@@ -131,4 +140,4 @@ Array('uint7', [45, 100, 15, 1])
 ```
 
 
-<sub>Copyright (c) 2006 - 2025 Scott Griffiths</sub>
+<sub>Copyright (c) 2006 - 2026 Scott Griffiths</sub>

{bitstring-4.3.0 → bitstring-4.4.0}/README.md

@@ -4,9 +4,6 @@
 
 **bitstring** is a Python library to help make the creation and analysis of all types of bit-level binary data as simple and efficient as possible. It has been actively maintained since 2006.
 
-The library has has now been downloaded over 100 million times!     ✨ [![Pepy Total Downloads](https://img.shields.io/pepy/dt/bitstring?label=Downloads:&labelColor=orange&color=orange)](https://www.pepy.tech/projects/bitstring) ✨
-
-
 
 [![CI badge](https://github.com/scott-griffiths/bitstring/actions/workflows/.github/workflows/ci.yml/badge.svg)](https://github.com/scott-griffiths/bitstring/actions/workflows/ci.yml)
 [![Docs](https://img.shields.io/readthedocs/bitstring?logo=readthedocs&logoColor=white)](https://bitstring.readthedocs.io/en/latest/)
@@ -21,6 +18,14 @@ The library has has now been downloaded over 100 million times!    
 > [!NOTE]
 > To see what been added, improved or fixed, and also to see what's coming in the next version, see the [release notes](https://github.com/scott-griffiths/bitstring/blob/main/release_notes.md).
 
+# News
+
+I'm rewriting the core of bitstring in Rust, and have released that cut-down and streamlined interface as the [tibs](https://github.com/scott-griffiths/tibs) package. It's now in beta, and feedback is welcome. Just `pip install tibs` to try it out.
+
+[![tibs](https://raw.githubusercontent.com/scott-griffiths/tibs/main/doc/tibs.png)](https://github.com/scott-griffiths/tibs)
+
+A sleek Python library for your binary data
+
 
 # Overview
 
@@ -106,4 +111,4 @@ Array('uint7', [45, 100, 15, 1])
 ```
 
 
-<sub>Copyright (c) 2006 - 2025 Scott Griffiths</sub>
+<sub>Copyright (c) 2006 - 2026 Scott Griffiths</sub>

{bitstring-4.3.0 → bitstring-4.4.0}/bitstring/__init__.py

@@ -55,11 +55,26 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 """
 
-__version__ = "4.3.0"
+__version__ = "4.4.0"
 
 __author__ = "Scott Griffiths"
 
 import sys
+import os
+import importlib
+
+# New ability to use tibs for core operations instead of bitarray.
+# Tibs is written in Rust and is still in beta. Use the environment variable
+# BITSTRING_USE_RUST_CORE=1 before importing the module to turn it on.
+_env_core = os.getenv('BITSTRING_USE_RUST_CORE', '').strip().lower()
+_USE_RUST_CORE = _env_core in ('1', 'true', 'yes', 'on')
+if _USE_RUST_CORE:
+    bitstore = importlib.import_module('bitstring.bitstore_tibs')
+    bitstore_helpers = importlib.import_module('bitstring.bitstore_tibs_helpers')
+else:
+    bitstore = importlib.import_module('bitstring.bitstore_bitarray')
+    bitstore_helpers = importlib.import_module('bitstring.bitstore_bitarray_helpers')
+bitstore_common_helpers = importlib.import_module('bitstring.bitstore_common_helpers')
 
 from .bits import Bits
 from .bitstring_options import Options
@@ -226,7 +241,7 @@ dtype_definitions = [
     # String types
     DtypeDefinition('hex', Bits._sethex, Bits._gethex, str, False, hex_bits2chars,
                     allowed_lengths=(0, 4, 8, ...), description="a hexadecimal string"),
-    DtypeDefinition('bin', Bits._setbin_safe, Bits._getbin, str, False, bin_bits2chars,
+    DtypeDefinition('bin', Bits._setbin, Bits._getbin, str, False, bin_bits2chars,
                     description="a binary string"),
     DtypeDefinition('oct', Bits._setoct, Bits._getoct, str, False, oct_bits2chars,
                     allowed_lengths=(0, 3, 6, ...), description="an octal string"),

{bitstring-4.3.0 → bitstring-4.4.0}/bitstring/bitarray_.py

@@ -10,6 +10,9 @@ from bitstring.exceptions import CreationError, Error
 from bitstring.bits import Bits, BitsType, TBits
 
 import bitstring.dtypes
+common_helpers = bitstring.bitstore_common_helpers
+
+MutableBitStore = bitstring.bitstore.MutableBitStore
 
 
 class BitArray(Bits):
@@ -112,14 +115,37 @@ class BitArray(Bits):
                   initialising using 'bytes' or 'filename'.
 
         """
-        if self._bitstore.immutable:
-            self._bitstore = self._bitstore._copy()
-            self._bitstore.immutable = False
+        pass
+
+    def __new__(cls: Type[TBits], auto: Optional[Union[BitsType, int]] = None, /, length: Optional[int] = None,
+                offset: Optional[int] = None, **kwargs) -> TBits:
+        x = super(Bits, cls).__new__(cls)
+        if auto is None and not kwargs:
+            # No initialiser so fill with zero bits up to length
+            if length is not None:
+                x._bitstore = MutableBitStore.from_zeros(length)
+            else:
+                x._bitstore = MutableBitStore()
+            return x
+        x._initialise(auto, length, offset, immutable=False, **kwargs)
+        return x
+
+    @classmethod
+    def fromstring(cls: TBits, s: str, /) -> TBits:
+        """Create a new bitstring from a formatted string."""
+        x = super().__new__(cls)
+        b = common_helpers.str_to_bitstore(s)
+        x._bitstore = b._mutable_copy()
+        return x
 
     def copy(self: TBits) -> TBits:
         """Return a copy of the bitstring."""
         return self.__copy__()
 
+    def _invert_all(self) -> None:
+        """Invert every bit."""
+        self._bitstore.invert()
+
     def __setattr__(self, attribute, value) -> None:
         try:
             # First try the ordinary attribute setter
@@ -148,8 +174,7 @@ class BitArray(Bits):
     def __copy__(self) -> BitArray:
         """Return a new copy of the BitArray."""
         s_copy = BitArray()
-        s_copy._bitstore = self._bitstore._copy()
-        assert s_copy._bitstore.immutable is False
+        s_copy._bitstore = self._bitstore._mutable_copy()
         return s_copy
 
     def _setitem_int(self, key: int, value: Union[BitsType, int]) -> None:
@@ -427,7 +452,7 @@ class BitArray(Bits):
         """
         if pos is None:
             # Set all bits to either 1 or 0
-            self._setint(-1 if value else 0)
+            self._bitstore.__setitem__(slice(None), bool(value))
             return
         if not isinstance(pos, abc.Iterable):
             pos = (pos,)