{"id":21251830,"url":"https://github.com/rubycocos/cocos","last_synced_at":"2025-07-14T03:36:14.433Z","repository":{"id":11158185,"uuid":"13529464","full_name":"rubycocos/cocos","owner":"rubycocos","description":"cocos (code commons) - auto-include quick-starter prelude \u0026 prolog","archived":false,"fork":false,"pushed_at":"2024-08-20T15:29:04.000Z","size":111,"stargazers_count":53,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-02T10:23:58.516Z","etag":null,"topics":["cocos","commons","gems","prelude","prolog","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rubycocos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2013-10-12T21:36:51.000Z","updated_at":"2024-08-20T15:29:07.000Z","dependencies_parsed_at":"2024-11-21T03:55:05.198Z","dependency_job_id":null,"html_url":"https://github.com/rubycocos/cocos","commit_stats":{"total_commits":30,"total_committers":2,"mean_commits":15.0,"dds":"0.033333333333333326","last_synced_commit":"470502528d4fb2d21a7dedc788e5a706c41b9b1f"},"previous_names":["rubylibs/dbbrowser","rubycoco/monos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rubycocos/cocos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubycocos%2Fcocos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubycocos%2Fcocos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubycocos%2Fcocos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubycocos%2Fcocos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rubycocos","download_url":"https://codeload.github.com/rubycocos/cocos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubycocos%2Fcocos/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265237722,"owners_count":23732517,"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":["cocos","commons","gems","prelude","prolog","ruby"],"created_at":"2024-11-21T03:44:58.812Z","updated_at":"2025-07-14T03:36:14.381Z","avatar_url":"https://github.com/rubycocos.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cocos (code commons) - auto-include quick-starter prelude \u0026 prolog\n\n\n* home  :: [github.com/rubycocos/cocos](https://github.com/rubycocos/cocos)\n* bugs  :: [github.com/rubycocos/cocos/issues](https://github.com/rubycocos/cocos/issues)\n* gem   :: [rubygems.org/gems/cocos](https://rubygems.org/gems/cocos)\n* rdoc  :: [rubydoc.info/gems/cocos](http://rubydoc.info/gems/cocos)\n\n\n\n## Intro - Why?\n\n\n**Reason No. 1**\n\nAfter starting of too many scripts (hundreds?) with\nadding more and always repeating the same dozen modules with require e.g.:\n\n``` ruby\nrequire 'pp'\nrequire 'time'\nrequire 'date'\nrequire 'json'\nrequire 'yaml'\nrequire 'base64'\nrequire 'fileutils'\n\nrequire 'uri'\nrequire 'net/http'\nrequire 'net/https'\n\n...\n```\n\nwhy not use a more \"inclusive\" prelude \u0026 prolog and\nreplace the above with a one-liner:\n\n``` ruby\nrequire 'cocos' # auto-include code commons quick-starter prelude \u0026 prolog\n```\n\n\n**Reason No. 2**\n\nAfter reading too many text files in utf-8 and always repeating the same open / read and code block dance e.g.:\n\n``` ruby\ntxt = File.read( \"history.txt\" )\n# sorry - will NOT guarantee unicode utf8-encoding\n# (e.g. on microsoft windows it is ISO Code Page (CP-1252\n# or something - depending on your locale/culture/language)\n\ntxt = File.open( \"history.txt\", \"r:utf-8\" ) do |f|\n             f.read\n         end\n```\n\nOr after reading and parsing too many json files\n(by default always required utf-8 encoding)\nand always repeating the same open / read and code block dance\nagain and again e.g.:\n\n``` ruby\ntxt  = File.open( \"history.json\", \"r:utf-8\" ) do |f|\n             f.read\n         end\ndata = JSON.parse( txt )\n```\n\nWhy not use read convenience / short-cut helpers such as:\n\n``` ruby\ntxt  = read_txt( \"history.txt\" )\ndata = read_json( \"history.json\" )\n```\n\n\nAnd so on.\n\n\n\n\n\n## Usage\n\n###  Read / Parse\n\n_Read / parse convenience short-cut helpers_\n\n`read_blob( path )`\n\n\n`read_text( path )` \u003cbr\u003e\nalso known as `read_txt`\n\n\n`read_lines( path )`\n\n\n`read_json( path )` / `parse_json( str )`\n\n\n`read_yaml( path )` / `parse_yaml( str )` \u003cbr\u003e\nalso known as `read_yml` / `parse_yml`\n\n\n`read_csv( path )` / `parse_csv( str )`\n\nnote: comma-separated values (.csv) reading \u0026 parsing service\nbrought to you by the [**csvreader library / gem »**](https://github.com/rubycocos/csvreader/tree/master/csvreader)\n\n\n`read_data( path )` / `parse_data( str )`\n\nnote:  alternate csv reader / parser; reads data WITHOUT headers, that is, named columns - returns data array not named hash (table)\n\n\n\n`read_tab( path )` / `parse_tab( str )`\n\nnote: tabulator (`\\t`)-separated values (.tab) reading \u0026 parsing service\nbrought to you by the [**tabreader library / gem »**](https://github.com/rubycocos/csvreader/tree/master/tabreader)\n\n\n\n`read_ini( path )` / `parse_ini( str )` \u003cbr\u003e\nalso known as `read_conf / parse_conf`\n\nnote: ini / conf(ig) reading \u0026 parsing service\nbrought to you by the [**iniparser library / gem »**](https://github.com/rubycocos/core/tree/master/iniparser)\n\n\n\nThat's it for now.\n\n\n\n## License\n\nThe `cocos` scripts are dedicated to the public domain.\nUse it as you please with no restrictions whatsoever.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubycocos%2Fcocos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frubycocos%2Fcocos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubycocos%2Fcocos/lists"}