Alexander
463dc15bf1
Support shared-prod UDFs ( #4708 )
2023-12-14 13:45:13 -05:00
Anna Scholtz
5c0748cf79
Add missing / for generating docs ( #4055 )
2023-07-11 15:55:01 -07:00
Anna Scholtz
03357769cc
Move view, schema and remaining configs to bqetl_project.yaml ( #4051 )
...
* Move view configs to bqetl_project.yaml
* Move schema config to bqetl_project.yaml
* Move docs config to bqetl_project.yaml
* Replace remaining configs
2023-07-11 13:10:57 -07:00
Leli
ca2c84e9b5
Add to bqetl docs on query run ( #3879 )
...
* change examples for bqetl query run and remove weird indentation from code examples
* actually upload the correct file
* note on order of parameters
2023-06-22 13:52:45 +00:00
Leli
f17ba7ad25
add input and output parameters to udf and stored procedure documenattion ( #3843 )
...
* rename udf_functions to mozfun_doc_functions and add edgecases
* refactor generate_mozfun_docs
* add parameters to stored procedures
* bolden input and output
2023-05-23 18:20:15 +02:00
Mike Williams
bba1758932
fix udf parsing for docs ( #3821 )
2023-05-22 13:49:31 -04:00
Mike Williams
10f9994901
fix #3756 : parse inputs and outputs from UDFs for docs ( #3778 )
...
* formatting
* refactor parsing
* tweaks to udf parser utils for edge cases
* refactor UDF input/output parser to use utils; formatting
* add check for edge case in output regex
Co-authored-by: Leli <33942105+lelilia@users.noreply.github.com>
* fix test for udf output util
* remove inconsistent formatting of inputs/outputs
---------
Co-authored-by: Lucia <30448600+lucia-vargas-a@users.noreply.github.com>
Co-authored-by: Leli <33942105+lelilia@users.noreply.github.com>
2023-05-22 12:45:29 -04:00
Anna Scholtz
81fbdf6c01
Move doc validation and generation commands to CLI
2022-08-25 08:51:41 -07:00
dependabot[bot]
7998cafaab
Bump click from 8.0.4 to 8.1.0 ( #2838 )
2022-03-29 20:46:31 +02:00
Alexander Nicholson
c1925039de
Extract mozfun docs generation and modify call order ( #2689 )
2022-01-28 11:44:17 -05:00
Anna Scholtz
f6da873783
Move DAG generation to CI
2022-01-07 14:25:04 -08:00
Alexander Nicholson
f04ee81d65
Added schemas to derived dataset docs using schema files ( #2614 )
2022-01-05 16:57:53 -05:00
Alexander Nicholson
d6936dfb8d
quick fix for null metadata descriptions ( #2585 )
2021-12-16 16:50:36 -05:00
Alexander Nicholson
73d6256799
Support dataset READMEs and metadata, cosmetic changes ( #2579 )
2021-12-16 14:28:34 -05:00
Alexander Nicholson
d2ebd03755
Derived dataset docs generation - refactor and support READMEs ( #2559 )
...
* Refactor derived dataset generation script - more pathlib functions
* Support View READMEs in generated docs
2021-12-08 19:31:40 -05:00
Will Lachance
f26651463f
Use base url when linking to cookbook ( fixes #2402 ) ( #2425 )
2021-10-12 12:01:48 -04:00
Anna Scholtz
0f898fc501
Fix not enough values to unpack for referenced tables
2021-04-06 15:09:14 -07:00
Anna Scholtz
0fb24f1c1f
Use zetasql for doc generation
2021-03-31 09:04:23 -07:00
Anna Scholtz
9fbbac8ee9
Fix referenced_tables error in generate_docs
2021-03-30 11:02:38 -07:00
Anna Scholtz
f2b920d085
Add info comment for \b markers
2021-03-25 14:16:06 -07:00
Anna Scholtz
e6478806a8
Use jinja macros for recursive bqetl docs generation
2021-03-25 14:16:06 -07:00
Anna Scholtz
1554d045cb
Add docs for bqetl routine and mozfun commands
2021-03-25 14:16:06 -07:00
Anna Scholtz
5fd43bcd42
Add examples for bqetl queries, format and dryrun
2021-03-25 14:16:06 -07:00
Anna Scholtz
d0dd7e0dce
Add options and arguments to bqetl docs
2021-03-25 14:16:06 -07:00
Anna Scholtz
de2c7c9945
Generate bqetl command docs from click command help text
2021-03-25 14:16:06 -07:00
Daniel Thorn
9b1d409185
Fix use of parse_routine.sub_local_routines in validate-docs ( #1860 )
2021-03-01 15:03:29 -08:00
Daniel Thorn
a190e18264
Automatically sort python imports ( #1840 )
2021-02-24 17:11:52 -05:00
Linh Nguyen
34cb4d559a
Copy `generated-sql` docs content to `sql` ( #1835 )
2021-02-24 15:31:31 -05:00
Linh Nguyen
2e43803cf1
Strip temporary dir name from filepath for docs generation ( #1819 )
...
* Remove "tmp/generated-sql" from dir name
Since docs are generated from 'tmp/generated-sql' dir,
we need to remove 'tmp/generated-sql' from file names
so they can be checked against the SKIP list
* Defide more specific destination path for mozfun
* Add pages sorting to mozfun
2021-02-23 09:27:22 -08:00
Linh Nguyen
28f15e16e5
Use generated SQL content as source for docs ( #1811 )
2021-02-16 13:33:53 -08:00
Linh Nguyen
4f26049318
Generate referenced tables for views ( #1763 )
...
* WIP
* Get referenced tables for mozdata
* Address review comments and add tests
* Try 'SELECT from {view}' method
This approach returns a lot of unfound table errors,
it seems like there's not a direct 1:1 correlation
between bigquery-etl table names and BigQuery datasets
on the cloud
* Add tests
* Lint dryrun.py
* Add some minor cleanups
* Add test for multiple referenced tables
* Sort referenced table results
2021-02-16 11:49:19 -08:00
Linh Nguyen
1ea5edbb95
Fix table-level links ( #1804 )
...
(fixes #1801 )
2021-02-12 13:52:48 -08:00
William Lachance
5148a7f775
New cookbook on creating a derived dataset ( #1781 )
...
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
Co-authored-by: Jeff Klukas <jklukas@mozilla.com>
2021-02-11 12:11:27 -05:00
Linh Nguyen
350291bd1a
Only show available urls in source ( #1762 )
...
Co-authored-by: Anthony Miyaguchi <amiyaguchi@mozilla.com>
2021-02-05 12:22:17 -08:00
Linh Nguyen
dd10f7a7f7
Generate summaries of derived tables ( fixes #1589 ) ( #1735 )
...
* Generate summaries of derived tables
* Generate mozdata docs
* Address requested changes
2021-02-04 13:05:26 -08:00
Linh Nguyen
0bb87d79f4
Update docs/index.md ( #1590 ) ( #1625 )
...
* Update docs/index.md
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
2020-12-15 15:53:19 -08:00
Linh Nguyen
be961f10a0
Add links to metadata.yaml editor and source dictory ( #1242 ) ( #1618 )
...
* Add links to edit and source directory
* Update docs/mkdocs.yml
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
Co-authored-by: jailang <lynjailang@gmail.com>
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
2020-12-15 11:52:46 -08:00
Anna Scholtz
b0aec90544
Fix UDF tests
2020-10-08 10:30:22 -07:00
Anna Scholtz
a84838466e
Rename routine tests
2020-10-08 10:30:22 -07:00
Anna Scholtz
67c5265b6f
Rename udf module to routine
2020-10-08 10:30:22 -07:00
Anna Scholtz
22d8798ef0
Rename functions that process UDFs and stored procedures to routine
2020-10-08 10:30:22 -07:00
Anna Scholtz
56c922a494
Fix generated docs path
2020-10-06 09:37:11 -07:00
Frank Bertsch
8a68128ee7
Clarify which functions are procedures in docs
2020-10-06 10:54:25 -04:00
Anna Scholtz
f131c585a5
Rename DEFAULT_PROJECTS to DEFAULT_PROJECTS_DIRS
2020-10-05 12:59:58 -07:00
Anna Scholtz
a16bc2824f
Fix validating docs
2020-10-05 12:59:58 -07:00
Anna Scholtz
d1c67dab53
Move projects into high-level sql/ folder
2020-10-05 12:59:58 -07:00
Frank Bertsch
efb49cf738
Dryrun stored procedures ( #1367 )
...
* Dryrun stored procedures
* Reformat SQL
* Update tests for reformatted sql
* Fix doc format again
* Let black run past max-line-length
Black does not mandate line-length, it only tries to adhere to it.
For that reason, we can't have flake8 fail at too-long line length.
https://black.readthedocs.io/en/stable/the_black_code_style.html#line-length
* Why doesn't pydoctest run locally?
* Apply suggestions from code review
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
Co-authored-by: Anna Scholtz <anna@scholtzan.net>
2020-10-01 16:48:28 -04:00
Frank Bertsch
bcb95bb449
Allow documentation for stored procedures ( #1358 )
...
* Allow documentation for stored procedures
Add docs for `create_events_view` procedure
* Additional instruction on procedure usage
* Fix SQL; fix backticks
* Last backtick fix
* Apply suggestions from review
* Update procedure reference
* Fix other use of backticks
* Add rough schema outline
* Apply suggestions from code review
Co-authored-by: William Lachance <wrlach@gmail.com>
Co-authored-by: William Lachance <wrlach@gmail.com>
2020-09-30 15:53:23 -04:00
Anna Scholtz
7566b7c3f0
Add CLI UDF tests
2020-09-09 14:10:44 -07:00
Anna Scholtz
56a475c572
Fix validating docs
2020-09-02 10:24:38 -07:00