WIP: Python bindings

[fabianfreyer]

See #13

Includes (merge these first, then rebase):

• Expose jail_attach #18
• Add support for non-persistent jails #19

Features

• Jail start/stop
• StoppedJail parameters
  • getter
  • setter
• StartedJail parameters
  • getter
  • setter
• RACCT statistics
• spawn child wrapper
  • wait, try_wait
  • exit code / signal
  • stdio redirection
    • stdio = subprocess.PIPE, subprocess.DEVNULL, subprocess.STDOUT, as well as custom fds
    • read_stdout(count) -> bytearray, read_stderr(count) -> bytearray
    • write_stdin(bytearray) -> bytes_written
    • readall_stdout_str() -> str, readall_stderr_str() -> str blocking until eof
    • write_stdin_str(str)
    • flush_stdin()
• iteration over RunningJails (Jls)

[fabianfreyer]

Adding the parameter set logic will require this to be based off #15. This allows us to do stuff like this:

#!/usr/bin/env python3
import jail
config = jail.StoppedJail("/", parameters={"osrelease": "FnordBSD 42.023"})
running = config.start()
print(running.parameters)

[igalic]

all of these types look pretty much the same to me, or am i missing something?

[fabianfreyer]

@igalic what types?

[igalic]

the impl StoppedJail and impl RunningJail both looked very similar, but i was also very confused about the lib.rs vs oldlib.rs

[fabianfreyer]

@igalic thanks for taking a look!

• oldlib.rs was a mistake - fixed that. Sorry!
• StoppedJail and RunningJail are things in libjail-rs that I created to attempt to model the jail lifetime using the rust type system and are therefore distinct types. The python wrapper doesn't necessarily need to model those quirks, but they are kept to more closely wrap the libjail-rs rust library API.

[igalic]

👀

[igalic]

that's a pretty cool "hack"