Split up handling of archive file based on version

Fix typo

Fix typo in file format specification version 1

Create file format for format version 1

This is in preparation of improving compression by concatenating files
together before compressing them to reduce the per-file overhead.

backport: Fixes for v0-file-format extract fn

Error if "-C <dir>" where "dir" doesn't exist

Fix potential NULL-ptr dereference

Add compiler hardening flags

Impl. way to set custom hasher for hash_map

Convert "unsigned long long" to "uint64_t"

Missed during previous changes using stdint.h .

`clang-format`

Use stdint.h types instead of "int", "long", etc.

Add single-ptr variants data structures' free fns

Refactor priority-heap insert fn

priority-heap insert now takes a pointer to a priority-heap instead of a
double pointer.

Refactor data_structures/hash_map rehash fn

Cleanup related to change of hash-map insert fn

Refactor hash_map insert to use single ptr

Previous implementation used a double ptr for inserting into a hash map.
This refactoring allows for only needing to use a single ptr.

Fixes https://git.seodisparate.com/stephenseo/SimpleArchiver/issues/17 .

Fixes related to compiler warnings

Fix integer mismatch usages/comparisons.

Use "size_t" instead of "unsigned int" for data structures.

hash_map: Use const where applicable

hash_map iter fn: const key-value, update unittest

Impl. hash_map iter, clang-format

Switch to ISC License

Cleanup/refactorings

Moved common functions to helpers.h, and similar cleanup/refactorings.

Add NULL check when printing cwd on temp file fail

More verbose log when failing to create temp file

Improve file-count logs

Add check if file(s) are readable when archiving

Also some minor changes like more error logs and refactorings.

"Fix" windows build

TODO:
    Native Windows implementation.

Fix "-C <dir>" usage

TODO:
    Merge re-used functions into "helpers".

Update README.md

Impl. "-C <dir>", refactorings

Update README.md

Impl. being able to set dir for temporary files

Refactor parser, setup for different temp dir

Minor help-text/doc fix

Update README.md

Update README.md

Update README.md

Comment out debug print

"Fix" windows build

Impl. link extracting

Add abs_path check when referring out of archive

If absolute paths are enabled, and a link points to something outside of
the archive, a flag is set on the symlink entry to prefer absolute
paths.

Create "set" of filenames for use when archiving

Split off code into internal helper function

Function gets absolute path to given filename.

Minor tweak to includes in archiver

Update file_format.md

Add "--no-abs-symlink" to not store absolute paths

Impl. archiving abs/rel-paths for symbolic links

TODO:
    Choosing the ideal link based on if link points to an archived file.
    Extracting (creating) symbolic links from archive.

Set user permission bits if non-Unix platform

Fix improper handling of unsupported symlinks

TODO:
    Archive symlinks properly.
    Extract symlinks properly.

Support "-f -" to read/write archive stdin/stdout

Use SIGPIPE handling on UNIX platforms

Improve error handling

Handle SIGPIPE.

More robust error handling

Fix robust cleanup of temporary compressed file

More robust handling of bad compressor cmd

Do not create archive file on failure

More robust cleanup of temporary file

Improve error print

Print permissions when in "-t" mode

Fix error when checking with "-t"

Improve error printing

Remove unnecessary "include"s

Comment out debug print

Impl. extract "white-list"

When extracting, the given positional args will determine a "white-list"
of files to extract. If no positional args are given, then all files in
the archive will be extracted.

Improve error handling when parsing/extracting

Fix extracting when no compressor was used

Store/restore file permissions

"Fix" windows build

Implement extracting from archive

TODO:
    Storing file permissions to be extracted with same permissions.
    Archiving and extracting symbolic links.

Add helper to create dirs from filepath

Use waitpid on compress to avoid defunct processes

Output when writing file to archive

Impl. compressing with arbitrary command

TODO:
    Archive extracting.
    Create archive with symbolic links.

Minor fixes

Impl. setup for de/compression

Some setup code in preparation of doing the actual file compression when
creating an archive.

"-t": Note that file is compressed if compressed

Impl. "-t" command (printing archive info)

TODO:
    Write symbolic links into archive when creating.
    Use De/compressor cmds when creating archive.
    Extracting archive.

Update parser flags to allow "checking" with "-t"

Add "status progress" when archiving

Impl. basic functionality "MVP"

"MinimumViableProduct", resolves #2 .

TODO:
  Support de/compressor cmds when creating archive.
  Support symbolic links when creating archive.
  Support extracting archive.

big-endian convert: Use stdint.h

Replace "unsigned short" with uint16_t, "unsigned int" with uint32_t,
and "unsigned long long" with uint64_t.

Minor tweaks to file format

Add "--overwrite-create"

Default behavior is now to NOT overwrite existing archive files for
storing output unless "--overwrite-create" is specified.

Revise file_format.md

Specify how symlink paths should be handled if they do not exist (path
size of 0).

Impl. handling symbolic links

Remove unnecessary "TODO" in comment.

Update file_format.md

Make strings NULL-terminated.

revise file_format.md

Update file_format.md

Resolves #11 .

parser: Enable existing codepath for OSX

The Unix functions/headers used in parser for getting files/dirs from
the given positional arguments are also available in OSX
(theoretically), so they are now enabled for OSX platforms.

TODO: Add getting files/dirs code for the Windows platform.

Handle symbolic links separately

Previous implementation could loop forever following a symbolic link
that goes backwards. This commit makes symbolic links an "unhandled file
type" for now.

"platforms.h" include should be before its usage

Impl. parser accepting files and dirs

Fix memory leak in hash_map.

Current "main" prints specified files and subfiles of specified
directories.

TODO: Handle symbolic links

Remove 'extern' from parser.h

Add helpers for conversion to/from big-endian

Also added tests for big-endian-conversion functions.

Revise file_format

The changes should allow for the .simplearchive file to be directly
outputted to standard out in a single pass.

Resolves #10 .

Some work on arg parser

Also added unit tests for arg parser.

Fix unit test for priority heap

Change priority_heap to accept "less_fn"

This allows for reverse order in the priority heap by using a "more_fn"
in place of a "less fn".