- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <title>
- Class: HelixVersioningEngine::ChangeService
- — Documentation by YARD 0.8.7.6
- </title>
- <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
- <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
- <script type="text/javascript" charset="utf-8">
- hasFrames = window.top.frames.main ? true : false;
- relpath = '../';
- framesUrl = "../frames.html#!HelixVersioningEngine/ChangeService.html";
- </script>
- <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
- <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
- </head>
- <body>
- <div id="header">
- <div id="menu">
- <a href="../_index.html">Index (C)</a> »
- <span class='title'><span class='object_link'><a href="../HelixVersioningEngine.html" title="HelixVersioningEngine (module)">HelixVersioningEngine</a></span></span>
- »
- <span class="title">ChangeService</span>
- <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
- </div>
- <div id="search">
- <a class="full_list_link" id="class_list_link"
- href="../class_list.html">
- Class List
- </a>
- <a class="full_list_link" id="method_list_link"
- href="../method_list.html">
- Method List
- </a>
- <a class="full_list_link" id="file_list_link"
- href="../file_list.html">
- File List
- </a>
- </div>
- <div class="clear"></div>
- </div>
- <iframe id="search_frame"></iframe>
- <div id="content"><h1>Class: HelixVersioningEngine::ChangeService
- </h1>
- <dl class="box">
- <dt class="r1">Inherits:</dt>
- <dd class="r1">
- <span class="inheritName">Object</span>
- <ul class="fullTree">
- <li>Object</li>
- <li class="next">HelixVersioningEngine::ChangeService</li>
- </ul>
- <a href="#" class="inheritanceTree">show all</a>
- </dd>
- <dt class="r2 last">Defined in:</dt>
- <dd class="r2 last">lib/helix_versioning_engine/change_service.rb</dd>
- </dl>
- <div class="clear"></div>
- <h2>Overview</h2><div class="docstring">
- <div class="discussion">
- <p>This class assists in creating changelists based on an array of file
- changes, some of which may be file uploads.</p>
- <p>This is the implementation for file uploads and change creation.</p>
- </div>
- </div>
- <div class="tags">
- </div><h2>Defined Under Namespace</h2>
- <p class="children">
- <strong class="classes">Classes:</strong> <span class='object_link'><a href="ChangeService/File.html" title="HelixVersioningEngine::ChangeService::File (class)">File</a></span>
- </p>
- <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
- <ul class="summary">
- <li class="public ">
- <span class="summary_signature">
- <a href="#client_name-instance_method" title="#client_name (instance method)">- (Object) <strong>client_name</strong> </a>
- </span>
- <span class="note title readonly">readonly</span>
- <span class="summary_desc"><div class='inline'>
- <p>The name of the temporary client.</p>
- </div></span>
- </li>
- <li class="public ">
- <span class="summary_signature">
- <a href="#client_root-instance_method" title="#client_root (instance method)">- (Object) <strong>client_root</strong> </a>
- </span>
- <span class="note title readonly">readonly</span>
- <span class="summary_desc"><div class='inline'>
- <p>The root directory of the temporary client.</p>
- </div></span>
- </li>
- <li class="public ">
- <span class="summary_signature">
- <a href="#p4-instance_method" title="#p4 (instance method)">- (Object) <strong>p4</strong> </a>
- </span>
- <span class="note title readonly">readonly</span>
- <span class="summary_desc"><div class='inline'>
- <p>The P4 connection we're using, that should already be logged in for a
- particular user.</p>
- </div></span>
- </li>
- </ul>
- <h2>
- Instance Method Summary
- <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
- </h2>
- <ul class="summary">
- <li class="public ">
- <span class="summary_signature">
- <a href="#initialize-instance_method" title="#initialize (instance method)">- (ChangeService) <strong>initialize</strong>(p4: nil, client_name: nil, client_root: nil) </a>
- </span>
- <span class="note title constructor">constructor</span>
- <span class="summary_desc"><div class='inline'>
- <p>A new instance of ChangeService.</p>
- </div></span>
- </li>
- <li class="public ">
- <span class="summary_signature">
- <a href="#submit-instance_method" title="#submit (instance method)">- (Object) <strong>submit</strong>(files: [], description: 'Updating files') </a>
- </span>
- <span class="summary_desc"><div class='inline'></div></span>
- </li>
- </ul>
- <div id="constructor_details" class="method_details_list">
- <h2>Constructor Details</h2>
- <div class="method_details first">
- <h3 class="signature first" id="initialize-instance_method">
- - (<tt><span class='object_link'><a href="" title="HelixVersioningEngine::ChangeService (class)">ChangeService</a></span></tt>) <strong>initialize</strong>(p4: nil, client_name: nil, client_root: nil)
- </h3><div class="docstring">
- <div class="discussion">
- <p>Returns a new instance of ChangeService</p>
- </div>
- </div>
- <div class="tags">
- </div><table class="source_code">
- <tr>
- <td>
- <pre class="lines">
- 21
- 22
- 23
- 24
- 25</pre>
- </td>
- <td>
- <pre class="code"><span class="info file"># File 'lib/helix_versioning_engine/change_service.rb', line 21</span>
- <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>p4:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>client_name:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>client_root:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
- <span class='ivar'>@p4</span> <span class='op'>=</span> <span class='id identifier rubyid_p4'>p4</span>
- <span class='ivar'>@client_name</span> <span class='op'>=</span> <span class='id identifier rubyid_client_name'>client_name</span>
- <span class='ivar'>@client_root</span> <span class='op'>=</span> <span class='id identifier rubyid_client_root'>client_root</span>
- <span class='kw'>end</span></pre>
- </td>
- </tr>
- </table>
- </div>
- </div>
- <div id="instance_attr_details" class="attr_details">
- <h2>Instance Attribute Details</h2>
- <span id=""></span>
- <div class="method_details first">
- <h3 class="signature first" id="client_name-instance_method">
- - (<tt>Object</tt>) <strong>client_name</strong> <span class="extras">(readonly)</span>
- </h3><div class="docstring">
- <div class="discussion">
- <p>The name of the temporary client</p>
- </div>
- </div>
- <div class="tags">
- </div><table class="source_code">
- <tr>
- <td>
- <pre class="lines">
- 16
- 17
- 18</pre>
- </td>
- <td>
- <pre class="code"><span class="info file"># File 'lib/helix_versioning_engine/change_service.rb', line 16</span>
- <span class='kw'>def</span> <span class='id identifier rubyid_client_name'>client_name</span>
- <span class='ivar'>@client_name</span>
- <span class='kw'>end</span></pre>
- </td>
- </tr>
- </table>
- </div>
- <span id=""></span>
- <div class="method_details ">
- <h3 class="signature " id="client_root-instance_method">
- - (<tt>Object</tt>) <strong>client_root</strong> <span class="extras">(readonly)</span>
- </h3><div class="docstring">
- <div class="discussion">
- <p>The root directory of the temporary client</p>
- </div>
- </div>
- <div class="tags">
- </div><table class="source_code">
- <tr>
- <td>
- <pre class="lines">
- 19
- 20
- 21</pre>
- </td>
- <td>
- <pre class="code"><span class="info file"># File 'lib/helix_versioning_engine/change_service.rb', line 19</span>
- <span class='kw'>def</span> <span class='id identifier rubyid_client_root'>client_root</span>
- <span class='ivar'>@client_root</span>
- <span class='kw'>end</span></pre>
- </td>
- </tr>
- </table>
- </div>
- <span id=""></span>
- <div class="method_details ">
- <h3 class="signature " id="p4-instance_method">
- - (<tt>Object</tt>) <strong>p4</strong> <span class="extras">(readonly)</span>
- </h3><div class="docstring">
- <div class="discussion">
- <p>The P4 connection we're using, that should already be logged in for a
- particular user.</p>
- </div>
- </div>
- <div class="tags">
- </div><table class="source_code">
- <tr>
- <td>
- <pre class="lines">
- 13
- 14
- 15</pre>
- </td>
- <td>
- <pre class="code"><span class="info file"># File 'lib/helix_versioning_engine/change_service.rb', line 13</span>
- <span class='kw'>def</span> <span class='id identifier rubyid_p4'>p4</span>
- <span class='ivar'>@p4</span>
- <span class='kw'>end</span></pre>
- </td>
- </tr>
- </table>
- </div>
- </div>
- <div id="instance_method_details" class="method_details_list">
- <h2>Instance Method Details</h2>
- <div class="method_details first">
- <h3 class="signature first" id="submit-instance_method">
- - (<tt>Object</tt>) <strong>submit</strong>(files: [], description: 'Updating files')
- </h3><table class="source_code">
- <tr>
- <td>
- <pre class="lines">
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50</pre>
- </td>
- <td>
- <pre class="code"><span class="info file"># File 'lib/helix_versioning_engine/change_service.rb', line 27</span>
- <span class='kw'>def</span> <span class='id identifier rubyid_submit'>submit</span><span class='lparen'>(</span><span class='label'>files:</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='label'>description:</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>Updating files</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
- <span class='id identifier rubyid_change_id'>change_id</span> <span class='op'>=</span> <span class='const'>Util</span><span class='period'>.</span><span class='id identifier rubyid_init_changelist'>init_changelist</span><span class='lparen'>(</span><span class='id identifier rubyid_p4'>p4</span><span class='comma'>,</span> <span class='id identifier rubyid_description'>description</span><span class='rparen'>)</span>
- <span class='kw'>begin</span>
- <span class='id identifier rubyid_files'>files</span> <span class='op'>=</span> <span class='id identifier rubyid_files'>files</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_f'>f</span><span class='op'>|</span> <span class='id identifier rubyid_f'>f</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>ChangeService</span><span class='op'>::</span><span class='const'>File</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id identifier rubyid_f'>f</span> <span class='op'>:</span> <span class='const'>ChangeService</span><span class='op'>::</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_f'>f</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
- <span class='id identifier rubyid_collect_file_results'>collect_file_results</span><span class='lparen'>(</span><span class='id identifier rubyid_files'>files</span><span class='rparen'>)</span>
- <span class='id identifier rubyid_files'>files</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_f'>f</span><span class='op'>|</span> <span class='id identifier rubyid_f'>f</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span><span class='id identifier rubyid_p4'>p4</span><span class='comma'>,</span> <span class='id identifier rubyid_change_id'>change_id</span><span class='comma'>,</span> <span class='id identifier rubyid_client_root'>client_root</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
- <span class='id identifier rubyid_p4'>p4</span><span class='period'>.</span><span class='id identifier rubyid_run_submit'>run_submit</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>-c</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='id identifier rubyid_change_id'>change_id</span><span class='rparen'>)</span>
- <span class='kw'>rescue</span> <span class='const'>StandardError</span> <span class='op'>=></span> <span class='id identifier rubyid_ex'>ex</span>
- <span class='comment'># Delete the changelist
- </span> <span class='id identifier rubyid_p4'>p4</span><span class='period'>.</span><span class='id identifier rubyid_at_exception_level'>at_exception_level</span><span class='lparen'>(</span><span class='const'>P4</span><span class='op'>::</span><span class='const'>RAISE_NONE</span><span class='rparen'>)</span> <span class='kw'>do</span>
- <span class='id identifier rubyid_p4'>p4</span><span class='period'>.</span><span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>revert</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>-c</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='id identifier rubyid_change_id'>change_id</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>//...</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
- <span class='id identifier rubyid_p4'>p4</span><span class='period'>.</span><span class='id identifier rubyid_run_change'>run_change</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>-d</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='id identifier rubyid_change_id'>change_id</span><span class='rparen'>)</span>
- <span class='kw'>if</span> <span class='const'>Util</span><span class='period'>.</span><span class='id identifier rubyid_error?'>error?</span><span class='lparen'>(</span><span class='id identifier rubyid_p4'>p4</span><span class='rparen'>)</span>
- <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>possible issues deleting change </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_change_id'>change_id</span><span class='embexpr_end'>}</span><span class='tstring_content'>: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_p4'>p4</span><span class='period'>.</span><span class='id identifier rubyid_messages'>messages</span><span class='embexpr_end'>}</span><span class='tstring_end'>"</span></span>
- <span class='kw'>end</span>
- <span class='kw'>end</span>
- <span class='id identifier rubyid_raise'>raise</span> <span class='id identifier rubyid_ex'>ex</span>
- <span class='kw'>end</span>
- <span class='kw'>end</span></pre>
- </td>
- </tr>
- </table>
- </div>
- </div>
- </div>
- <div id="footer">
- Generated on Mon Oct 12 22:20:53 2015 by
- <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
- 0.8.7.6 (ruby-2.2.3).
- </div>
- </body>
- </html>
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#11 | 16275 | Doug Scheirer | Merge from main | 9 years ago | |
#10 | 16196 | Doug Scheirer | Merge from main | 9 years ago | |
#9 | 16148 | Doug Scheirer | Merge from main | 9 years ago | |
#8 | 16114 | Doug Scheirer | Merge from main | 9 years ago | |
#7 | 16079 | Doug Scheirer | Merge from main | 9 years ago | |
#6 | 16014 | Doug Scheirer | Merge down from main | 9 years ago | |
#5 | 15884 | Doug Scheirer | Merge from main | 9 years ago | |
#4 | 15868 | Doug Scheirer | Merge from main | 9 years ago | |
#3 | 15845 | Doug Scheirer | Integ from main | 9 years ago | |
#2 | 15715 | Doug Scheirer | merge changes from main | 10 years ago | |
#1 | 15688 | Doug Scheirer | Populate -o //guest/perforce_software/helix-web-services/... //guest/doug_scheirer/helix-...web-services/.... « |
10 years ago | |
//guest/perforce_software/helix-web-services/main/build/doc/helix_web_services/HelixVersioningEngine/ChangeService.html | |||||
#32 | 15676 | tjuricek | HWS/NOARCH/2015.1.main/201509092205 | 10 years ago | |
#31 | 15589 | tjuricek | Update path to test output and update docs. | 10 years ago | |
#30 | 15542 | tjuricek | Add spaces to our basic 'component encode' mechanism, and use it for HVE project IDs. I...n general, this will make the HVE IDs a bit more readable. « |
10 years ago | |
#29 | 15517 | tjuricek | Do not require changelist ID for submitting Helix Sync pending changelists. | 10 years ago | |
#28 | 15499 | tjuricek | Naive implementation of helix sync project submit for "helix versioning engine projects". | 10 years ago | |
#27 | 15487 | tjuricek | Add basic ability to create pending changelists for helix sync projects. | 10 years ago | |
#26 | 15479 | tjuricek | Added a basic "HVE project" implementation for creating clients. | 10 years ago | |
#25 | 15447 | tjuricek | Add simple Example application to list "projects" in a HVE instance. Qt's a little weir...d to follow, so I may have to find a different kind of example to write. It does work, however. « |
10 years ago | |
#24 | 15240 | tjuricek | Set api level via request path on all Helix Versioning Engine methods. This will allow... migration of applications to different P4D versions. Our internal methods (like project API) should attempt to handle backward compatibility similarly. P4WEBAPI-118 « |
10 years ago | |
#23 | 15228 | tjuricek | Revise triggers implementation, tests, and documentation. | 10 years ago | |
#22 | 15227 | tjuricek | Revise implementation, tests, and documentation for protections management. Remove some... specs I will not be revising from the helix_web_services project. « |
10 years ago | |
#21 | 15225 | tjuricek | Revise counter implementation, tests, and documentation Wasn't available in the Ruby cl...ient before, so, it's now available. « |
10 years ago | |
#20 | 15222 | tjuricek | Revise server specs testing and documentation. Note: also fixed issues with setting P4P...ORT via headers. For whatever reason, the host setting doesn't seem to work like I expect it to, though P4PORT works just fine. « |
10 years ago | |
#19 | 15211 | tjuricek | Implement tests and documentation for label spec management. | 10 years ago | |
#18 | 15210 | tjuricek | Implement tests and documentation for job spec management. | 10 years ago | |
#17 | 15209 | tjuricek | Implement tests and documentation for group spec management. | 10 years ago | |
#16 | 15208 | tjuricek | Revise 'command' implementation, tests, and documentaiton. This includes a change from... a command blacklist to a whitelist. See P4WEBAPI-21 « |
10 years ago | |
#15 | 15205 | tjuricek | Implemented tests and documentation for depot spec editing. | 10 years ago | |
#14 | 15189 | tjuricek | Update files implementation, testing, and documentation. | 10 years ago | |
#13 | 15185 | tjuricek | Update user spec management implementation, tests, and documentation. | 10 years ago | |
#12 | 15144 | tjuricek | Setup stream spec tests and documentation. Also revised the documentation folder http_p...4_web_api -> helix_versioning_engine « |
10 years ago | |
#11 | 15132 | tjuricek | Provde a basic submit -e mechanism on classic perforce workspaces. | 10 years ago | |
#10 | 15110 | tjuricek | Revise changes methods for new p4 connection handling, add server specs, remove model refe...rences in client, and update asciidoc documentation. « | 10 years ago | |
#9 | 15099 | tjuricek | Revise project services to be our simple 'container' for other systems. | 10 years ago | |
#8 | 15098 | tjuricek | Revised project services to GET-only forms. With Helix Sync revising to integrate purel...y with Helix Cloud, this is the only thing we can reasonably define. « |
10 years ago | |
#7 | 15090 | tjuricek | Update _proposed_ API for project services. This is *very likely* to change, and will n...ot be implemented until reviewed. « |
10 years ago | |
#6 | 15078 | tjuricek |
clients spec method revisions Updated some other documentation. |
10 years ago | |
#5 | 15077 | tjuricek | Add new 'model' technique, revised branch spec operations, test Auth::Middleware. The R...uby client now does *not* strictly type anything, but extends OpenStruct with helper methods to help deal with inconsistent data formats. See the OpenModel class documentation for more details. The Auth::Middleware class is also *finally* implemented as well. This does not take into account all possible variations of server behavior (yet), but that will happen in follow-up work. « |
10 years ago | |
#4 | 15073 | tjuricek | Update Auth::Middleware and add spec | 10 years ago | |
#3 | 15053 | tjuricek | Revise the client API to use the new login method. The current specs will need to be re...vised since data normalization is moving out of the server and into the client. « |
10 years ago | |
#2 | 15038 | tjuricek | Document 'login' auth method and client programming overview. | 10 years ago | |
#1 | 15032 | tjuricek | Starting config and doc revisions. System is now broken while revisions underway. Conf...iguration of the p4d connection is now done via a single HWSSettings middleware object injected into the Rack env. The HWSP4Cleanup middleware now cleans up any p4 injected into the Rack env. The Auth::App class now mostly just contains one method to generate a p4 ticket. /auth/v1/login. Added yard documentation for the main project. Yard docs have been reconfigured to dump into build/ directories. This should probably be done with each release. Hm... The top level rake file contains a task, 'all:doc', to update our documentation. This should probably be run for each checkin. Hm... Specs are now using Rack::Test on top of a 'live' p4d. I'd suggest you still use the p4util mechanism, which now dumps to a /tmp folder, so we can safely add P4IGNORE rules back into your local .p4config file. Old 'perforce' application now called 'helix_versioning_engine'. Removing cache data. Helix Sync may be slow. It may also get axed. We'll see. « |
10 years ago |