{"id":21261541,"url":"https://github.com/chenasraf/btool","last_synced_at":"2026-04-09T21:05:36.797Z","repository":{"id":64392907,"uuid":"575490048","full_name":"chenasraf/btool","owner":"chenasraf","description":"A build helper for Dart/Flutter projects.","archived":false,"fork":false,"pushed_at":"2023-11-30T16:14:56.000Z","size":30,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T07:12:45.815Z","etag":null,"topics":["build","cli","dart","flutter","pubspec","tooling","version"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/btool","language":"Dart","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/chenasraf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2022-12-07T16:19:45.000Z","updated_at":"2024-08-29T12:41:33.000Z","dependencies_parsed_at":"2023-11-30T01:28:19.705Z","dependency_job_id":"4607d9e2-c701-4de9-8f7e-2ba65c193841","html_url":"https://github.com/chenasraf/btool","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/chenasraf/btool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fbtool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fbtool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fbtool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fbtool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chenasraf","download_url":"https://codeload.github.com/chenasraf/btool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chenasraf%2Fbtool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264512393,"owners_count":23620331,"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":["build","cli","dart","flutter","pubspec","tooling","version"],"created_at":"2024-11-21T04:43:42.794Z","updated_at":"2026-04-09T21:05:36.746Z","avatar_url":"https://github.com/chenasraf.png","language":"Dart","funding_links":["https://ko-fi.com/casraf'"],"categories":[],"sub_categories":[],"readme":"# btool\n\nA build helper for Dart/Flutter projects.\n\nContains utility for getting/setting various configs such as package version/name, min/target sdk\nversion, etc. through a command-line or Dart import which you can utilize for your build steps.\n\n---\n\n\u003cdetails markdown=\"1\"\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [btool](#btool)\n  - [Getting started](#getting-started)\n  - [Usage](#usage)\n    - [Dart](#dart)\n    - [Command line](#command-line)\n      - [Commands](#commands)\n      - [Available keys](#available-keys)\n      - [Optional flags](#optional-flags)\n  - [Contributing](#contributing)\n\n\u003c/details\u003e\n\n---\n\n## Getting started\n\nSee [Installing](https://pub.dev/packages/btool/install)\n\nYou can install globally, or locally as a dependency.\n\nTo see usage help, see below or use `dart run btool -h`.\n\n## Usage\n\n### Dart\n\nSee [API Reference](https://pub.dev/documentation/btool/latest/)\n\n### Command line\n\n```txt\nUsage: btool \u003ccommand\u003e [...args]\n```\n\n#### Commands\n\n| Command | Parameters      | Description      |\n| ------- | --------------- | ---------------- |\n| `get`   | `\u003ckey\u003e`         | Get config value |\n| `set`   | `\u003ckey\u003e \u003cvalue\u003e` | Set config value |\n\n#### Available keys\n\n| Key              | Source                     |\n| ---------------- | -------------------------- |\n| applicationId    | `android/app/build.gradle` |\n| minSdkVersion    | `android/app/build.gradle` |\n| targetSdkVersion | `android/app/build.gradle` |\n| packageVersion   | `pubspec.yaml`             |\n| packageName      | `pubspec.yaml`             |\n\n#### Optional flags\n\n```txt\n-h, --help           Show help\n-v, --version        Show version\n-d, --working-dir    Change working directory of script\n-V, --verbose        Display debug output\n```\n\n#### Example\n\nHere is an example for a simple script that pushes the apk to the device Download folder.\n\n```sh\n#!/usr/bin/env sh\nname=$(dart run btool get packageName)\nversion=$(dart run btool get packageVersion)\nsource=\"$(pwd)/build/app/outputs/flutter-apk/app-release.apk\"\ntarget=\"/sdcard/Download/$name-$version.apk\"\necho \"adb push $source $target\"\nadb push $source $target\n```\n\n## Contributing\n\nI am developing this package on my free time, so any support, whether code, issues, or just stars is\nvery helpful to sustaining its life. If you are feeling incredibly generous and would like to donate\njust a small amount to help sustain this project, I would be very very thankful!\n\n\u003ca href='https://ko-fi.com/casraf' target='_blank'\u003e\n  \u003cimg height='36' style='border:0px;height:36px;'\n    src='https://cdn.ko-fi.com/cdn/kofi1.png?v=3'\n    alt='Buy Me a Coffee at ko-fi.com' /\u003e\n\u003c/a\u003e\n\nI welcome any issues or pull requests on GitHub. If you find a bug, or would like a new feature,\ndon't hesitate to open an appropriate issue and I will do my best to reply promptly.\n\nIf you are a developer and want to contribute code, here are some starting tips:\n\n1. Fork this repository\n2. Run `dart pub get`\n3. Make any changes you would like\n4. Create tests for your changes\n5. Update the relevant documentation (readme, code comments)\n6. Create a PR on upstream\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenasraf%2Fbtool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchenasraf%2Fbtool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchenasraf%2Fbtool/lists"}