| <!DOCTYPE html> |
| <html> |
| <head> |
| <meta http-equiv="content-type" content="text/html;charset=utf-8"> |
| <title>tag.c</title> |
| <link rel="stylesheet" href="../css.css"> |
| <style type="text/css"> |
| a.fnlink {text-decoration: none} |
| a.fnlink:hover {text-decoration: underline} |
| </style> |
| </head> |
| <body> |
| <div id='container'> |
| <div id="background"></div> |
| <div id="jump_to"> |
| Jump To … |
| <div id="jump_wrapper"> |
| <div id="jump_page"> |
| <a class="source" href="../../#v0.25.0">API Docs</a> |
| <a class="source" href="add.html">add.c</a> |
| <a class="source" href="blame.html">blame.c</a> |
| <a class="source" href="cat-file.html">cat-file.c</a> |
| <a class="source" href="common.html">common.c</a> |
| <a class="source" href="describe.html">describe.c</a> |
| <a class="source" href="diff.html">diff.c</a> |
| <a class="source" href="for-each-ref.html">for-each-ref.c</a> |
| <a class="source" href="general.html">general.c</a> |
| <a class="source" href="init.html">init.c</a> |
| <a class="source" href="log.html">log.c</a> |
| <a class="source" href="network/clone.html">clone.c</a> |
| <a class="source" href="network/common.html">common.c</a> |
| <a class="source" href="network/fetch.html">fetch.c</a> |
| <a class="source" href="network/git2.html">git2.c</a> |
| <a class="source" href="network/index-pack.html">index-pack.c</a> |
| <a class="source" href="network/ls-remote.html">ls-remote.c</a> |
| <a class="source" href="remote.html">remote.c</a> |
| <a class="source" href="rev-list.html">rev-list.c</a> |
| <a class="source" href="rev-parse.html">rev-parse.c</a> |
| <a class="source" href="showindex.html">showindex.c</a> |
| <a class="source" href="status.html">status.c</a> |
| <a class="source" href="tag.html">tag.c</a> |
| </div> |
| </div> |
| </div> |
| <table cellspacing=0 cellpadding=0> |
| <thead> |
| <tr> |
| <th class=docs><h1>tag.c</h1></th> |
| <th class=code></th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr id='section-1'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-1">¶</a> |
| </div> |
| |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="cm">/*</span> |
| <span class="cm"> * libgit2 "tag" example - shows how to list, create and delete tags</span> |
| <span class="cm"> *</span> |
| <span class="cm"> * Written by the libgit2 contributors</span> |
| <span class="cm"> *</span> |
| <span class="cm"> * To the extent possible under law, the author(s) have dedicated all copyright</span> |
| <span class="cm"> * and related and neighboring rights to this software to the public domain</span> |
| <span class="cm"> * worldwide. This software is distributed without any warranty.</span> |
| <span class="cm"> *</span> |
| <span class="cm"> * You should have received a copy of the CC0 Public Domain Dedication along</span> |
| <span class="cm"> * with this software. If not, see</span> |
| <span class="cm"> * <http://creativecommons.org/publicdomain/zero/1.0/>.</span> |
| <span class="cm"> */</span> |
| |
| <span class="cp">#include "common.h"</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-2'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-2">¶</a> |
| </div> |
| <p>The following example partially reimplements the <code>git tag</code> command |
| and some of its options.</p> |
| |
| <p>These commands should work:</p> |
| |
| <ul> |
| <li>Tag name listing (<code>tag</code>)</li> |
| <li>Filtered tag listing with messages (<code>tag -n3 -l "v0.1*"</code>)</li> |
| <li>Lightweight tag creation (<code>tag test v0.18.0</code>)</li> |
| <li>Tag creation (<code>tag -a -m "Test message" test v0.18.0</code>)</li> |
| <li>Tag deletion (<code>tag -d test</code>)</li> |
| </ul> |
| |
| <p>The command line parsing logic is simplified and doesn't handle |
| all of the use cases.</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre></pre></div> |
| </td> |
| </tr> |
| <tr id='section-3'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-3">¶</a> |
| </div> |
| <p>tag_options represents the parsed command line options</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">message</span><span class="p">;</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">pattern</span><span class="p">;</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">tag_name</span><span class="p">;</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">target</span><span class="p">;</span> |
| <span class="kt">int</span> <span class="n">num_lines</span><span class="p">;</span> |
| <span class="kt">int</span> <span class="n">force</span><span class="p">;</span> |
| <span class="p">}</span> <span class="n">tag_options</span><span class="p">;</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-4'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-4">¶</a> |
| </div> |
| <p>tag_state represents the current program state for dragging around</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">typedef</span> <span class="k">struct</span> <span class="p">{</span> |
| <span class="n">git_repository</span> <span class="o">*</span><span class="n">repo</span><span class="p">;</span> |
| <span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span><span class="p">;</span> |
| <span class="p">}</span> <span class="n">tag_state</span><span class="p">;</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-5'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-5">¶</a> |
| </div> |
| <p>An action to execute based on the command line arguments</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">typedef</span> <span class="nf">void</span> <span class="p">(</span><span class="o">*</span><span class="n">tag_action</span><span class="p">)(</span><span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">);</span> |
| <span class="k">typedef</span> <span class="k">struct</span> <span class="n">args_info</span> <span class="n">args_info</span><span class="p">;</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">check</span><span class="p">(</span><span class="kt">int</span> <span class="n">result</span><span class="p">,</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">message</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="k">if</span> <span class="p">(</span><span class="n">result</span><span class="p">)</span> <span class="n">fatal</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-6'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-6">¶</a> |
| </div> |
| <p>Tag listing: Print individual message lines</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">print_list_lines</span><span class="p">(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">message</span><span class="p">,</span> <span class="k">const</span> <span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">msg</span> <span class="o">=</span> <span class="n">message</span><span class="p">;</span> |
| <span class="kt">int</span> <span class="n">num</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span> <span class="o">-</span> <span class="mi">1</span><span class="p">;</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">msg</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-7'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-7">¶</a> |
| </div> |
| <p>first line - headline</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre> <span class="k">while</span><span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="o">*</span><span class="n">msg</span> <span class="o">!=</span> <span class="sc">'\n'</span><span class="p">)</span> <span class="n">printf</span><span class="p">(</span><span class="s">"%c"</span><span class="p">,</span> <span class="o">*</span><span class="n">msg</span><span class="o">++</span><span class="p">);</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-8'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-8">¶</a> |
| </div> |
| <p>skip over new lines</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre> <span class="k">while</span><span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="o">*</span><span class="n">msg</span> <span class="o">==</span> <span class="sc">'\n'</span><span class="p">)</span> <span class="n">msg</span><span class="o">++</span><span class="p">;</span> |
| |
| <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-9'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-9">¶</a> |
| </div> |
| <p>print just headline?</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre> <span class="k">if</span> <span class="p">(</span><span class="n">num</span> <span class="o">==</span> <span class="mi">0</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span> |
| <span class="k">if</span> <span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="n">msg</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-10'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-10">¶</a> |
| </div> |
| <p>print individual commit/tag lines</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre> <span class="k">while</span> <span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="n">num</span><span class="o">--</span> <span class="o">>=</span> <span class="mi">2</span><span class="p">)</span> <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">" "</span><span class="p">);</span> |
| |
| <span class="k">while</span> <span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="o">*</span><span class="n">msg</span> <span class="o">!=</span> <span class="sc">'\n'</span><span class="p">)</span> <span class="n">printf</span><span class="p">(</span><span class="s">"%c"</span><span class="p">,</span> <span class="o">*</span><span class="n">msg</span><span class="o">++</span><span class="p">);</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-11'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-11">¶</a> |
| </div> |
| <p>handle consecutive new lines</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre> <span class="k">if</span> <span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="o">*</span><span class="n">msg</span> <span class="o">==</span> <span class="sc">'\n'</span> <span class="o">&&</span> <span class="n">msg</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="sc">'\n'</span><span class="p">)</span> <span class="p">{</span> |
| <span class="n">num</span><span class="o">--</span><span class="p">;</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span> |
| <span class="p">}</span> |
| <span class="k">while</span><span class="p">(</span><span class="o">*</span><span class="n">msg</span> <span class="o">&&</span> <span class="o">*</span><span class="n">msg</span> <span class="o">==</span> <span class="sc">'\n'</span><span class="p">)</span> <span class="n">msg</span><span class="o">++</span><span class="p">;</span> |
| |
| <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span> |
| <span class="p">}</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-12'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-12">¶</a> |
| </div> |
| <p>Tag listing: Print an actual tag object</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">print_tag</span><span class="p">(</span><span class="n">git_tag</span> <span class="o">*</span><span class="n">tag</span><span class="p">,</span> <span class="k">const</span> <span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"%-16s"</span><span class="p">,</span> <span class="n"><a name="git_tag_name-20" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_name">git_tag_name</a></span><span class="p">(</span><span class="n">tag</span><span class="p">));</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span><span class="p">)</span> <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">msg</span> <span class="o">=</span> <span class="n"><a name="git_tag_message-21" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_message">git_tag_message</a></span><span class="p">(</span><span class="n">tag</span><span class="p">);</span> |
| <span class="n">print_list_lines</span><span class="p">(</span><span class="n">msg</span><span class="p">,</span> <span class="n">state</span><span class="p">);</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span> |
| <span class="p">}</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-13'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-13">¶</a> |
| </div> |
| <p>Tag listing: Print a commit (target of a lightweight tag)</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">print_commit</span><span class="p">(</span><span class="n">git_commit</span> <span class="o">*</span><span class="n">commit</span><span class="p">,</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">name</span><span class="p">,</span> |
| <span class="k">const</span> <span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"%-16s"</span><span class="p">,</span> <span class="n">name</span><span class="p">);</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span><span class="p">)</span> <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">msg</span> <span class="o">=</span> <span class="n"><a name="git_commit_message-2" class="fnlink" href="../../#v0.25.0/group/commit/git_commit_message">git_commit_message</a></span><span class="p">(</span><span class="n">commit</span><span class="p">);</span> |
| <span class="n">print_list_lines</span><span class="p">(</span><span class="n">msg</span><span class="p">,</span> <span class="n">state</span><span class="p">);</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span> |
| <span class="p">}</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-14'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-14">¶</a> |
| </div> |
| <p>Tag listing: Fallback, should not happen</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">print_name</span><span class="p">(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">name</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">printf</span><span class="p">(</span><span class="s">"%s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">name</span><span class="p">);</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-15'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-15">¶</a> |
| </div> |
| <p>Tag listing: Lookup tags based on ref name and dispatch to print</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">int</span> <span class="nf">each_tag</span><span class="p">(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">name</span><span class="p">,</span> <span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">git_repository</span> <span class="o">*</span><span class="n">repo</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">;</span> |
| <span class="n">git_object</span> <span class="o">*</span><span class="n">obj</span><span class="p">;</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_revparse_single-13" class="fnlink" href="../../#v0.25.0/group/revparse/git_revparse_single">git_revparse_single</a></span><span class="p">(</span><span class="o">&</span><span class="n">obj</span><span class="p">,</span> <span class="n">repo</span><span class="p">,</span> <span class="n">name</span><span class="p">),</span> |
| <span class="s">"Failed to lookup rev"</span><span class="p">,</span> <span class="n">name</span><span class="p">);</span> |
| |
| <span class="k">switch</span> <span class="p">(</span><span class="n"><a name="git_object_type-6" class="fnlink" href="../../#v0.25.0/group/object/git_object_type">git_object_type</a></span><span class="p">(</span><span class="n">obj</span><span class="p">))</span> <span class="p">{</span> |
| <span class="k">case</span> <span class="n">GIT_OBJ_TAG</span>: |
| <span class="n">print_tag</span><span class="p">((</span><span class="n">git_tag</span> <span class="o">*</span><span class="p">)</span> <span class="n">obj</span><span class="p">,</span> <span class="n">state</span><span class="p">);</span> |
| <span class="k">break</span><span class="p">;</span> |
| <span class="k">case</span> <span class="n">GIT_OBJ_COMMIT</span>: |
| <span class="n">print_commit</span><span class="p">((</span><span class="n">git_commit</span> <span class="o">*</span><span class="p">)</span> <span class="n">obj</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">state</span><span class="p">);</span> |
| <span class="k">break</span><span class="p">;</span> |
| <span class="nl">default:</span> |
| <span class="n">print_name</span><span class="p">(</span><span class="n">name</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="n"><a name="git_object_free-7" class="fnlink" href="../../#v0.25.0/group/object/git_object_free">git_object_free</a></span><span class="p">(</span><span class="n">obj</span><span class="p">);</span> |
| <span class="k">return</span> <span class="mi">0</span><span class="p">;</span> |
| <span class="p">}</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">action_list_tags</span><span class="p">(</span><span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">pattern</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="o">-></span><span class="n">pattern</span><span class="p">;</span> |
| <span class="n">git_strarray</span> <span class="n">tag_names</span> <span class="o">=</span> <span class="p">{</span><span class="mi">0</span><span class="p">};</span> |
| <span class="kt">size_t</span> <span class="n">i</span><span class="p">;</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_tag_list_match-25" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_list_match">git_tag_list_match</a></span><span class="p">(</span><span class="o">&</span><span class="n">tag_names</span><span class="p">,</span> <span class="n">pattern</span> <span class="o">?</span> <span class="n">pattern</span> <span class="o">:</span> <span class="s">"*"</span><span class="p">,</span> <span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">),</span> |
| <span class="s">"Unable to get list of tags"</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| |
| <span class="k">for</span><span class="p">(</span><span class="n">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">i</span> <span class="o"><</span> <span class="n">tag_names</span><span class="p">.</span><span class="n">count</span><span class="p">;</span> <span class="n">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> |
| <span class="n">each_tag</span><span class="p">(</span><span class="n">tag_names</span><span class="p">.</span><span class="n">strings</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">state</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="n"><a name="git_strarray_free-19" class="fnlink" href="../../#v0.25.0/group/strarray/git_strarray_free">git_strarray_free</a></span><span class="p">(</span><span class="o">&</span><span class="n">tag_names</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">action_delete_tag</span><span class="p">(</span><span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="p">;</span> |
| <span class="n">git_object</span> <span class="o">*</span><span class="n">obj</span><span class="p">;</span> |
| <span class="n">git_buf</span> <span class="n">abbrev_oid</span> <span class="o">=</span> <span class="p">{</span><span class="mi">0</span><span class="p">};</span> |
| |
| <span class="n">check</span><span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> <span class="s">"Name required"</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_revparse_single-14" class="fnlink" href="../../#v0.25.0/group/revparse/git_revparse_single">git_revparse_single</a></span><span class="p">(</span><span class="o">&</span><span class="n">obj</span><span class="p">,</span> <span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">),</span> |
| <span class="s">"Failed to lookup rev"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_object_short_id-5" class="fnlink" href="../../#v0.25.0/group/object/git_object_short_id">git_object_short_id</a></span><span class="p">(</span><span class="o">&</span><span class="n">abbrev_oid</span><span class="p">,</span> <span class="n">obj</span><span class="p">),</span> |
| <span class="s">"Unable to get abbreviated OID"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_tag_delete-24" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_delete">git_tag_delete</a></span><span class="p">(</span><span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">),</span> |
| <span class="s">"Unable to delete tag"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">);</span> |
| |
| <span class="n">printf</span><span class="p">(</span><span class="s">"Deleted tag '%s' (was %s)</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> <span class="n">abbrev_oid</span><span class="p">.</span><span class="n">ptr</span><span class="p">);</span> |
| |
| <span class="n"><a name="git_buf_free-1" class="fnlink" href="../../#v0.25.0/group/buf/git_buf_free">git_buf_free</a></span><span class="p">(</span><span class="o">&</span><span class="n">abbrev_oid</span><span class="p">);</span> |
| <span class="n"><a name="git_object_free-8" class="fnlink" href="../../#v0.25.0/group/object/git_object_free">git_object_free</a></span><span class="p">(</span><span class="n">obj</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">action_create_lighweight_tag</span><span class="p">(</span><span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">git_repository</span> <span class="o">*</span><span class="n">repo</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">;</span> |
| <span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="p">;</span> |
| <span class="n">git_oid</span> <span class="n">oid</span><span class="p">;</span> |
| <span class="n">git_object</span> <span class="o">*</span><span class="n">target</span><span class="p">;</span> |
| |
| <span class="n">check</span><span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> <span class="s">"Name required"</span><span class="p">);</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">)</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span> <span class="o">=</span> <span class="s">"HEAD"</span><span class="p">;</span> |
| |
| <span class="n">check</span><span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">,</span> <span class="s">"Target required"</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_revparse_single-15" class="fnlink" href="../../#v0.25.0/group/revparse/git_revparse_single">git_revparse_single</a></span><span class="p">(</span><span class="o">&</span><span class="n">target</span><span class="p">,</span> <span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">),</span> |
| <span class="s">"Unable to resolve spec"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_tag_create_lightweight-23" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_create_lightweight">git_tag_create_lightweight</a></span><span class="p">(</span><span class="o">&</span><span class="n">oid</span><span class="p">,</span> <span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> |
| <span class="n">target</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">force</span><span class="p">),</span> <span class="s">"Unable to create tag"</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| |
| <span class="n"><a name="git_object_free-9" class="fnlink" href="../../#v0.25.0/group/object/git_object_free">git_object_free</a></span><span class="p">(</span><span class="n">target</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">action_create_tag</span><span class="p">(</span><span class="n">tag_state</span> <span class="o">*</span><span class="n">state</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">git_repository</span> <span class="o">*</span><span class="n">repo</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">repo</span><span class="p">;</span> |
| <span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span> <span class="o">=</span> <span class="n">state</span><span class="o">-></span><span class="n">opts</span><span class="p">;</span> |
| <span class="n">git_signature</span> <span class="o">*</span><span class="n">tagger</span><span class="p">;</span> |
| <span class="n">git_oid</span> <span class="n">oid</span><span class="p">;</span> |
| <span class="n">git_object</span> <span class="o">*</span><span class="n">target</span><span class="p">;</span> |
| |
| <span class="n">check</span><span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> <span class="s">"Name required"</span><span class="p">);</span> |
| <span class="n">check</span><span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">message</span><span class="p">,</span> <span class="s">"Message required"</span><span class="p">);</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">)</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span> <span class="o">=</span> <span class="s">"HEAD"</span><span class="p">;</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_revparse_single-16" class="fnlink" href="../../#v0.25.0/group/revparse/git_revparse_single">git_revparse_single</a></span><span class="p">(</span><span class="o">&</span><span class="n">target</span><span class="p">,</span> <span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">),</span> |
| <span class="s">"Unable to resolve spec"</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_signature_default-17" class="fnlink" href="../../#v0.25.0/group/signature/git_signature_default">git_signature_default</a></span><span class="p">(</span><span class="o">&</span><span class="n">tagger</span><span class="p">,</span> <span class="n">repo</span><span class="p">),</span> |
| <span class="s">"Unable to create signature"</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_tag_create-22" class="fnlink" href="../../#v0.25.0/group/tag/git_tag_create">git_tag_create</a></span><span class="p">(</span><span class="o">&</span><span class="n">oid</span><span class="p">,</span> <span class="n">repo</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> |
| <span class="n">target</span><span class="p">,</span> <span class="n">tagger</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">message</span><span class="p">,</span> <span class="n">opts</span><span class="o">-></span><span class="n">force</span><span class="p">),</span> <span class="s">"Unable to create tag"</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| |
| <span class="n"><a name="git_object_free-10" class="fnlink" href="../../#v0.25.0/group/object/git_object_free">git_object_free</a></span><span class="p">(</span><span class="n">target</span><span class="p">);</span> |
| <span class="n"><a name="git_signature_free-18" class="fnlink" href="../../#v0.25.0/group/signature/git_signature_free">git_signature_free</a></span><span class="p">(</span><span class="n">tagger</span><span class="p">);</span> |
| <span class="p">}</span> |
| |
| <span class="k">static</span> <span class="kt">void</span> <span class="nf">print_usage</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"usage: see `git help tag`</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span> |
| <span class="n">exit</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-16'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-16">¶</a> |
| </div> |
| <p>Parse command line arguments and choose action to run when done</p> |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">parse_options</span><span class="p">(</span><span class="n">tag_action</span> <span class="o">*</span><span class="n">action</span><span class="p">,</span> <span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span><span class="p">,</span> <span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">**</span><span class="n">argv</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">args_info</span> <span class="n">args</span> <span class="o">=</span> <span class="n">ARGS_INFO_INIT</span><span class="p">;</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_list_tags</span><span class="p">;</span> |
| |
| <span class="k">for</span> <span class="p">(</span><span class="n">args</span><span class="p">.</span><span class="n">pos</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span> <span class="n">args</span><span class="p">.</span><span class="n">pos</span> <span class="o"><</span> <span class="n">argc</span><span class="p">;</span> <span class="o">++</span><span class="n">args</span><span class="p">.</span><span class="n">pos</span><span class="p">)</span> <span class="p">{</span> |
| <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">curr</span> <span class="o">=</span> <span class="n">argv</span><span class="p">[</span><span class="n">args</span><span class="p">.</span><span class="n">pos</span><span class="p">];</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="n">curr</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">!=</span> <span class="sc">'-'</span><span class="p">)</span> <span class="p">{</span> |
| <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">)</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span> <span class="o">=</span> <span class="n">curr</span><span class="p">;</span> |
| <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">opts</span><span class="o">-></span><span class="n">target</span><span class="p">)</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">target</span> <span class="o">=</span> <span class="n">curr</span><span class="p">;</span> |
| <span class="k">else</span> |
| <span class="n">print_usage</span><span class="p">();</span> |
| |
| <span class="k">if</span> <span class="p">(</span><span class="o">*</span><span class="n">action</span> <span class="o">!=</span> <span class="o">&</span><span class="n">action_create_tag</span><span class="p">)</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_create_lighweight_tag</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">strcmp</span><span class="p">(</span><span class="n">curr</span><span class="p">,</span> <span class="s">"-n"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_list_tags</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">strcmp</span><span class="p">(</span><span class="n">curr</span><span class="p">,</span> <span class="s">"-a"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_create_tag</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">strcmp</span><span class="p">(</span><span class="n">curr</span><span class="p">,</span> <span class="s">"-f"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">force</span> <span class="o">=</span> <span class="mi">1</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="n">match_int_arg</span><span class="p">(</span><span class="o">&</span><span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span><span class="p">,</span> <span class="o">&</span><span class="n">args</span><span class="p">,</span> <span class="s">"-n"</span><span class="p">,</span> <span class="mi">0</span><span class="p">))</span> <span class="p">{</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_list_tags</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="n">match_str_arg</span><span class="p">(</span><span class="o">&</span><span class="n">opts</span><span class="o">-></span><span class="n">pattern</span><span class="p">,</span> <span class="o">&</span><span class="n">args</span><span class="p">,</span> <span class="s">"-l"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_list_tags</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="n">match_str_arg</span><span class="p">(</span><span class="o">&</span><span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span><span class="p">,</span> <span class="o">&</span><span class="n">args</span><span class="p">,</span> <span class="s">"-d"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_delete_tag</span><span class="p">;</span> |
| <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="n">match_str_arg</span><span class="p">(</span><span class="o">&</span><span class="n">opts</span><span class="o">-></span><span class="n">message</span><span class="p">,</span> <span class="o">&</span><span class="n">args</span><span class="p">,</span> <span class="s">"-m"</span><span class="p">))</span> <span class="p">{</span> |
| <span class="o">*</span><span class="n">action</span> <span class="o">=</span> <span class="o">&</span><span class="n">action_create_tag</span><span class="p">;</span> |
| <span class="p">}</span> |
| <span class="p">}</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| <tr id='section-17'> |
| <td class=docs> |
| <div class="pilwrap"> |
| <a class="pilcrow" href="#section-17">¶</a> |
| </div> |
| <p>Initialize tag_options struct</p> |
| |
| </td> |
| <td class=code> |
| <div class='highlight'><pre><span class="k">static</span> <span class="kt">void</span> <span class="nf">tag_options_init</span><span class="p">(</span><span class="n">tag_options</span> <span class="o">*</span><span class="n">opts</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">memset</span><span class="p">(</span><span class="n">opts</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="k">sizeof</span><span class="p">(</span><span class="o">*</span><span class="n">opts</span><span class="p">));</span> |
| |
| <span class="n">opts</span><span class="o">-></span><span class="n">message</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">pattern</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">tag_name</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">target</span> <span class="o">=</span> <span class="nb">NULL</span><span class="p">;</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">num_lines</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> |
| <span class="n">opts</span><span class="o">-></span><span class="n">force</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> |
| <span class="p">}</span> |
| |
| <span class="kt">int</span> <span class="nf">main</span><span class="p">(</span><span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">**</span><span class="n">argv</span><span class="p">)</span> |
| <span class="p">{</span> |
| <span class="n">git_repository</span> <span class="o">*</span><span class="n">repo</span><span class="p">;</span> |
| <span class="n">tag_options</span> <span class="n">opts</span><span class="p">;</span> |
| <span class="n">tag_action</span> <span class="n">action</span><span class="p">;</span> |
| <span class="n">tag_state</span> <span class="n">state</span><span class="p">;</span> |
| |
| <span class="n"><a name="git_libgit2_init-3" class="fnlink" href="../../#v0.25.0/group/libgit2/git_libgit2_init">git_libgit2_init</a></span><span class="p">();</span> |
| |
| <span class="n">check_lg2</span><span class="p">(</span><span class="n"><a name="git_repository_open_ext-11" class="fnlink" href="../../#v0.25.0/group/repository/git_repository_open_ext">git_repository_open_ext</a></span><span class="p">(</span><span class="o">&</span><span class="n">repo</span><span class="p">,</span> <span class="s">"."</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">),</span> |
| <span class="s">"Could not open repository"</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">);</span> |
| |
| <span class="n">tag_options_init</span><span class="p">(</span><span class="o">&</span><span class="n">opts</span><span class="p">);</span> |
| <span class="n">parse_options</span><span class="p">(</span><span class="o">&</span><span class="n">action</span><span class="p">,</span> <span class="o">&</span><span class="n">opts</span><span class="p">,</span> <span class="n">argc</span><span class="p">,</span> <span class="n">argv</span><span class="p">);</span> |
| |
| <span class="n">state</span><span class="p">.</span><span class="n">repo</span> <span class="o">=</span> <span class="n">repo</span><span class="p">;</span> |
| <span class="n">state</span><span class="p">.</span><span class="n">opts</span> <span class="o">=</span> <span class="o">&</span><span class="n">opts</span><span class="p">;</span> |
| <span class="n">action</span><span class="p">(</span><span class="o">&</span><span class="n">state</span><span class="p">);</span> |
| |
| <span class="n"><a name="git_repository_free-12" class="fnlink" href="../../#v0.25.0/group/repository/git_repository_free">git_repository_free</a></span><span class="p">(</span><span class="n">repo</span><span class="p">);</span> |
| <span class="n"><a name="git_libgit2_shutdown-4" class="fnlink" href="../../#v0.25.0/group/libgit2/git_libgit2_shutdown">git_libgit2_shutdown</a></span><span class="p">();</span> |
| |
| <span class="k">return</span> <span class="mi">0</span><span class="p">;</span> |
| <span class="p">}</span></pre></div> |
| </td> |
| </tr> |
| </table> |
| </div> |
| </body> |
