{"id":17648073,"url":"https://github.com/gpanders/ztags","last_synced_at":"2025-04-30T22:07:59.145Z","repository":{"id":50022051,"uuid":"498478747","full_name":"gpanders/ztags","owner":"gpanders","description":"Generate tags files for Zig projects","archived":false,"fork":false,"pushed_at":"2024-06-25T16:23:17.000Z","size":116,"stargazers_count":18,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-26T17:40:49.107Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://git.sr.ht/~gpanders/ztags","language":"Zig","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/gpanders.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-31T19:55:36.000Z","updated_at":"2024-06-25T16:29:23.000Z","dependencies_parsed_at":"2024-01-17T00:44:09.010Z","dependency_job_id":"4a18049e-8855-44cf-9a2a-10c1f12778ab","html_url":"https://github.com/gpanders/ztags","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpanders%2Fztags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpanders%2Fztags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpanders%2Fztags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpanders%2Fztags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gpanders","download_url":"https://codeload.github.com/gpanders/ztags/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222670761,"owners_count":17020515,"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":[],"created_at":"2024-10-23T11:16:11.583Z","updated_at":"2025-03-31T17:30:51.625Z","avatar_url":"https://github.com/gpanders.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ztags\n\nGenerate tags files for Zig projects.\n\nUnlike `ctags`, this does not use regular expressions, but instead analyzes the\nabstract syntax tree of the source code.\n\n## Building\n\nClone this repository and build with `zig build` (Only Zig 0.13 is supported).\nThis will produce a `Debug` build by default, which generates useful error\nmessages but can be a bit slow. To build a release build use\n\n```console\n$ zig build -Doptimize=ReleaseSafe\n```\n\nTo build the man page (requires [scdoc][]), run\n\n```console\n$ zig build docs\n```\n\nThis will install the man page to `share/man/man1/ztags.1` relative to the\nprefix given with `-p`/`--prefix` (default `zig-out`).\n\nTo build and install both `ztags` and the man page to `$PREFIX` simultaneously,\nuse\n\n```console\n$ zig build -Doptimize=ReleaseSafe -p $PREFIX install docs\n```\n\n[scdoc]: https://sr.ht/~sircmpwn/scdoc/\n\n## Usage\n\nPass a source file to the `ztags` executable. `ztags` will find `@import`\nstatements for relative files (i.e. any imports that end with `.zig`) and\nrecursively index those files too.\n\nPackages (imports that are not a relative path, but a package name such as\n`@import(\"foo\")`) are not followed, as package information is not available at\nruntime. Instead, pass the root source file of each package as an additional\ncommand line argument.\n\nFor example, the entire Zig standard library can be indexed using:\n\n```console\n$ ztags /path/to/zig/std/std.zig\n```\n\nThe following \"kinds\" are supported:\n\n- `enum`\n- `field`\n- `struct`\n- `constant`\n- `function`\n- `variable`\n- `union`\n\n## Contributing\n\nBugs can be reported on the [issue tracker][issues]. PRs are accepted on [GitHub][github] or [Codeberg][codeberg].\n\n[issues]: https://codeberg.org/gpanders/ztags/issues\n[github]: https://github.com/gpanders/ztags\n[codeberg]: https://codeberg.org/gpanders/ztags\n\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpanders%2Fztags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgpanders%2Fztags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpanders%2Fztags/lists"}