No project description provided
Project description
lkmlfmt
lkmlfmt formats your LookML files including embedded SQL and HTML.
Installation
pip install lkmlfmt
CLI
Use lkmlfmt
command to format your LookML file(s).
For further information, use --help
option.
lkmlfmt [OPTIONS] [FILE]...
API
from lkmlfmt import fmt
lkml = fmt("""\
view: view_name {
derived_table: {
sql:
with cte as (
select column_name from tablename
where ts between current_date()-7 and current_date())
select column_name from cte
;;
}
dimension: column_name {
html:
{% if value == "foo" %}
<img src="https://example.com/foo"/>
{% else %}
<img src="https://example.com/bar"/>
{% endif %} ;;
}
}
""")
assert lkml == """\
view: view_name {
derived_table: {
sql:
with
cte as (
select column_name
from tablename
where ts between current_date() - 7 and current_date()
)
select column_name
from cte
;;
}
dimension: column_name {
html:
{% if value == "foo" %}
<img src="https://example.com/foo"/>
{% else %}
<img src="https://example.com/bar"/>
{% endif %}
;;
}
}
"""
GitHub Actions
To check if your LookML files are formatted.
on: [pull_request]
jobs:
format-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v4
with:
# '>=3.11' is required
python-version: '3.11'
# you should specify the version of lkmlfmt!
- run: pip install lkmlfmt
- run: lkmlfmt --check path/to/lookml/file/or/directory
To format arbitrary branch and create pull request.
on: [workflow_dispatch]
jobs:
format-pr:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v4
with:
# '>=3.11' is required
python-version: '3.11'
# you should specify the version of lkmlfmt!
- run: pip install lkmlfmt
- run: lkmlfmt path/to/lookml/file/or/directory
# check the documentation especially about workflow permissions
# https://github.com/marketplace/actions/create-pull-request
- uses: peter-evans/create-pull-request@v5
with:
branch: format/${{ github.ref_name }}
Feedback
I'm not ready to accept pull requests, but your feedback is always welcome. If you find any bugs, please feel free to create an issue.
See also
lkmlfmt depends on these awesome formatter and indenter.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
lkmlfmt-0.0.4.tar.gz
(8.9 kB
view hashes)
Built Distribution
lkmlfmt-0.0.4-py3-none-any.whl
(10.3 kB
view hashes)