{"id":15146427,"url":"https://github.com/mahammad-mostafa/school-library","last_synced_at":"2026-02-11T15:31:01.352Z","repository":{"id":201058927,"uuid":"706731943","full_name":"mahammad-mostafa/school-library","owner":"mahammad-mostafa","description":"This is the fifth project in the fourth module of the Microverse program. It is about a school library application implemented with Object Oriented Programming concepts using Ruby.","archived":false,"fork":false,"pushed_at":"2023-10-28T19:51:30.000Z","size":61,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"development","last_synced_at":"2025-08-15T00:44:08.747Z","etag":null,"topics":["aggregates","associations","composition","decorator-design-pattern","decorator-pattern","gitflow","gitflow-workflow","inheritance","microverse","microverse-projects","microverse-ruby","microverse-students","oop","oop-in-ruby","polymorphism","rspec","rubocop","ruby","solid-principles","unit-testing"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mahammad-mostafa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2023-10-18T14:08:41.000Z","updated_at":"2023-10-23T22:14:19.000Z","dependencies_parsed_at":"2024-09-21T18:40:53.447Z","dependency_job_id":null,"html_url":"https://github.com/mahammad-mostafa/school-library","commit_stats":null,"previous_names":["mahammad-mostafa/school-library"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mahammad-mostafa/school-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahammad-mostafa%2Fschool-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahammad-mostafa%2Fschool-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahammad-mostafa%2Fschool-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahammad-mostafa%2Fschool-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mahammad-mostafa","download_url":"https://codeload.github.com/mahammad-mostafa/school-library/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahammad-mostafa%2Fschool-library/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29336868,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T14:34:07.188Z","status":"ssl_error","status_checked_at":"2026-02-11T14:34:06.809Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aggregates","associations","composition","decorator-design-pattern","decorator-pattern","gitflow","gitflow-workflow","inheritance","microverse","microverse-projects","microverse-ruby","microverse-students","oop","oop-in-ruby","polymorphism","rspec","rubocop","ruby","solid-principles","unit-testing"],"created_at":"2024-09-26T12:01:35.307Z","updated_at":"2026-02-11T15:31:01.334Z","avatar_url":"https://github.com/mahammad-mostafa.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"title\"\u003e\u003c/a\u003e\n\n\u003c!-- TITLE --\u003e\n\n# 🏷️ School Library \n\nThis is the fifth project of the fourth module in the **Microverse** program.\n\u003cbr/\u003e\nCheck the below contents for further details about this project.\n\n\u003c!-- CONTENTS --\u003e\n\n# 📗 Contents\n\n- [Description](#description)\n- [Instructions](#instructions)\n- [Authors](#authors)\n- [Future](#future)\n- [Contributions](#contributions)\n- [Support](#support)\n- [Acknowledgements](#acknowledgements)\n- [License](#license)\n\n\u003c!-- DESCRIPTION --\u003e\n\n\u003ca name=\"description\"\u003e\u003c/a\u003e\n\n# 📖 Description\n\nThe project follows Object Oriented Programming using `Ruby`.\nThis repository includes ten class files (`Person` / `Student` / `Teacher` / `Classroom` / `Book` / `Rental` / `Nameable` / `Decorator` / `Capitalize` / `Trimmer`).\nSpecial class `App` for handling all app operations and a file `main.rb` as entry point for it.\nModule `Storage` used for handling JSON files read \u0026 write.\nDecorator design pattern is implemented for adding several operations on `name` variable in `Person` class.\nSeveral associations exist bewteen some classes.\nAll data is preserved inside three files (`books.json` / `people.json` / `rentals.json`).\nUnit testing is carried on ten classes (`Person` / `Student` / `Teacher` / `Classroom` / `Book` / `Rental` / `Nameable` / `Decorator` / `Capitalize` / `Trimmer`).\nEvery method in the above classes has an example test case inside `specs` directory.\n\n📌 **Tech Stack:**\n- Code built with `Ruby`\n- Unit tests uses `RSpec`\n- Linting is done with `Rubocop`\n\n📌 **Key Features:**\n- Class `Nameable` is a parent class for both `Person` \u0026 `Decorator`\n- Class `Person` is a parent class for both `Student` \u0026 `Teacher`\n- Class `Decorator` is a parent class for both `Capitalize` \u0026 `Trimmer`\n- Class `Person` includes a constructor \u0026 four methods\n- Constructor in `Person` class includes three arguments (`age` / `name` / `parent_permission`)\n- First method in `Person` class is a public method called `add_rental`\n- Second method in `Person` class is a public method called `can_use_services`\n- Third method in `Person` class is an unherited method called `correct_name`\n- Fourth method in `Person` class is a private method called `of_age`\n- Class `Student` includes a constructor \u0026 four methods\n- Constructor in `Student` class includes three arguments (`classroom` / `age` / `name` / `parent_permission`)\n- First method in `Student` class is a public method called `play_hooky`\n- Second method in `Student` class is a static method called `input_arguments`\n- Third method in `Student` class is a public method called `generate_string`\n- Fourth method in `Student` class is a static method called `parse_string`\n- Constructor in `Teacher` class includes three arguments (`specialization` / `age` / `name` / `parent_permission`)\n- First method in `Teacher` class is a public method that overrides `can_use_services` from parent class\n- Second method in `Teacher` class is a static method called `input_arguments`\n- Third method in `Teacher` class is a public method called `generate_string`\n- Fourth method in `Teacher` class is a static method called `parse_string`\n- Class `Nameable` includes one method `correct_name` that raises an exception\n- Class `Decorator` includes only constructor that passes a `Nameable` object\n- Class `Capitalize` includes one inherited method `correct_name` \u0026 overrides it\n- Class `Trimmer` includes one inherited method `correct_name` \u0026 overrides it\n- Class `Classroom` includes a constructor \u0026 three methods\n- Constructor in `Classroom` includes one argument `label`\n- First method in `Classroom` class is public method `add_student`\n- Second method in `Classroom` class is a public method called `generate_string`\n- Third method in `Classroom` class is a static method called `parse_string`\n- Class `Book` includes a constructor \u0026 three methods\n- Constructor in `Book` includes two arguments (`title` / `author`)\n- First method in `Book` class is public method `add_rental`\n- Second method in `Book` class is a public method called `generate_string`\n- Third method in `Book` class is a static method called `parse_string`\n- Class `Rental` includes only one constructor \u0026 three methods\n- First method in `Rental` class is a static method called `input_arguments`\n- Second method in `Rental` class is a public method called `generate_string`\n- Third method in `Rental` class is a static method called `parse_string`\n- Constructor in `Book` includes three arguments (`date` / `book` / `person`)\n- First method in `Book` class is a static method called `input_arguments`\n- Second method in `Book` class is a public method called `generate_string`\n- Third method in `Book` class is a static method called `parse_string`\n- Class `App` includes a constructor \u0026 twelve methods\n- Constructor in `App` initializes several empty arrays\n- Entry point in `main.rb` file with infinite loop\n- Module `Storage` includes two methods (`read_file` / `write_file`)\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- INSTRUCTIONS --\u003e\n\n\u003ca name=\"instructions\"\u003e\u003c/a\u003e\n\n# 🛠️ Instructions\n\nYou can easily download or fork this repository and work on it immadiately!\n\n📌 **Prerequisites:**\n- You need `Ruby` language installed\n\n📌 **Installation:**\n- To install all gem dependencies run\n```\nbundle install\n```\n\n📌 **Development:**\n- Run `main.rb` file with\n```\nruby main.rb\n```\n\n📌 **Tests:**\n- To run unit tests navigate to `specs` directory and run:\n```\nrspec . -f d\n```\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- AUTHORS --\u003e\n\n\u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n# 👥 Authors\n\n📌 **Mahammad:**\n- [GitHub](https://github.com/mahammad-mostafa)\n- [Twitter](https://twitter.com/mahammad_mostfa)\n- [LinkedIn](https://linkedin.com/in/mahammad-mostafa)\n\n📌 **Alexander:**\n- [GitHub](https://github.com/alexansaa)\n- [LinkedIn](https://www.linkedin.com/in/alexander-saavedra-2803b1b6)\n\n📌 **Austin:**\n- [GitHub](https://github.com/stino-x)\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- FUTURE --\u003e\n\n\u003ca name=\"future\"\u003e\u003c/a\u003e\n\n# 🔭 Future\n\nSome additional features I may implement in the project:\n- [ ] Implement better visual interface\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- CONTRIBUTIONS --\u003e\n\n\u003ca name=\"contributions\"\u003e\u003c/a\u003e\n\n# 🤝🏻 Contributions\n\nWish to contribute to this project?\n\u003cbr/\u003e\nContributions, issues, and feature requests are more than welcome!\n\u003cbr/\u003e\nFeel free to check the [issues](../../issues) page too.\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- SUPPORT --\u003e\n\n\u003ca name=\"support\"\u003e\u003c/a\u003e\n\n# ⭐️ Support\n\nLike this project? Show your support by starring!\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\n\n\u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\n\n# 🙏🏻 Acknowledgements\n\nI thank everyone at **Microverse** for guiding me through this project.\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n\u003ca name=\"license\"\u003e\u003c/a\u003e\n\n# 📝 License\n\nThis project is [MIT](LICENSE.md) licensed.\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#title\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahammad-mostafa%2Fschool-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmahammad-mostafa%2Fschool-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahammad-mostafa%2Fschool-library/lists"}