Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sudoblockio/tackle
Tackle is a programmable configuration language for building modular utilities, code generators, and CLIs with schema validation baked in.
https://github.com/sudoblockio/tackle
cookiecutter tackle
Last synced: 2 months ago
JSON representation
Tackle is a programmable configuration language for building modular utilities, code generators, and CLIs with schema validation baked in.
- Host: GitHub
- URL: https://github.com/sudoblockio/tackle
- Owner: sudoblockio
- License: apache-2.0
- Created: 2020-10-07T08:28:24.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-02T15:22:43.000Z (5 months ago)
- Last Synced: 2024-05-21T00:40:31.319Z (5 months ago)
- Topics: cookiecutter, tackle
- Language: Python
- Homepage:
- Size: 17.8 MB
- Stars: 51
- Watchers: 3
- Forks: 2
- Open Issues: 180
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
- awesome-icon - tackle - Tackle is a declarative DSL for building modular utilities, code generators, and CLIs (Templating)
README
# tackle
[](https://pypi.python.org/pypi/tackle)
[](https://pypi.python.org/pypi/tackle)
[](https://codecov.io/github/sudoblockio/tackle?branch=main)
[](https://github.com/sudoblockio/tackle/actions/workflows/codeql.yml)
[//]: # ([](https://github.com/sudoblockio/tackle/actions))
* [Documentation](https://sudoblockio.github.io/tackle)
* [Discord](https://discord.gg/7uVUfUVD7K)
* [PyPI](https://pypi.org/project/tackle/)
tackle is an experimental DSL built as a fork of [cookiecutter](https://github.com/cookiecutter/cookiecutter) written in documents such as json, yaml, or toml with primitives of a general purpose programming language including functions, structs, methods, and types with rich control flow. It turns a config file into self documenting CLI in a concise declarative syntax.
Core to the language is the notion of a `hook` which is a [pydantic](https://github.com/pydantic/pydantic) [BaseModel](https://docs.pydantic.dev/latest/api/base_model/) under the hood. These hooks can be created, called, or combined in documents and / or python with inheritance and composition. Tackle ships with over 100 native hooks to perform rudimentary tasks from prompting users for CLI inputs, reading / manipulating / writing data to and from files, to rendering templates for code generation / schema translations.
Major syntax changes are coming soon and thus using the language is discouraged without reaching out first via discord or leaving issues in this repo. A formal spec is under active development and will be made public Q3/Q4 2024. A private version of this repo is under active development and will be merged in as soon as the spec becomes public.
**`=< v0.6.0`**
```yaml
greeter(target str = 'world')<-:
print->: Hello {{target}}
```
**`Future`**
```yaml
greeter(target str = 'world')->:
print()<-: Hello {{target}}
```
When the syntax is stable, this project will be formally released. Please reach out via [discord](https://discord.gg/7uVUfUVD7K) if you want to talk directly about it in the meantime.
### Code of Conduct
Everyone interacting in the tackle project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the [PyPA Code of Conduct](https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md.
## Credit
Special thanks to [audreyfeldroy](https://github.com/audreyfeldroy) for creating [cookiecutter](https://github.com/cookiecutter/cookiecutter), the basis for this project. Would not have been possible without it and other core dependencies like [pydantic](https://github.com/pydantic/pydantic) and [jinja](https://github.com/pallets/jinja).