mirror of
https://github.com/python/cpython.git
synced 2025-08-04 17:08:35 +00:00
Make lzma.{encode,decode}_filter_properties private.
These functions were originally added to support LZMA compression in the zipfile module, and are not of interest for the majority of users. They can be made public in 3.4 if there is user interest, but in the meanwhile, I've opted to present a smaller, simpler API for the module's initial release.
This commit is contained in:
parent
01317d2ed5
commit
a425c3d5a2
5 changed files with 31 additions and 63 deletions
|
@ -268,32 +268,6 @@ Miscellaneous
|
|||
feature set.
|
||||
|
||||
|
||||
.. function:: encode_filter_properties(filter)
|
||||
|
||||
Return a :class:`bytes` object encoding the options (properties) of the
|
||||
filter specified by *filter* (a dictionary).
|
||||
|
||||
*filter* is interpreted as a filter specifier, as described in
|
||||
:ref:`filter-chain-specs`.
|
||||
|
||||
The returned data does not include the filter ID itself, only the options.
|
||||
|
||||
This function is primarily of interest to users implementing custom file
|
||||
formats.
|
||||
|
||||
|
||||
.. function:: decode_filter_properties(filter_id, encoded_props)
|
||||
|
||||
Return a dictionary describing a filter with ID *filter_id*, and options
|
||||
(properties) decoded from the :class:`bytes` object *encoded_props*.
|
||||
|
||||
The returned dictionary is a filter specifier, as described in
|
||||
:ref:`filter-chain-specs`.
|
||||
|
||||
This function is primarily of interest to users implementing custom file
|
||||
formats.
|
||||
|
||||
|
||||
.. _filter-chain-specs:
|
||||
|
||||
Specifying custom filter chains
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue