pamqp

Breaking Changes

• Python 3.11+ required (previously 3.7+)
• Removed explicit __annotations__ class variable from all command classes and base classes. Python manages __annotations__ automatically; the explicit declarations conflicted with object.__annotations__. Code that introspected MyCommand.__annotations__ directly may need updating.

Bug Fixes

• Fix Basic.Reject(requeue=False) being coerced to True — The codegen emitted self.requeue = requeue or True which made it impossible to reject without requeuing. Now uses a proper ternary to preserve explicit False. (#45 related, also previously fixed in 3.0.1 but regressed)
• Fix Exchange.Declare(internal=True) raising ValueError — The internal flag was incorrectly treated as a deprecated field. It is a legitimate AMQP flag used for internal exchanges and RabbitMQ tracing.
• Fix encoding of negative byte-range integers in field tables (#45) — table_integer routed values in -128..127 to octet() which uses unsigned byte format (struct 'B'), causing struct.error for negative values like -1. Now uses signed byte format (struct '>b'). This affected x-priority, x-delivery-limit, and any other table argument using small negative integers.
• Fix codegen domain regex for exchange/queue names — The codegen now extends the AMQP spec regex to include characters RabbitMQ allows in practice (@, #, ,, /, +, space), and fixes a bug where the trailing-comma replacement corrupted regex patterns containing commas.

Improvements

• Full type checking with mypy and basedpyright — Both type checkers now pass cleanly and are enforced in pre-commit hooks and CI.
• typing.ClassVar annotations on all class-level attributes across base classes, command classes, body, header, and heartbeat modules. Codegen updated to emit these correctly.
• Explicit submodule imports in __init__.py to satisfy basedpyright's reportUnsupportedDunderAll check.
• Boolean default assignment fix in codegen — Boolean fields with defaults now use ternary expressions (x if x is not None else default) instead of x or default, which correctly preserves False values.

Tooling & Documentation

• Modernized project tooling — hatchling build backend, uv for dependency management, ruff for linting/formatting, pre-commit hooks
• Migrated documentation from Sphinx/RST to MkDocs/Markdown with mkdocs-material theme and mkdocstrings for API reference
• Converted README from RST to Markdown with updated badges, features, and "Used By" section
• Updated CI — GitHub Actions with Python 3.11-3.14 matrix, uv-based workflow, mypy and basedpyright checks
• Updated CONTRIBUTING.md with current uv/ruff/pre-commit workflow
• License dates updated to 2011-2026
• Trusted PyPI publishing via GitHub Actions OIDC

Update changelog to include last change

Fix line length issue in comment

Update changelog and bump version

Remove unused annotation

• Fix an issue with Basic.Reject requeue=False always being set to True (#29 - eandersson)

• Fix unsigned short-int encoding and decoding to use the correct amqp field designation of B instead of b (#27)
• Fix timestamp encoding/decoding tests to work when the timezone is set on the host machine (#26)

Fix additional missing branch coverage

• Rename pamqp.frame._frame_parts to pamqp.frame.frame_parts (#15 again)
• pamqp.commands.Basic.QoS.global_ renamed to pamqp.commands.Basic.QoS.globally
• Removed mypy checking due to errors in mypy and recursive type aliases
• Added pamqp/py.typed for PEP-561 compatibility (#21 - michael-k)

• Refactor codegen.py
• Revert the behaviors added in 3.0.0a2 with regard to documented defaults and None
• Use amqp0-9-1.extended.xml instead of amqp-0-9-1.xml to get the documentation for RabbitMQ added classes/methods
• Add strict value checking for deprecated values
• Remove empty __init__ functions from method classes

• Make comparison of Basic.Properties against other object types raise NotImplementedError
• Return test coverage to 100%

• Added mypy as part of the test pipeline and made updates based upon its findings
• Added length checking and regex checking for values specified in AMQP spec
• Fixed some of the type annotations added in 3.0.0a0
• Fixed some of the documentation and label usage in pamqp.commands
• Removed redundant inline documentation in pamqp.commands
• Updated default values to only reflect defaults specified in the XML and JSON specs. If no default is specified, the value will now be None

• Revert the removal of pamqp.body.ContentBody.name

• Update to support Python 3.6+ only
• Add typing annotations to all modules, callables, and classes
• Moved exceptions from pamqp.specification to pamqp.exceptions
• Moved constants from pamqp.specification to pamqp.constants
• Moved base classes out of pamqp.specification to pamqp.base
• Changed the structure of nested classes for AMQP Commands (Classes & Methods) in pamqp.specification to functions in pamqp.commands
• Renamed pamqp.specification.ERRORS to pamqp.exceptions.CLASS_MAPPING
• Remove convenience exports of pamqp.headers.ContentHeader and pamqp.header.ProtocolHeader
• pamqp.body.ContentBody.value now only supports bytes
• Changed pamqp.decode.timestamp to return a datetime.datetime instance instead of time.struct_time
• Updated pamqp.encode.support_deprecated_rabbitmq() to allow for toggling support
• Changed pamqp.encode.timestamp to only support datetime.datetime and time.struct_time values, dropping epoch (int) support
• Removed pamqp.frame.BasicProperties.to_dict() in favor of behavior allowing for dict(pamqp.frame.BasicProperties)
• Optimized pamqp.heartbeat.Heartbeat to marshal the static frame value as a predefined class attribute
• Add support for Connection.UpdateSecret and Connection.UpdateSecretOk
• Removed the ability to unset a Basic.Property by invoking del properties[key]
• Removed the deprecated pamqp.codec sub-package

• Add pamqp.encode.support_deprecated_rabbitmq function to limit data types available when encoding field-tables for older RabbitMQ versions

• Change pamqp.encode.timestamp to allow for numeric/epoch timestamps (#14 - mosquito)
• Change pamqp.frame.frame_parts to a public method (#15 - mosquito)
• Cleanup of code to pass configured flake8 tests
• Add support for 8-bit unsigned integer values in pamqp.encode.table_integer

• Change raising a DeprecationWarning exception to using warnings.warn for deprecated AMQP methods (#13 - dzen)

• Change Python versions supported to 2.7 and 3.4+
• Always decode field table keys as strings (#6)
  • This may be a breaking change means in Python3 keys will always be type str for short strings. This includes frame values and field table values.
  • In Python 2.7 if a short-string (key, frame field value, etc) has UTF-8 characters in it, it will be a unicode object.
• Combine test coverage across all Python versions
• Fix range for signed short integer (#7)
• Fix guards for usage of unsigned short usage in pamqp.encode (#7)
• Fix encoding and decoding of unsigned short (#7)
• Add support for unsigned short integer and long integer in field tables (#10)
• Address edge case of small value in long type (#8)
• Address long string encoding inconsistency (#9)
• Cleanup unicode object & conditionals in py3 (#9)
• Add pamqp.exceptions.PAMQPException as a base class for pamqp specific exceptions (#4)
• Fix decoding of void values in a field table or array

• Fix the encoding guard for unsigned short integers to be 65535

• Remove UTF-8 encoding from byte_array (#2)
• Fix AMQP Field Tables / Basic.Properties headers behavior:
  • Field names per spec should not exceed 128 bytes
  • long-strings should not be utf-8 encoded (only short-strings)
• Ensure that field table long strings are not coerced to UTF-8 as specified in AMQP 0-9-1
• Move AMQP Methods in specification.py to slotted classes
• Change Basic.Properties to a slotted class
• Instead of class level attributes with the same name as obj attributes, prefix class attributes for data types with an underscore
• Add new class method type() for Basic.Properties for accessing data type
• Add new class method type() for AMQP methods for accessing data type
• Change Basic.Properties.attributes to Basic.Properties.attributes(), returning the list of slotted attributes
• Fix a typo for booleans in the method mapping for table decoding
• Frame.__getitem__ will now raise a KeyError instead of None for an invalid attribute
• PropertiesBase no longer checks to see if an attribute is set for contains
• Adds new specification tests
• More efficiently handle the frame end character in Python 3

• Cleanup how UTF-8 is handled in decoding strings
• Ensure that field tables (headers property, etc) can use keys with utf-8 data
• Address missing and mis-aligned AMQP-0-9-1 field table decoding with the field type indicators from the RabbitMQ protocol errata page
• Fix an encoding by type bug introduced with 1.4 having to do with bytearrays
• Be explicit about needing a class id in the ContentHeader
• Update the tests to reflect the unicode changes
• Clean up the tests

• Fix a long standing bug for non-specified responses for RabbitMQ AMQP extensions
• Refactor adding bytearrays and recoding complexity
• Add bytearray support (#1)
• Change encode/decode type errors from ValueError to TypeError exceptions
• Remove separate codecs for Python 2 & 3
• Move codecs from pamqp.codec.encode and pamqp.codec.decode to pamqp.encode and pamqp.decode
• Deprecate pamqp.codec

• Fix encoding of long-long-integers

• Remove support for short strings in field tables

• Add short-short-int support

• Fix distribution requirements

• Add decimal data type support

• Fix Confirm.Select definition

• Add support for Connection.Blocked, Connection.Unblocked
• Add documentation to specification.py in the codegen process

• Fix exception creation

• Add Confirm.Select, Confirm.SelectOk

• Remove debugging print statements (eek)

• Add Python 3.3 support

• Address Unicode issues
• Add void support in table arrays

• Initial version