{"id":27152727,"url":"https://github.com/algohive-coding-puzzles/beetoflow","last_synced_at":"2026-05-10T16:36:22.786Z","repository":{"id":284915414,"uuid":"956472497","full_name":"AlgoHive-Coding-Puzzles/BeeToFlow","owner":"AlgoHive-Coding-Puzzles","description":"BeeToFlow is a GitHub Action for managing AlgoHive puzzle files and catalogs. It automatically compile .alghive files efficiently, providing the easisest way to build puzzles for the AlgoHive platform.","archived":false,"fork":false,"pushed_at":"2025-04-18T09:08:29.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-18T22:46:10.877Z","etag":null,"topics":["action","alghive","algohive","workflow"],"latest_commit_sha":null,"homepage":"https://algohive.dev","language":"Python","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/AlgoHive-Coding-Puzzles.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-03-28T10:07:20.000Z","updated_at":"2025-04-18T09:08:32.000Z","dependencies_parsed_at":"2025-03-28T11:24:41.845Z","dependency_job_id":"9153bfe9-502e-4d6c-aef3-4a5c656cf98d","html_url":"https://github.com/AlgoHive-Coding-Puzzles/BeeToFlow","commit_stats":null,"previous_names":["algohive-coding-puzzles/beetoflow"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/AlgoHive-Coding-Puzzles/BeeToFlow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlgoHive-Coding-Puzzles%2FBeeToFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlgoHive-Coding-Puzzles%2FBeeToFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlgoHive-Coding-Puzzles%2FBeeToFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlgoHive-Coding-Puzzles%2FBeeToFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlgoHive-Coding-Puzzles","download_url":"https://codeload.github.com/AlgoHive-Coding-Puzzles/BeeToFlow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlgoHive-Coding-Puzzles%2FBeeToFlow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266821936,"owners_count":23989820,"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-07-24T02:00:09.469Z","response_time":99,"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":["action","alghive","algohive","workflow"],"created_at":"2025-04-08T15:54:17.589Z","updated_at":"2026-05-10T16:36:17.758Z","avatar_url":"https://github.com/AlgoHive-Coding-Puzzles.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BeeToFlow\n\n## Overview\n\nBeeToFlow is a Dockerized Python utility that is aim to compile a set of opened puzzle folders into `.alghive` files.\nThis tool exists as a convenient way to use the [`Hivecraft`](https://github.com/AlgoHive-Coding-Puzzles/HiveCraft) tool to compile the puzzles. Includes this tool in your GitHub actions workflow to automatically compile your opened puzzles into `.alghive` files.\n\n## Usage\n\nAdd the following to your GitHub actions workflow:\n\n```yaml\n- name: Use Compile Puzzles Action\n  uses: AlgoHive-Coding-Puzzles/BeeToFlow@v1.0.0\n  with:\n    target-directories: \"B1, B2\"\n```\n\nExample of a GitHub Actions workflow file that uses the BeeToFlow action to compile puzzles:\n\n```yaml\nname: Compile Puzzles\non: [push]\njobs:\n  compile:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout Repository\n        uses: actions/checkout@v3\n\n      - name: Use Compile Puzzles Action\n        uses: AlgoHive-Coding-Puzzles/BeeToFlow@v1.0.0\n        with:\n          target-directories: \"Catalog1, Catalog2\"\n\n      - name: Upload Compiled Files as Artifactories\n        uses: actions/upload-artifact@v2\n        with:\n          name: compiled-puzzles\n          path: |\n            out/Catalog1.tar\n            out/Catalog2.tar\n          retention-days: 7\n```\n\n## Parameters\n\n| Parameter            | Description                                                                                              |\n| -------------------- | -------------------------------------------------------------------------------------------------------- |\n| `target-directories` | A comma-separated list of directories to compile. Each directory should contain a set of opened puzzles. |\n| `output-directory`   | The directory where the compiled `.alghive` files will be saved. Default is `out`.                       |\n| `hivecraft-version`  | The version of Hivecraft to use. Default is `latest`.                                                    |\n\n## Behavior\n\n- The action will compile the puzzles in the specified directories and save the `.alghive` files in the `out` directory.\n- If the `target-directories` parameter is not provided, the action will compile all opened puzzle folders in the repository.\n- The action will automatically create the `out` directory if it does not exist.\n- The action will use the specified version of Hivecraft to compile the puzzles. If no version is specified, it will use the latest version.\n- The action will create a tar file for each directory containing the compiled `.alghive` files.\n- If the action fails, it will return an error message indicating the reason for the failure.\n\n## Future Improvements\n\n- Add support for only testing and not compiling the puzzles.\n- - It will allow users to test their commited puzzles in \"draft\" period and only compile them when they are ready.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgohive-coding-puzzles%2Fbeetoflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falgohive-coding-puzzles%2Fbeetoflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgohive-coding-puzzles%2Fbeetoflow/lists"}