These items are considered good candidates for contributions.
These items are clearly defined and can be directly implemented.
-
Enable sanitizers in CI builds.
-
Add test to add/replace/remove files in torrentzip archives using
zipsh.
These items need clarifications, especially regarding implementation details and expected behavior. Open a discussion before implementing them.
- Add test program for testing
zip_source_tAPI using theshelllibrary.
These items are intended for internal use only and are not meant to be implemented by external contributors.
- move add with data, replace to
zipsh_regress - move count to
zipsh - add/extract
- option to omit directory names in target file names
- option for recursive
- option to specify target filename (error if multiple source files specified)
- add: option to follow/omit symbolic links?
- Create archive by default? Calling it with non-existing file doesn't give an error, which is counterintuitive.
- Don't accept options after non-option arguments. Adapt tests.
- Documentation.
- Add more commands.
- enum argument types: match case insensitive. default case as looks better
- fnmatch(): error handling, honor case sensitivity from flags, use FNM_PATHNAME, FNM_PERIOD?
- Add support for changing argument type depending on options (e.g.
cat -i) - Switch tests to
zipsh_regress.
- add API
- archive_flags
- unchange all
- progress/cancel callbacks
- mtime/dostime
- fopen &c
- zip archive hole, buffer
- Switch existing one-off test programs to
zipsh_regress, sources shell, or CMocka, where possible.
- improve AES and PKWARE encryption tests
- add more
- review memset() uses
- Handle data sources with unknown uncompressed size: if we forced ZIP64 and don't need it, return specific error (so calling code can decide what to do (e. g. clear torrentzip flag and call
zip_close()again)).
-
Create section for developers and contributors, add directory layout, compatibility layer, shell API.
-
Document that edge cases that are not explicitly allowed should be assumed not to work.
-
Use macros with overflow checks instead of ad-hoc implementations.
-
split
zip_source_tin main part and reference so we can keep track which reference called open and we can invalidate references if the underlying source gets invalidated (e. g. byzip_close). -
Add source command to tell lower layer that we've reached EOF. Use in WinZip AES to trigger HMAC check (or error if too much unread data remains).
The zip format allows for a prefix before the zip archive. This is used by some applications to store additional data before the zip archive, e.g. self-extracting archives. libzip can open such archives, but currently does not support creating such archives and deletes the prefix if the archive is modified.
According to the zip format specification, the offsets in archives with a prefix are relative to the start of the file, not the start of the zip archive itself.
Suggestions for the API:
zip_set_archive_prefix(struct zip *za, const zip_uint8_t *data, zip_uint64_t length);
const zip_uint8_t *zip_get_archive_prefix(struct zip *za, zip_uint64_t *lengthp);- add lzma2 support
- add deflate64 support (https://github.com/madler/zlib/blob/master/contrib/infback9/infback9.h)
-
Add
zip_file_use_passwordto set per-file password to use if libzip needs to decrypt the file (e.g. when changing encryption or compression method). -
zip_get_archive_commenthasint *lenpargument. Cleaner would bezip_uint32_t *. rename and fix. which other functions for naming consistency? -
rename remaining
zip_XXX_{file,archive}_*tozip_{file,archive}_XXX_*? -
compression/crypt implementations: how to set error code on failure
-
compression/crypt error messages a la
ZIP_ER_ZLIB(no detailed info passing)
-
Let sources create extra fields, remove WinZip AES special case from
zip_dirent_write(). -
consistently use
_zip_crypto_clear()for passwords -
support setting extra fields from
zip_source- introduce layers of extra fields:
- original
- from
zip_source - manually set
- when querying extra fields, search all of them in reverse order
- add whiteout (deleted) flag
- allow invalid data flag, used when computing extra field size before writing data
- new command
ZIP_SOURCE_EXTRA_FIELDS - no support for multiple copies of same extra field
- introduce layers of extra fields:
-
function to copy file from one archive to another
-
set
O_CLOEXECflag after fopen and mkstemp -
support streaming output (creating new archive to e.g. stdout)
-
add function to read/set ASCII file flag
-
add custom compression function support
-
zip_source_zip(): allow rewinding -
zipcmp: add option for file content comparison -
zipcmp: add more paranoid checks:- external attributes/opsys
- version needed/made by
- general purpose bit flags
-
add more consistency checks:
- for stored files, test compressed = uncompressed
- data descriptor
- local headers come before central dir
-
support for old compression methods?
- ensure that nentries is small enough not to cause overflow (size_t for entry, uint64 for CD on disk)
- check for limits imposed by format (central dir size, file size, extra fields, ...)
_zip_u2d_time(): handlelocaltime(3)failure- POSIX:
zip_open(): check whether file can be created and fail if not - fix inconsistent usage of valid flags (not checked in many places)
cdr == NULL->ER_NOENTvs.idx > cdir->nentry->ER_INVALinconsistent (still there?)
- go over cdir parser and rename various offset/size variables to make it clearer
- use bool
- use
ZIP_SOURCE_SUPPORTS_{READABLE,SEEKABLE,WRITABLE} - use
zip_source_seek_compute_offset() - get rid of
zip_get_encryption_implementation() - use
zip_*int*_tinternally zip_source_file(): don't allow write if start/len specify a part of the file
- document valid file paths
- keep error codes in man pages in sync
- document error codes in new man pages
- add coverage reports, e.g. using gcovr or https://github.com/eddyxu/cpp-coveralls (coveralls.io)
- review guidelines/community standards
- test different crypto backends with GitHub actions.
- improve man page formatting of tagged lists on webpage (
<dl>) - script to check if all exported symbols are marked with
ZIP_EXTERN, add tomake distcheck
- get cmake to optionally build frameworks
-
add test cases for all
ZIP_INCONSdetail errors -
incons-local-filename-short.zzipdoesn't test short filename, since extra fields fail to parse. -
test error cases with special source
- tell it which command should fail
- use it both as source for
zip_addandzip_open_from_source ziptool_regress:-e error_spec: source containing zip fails depending onerror_specadd_with_error name content error_spec: add content to archive, where source fails depending onerror_specadd_file_with_error name file_to_add offset len error_spec: add file to archive, len bytes starting from offset, where source fails depending onerror_spec
error_spec:- source command that fails
- error code that source returns
- conditions that must be met for error to trigger
- Nth call of command
- read/write: total byte count so far
- state of source (opened, EOF reached, ...)
-
test for zipcmp reading directory (requires fts)
-
add test case for clone with files > 4k
-
consider testing for
malloc/reallocfailures -
Winzip AES support
- test cases decryption: <=20, >20, stat for both
- test cases encryption: no password, default password, file-specific password, 128/192/256, <=20, >20
- support testing on macOS
-
add test cases for lots of files (including too many)
-
add test cases for holes (between files, between files and cdir, between cdir and eocd, + zip64 where appropriate)
-
test seek in
zip_source_crc_create() -
test cases for
set_extra*,delete_extra*,*extra_field* -
test cases for in memory archives
- add
- delete
- delete all
- modify
-
use gcov output to increase test coverage
-
add test case to change values for newly added files (name, compression method, comment, mtime, . . .)
-
zip_open()file less thanEOCDLENbytes long -
test calls against old API
-
rename file to dir/ and vice versa (fails)
-
fix comment test to be newline insensitive
-
check if http://bugs.python.org/issue20078 provides ideas for new tests
-
(
add,replace)- add to empty zip
- add to existing zip
- add w/ existing file name [E]
- replace ok
- replace w/ illegal index [E]
- replace w/ deleted name [E]
- unchange added/replaced file
-
(
close)- copy zip file
- open copy
- rename, delete, replace, add w/ new name, add w/ deleted name
- close
- zipcmp copy expected
- remove copy
-
(
error_get) -
(
error_get_sys_type) -
(
error_to_str) -
(
extra_fields) -
(
file_error_get) -
(
file_strerror) -
(
replace) -
(
source_buffer) -
(
source_file) -
(
source_filep) -
(
source_free) -
(
source_function) -
(
source_zip) -
(
strerror) -
(
unchange) -
(
unchange_all) -
open(ZIP_RDONLY) -
I/O abstraction layer
zip_open_from_source
-
read two zip entries interleaved
-
test
zip_file_is_seekable(viaziptool?)