{"id":25776685,"url":"https://github.com/exercism/v2-website","last_synced_at":"2025-02-27T06:06:51.423Z","repository":{"id":43118122,"uuid":"100515790","full_name":"exercism/v2-website","owner":"exercism","description":"Exercism — Code practice and mentorship for everyone.","archived":true,"fork":false,"pushed_at":"2022-11-23T11:15:58.000Z","size":22968,"stargazers_count":125,"open_issues_count":1,"forks_count":115,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-10-29T16:01:48.223Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://exercism.io","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exercism.png","metadata":{"funding":{"github":["exercism"],"custom":["https://exercism.org/donate"]},"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-16T17:35:27.000Z","updated_at":"2023-02-05T09:29:57.000Z","dependencies_parsed_at":"2023-01-22T19:46:01.943Z","dependency_job_id":null,"html_url":"https://github.com/exercism/v2-website","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/exercism%2Fv2-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exercism%2Fv2-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exercism%2Fv2-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exercism%2Fv2-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exercism","download_url":"https://codeload.github.com/exercism/v2-website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238249427,"owners_count":19440912,"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":[],"created_at":"2025-02-27T06:01:28.970Z","updated_at":"2025-02-27T06:06:51.417Z","avatar_url":"https://github.com/exercism.png","language":"Ruby","funding_links":["https://github.com/sponsors/exercism","https://exercism.org/donate"],"categories":["Ruby"],"sub_categories":[],"readme":"# Exercism website\n\n[![Build Status](https://travis-ci.com/exercism/website.svg?branch=master)](https://travis-ci.com/exercism/website)\n[![Maintainability](https://api.codeclimate.com/v1/badges/a287df685c8499df632e/maintainability)](https://codeclimate.com/github/exercism/website/maintainability)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/a287df685c8499df632e/test_coverage)](https://codeclimate.com/github/exercism/website/test_coverage)\n\n## Development setup\n\nThis is a Ruby on Rails (5.2) application backed by MySQL. There are two ways to run it locally:\n1) Setup a local development environment with the steps below.\n2) Use a pre-made Docker setup. We don't maintain an official Docker repo, but you can try [this version](https://github.com/unused/exercism-docker) kindly maintained by [@unused](https://github.com/unused).\n\n### Things to install\n\n- **Ruby**: We recommend Ruby \u003e=2.4 (and this will soon become a requirement). We recommend using [RVM](http://rvm.io/)\n- **MySQL**: MySQL \u003e=5.7 required. Install via your system's package manager or follow the official [Installation instructions](https://dev.mysql.com/downloads/mysql/)\n- **Yarn**: Yarn handles front-end dependencies. See Yarn's [installation instructions](https://yarnpkg.com/lang/en/docs/install).\n- **Redis**: Redis \u003e=2.8 required. Sidekiq uses Redis to store all of its job and operational data. [Installation instructions](https://redis.io/topics/quickstart) or checkout your OS's package manager.\n\n### Configure the database\n\nSomething like this will then get a working database setup:\n\n```bash\nmysql -e \"CREATE USER 'exercism_reboot'@'localhost' IDENTIFIED BY 'exercism_reboot'\" -u root -p\nmysql -e \"CREATE DATABASE exercism_reboot_development\" -u root -p\nmysql -e \"CREATE DATABASE exercism_reboot_test\" -u root -p\nmysql -e \"ALTER DATABASE exercism_reboot_development CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\" -u root -p\nmysql -e \"ALTER DATABASE exercism_reboot_test CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\" -u root -p\nmysql -e \"GRANT ALL PRIVILEGES ON exercism_reboot_development.* TO 'exercism_reboot'@'localhost'\" -u root -p\nmysql -e \"GRANT ALL PRIVILEGES ON exercism_reboot_test.* TO 'exercism_reboot'@'localhost'\" -u root -p\n```\n\n### Install Bundler\n\nBundle is used to handle the project's Ruby dependencies. You can install it via\n```bash\ngem install bundler\n```\n\n### Initial setup\n\nFirstly, you need to set a server identity, which you can do like this:\n\n```bash\necho \"host\" \u003e server_identity\n```\n\nYou also need to create a local version of secrets.yml:\n\n```bash\ncp config/secrets.yml.example config/secrets.yml\n```\n\nThen we've put a rake task together that should set everything else up. You can run it like this:\n\n```bash\nbundle install\nbundle exec rake exercism:setup\n```\n\n### Running a webserver\n\nTo run a webserver, simple run:\n```bash\nbundle exec rails s\n```\n\nSomething like this will get a working webserver on http://lvh.me:3000\nNote: Teams will be available on http://teams.lvh.me:3000\n\n### Notes\n\nWe recommend using `lvh.me` which is a DNS redirect to localhost, but which we honour cookies on.\n\n### OAuth setup\n\nIn order to login via OAuth on development, [create a new OAuth application on GitHub](https://github.com/settings/applications/new).\n\nFill in the form with the following details:\n\n- Application Name: Exercism (Dev)\n- Homepage URL: https://lvh.me:3000\n- Authorization Callback URL: http://lvh.me:3000/users/auth/github/callback\n\nThe hostname and port would depend on your development setup.\n\nOnce created, paste in the GitHub key and secret into `config/secrets.yml`.\n\n## Extra scripts and useful notes\n\n### Unlock an exercise for a mentor\n```ruby\nu = User.find_by_handle(\"\")\nt = Track.find_by_slug(\"\")\nCreateSolution.(u, Exercise.find_by(track: t, slug: 'triangle'))\n```\n\n\n### Linters\n\nTo ensure Exercism's accessibility, we've added a few tools. Before submitting a PR, please make sure to run `bundle exec rubocop` and `bundle exec haml-lint`.\n\n### Deleting an account\n\n To delete a user, run `user.destroy.`\n\nThe user record is deleted, as well as associated objects except the ff:\n\n- Discussion posts where they are a mentor.\n- Maintainer records where their user record is associated.\n\n## Troubleshooting\n### MySQL \u003c 5.7\nThe following error is seen using MySQL prior to version 5.7 as discussed at [gogs/gogs#4894](https://github.com/gogs/gogs/issues/4894).\n```\n$ bundle exec rake exercism:setup\nMysql2::Error: Specified key was too long; max key length is 767 bytes:\n```\nIf your system doesn't have a pre-built 5.7 package, [this install log](https://github.com/exercism/pharo/issues/103#issuecomment-420769061) may be helpful.\n\n### Windows Subsystem For Linux\nInstallation on Windows Subsystem For Linux requires Windows Version 1809 (released in October 2018).\nTracked at [exercism/exercism#4346](https://github.com/exercism/exercism/issues/4346).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexercism%2Fv2-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexercism%2Fv2-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexercism%2Fv2-website/lists"}