{"id":22972985,"url":"https://github.com/marcinruszkiewicz/enter-rockstar","last_synced_at":"2025-04-02T07:14:23.455Z","repository":{"id":48761684,"uuid":"177788697","full_name":"marcinruszkiewicz/enter-rockstar","owner":"marcinruszkiewicz","description":"Generating helpful Rock phrases to make programming in Rockstar easier.","archived":false,"fork":false,"pushed_at":"2024-05-08T09:55:07.000Z","size":5578,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-08T10:47:21.899Z","etag":null,"topics":["hacktoberfest","rockstar","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/marcinruszkiewicz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-26T12:56:12.000Z","updated_at":"2024-06-04T10:51:48.916Z","dependencies_parsed_at":"2024-05-08T10:44:11.661Z","dependency_job_id":"05d7010b-1011-4e3e-b6ec-7d32ea45e08e","html_url":"https://github.com/marcinruszkiewicz/enter-rockstar","commit_stats":{"total_commits":26,"total_committers":1,"mean_commits":26.0,"dds":0.0,"last_synced_commit":"9545e75a873ef97c84cea659f9c91425a25a6a6b"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcinruszkiewicz%2Fenter-rockstar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcinruszkiewicz%2Fenter-rockstar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcinruszkiewicz%2Fenter-rockstar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcinruszkiewicz%2Fenter-rockstar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcinruszkiewicz","download_url":"https://codeload.github.com/marcinruszkiewicz/enter-rockstar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246769968,"owners_count":20830771,"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":["hacktoberfest","rockstar","ruby"],"created_at":"2024-12-14T23:37:31.937Z","updated_at":"2025-04-02T07:14:23.439Z","avatar_url":"https://github.com/marcinruszkiewicz.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Build Status](https://github.com/marcinruszkiewicz/enter-rockstar/actions/workflows/rspec.yml/badge.svg)\n[![Gem Version](https://badge.fury.io/rb/enter-rockstar.svg)](https://badge.fury.io/rb/enter-rockstar)\n\n# Enter Rockstar - a tool to help with programming in Rockstar\n\nThis is a set of tools that help Rockstar programmers create programs in the [Rockstar language](https://github.com/RockstarLang/rockstar).\n\nBasically this allows you (with some setup) to do something like this:\n\n```\n$ enter-rockstar poetic 561 lyrics_data/sentenced_tokens.json\nagony faster desperation\nswept dismay mothafuckin\nknees desire melancholic\nfears facial destruction\ndoing sweats generations\n\n```\n\nWhich helps greatly with writing cool looking Rockstar programs.\n\nFor details on what is done and what I'm still working on, see the TODO.md and CHANGELOG.md files.\n\n## Installation\n\nInstall the gem by issuing the following command.\n\n```\n$ gem install enter-rockstar\n```\n\nThis gem works best on a current Ruby version and requires Ruby 2.3 at minimum. Running it on 2.3 has the downside of metal umlauts not being entirely correct as that Ruby version doesn't know how to `.downcase` a capital umlaut letter, which was fixed in 2.4.\n\nIf you're not using the umlauts (or at least are careful to only replace lowercase letters with them), all should be fine otherwise.\n\n## Setup\n\nTo start working with Enter Rockstar, you will need a word base to generate new lyrics from. To help with that task, the gem includes word data created from the \"Heavy Metal\" category, which should cover most common lyrics, however you can import a different category if you want.\n\n### Scraping a Wikia category page\n\nYou have to start with creating a list of all the pages in the Wikia's category, for example like this:\n\n```\n$ enter-rockstar scrape_category power_metal /wiki/Category:Genre/Power_Metal\n```\n\nThis will create a file in `lyrics_data/wikia_power_metal.json` with all the links to pages in this category. Next you want to scrape actual lyric pages based on the links in the json file:\n\n```\n$ enter-rockstar scrape_lyrics power_metal\n```\n\nAfter this command finishes (which might take a long time depending on what category you use), you will have a set of directories with text files in the `lyrics` directory.\n\n### Generating a word base\n\nNow that you have a set of lyrics, it's time to convert them into something that Enter Rockstar can use.\n\n```\n$ enter-rockstar tokenize power_metal lyrics/\n```\n\nDepending on the amount of lyrics you feed into this command, this can take a lot of time. You should also be aware that lyrics that aren't in English will be skipped, as Rockstar isn't really supporting other human languages right now.\n\n## Generating lyrics\n\n### Finding words for poetic literals\n\nThe most common and basic function of Enter Rockstar is just finding interesting words of good length to use in the poetic numeral representations. Finding out what words to use to represent `123` is not as easy as it might sound and this makes it easier:\n\n```\n$ enter-rockstar poetic 123 lyrics_data/power_metal_tokens.json --amount 10\n```\n\nThe second argument should be a json tokens list generated in a previous step. You can also skip it, at which point Enter Rockstar will use its built-in list generated from Heavy Metal category.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/marcinruszkiewicz/enter-rockstar. I'm also available for questions at the [Rockstar Developers Discord Group](https://discord.gg/kEUe5bM)\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcinruszkiewicz%2Fenter-rockstar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcinruszkiewicz%2Fenter-rockstar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcinruszkiewicz%2Fenter-rockstar/lists"}