Add symbolic link options

[miurahr]

• Add enable_symlink boolean option for read, extractall, and extract
• Add dereference boolean option for write and writeall
  • SevenZipFile constructor option dereference is marked deprecated and will be removed in future version

Signed-off-by: Hiroshi Miura [email protected]

[miurahr]

We should treat an argument dereferece of SevenZipFile constructor as a default of write and writeall methods, and users can override it in each write call.

[miurahr]

#636 related

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.07% (target: -1.00%)	✅ 87.50%

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (42a3dc8)	3514	3087	87.85%
Head commit (3023660)	3518 (+4)	3093 (+6)	87.92% (+0.07%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#482)	40	35	87.50%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

[coveralls]

coverage: 87.406% (+0.04%) from 87.365%
when pulling 3023660 on topic/miurahr/security/symlink-extraction-optional
into 42a3dc8 on master.

[miurahr]

This modification changes the behavior of py7zr. When got symbolic link inside archive, previous versions are extract it as symbolic link but now py7zr requires EXPLICIT option to extract symbolic link.

It is because, we need to update a manual document and put warning on README.
It is also better to make a discussion thread on GitHub discussion forum.