{"repo":"stepchowfun/tagref","free":true,"listed":false,"github":"https://github.com/stepchowfun/tagref","clone":"git clone https://github.com/stepchowfun/tagref.git","description":"Tagref helps you manage cross-references in your code.","language":"Rust","stars":240,"topics":["continuous-integration","linter","cross-reference","cross-references","cross-referencing"],"license":null,"category":"dev-tools","readme_excerpt":"Tagref Tagref helps you manage cross-references in your code. You can use it to help keep things in sync, document assumptions, maintain invariants, etc. Airbnb, Notion, and Watershed use it to level up their code health. You can use it too! Tagref works with any programming language, and it respects your .gitignore file as well as other common filter files. It's recommended to set up Tagref as an automated continuous integration (CI) check. Tagref is fast and almost certainly won't be the bottleneck in your CI. What is it? Tagref allows you to annotate your code with tags (in comments) which can be referenced from other parts of the codebase. Here's an example in Python: To help you manage these tags and references, Tagref checks the following: 1. References actually point to tags. A tag cannot be deleted or renamed without updating the references that point to it. 2. Tags are unique. There is never any ambiguity about which tag is being referenced. In the example above, Tagref doesn't guarantee that polynomial returns a nonzero number. It isn't magic! It only ensures that the polynomial nonzero tag exists unambiguously. The programmer is still responsible for keeping the comments in sync with the code. In addition to references to tags, Tagref also supports file references and directory references . A file reference guarantees that the given file exists. For example: A directory reference guarantees that the given directory exists. For example: By default, file and director","default_branch":null,"files":null,"tree":[],"storefront":"/r/stepchowfun","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/stepchowfun/tagref/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}