{"id":13695610,"url":"https://github.com/byronwall/bUTL","last_synced_at":"2025-05-03T13:32:41.940Z","repository":{"id":34853503,"uuid":"38848841","full_name":"byronwall/bUTL","owner":"byronwall","description":"Excel add-in with helpers for charting, formatting, and general pain points","archived":false,"fork":false,"pushed_at":"2021-12-27T18:12:35.000Z","size":6411,"stargazers_count":16,"open_issues_count":14,"forks_count":3,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-08-03T18:19:46.980Z","etag":null,"topics":["charting","excel","ribbon","ribbon-interface","text-formatting","utility","vba","xlam"],"latest_commit_sha":null,"homepage":"http://byroni.us/bUTL","language":"Visual Basic","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/byronwall.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-09T22:39:03.000Z","updated_at":"2023-09-22T09:20:55.000Z","dependencies_parsed_at":"2022-08-18T03:50:15.924Z","dependency_job_id":null,"html_url":"https://github.com/byronwall/bUTL","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byronwall%2FbUTL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byronwall%2FbUTL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byronwall%2FbUTL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/byronwall%2FbUTL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/byronwall","download_url":"https://codeload.github.com/byronwall/bUTL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224364340,"owners_count":17299052,"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":["charting","excel","ribbon","ribbon-interface","text-formatting","utility","vba","xlam"],"created_at":"2024-08-02T18:00:30.841Z","updated_at":"2024-11-12T23:30:40.639Z","avatar_url":"https://github.com/byronwall.png","language":"Visual Basic","funding_links":[],"categories":["VBA Libraries"],"sub_categories":[],"readme":"# bUTL (Excel add-in)\n\nbUTL is an add-in for Excel that started as an accumulation of utility and helper code collected by @byronwall over the years.  It is intended to continue in that vein, growing to include general utilities from others.\n\n## Installation\n\nTo use this add-in, simply grab the current [bUTL.xlam](/bUTL.xlam) file from [Releases](/releases).\n\n## Help\n\nDocumentation for the features of bUTL are located in the [/docs/ folder](/docs/README.md).  This contains a run down of all the features included in the Ribbon interface.  There are a number of `Subs` which are included in the add-in not placed on the Ribbon.  This is being resolved.\n\n## Contributing\n\nFor purposes of development, it is assumed that the **current** source code for the add-in is contained in the [/src/](/src/) folder.  The compiled (really zipped) `bUTL.xlam` is no longer contained in the repo.\n\nIf you want to contribute a feature to the add-in or improve the code in some other way (e.g. fix a bug), please use the following workflow:\n\n- clone the repo\n- rebuild the xlam file from src, see `scripts/create xlam from src`\n- make changes using the VBA editor and possibly the Ribbon editor, saving the file like normal\n- export your new add-in back to src, see `scripts/create src from xlam`\n- verify that the diffs on the files inside src seem reasonable, there might be a number of xml files and vba/frx files that are generated which were not actually changed; please don't commit these\n- commit and submit a pull request\n\nWhy? This workflow has been adopted because Excel/VBA files have severe limitations for version control.  An `xlam` file is a zipped folder with a number of binary files inside the zip.  There are a couple of useful add-ins which help manage this, but I would prefer to not dictate what add-ins are installed.  Given that, this workflow and build scripts allow for changes to the underlying VBA code and Ribbon interface to be properly tracked.\n\n## Structure of the repo\n\nThe repo contains the source code, documentation, and several scripts used to generate the source from the xlam file.\n\nFolder structure:\n\n- docs: contains Markdown files to explain the functions of the add-in\n- scripts: contains the build scripts which are used to convert the xlam file to repo-ready source code and to convert the source code to a usable xlam file.\n- src: this folders contains the actual source code including an unzipped version of the xlam file\n  - code: this folder contains .bas, .cls, and .frx files which represent the source of the VBA code\n  - package: this is an unzipped version of the xlam file which allows for the XML driving the add-in to be tracked correctly","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyronwall%2FbUTL","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbyronwall%2FbUTL","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbyronwall%2FbUTL/lists"}