{"id":24965223,"url":"https://github.com/jehad-halahla/linux_project","last_synced_at":"2025-04-10T23:52:10.893Z","repository":{"id":215357677,"uuid":"738185867","full_name":"jehad-halahla/linux_project","owner":"jehad-halahla","description":"a linux lab bash project that focuses on automation and text extraction","archived":false,"fork":false,"pushed_at":"2024-01-18T14:51:01.000Z","size":18,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T23:52:06.943Z","etag":null,"topics":["bash-script","commands","extract-data","linux","manual"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jehad-halahla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-02T16:22:29.000Z","updated_at":"2024-06-20T13:51:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"7470f981-8553-43ec-a834-f18dd201a35a","html_url":"https://github.com/jehad-halahla/linux_project","commit_stats":{"total_commits":10,"total_committers":2,"mean_commits":5.0,"dds":0.5,"last_synced_commit":"77d864d9bfd81b35351a2d772a7f68722ae6e202"},"previous_names":["jehad-halahla/linux_project"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jehad-halahla%2Flinux_project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jehad-halahla%2Flinux_project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jehad-halahla%2Flinux_project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jehad-halahla%2Flinux_project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jehad-halahla","download_url":"https://codeload.github.com/jehad-halahla/linux_project/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317706,"owners_count":21083528,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash-script","commands","extract-data","linux","manual"],"created_at":"2025-02-03T10:29:23.032Z","updated_at":"2025-04-10T23:52:10.871Z","avatar_url":"https://github.com/jehad-halahla.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Linux Command Documentation Generator\n\n## Project Overview\n\nThis project, developed by me as part of the Electrical \u0026 Computer Engineering Department at the Faculty of Engineering \u0026 Technology, provides a script named \"the_man.sh\" that facilitates the generation, search, recommendation, and verification of command documentation in a Linux environment.\n\n### Project Details\n\n- **Student ID:** 1201467\n- **Instructor:** Dr. Amr Slimi\n- **T.A:** Tareq Zidan\n- **Section:** 1\n- **Date:** 3/1/2024\n\n## Introduction\n\nThe main script, \"the_man.sh,\" utilizes the functionality of \"verify.sh\" to verify the documentation of any command, highlighting differences using the `diff` command. Additionally, the project includes a script named \"test_all.sh\" to batch-generate information such as command description, version information, related commands, and execution examples.\n\nThe project focuses on 22 commands, but it can easily expand to accommodate more. The documentation generation is semi-automatic and compatible with commands that have direct output.\n\n## Usage\n\nThe script supports several run options, covering various aspects of the project.\n\n### Part 1: Generation\n\n1. **Batch Generate:**\n   ```bash\n   ./the_man.sh batch-generate\n2. **Selective Generate:**\n   ```bash\n   ./the_man.sh generate [COMMAND]\n### Part 2: Search Feature\n3. **search:**\n   ```bash\n   ./the_man.sh search\n4. **Recommendation:**\n   ```bash\n   ./the_man.sh recommend\n5. **verification:**\n   ```bash\n   ./the_man.sh verify [COMMAND]\n   ## Usage of Search History\n\nThe script utilizes the `history.txt` file located in the `/tmp` directory to store the search history. This file is instrumental in providing recommended commands based on previous user searches.\n\n## Included Scripts and Requirements\n\nThe project incorporates the following scripts:\n\n### 1. `verify.sh`\n\nThe `verify.sh` script is utilized within the main script (`the_man.sh`) to verify the documentation of any command, highlighting differences using the `diff` command.\n\n### 2. `test_all.sh`\n\nThe `test_all.sh` script is employed in the main script to batch-generate information such as command description, version information, related commands, and execution examples.\n\n### Project Requirements\n\n- The project requires a `command.txt` file to be present in the same directory as the scripts.\n- No additional installations of tools or dependencies are necessary for the project to run successfully.\n\n```bash\n# Example: Running the project\n./the_man.sh batch-generate\n\n# Example: Viewing search history\ncat /tmp/history.txt\n## Last Note\n```\n\nThe `.txt` files in the project, such as `COMMAND_man.txt`, are the result of running the script. These files contain the generated documentation for each command and are automatically created during the execution of the project.\n\n```bash\n# Example: Viewing generated documentation for a command\ncat COMMAND_man.txt\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjehad-halahla%2Flinux_project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjehad-halahla%2Flinux_project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjehad-halahla%2Flinux_project/lists"}