From 63d2d4158771a25d5433dcf3f6f9b732a3f698a7 Mon Sep 17 00:00:00 2001 From: Darryl Nixon Date: Sun, 16 Jul 2023 15:25:03 -0700 Subject: [PATCH] Clarify CLI and add initial real README --- README.md | 37 +++++++++++++++++++++++++++++++++---- melamine/cli.py | 10 +++++++--- 2 files changed, 40 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index d902a49..b193890 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,41 @@ +
+melamine logo + # melamine -todo! +**melamine** is a better file shredder -## install +for linux
+ +[Installation](#installation) • +[Example](#example) • +[Contributing](#contributing) • +[License](#license) +
+ +## Installation + +todo ```bash sudo apt install --yes --no-install-recommends build-essential python3-dev libzfslinux-dev && \ sudo pip3 install Cython && \ -git clone https://github.com/truenas/py-libzfs && \ -cd py-libzfs && ./configure --prefix=/usr && sudo make install +git clone https://github.com/truenas/py-libzfs && pushd py-libzfs && \ +./configure --prefix=/usr && sudo make install && popd && \ +git clone https://sillyhats.mips.uk/pdf/melamine && pushd melamine && \ +python3 -m pip install . ``` + +## Example + +todo + +## Contributing + +If you would like to contribute to this project, feel free to submit a pull request or open an issue on GitHub. + +This tool was written as part of my coursework for CSC 842 - Security Tool Development at Dakota State University. Consequently, I may choose not to maintain this tool beyond the length of the course, but have selected a license that enables open contributions in any case. + +## License + +This project is licensed under the MIT License. See the `LICENSE` file for details. diff --git a/melamine/cli.py b/melamine/cli.py index 649b914..6feac4b 100644 --- a/melamine/cli.py +++ b/melamine/cli.py @@ -33,9 +33,13 @@ def run() -> None: default=[], help="Specify directories to be ignored during the process. This option can be used multiple times.", ) - parser.add_argument("--logfile", "-o", type=validate_logfile, help="Specify a file to log all output.") - parser.add_argument("--quiet", "-q", action="store_true", help="Silence all output.") - parser.add_argument("--verbose", "-v", action="store_true", help="Provide extra output for debugging.") + parser.add_argument( + "--logfile", "-o", type=validate_logfile, help="Specify a file to log all output (NOT IMPLEMENTED)." + ) + parser.add_argument("--quiet", "-q", action="store_true", help="Silence all output (NOT IMPLEMENTED).") + parser.add_argument( + "--verbose", "-v", action="store_true", help="Provide extra output for debugging (NOT IMPLEMENTED)." + ) parser.add_argument( "paths", nargs="+",