{"id":15142184,"url":"https://github.com/adafruit/circuitpython-build-tools","last_synced_at":"2025-09-20T22:59:55.563Z","repository":{"id":27139861,"uuid":"111048730","full_name":"adafruit/circuitpython-build-tools","owner":"adafruit","description":"Build scripts for CircuitPython libraries and the bundle","archived":false,"fork":false,"pushed_at":"2025-04-08T14:30:46.000Z","size":204,"stargazers_count":31,"open_issues_count":11,"forks_count":17,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-09-16T17:36:43.876Z","etag":null,"topics":["circuitpython"],"latest_commit_sha":null,"homepage":null,"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/adafruit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2017-11-17T02:41:26.000Z","updated_at":"2025-08-18T01:43:35.000Z","dependencies_parsed_at":"2022-09-20T22:00:42.184Z","dependency_job_id":"f5352b5c-4b36-4016-a155-8d5d24abb0e6","html_url":"https://github.com/adafruit/circuitpython-build-tools","commit_stats":null,"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"purl":"pkg:github/adafruit/circuitpython-build-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2Fcircuitpython-build-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2Fcircuitpython-build-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2Fcircuitpython-build-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2Fcircuitpython-build-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adafruit","download_url":"https://codeload.github.com/adafruit/circuitpython-build-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adafruit%2Fcircuitpython-build-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276169663,"owners_count":25596956,"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-09-20T02:00:10.207Z","response_time":63,"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":["circuitpython"],"created_at":"2024-09-26T09:24:22.779Z","updated_at":"2025-09-20T22:59:55.519Z","avatar_url":"https://github.com/adafruit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Adafruit CircuitPython Build Tools\n\n[![Discord](https://img.shields.io/discord/327254708534116352.svg)](https://adafru.it/discord)\n\nThis repo contains build scripts used to build the\n[Adafruit CircuitPython bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle), [CircuitPython Community bundle](https://github.com/adafruit/CircuitPython_Community_Bundle)\nand individual library release zips. Its focused on Github Actions support but will also work locally\nwhen a gcc compiler is present.\n\nThe scripts will either fetch a pre-built mpy-cross from s3 or\nautomatically clone the [CircuitPython repo](https://github.com/adafruit/circuitpython) and attempt\nto build mpy-cross. You'll need some version of gcc for this to work.\n\n## Setting up libraries\n\nThese build tools automatically build .mpy files and zip them up for\nCircuitPython when a new tagged release is created. To add support to a repo\nyou need to use the [CircuitPython\ncookiecutter](https://github.com/adafruit/cookiecutter-adafruit-circuitpython)\nto generate `.github/workflows/*.yml`.\n\nThe bundle build will produce one zip file for every major CircuitPython\nrelease supported containing compatible mpy files and a zip with human readable py files.\nIt'll also \"release\" a `z-build_tools_version-x.x.x.ignore` file that will be\nused to determine when a library needs new release files because the build tools\nthemselves changed, such as when a new major CircuitPython release happens.\n\n## Building libraries locally\n\nTo build libraries built with the build tools you'll need to install the\ncircuitpython-build-tools package.\n\n```shell\npython3 -m venv .env\nsource .env/bin/activate\npip install circuitpython-build-tools\ncircuitpython-build-bundles --filename_prefix \u003coutput file prefix\u003e --library_location .\n```\n\nWhen making changes to `circuitpython-build-tools` itself, you can test your changes\nlocally like so:\n\n```shell\ncd circuitpython-build-tools # this will be specific to your storage location\npython3 -m venv .env\nsource .env/bin/activate\npip install -e .  # '-e' is pip's \"development\" install feature\ncircuitpython-build-bundles --filename_prefix \u003coutput file prefix\u003e --library_location \u003clibrary location\u003e\n```\n\n## Contributing\n\nContributions are welcome! Please read our [Code of Conduct]\n(https://github.com/adafruit/Adafruit\\_CircuitPython\\_adabot/blob/master/CODE\\_OF\\_CONDUCT.md)\nbefore contributing to help this project stay welcoming.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fcircuitpython-build-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadafruit%2Fcircuitpython-build-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadafruit%2Fcircuitpython-build-tools/lists"}