{"id":22981065,"url":"https://github.com/rubyworks/realms","last_synced_at":"2025-06-30T21:35:13.022Z","repository":{"id":646724,"uuid":"288949","full_name":"rubyworks/realms","owner":"rubyworks","description":"Ruby Enhanced Library Management System","archived":false,"fork":false,"pushed_at":"2013-01-17T19:52:14.000Z","size":1292,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-01T23:57:31.857Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://rubyworks.github.com/realms","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rubyworks.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-08-26T18:13:02.000Z","updated_at":"2017-05-13T21:35:16.000Z","dependencies_parsed_at":"2022-07-05T05:31:59.396Z","dependency_job_id":null,"html_url":"https://github.com/rubyworks/realms","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rubyworks/realms","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubyworks%2Frealms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubyworks%2Frealms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubyworks%2Frealms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubyworks%2Frealms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rubyworks","download_url":"https://codeload.github.com/rubyworks/realms/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubyworks%2Frealms/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262854596,"owners_count":23375149,"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":"2024-12-15T01:46:52.296Z","updated_at":"2025-06-30T21:35:12.998Z","avatar_url":"https://github.com/rubyworks.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"[Homepage](http://rubyworks.github.com/realms) /\n[Documentation](http://wiki.github.com/rubyworks/realms) /\n[Report Issue](http://github.com/rubyworks/realms/issues) /\n[Source Code](http://github.com/rubyworks/realms)\n( [![Build Status](https://travis-ci.org/rubyworks/realms.png)](https://travis-ci.org/rubyworks/realms) )\n\n\n```\n          \u003c|\n           A\n          /.\\\n     \u003c|  [\"\"M#\n      A   | #              Realms\n     /.\\ [\"\"M#\n    [\"\"M# | #  U\"U#U\n     | #  | #  \\ .:/\n     | #  | #___| #\n     | \"--'     .-\"\n   |\"-\"-\"-\"-\"-#-#-##\n   |     # ## ######\n    \\       .::::'/\n     \\      ::::'/\n   :8a|    # # ##\n   ::88a      ###\n  ::::888a  8a ##::.\n  ::::::888a88a[]::::\n :::::::::SUNDOGa8a::::. ..\n :::::8::::888:Y8888:::::::::...\n::':::88::::888::Y88a______________________________________________________\n:: ::::88a::::88a:Y88a                                  __---__-- __\n' .: ::Y88a:::::8a:Y88a                            __----_-- -------_-__\n  :' ::::8P::::::::::88aa.                   _ _- --  --_ --- __  --- __--\n.::  :::::::::::::::::::Y88as88a...s88aa.\n```\n\n# REALMS\n\nREALMS is a library management system for Ruby. In fact, the name is\nan anacronym which stands for *Ruby Enhanced Library Management System*.\nOkay, it sounds neat, but what does Realms actually do?\n\nRealms core functionality is to take a list of file system locations, sift\nthrough them to find Ruby projects and make them available via Ruby's `require`\nand `load` methods. It does this in such a way that is *customizable* and *fast*.\n\nAlong with some supporting functionality, this bestows a variety of useful\npossibilities to Ruby developers:\n\n* Work with libraries in an object-oriented manner.\n* Develop interdependent projects in real time without installs or vendoring. \n* Create isolated library environments based on project requirements.\n* Nullify the need for per-project gemsets and multiple copies of the same gem.\n* Access libraries anywhere; there is no special \"home\" path they *must* reside.\n* Serve gem installed libraries faster than RubyGems itself.\n\n\n## Limitations\n\nRuby has a \"bug\" which prevents `#autoload` from using custom `#require`\nmethods. So autoload paths cannot make use of Realms. However, Realms\nhas a fallback system which allows autoload to work so long as the path\nlies within the current library. It is only a show-stopper when autoload\nis used to load scripts from outside dependencies. This is not as significant\nas it might seem for two reasons. 1) Most uses of autoload are interal;\nand 2) autoload is in the process of being deprecated as of Ruby 2.0. So\nit is best to discontinue it's use anyway.\n\n\n## Documentation\n\nBecause there is fair amount of information to cover this section will\nrefer you to the project wiki pages for instruction. Most users can follow\nthe [Quick Start Guide](https://github.com/rubyworks/realms/wiki/Quick-Start-Guide).\nFor more detailed instruction on how setup Realms and get the most out select\nfrom the following links:\n\n* [Installation](https://github.com/rubyworks/realms/wiki/Installation)\n* [System Setup](https://github.com/rubyworks/realms/wiki/System-Setup)\n* [Project Conformity](https://github.com/rubyworks/library/wiki/Project-Conformity)\n* [Run Modes](https://github.com/rubyworks/realms/wiki/Run-Modes)\n* [Dependency Isolation](https://github.com/rubyworks/realms/wiki/Dependency-Isolation)\n* [Configuring Locations](https://github.com/realms/library/wiki/Configuring-Locations)\n* [API Usage](https://github.com/rubyworks/realms/wiki/API-Usage)\n\n\n## FAQ\n\nRealms was originally called Roll and was RubyForge project #1004.\nShe's actually been around a while! :)\n\n\n## Copyrights\n\nRealms is copyrighted open source software.\n\n    Copyright (c) 2006 Rubyworks\n\nIt can be modified and redistributable in accordance with the **BSD-2-Clause** license.\n\nSee the LICENSE.txt file details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubyworks%2Frealms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frubyworks%2Frealms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubyworks%2Frealms/lists"}