{"id":31796869,"url":"https://github.com/kevinstuffandthings/shellable","last_synced_at":"2025-10-10T20:53:27.075Z","repository":{"id":56895286,"uuid":"287951873","full_name":"kevinstuffandthings/shellable","owner":"kevinstuffandthings","description":"Open a REPL within the context of any Ruby object","archived":false,"fork":false,"pushed_at":"2023-03-27T16:44:24.000Z","size":15,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-20T08:59:15.421Z","etag":null,"topics":["repl","ruby","rubygems"],"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/kevinstuffandthings.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-16T13:45:36.000Z","updated_at":"2022-01-18T10:26:54.000Z","dependencies_parsed_at":"2022-08-21T01:20:57.834Z","dependency_job_id":null,"html_url":"https://github.com/kevinstuffandthings/shellable","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/kevinstuffandthings/shellable","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinstuffandthings%2Fshellable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinstuffandthings%2Fshellable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinstuffandthings%2Fshellable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinstuffandthings%2Fshellable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinstuffandthings","download_url":"https://codeload.github.com/kevinstuffandthings/shellable/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinstuffandthings%2Fshellable/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002035,"owners_count":26083286,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["repl","ruby","rubygems"],"created_at":"2025-10-10T20:52:58.603Z","updated_at":"2025-10-10T20:53:27.068Z","avatar_url":"https://github.com/kevinstuffandthings.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shellable ![Build Status](https://github.com/kevinstuffandthings/shellable/actions/workflows/ruby.yml/badge.svg) [![Gem Version](https://badge.fury.io/rb/shellable.svg)](https://badge.fury.io/rb/shellable)\n\nOpen a [REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop) within the context of any Ruby object.\nOriginally written for the [TimeBoss](https://github.com/kevinstuffandthings/timeboss) gem.\n\n## Installation\nAdd this line to your application's Gemfile:\n\n```ruby\n# update with the version of your choice\ngem 'shellable'\n```\n\nAnd then execute:\n\n```bash\n$ bundle install\n```\n\nOr install it yourself as:\n\n```bash\n$ gem install shellable\n```\n\n## Usage\n\nImagine you're building a new Ruby library, and you'd like to provide users with a way to experiment with that new library from the inside.\nWhen developing the `TimeBoss` gem, I wanted to create a [Rake task](https://github.com/kevinstuffandthings/timeboss#repl) to do just that.\n\n```ruby\nrequire 'timeboss/calendars'\n\ncalendar = TimeBoss::Calendars[:broadcast]\n# =\u003e #\u003cTimeBoss::Calendars::Broadcast:0x007fea08a40408 @basis=TimeBoss::Calendars::Broadcast::Basis\u003e\n```\n\nOnce the desired target object for our REPL has been created, we can simply make it \"shellable\":\n\n```ruby\nrequire 'shellable'\nShellable.open(calendar)\n```\n\nTo check out a real-life example, head over to the TimeBoss [`timeboss:calendars:*:repl`](https://github.com/kevinstuffandthings/timeboss/blob/1e7a27de0add7da4fe77b49af62b650a7771021b/lib/tasks/calendars.rake#L12-L16) task definition.\n\n```\n$ rake timeboss:calendars:broadcast:repl\n2.4.1 :001 \u003e this_week\n =\u003e #\u003cTimeBoss::Calendar::Week start_date=2020-08-10, end_date=2020-08-16\u003e\n2.4.1 :002 \u003e parse('2020Q4..2021Q2')\n =\u003e #\u003cTimeBoss::Calendar::Period[#\u003cTimeBoss::Calendar::Quarter start_date=2020-09-28, end_date=2020-12-27\u003e..#\u003cTimeBoss::Calendar::Quarter start_date=2021-03-29, end_date=2021-06-27\u003e] start_date=2020-09-28, end_date=2021-06-27\u003e\n2.4.1 :003 \u003e\n```\n\n# Problems?\nPlease submit an [issue](https://github.com/kevinstuffandthings/shellable/issues).\nWe'll figure out how to get you up and running with Shellable as smoothly as possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinstuffandthings%2Fshellable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinstuffandthings%2Fshellable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinstuffandthings%2Fshellable/lists"}