feat: creating and removing empty directories

[wassup05]

User facing functions added are

• make_directory (path, mode, err) (mode argument only for Unix systems)
• remove_directory (path, err)

1. Both of them support relative paths and on Windows, paths involving either / or \.
2. They bind to the CRT functions mkdir, rmdir, _mkdir, _rmdir on Unix and Windows respectively.
3. A binding to strerror has been included as a private helper to provide helpful error messages.
4. state_type is used for error handling.

Side note:
make_directory could have a logical argument recursive which would work like mkdir -p but that would require path manipulation especially dir_name from #999

Do let me know your thoughts.

[sebastian-mutz]

Hey @wassup05. Thanks for the PR. Great work!

1. I added minor suggestions to the comments (just grammar).
2. For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

[sebastian-mutz]

Add period to end of sentence.

[sebastian-mutz]

Capitalise "appropriate" to be consistent. (Same down below).

[wassup05]

For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

I think it's fine @sebastian-mutz, doing that would kind of clutter the example I feel, and this is how it's been handled in some other examples as well like here and here

[sebastian-mutz]

For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

I think it's fine @sebastian-mutz, doing that would kind of clutter the example I feel, and this is how it's been handled in some other examples as well like here and here

Makes sense. Then it's best to keep it consistent.

[wassup05]

Concerning the mode argument which is not applicable to Windows, here is how some other languages handle it...

Python

Complete docs here: https://docs.python.org/3/library/os.html#os.mkdir
To quote some important parts:

On some systems, mode is ignored. Where it is used, the current umask value is first masked out. If bits other than the last 9 (i.e. the last 3 digits of the octal representation of the mode) are set, their meaning is platform-dependent. On some platforms, they are ignored and you should call chmod() explicitly to set them.

On Windows, a mode of 0o700 is specifically handled to apply access control to the new directory such that only the current user and administrators have access. Other values of mode are ignored.

Golang

Golang does it in a different way by creating a portable custom struct of the permission bits, to quote exactly

A FileMode represents a file's mode and permission bits. The bits have the same definition on all systems, so that information about files can be moved from one system to another portably. Not all bits apply to all systems. The only required bit is ModeDir for directories.

Reference: https://pkg.go.dev/os#FileMode, https://pkg.go.dev/os#Mkdir

Rust

Rust seems to have dropped this argument completely and uses default permissions
Reference: https://doc.rust-lang.org/std/fs/fn.create_dir.html