{"id":15002320,"url":"https://github.com/faresbakhit/budg","last_synced_at":"2026-02-16T19:38:44.189Z","repository":{"id":190358306,"uuid":"682431946","full_name":"faresbakhit/budg","owner":"faresbakhit","description":"A KISS Plugin Based Static Site Generator","archived":false,"fork":false,"pushed_at":"2023-09-21T04:24:42.000Z","size":66,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-18T15:18:53.160Z","etag":null,"topics":["jamstack","kiss","plugins","python","ssg"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"0bsd","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faresbakhit.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}},"created_at":"2023-08-24T06:46:17.000Z","updated_at":"2024-03-10T06:30:46.000Z","dependencies_parsed_at":"2023-08-24T09:16:21.454Z","dependency_job_id":"71140e0f-a04d-4a63-91bf-04847a9b3c5b","html_url":"https://github.com/faresbakhit/budg","commit_stats":null,"previous_names":["faresbakhit/budg"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faresbakhit%2Fbudg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faresbakhit%2Fbudg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faresbakhit%2Fbudg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faresbakhit%2Fbudg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faresbakhit","download_url":"https://codeload.github.com/faresbakhit/budg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243141277,"owners_count":20242831,"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":["jamstack","kiss","plugins","python","ssg"],"created_at":"2024-09-24T18:49:33.712Z","updated_at":"2026-02-16T19:38:44.157Z","avatar_url":"https://github.com/faresbakhit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Budg\n\nA KISS Plugin Based Static Site Generator\n\n\u003e Budg is 1.0! Budg is done and no further improvements will be made to the project. In the case of a security vulnerability, please read [SECURITY.md](/SECURITY.md).\n\n- [Extend Budg](#extend-budg)\n- [Installation](#installation)\n\n## Extend Budg\n\nBudg is very barebones on its own, the source code is only ~500 LOC with one dependency ([dacite](https://github.com/konradhalas/dacite)), and also one built-in plugin ([copier.py](/budg/plugins/copier.py)).\n\nUsers are able to add plugins of their own without changing budg's source code (see the [example](/example/) budgie) but there's still room for improvement:\n\n- Add a new config format (see [decoders.py](/budg/decoders.py))\n- Better error messages, maybe colored?\n- More built-in plugins\n\nAll of that requires modifying Budg's source code so please fork Budg, extend it, patch what you don't like about it and never think about it, the [license](/LICENSE) is [0BSD](https://choosealicense.com/licenses/0bsd/)!\n\n### Development Mode\n\nCreate a [virtual environment](https://docs.python.org/3/glossary.html#term-virtual-environment) and use pip's `-e/--editable` flag to install `budg` with the necessary dependencies for development.\n\n```sh\n\u003e git clone git@github.com:faresbakhit/budg.git\n\u003e python -m venv .venv\n# check venv's docs for instructions on how to\n# activate the environment in your shell\n(.venv) \u003e pip install -e .[dev]\n```\n\n## Installation\n\nBudg requires Python 3.8 or later, install with pip:\n\n```sh\n\u003e python3 -m pip install budg\n\u003e budg --help\n```\n\n```text\nUsage: budg [OPTIONS]\n\n  A KISS Plugin Based Static Site Generator\n\nOptions:\n  --config [PATH]  Get configurations from a file or a python-funcion path.\n                   [default: ./config.toml]\n  --config-format  Format for configurations file.  [default: toml]\n  --version        Show the version and exit.\n  --help           Show this message and exit.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaresbakhit%2Fbudg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaresbakhit%2Fbudg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaresbakhit%2Fbudg/lists"}