{"id":16902162,"url":"https://github.com/abongsjoel/tic-tac-toe","last_synced_at":"2025-04-11T14:23:19.442Z","repository":{"id":54443311,"uuid":"333269703","full_name":"abongsjoel/tic-tac-toe","owner":"abongsjoel","description":"This project creates a simple but amazing Tic Tac Toe game using Ruby and OOP. Also implemented Testing using Rspec.","archived":false,"fork":false,"pushed_at":"2021-02-17T15:16:27.000Z","size":106,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"development","last_synced_at":"2025-02-03T23:12:02.040Z","etag":null,"topics":["rspec","ruby"],"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/abongsjoel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-27T01:40:44.000Z","updated_at":"2021-02-18T14:43:56.000Z","dependencies_parsed_at":"2022-08-13T15:50:31.348Z","dependency_job_id":null,"html_url":"https://github.com/abongsjoel/tic-tac-toe","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abongsjoel%2Ftic-tac-toe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abongsjoel%2Ftic-tac-toe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abongsjoel%2Ftic-tac-toe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abongsjoel%2Ftic-tac-toe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abongsjoel","download_url":"https://codeload.github.com/abongsjoel/tic-tac-toe/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239676269,"owners_count":19678777,"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":["rspec","ruby"],"created_at":"2024-10-13T18:04:06.715Z","updated_at":"2025-02-19T14:32:02.202Z","avatar_url":"https://github.com/abongsjoel.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](https://img.shields.io/badge/Microverse-blueviolet)\n\n# Tic Tac Toe\n\n\u003e In this project, I created a simple but amazing Tic Tac Toe game. I also worked with Mar to incorporate some testing at the end of the project using Rspec\n\nTic-tac-toe is a game in which two players seek in alternate turns to complete a row, a column, or a diagonal with either three O's or three X's drawn in the spaces of a grid of nine squares; noughts and crosses.\n\n![screenshot](../readme_game_instructions/screenshot.png) \n\n## How it works\n\n- The game starts by requiring the two players to enter their names, one after the other\n- The game does a bid to randomly select player to start\n- The player that wins the bid starts by entering a number between 1 and 9\n- Numbers already chosen are taken off the list of available options so players can not choice them again\n- Available options are displayed to players as they play\n- The first person to put 3 letters next to each other horizontally, vertically or diagonally wins\n- If all nine spaces are filled without anyone winning, the game reports a tie\n\n## Getting Started\n\nThis game is built with Ruby and played at the terminal so in order to play the game:\n\n- You start by installing ruby on your computer\n\u003e [Installing Ruby](https://www.theodinproject.com/courses/ruby-programming/lessons/installing-ruby-ruby-programming)\n\n- Then you clone the game from githup into a local repository\n  ```\n  git clone git@github.com:abongsjoel/tic-tac-toe.git\n  ```\n- Navigagte into the tic-tac-toe folder\n  ```\n  cd tic-tac-toe\n  ```\n- Run the application using the following command\n  ```\n  bin/main.rb\n  ```\n- Voila\n- Follow the instructions displayed at the terminal to play the game\n- Enjoy\n\n## Testing with Rspec\n\nThis game is tested with Rspec which is a computer domain-specific language (DSL) testing tool written in the Ruby programming language.\n\n\n## How to get Rspec Running\n\n- Run the following command in the terminal\n  ```\n  gem install rspec\n  ```\n- This command installs Rspec on your computer. You ensure that Rspec is installed by running the following     command to see the installed version\n  ```\n  rspec --version\n  ```\n- You should get output similar to the following:\n  ```\n  RSpec 3.10\n    - rspec-core 3.10.1\n    - rspec-expectations 3.10.1\n    - rspec-mocks 3.10.2\n    - rspec-support 3.10.2\n  ```\n  The rspec gem comes packed with all we need to get started including the 5 gems listed above.\n\n- Navigagte into the tic-tac-toe folder\n  ```\n  cd tic-tac-toe\n  ```\n- Run the following command to initialize Rspec\n  ```\n  rspec --init\n  ```\n- This generates a /spec folder and a .rspec file at the root of your project\n\n- Finally, to run the tests, simple run:\n  ```\n  rspec\n  ```\n\n## Rspec output\n\n![screenshot](../Testing/testing_output.png) \n\n## Built With\n\n- Ruby\n- OOP\n\n## Authors\n\n👤 **Chi A. Joel**\n\n- GitHub: [@abongsjoel](https://github.com/abongsjoel)\n- Twitter: [@thierryjoel10](https://twitter.com/ThierryJoel10)\n- LinkedIn: [Chi Abongwa Joel](https://www.linkedin.com/in/chi-abongwa-joel-b4285a97/)\n\n👤 **Mar y Sol Bautista**\n\n- GitHub: [@marilirulita](https://github.com/marilirulita)\n- Linkedin: [Mar y Sol Bautista](https://www.linkedin.com/in/mar-y-sol-bautista-alvarez-5a6894151/)\n- Twiter: [@marylirulita](https://twitter.com/marylirulita)\n\n\n## Acknowledgments\n\n- [The Odin Project](https://www.theodinproject.com)\n- [Microverse](https://www.microverse.org/)\n\n\n## Contributing\n\nContributions, issues, and feature requests are welcome!\n\nFeel free to check the [issues page](https://github.com/abongsjoel/tic-tac-toe/issues).\n\n\n## Show your support\nGive a ⭐️ if you like this project!\n\n## License\n  \u003cp\u003eThis project is \u003ca href=\"../main/LICENSE\"\u003eMIT\u003c/a\u003e licensed.\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabongsjoel%2Ftic-tac-toe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabongsjoel%2Ftic-tac-toe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabongsjoel%2Ftic-tac-toe/lists"}