moonrope 1.4.1 → 2.0.0

data/templates/basic/_structure_attributes_list.erb

@@ -0,0 +1,55 @@
+<table class='table paramTable'>
+  <thead>
+    <tr>
+      <th width="45%">Attribute</th>
+      <th width="20%">Type</th>
+      <th width="35%">Example</th>
+    </tr>
+  </thead>
+  <% for attribute in attributes %>
+  <tr>
+    <td>
+      <p>
+        <span class='paramTable__name'><%= attribute.name_with_groups %></span>
+      </p>
+      <% if attribute.description %>
+        <p class='paramTable__description'><%= attribute.description %></p>
+      <% end %>
+
+      <% conditions = attribute.conditions.map { |c| structure.description_for_condition(c) }.compact %>
+      <% unless conditions.empty? %>
+        <ul class='paramTable__restrictedList'>
+          <% for condition in conditions %>
+          <li><%= condition %></li>
+          <% end %>
+        </ul>
+      <% end %>
+    </td>
+    <td><%= friendly_type(attribute.value_type) %></td>
+    <td>
+      <% if substructure = attribute.structure %>
+        <a class='link' href="<%= path("structures/#{substructure}.html")%>"><%= humanize(substructure.to_s.capitalize) %> structure</a>
+      <% else %>
+        <%= attribute.example %>
+      <% end %>
+    </td>
+  </tr>
+  <% end %>
+
+  <% if vars[:expansions] && !vars[:expansions].empty? %>
+  <% for name, expansion in vars[:expansions] %>
+  <tr>
+    <td>
+      <p>
+        <span class='paramTable__name'><%= name %></span>
+      </p>
+      <% if expansion[:description] %>
+        <p class='paramTable__description'><%= expansion[:description] %></p>
+      <% end %>
+    </td>
+    <td><%= friendly_type(expansion[:type]) %></td>
+    <td><%= expansion[:eg] || expansion[:example] %></td>
+  </tr>
+  <% end %>
+  <% end %>
+</table>

data/templates/basic/action.erb

@@ -0,0 +1,168 @@
+<% set_page_title "#{action.title || action.name} - #{action.controller.friendly_name || action.controller.name}" %>
+<% set_active_nav "controller-#{controller.name}" %>
+
+<h1><%= action.title || action.name %></h1>
+<% if action.description %>
+<p class='text'><%= action.description %></p>
+<% end %>
+
+<%= partial 'action_form', :controller => controller, :action => action %>
+
+<h2>URL</h2>
+<p class='apiURLFull'><span><%= full_prefix %>/</span><%= action.controller.name %>/<%= action.name %></p>
+
+<% if action.authenticator_to_use.is_a?(Moonrope::Authenticator) %>
+<% if rule = action.authenticator_to_use.rules[action.access_rule_to_use] %>
+<% if rule[:description] %>
+  <h2>Access</h2>
+  <p class='text'>
+    <%= rule[:description] %>
+    <% if rule[:error_code] %>
+    If not authorised, a <code><%= rule[:error_code] %></code> error will be returned.
+    <% end %>
+  </p>
+<% end %>
+<% end %>
+<% end %>
+
+<h2>Parameters</h2>
+<% if action.params.empty? %>
+  <p><em>This action doesn't support any parameters.</em></p>
+<% else %>
+  <table class='table paramTable'>
+    <thead>
+      <tr>
+        <th width="60%">Parameter</th>
+        <th width="20%">Type</th>
+        <th width="20%">Default</th>
+      </tr>
+    </thead>
+    <% for name, param in action.params %>
+    <tr>
+      <td>
+        <p>
+          <span class='paramTable__name'><%= name %></span>
+          <% if param[:required] && param[:default].nil? %><span class='paramTable__req'>Required</span><% end %>
+        </p>
+        <% if param[:description] %>
+          <p class='paramTable__description'><%= param[:description] %></p>
+        <% end %>
+      </td>
+      <td><%= friendly_type(param[:type]) %></td>
+      <td>
+        <% if param[:default].nil? %>
+          <span class='paramTable__nil'>null</span>
+        <% else %>
+          <%= param[:default] %>
+        <% end %>
+      </td>
+    </tr>
+    <% end %>
+  </table>
+<% end %>
+
+<% unless action.filters.empty? %>
+<h2>Filtering</h2>
+<p class='text'>
+  This action supports filtering. You can filter the results which you receive by
+  providing filters in the <code>filters</code> parameter. The following attributes
+  are supported for filtering.
+</p>
+<table class='table paramTable'>
+  <thead>
+    <tr>
+      <th width="40%">Attribute</th>
+      <th width="60%">Supported Operators</th>
+    </tr>
+  </thead>
+  <% for name, filter in action.filters %>
+  <tr>
+    <td><span class='paramTable__name'><%= name %></span></td>
+    <td><%= filter[:operators].map(&:to_s).join(', ') %></td>
+  </tr>
+  <% end %>
+</table>
+<% end %>
+
+<h2>Errors</h2>
+
+<% if action.errors.empty? %>
+  <p><em>There are no action-specific errors which can be raised.</em></p>
+<% else %>
+  <%= partial "errors_table", :errors => action.errors %>
+<% end %>
+
+<% if action.returns %>
+<h2>Response Data</h2>
+<% if action.returns[:structure] %>
+  <% if action.returns[:type] == :array %>
+    <p class='text'>This action will return an array of <a class='link' href='<%= path("structures/#{action.returns[:structure]}") %>'><%= humanize(action.returns[:structure]) %> structures</a>.</p>
+  <% else %>
+    <p class='text'>This action will return a <a class='link' href='<%= path("structures/#{action.returns[:structure]}") %>'><%= humanize(action.returns[:structure]) %> structure</a>.</p>
+  <% end %>
+
+  <% if opts = action.returns[:structure_opts] %>
+    <% if opts[:paramable] == true %>
+      <p class='text'>
+        You'll receive this structure in the most basic form, without extended data or
+        any expansions. You can choose to receive extended attributes by providing the <code>_full</code> parameter. You can
+        also choose to receive any expansions by providing an array in the <code>_expansions</code>
+        parameter. A full list of expansions can be found on the
+        <a class='link' href='<%= path("structures/#{action.returns[:structure]}") %>'>structure page</a>.
+      </p>
+    <% elsif opts[:paramable].is_a?(Hash) %>
+      <p class='text'>
+        <% if opts[:paramable].has_key?(:full) %>
+          <% if opts[:paramable][:full] %>
+          You'll receive all extended data with this structure, by default.
+          <% else %>
+          You won't receive any extended data with this structure, by default.
+          <% end %>
+          You can change this behaviour by passing true or false in the <code>_full</code>
+          parameter on the request.
+        <% else %>
+        You will only receive basic data for this structure, no extended data is available.
+        <% end %>
+
+        <% if opts[:paramable].has_key?(:expansions) %>
+          <% if opts[:paramable][:expansions].is_a?(Array) %>
+          By default, you'll receive expansions for <b><%= opts[:paramable][:expansions].join(', ') %></b>.
+          You can change these by providing an array of expansion names in the <code>_expansions</code>
+          parameter on the request.
+          <% elsif opts[:paramable][:expansions] == true %>
+          By default, you'll receive all expansions for the structure. You remove any/all of them by
+          providing an array of new expansion names in the <code>_expansions</code> parameter on the
+          request.
+          <% elsif opts[:paramable][:expansions] == false %>
+          By default, you'll receive no expansions for the structure. You can add them by providing
+          an array of new expansion names in the <code>_expansions</code> parameter on the request.
+          You can send <code>true</code> rather than array to receive all expansions.
+          <% end %>
+        <% else %>
+        No expansions will be provided.
+        <% end %>
+      </p>
+    <% else %>
+      <% if opts[:full] %>
+      You'll receive all attributes for this structure (basic and extended attributes).
+      <% else %>
+      You'll only receive basic attributes for this structure.
+      <% end %>
+      <% if opts[:expansions].is_a?(Array) %>
+      You'll receive expansions for <b><%= opts[:expansions].join(', ') %></b>.
+      <% elsif opts[:expansions] == true %>
+      You'll receive all expansions for this stucture.
+      <% end %>
+    <% end %>
+  <% else %>
+    You'll receive just the basic attributes for this structure. No expansions are provided.
+  <% end %>
+<% else %>
+  <p class='text'>
+    This action will return a <%= friendly_type(action.returns[:type]) %>.
+  </p>
+  <% if eg = (action.returns[:eg] || action.returns[:example]) %>
+  <pre class='code'><%= eg %></pre>
+  <% end %>
+<% end %>
+<% end %>

data/templates/basic/assets/lock.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8" viewBox="0 0 8 8">
+  <path fill="#ed4300" d="M3 0c-1.1 0-2 .9-2 2v1h-1v4h6v-4h-1v-1c0-1.1-.9-2-2-2zm0 1c.56 0 1 .44 1 1v1h-2v-1c0-.56.44-1 1-1z" transform="translate(1)" />
+</svg>

data/templates/basic/assets/reset.css

@@ -0,0 +1,101 @@
+html, body, body div, span, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, abbr, address, cite, code, del, dfn, em, img, ins, kbd, q, samp, small, strong, sub, sup, var, b, i, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, figure, footer, header, hgroup, menu, nav, section, time, mark, audio, video {
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	font-size: 100%;
+	letter-spacing:0;
+	vertical-align: baseline;
+	background: transparent;
+	font-weight:inherit;
+}
+
+* {
+	-webkit-box-sizing: border-box;
+	-moz-box-sizing: border-box;
+	box-sizing: border-box;
+}
+u { text-decoration: none;}
+b { font-weight:normal;}
+article, aside, figure, footer, header, hgroup, nav, section {display: block;}
+
+object,embed {max-width: 100%;}
+ul {list-style: none;}
+blockquote, q {quotes: none;}
+b,strong { font-weight:bold;}
+blockquote:before, blockquote:after, q:before, q:after {content: ''; content: none;}
+
+a {margin: 0; padding: 0; font-size: 100%; vertical-align: baseline; background: transparent;}
+
+del {text-decoration: line-through;}
+
+abbr[title], dfn[title] {border-bottom: 1px dotted #000; cursor: help;}
+
+/* tables still need cellspacing="0" in the markup */
+table {border-collapse: collapse; border-spacing: 0;}
+mark { color:inherit;}
+
+hr {display: block; height: 1px; border: 0; border-top: 1px solid #ccc; margin: 1em 0; padding: 0;}
+
+input, select {vertical-align: middle;}
+
+pre {
+	white-space: pre; /* CSS2 */
+	white-space: pre-wrap; /* CSS 2.1 */
+	white-space: pre-line; /* CSS 3 (and 2.1 as well, actually) */
+	word-wrap: break-word; /* IE */
+}
+
+input[type="radio"] {vertical-align: text-bottom;}
+input[type="checkbox"] {vertical-align: bottom; *vertical-align: baseline;}
+.ie6 input {vertical-align: text-bottom;}
+
+select, input, textarea {font: 99% sans-serif;}
+
+table {font-size: inherit; font: 100%;}
+
+/* Accessible focus treatment
+	people.opera.com/patrickl/experiments/keyboard/test */
+a:hover, a:active {outline: none;}
+
+small {font-size: 85%;}
+
+strong, th {font-weight: bold;}
+
+td, td img {vertical-align: top;}
+
+/* Make sure sup and sub don't screw with your line-heights
+	gist.github.com/413930 */
+sub, sup {font-size: 75%; line-height: 0; position: relative;}
+sup {top: -0.5em;}
+sub {bottom: -0.25em;}
+
+/* standardize any monospaced elements */
+pre, code, kbd, samp {font-family: monospace, sans-serif;}
+
+/* hand cursor on clickable elements */
+.clickable,
+label,
+input[type=button],
+input[type=submit],
+button {cursor: pointer;}
+
+/* Webkit browsers add a 2px margin outside the chrome of form elements */
+button, input, select, textarea {margin: 0;}
+
+/* make buttons play nice in IE */
+button {width: auto; overflow: visible;}
+
+/* scale images in IE7 more attractively */
+.ie7 img {-ms-interpolation-mode: bicubic;}
+
+/* prevent BG image flicker upon hover */
+.ie6 html {filter: expression(document.execCommand("BackgroundImageCache", false, true));}
+
+/* let's clear some floats */
+.clearfix:before, .clearfix:after { content: "\0020"; display: block; height: 0; overflow: hidden; }
+.clearfix:after { clear: both; }
+.clearfix { zoom: 1; }
+
+select, input, textarea, a { outline: none;}
+a { color:inherit;}

data/templates/basic/assets/style.css

@@ -0,0 +1,348 @@
+html {
+  font-family: Lato, Arial, sans-serif;
+  font-size:16px;
+}
+
+a {
+  text-decoration: none;
+}
+
+.sidebarBackground {
+  background:#2f3e4d;
+  width:200px;
+  position:fixed;
+  top:0;
+  bottom:0;
+  z-index:1;
+}
+
+.sidebar {
+  width:200px;
+  float:left;
+  z-index:10;
+  position:absolute;
+}
+.sidebar a {
+  display:block;
+  padding:7px 15px;
+  border-bottom:1px solid #394959;
+  color:#889db1;
+  font-size:85%;
+}
+
+.sidebar a:hover {
+  background-color:#26323f;
+}
+
+.sidebar a.active {
+  background-color:#1d2630;
+  color:#fff;
+}
+
+.footer {
+  margin-left:200px;
+  border-top:3px solid #efefef;
+  padding:20px 40px 100px 40px;
+  font-size:90%;
+  color:#999;
+}
+
+.content {
+  margin-left:200px;
+  padding:40px;
+  padding-right:15%;
+}
+
+
+.content h1 {
+  font-size:32px;
+  font-weight:900;
+  margin-bottom:15px;
+}
+
+.content h2 {
+  font-size:24px;
+  font-weight:700;
+  color:#f65552;
+  margin-bottom:10px;
+  margin-top:30px;
+}
+
+.content h3 {
+  font-size:18px;
+  font-weight:700;
+  color:#888;
+  margin-bottom:10px;
+  margin-top:30px;
+}
+
+.content p.text {
+  line-height:1.5;
+  margin-bottom:15px;
+}
+
+
+.content .standardList {
+  margin-bottom:15px;
+  line-height:1.5;
+}
+
+.content .standardList li {
+  list-style:square;
+  margin-bottom:15px;
+  margin-left:35px;
+}
+
+.content code {
+  font-family:'Droid Sans Mono', fixed;
+  color:#f65552;
+  padding:1px 2px;
+  font-size:90%;
+}
+
+.content pre.code {
+  font-family:'Droid Sans Mono', fixed;
+  white-space: pre;
+  background:#efefef;
+  padding:10px 10px 10px;
+  font-size:90%;
+  margin-bottom:15px;
+  border-radius:7px 7px 7px 7px;
+}
+
+.content pre.code span.jsonKey {
+  color:#7f55ad;
+  font-weight:bold;
+}
+
+.content pre.code span.jsonString {
+  color:#9eb503;
+}
+
+.content pre.code span.jsonComment {
+  color:#bbb;
+  font-style:italic;
+}
+
+.content a.link {
+  color:#2d80c8;
+  font-weight:700;
+  border-bottom:1px solid #2d80c8;
+}
+
+.content p.apiURL span {
+  color:#aaa;
+}
+
+.table {
+  width:100%;
+}
+
+.table th, .table td {
+  border-bottom:1px solid #ccc;
+  text-align: left;
+  padding:7px 0;
+}
+
+.table th {
+  border-bottom:2px solid #666;
+  font-size:90%;
+}
+
+.paramTable__req {
+  background:#ea4c89;
+  color:#fff;
+  font-weight:bold;
+  font-size:10px;
+  text-transform: uppercase;
+  padding:1px 3px;
+  border-radius: 2px;
+  vertical-align: 1px;
+  margin-left:5px;
+}
+
+.paramTable__field {
+  width:100%;
+  border:0;
+  padding:0;
+  font:inherit;
+  color:#7f55ad;
+}
+
+.paramTable__description {
+  font-size:90%;
+  color:#999;
+  margin-top:3px;
+}
+
+.paramTable__name {
+  font-family:'Droid Sans Mono', fixed;
+  font-size:90%;
+}
+
+.paramTable__restrictedList {
+  font-size:80%;
+  margin-top:7px;
+  background:url(lock.svg) no-repeat 0 1px;
+  background-size:14px;
+  color:#ed4300;
+  padding-left:20px;
+}
+
+.paramTable__nil {
+  color:#ccc;
+  font-size:90%;
+}
+
+.apiURLFull {
+  font-size:110%;
+  font-weight:bold;
+}
+
+.apiURLFull span {
+  color:#aaaaaa;
+  font-weight:normal;
+}
+
+.errorAttributeList {
+  font-size:80%;
+}
+
+.errorAttributeList li {
+  margin-bottom:8px;
+  list-style:square;
+  margin-left:16px;
+}
+.errorAttributeList li:last-child {
+  margin-bottom:0;
+}
+
+.errorAttributeList__name {
+  font-family:'Droid Sans Mono', fixed;
+}
+
+.errorAttributeList__desc {
+  color:#999;
+}
+
+/* Try Action Form */
+
+.tryForm {
+  display:none;
+  border:2px solid #ccc;
+  background:#f7f7f7;
+  border-radius:7px;
+  overflow: hidden;
+}
+
+.tryForm__header {
+  background:#ddd;
+  padding:15px 25px;
+  font-weight:700;
+  color:#999;
+
+}
+
+.tryForm__header input {
+  background:none;
+  border:0;
+  padding:0;
+  vertical-align:0px;
+  font:inherit;
+  font-weight:700;
+  color:#000;
+  width:auto;
+}
+
+.tryForm__output {
+  display:none;
+  background:#111;
+  color:#fff;
+  padding:15px;
+  font-family:'Droid Sans Mono', fixed;
+  white-space: pre;
+  word-wrap:normal;
+  font-size:90%;
+  overflow-x:auto;
+}
+
+.tryForm__output--success {
+  border-top:7px solid #68be28;
+}
+
+.tryForm__output--error {
+  border-top:7px solid #d4172e;
+}
+
+.tryForm__heading {
+  border-bottom:1px solid #ddd;
+  border-top:4px solid #aaa;
+  margin-bottom:15px;
+  padding:8px 25px;
+  background:#efefef;
+  font-weight:700;
+  font-size:80%;
+  text-transform: uppercase;
+  color:#888;
+}
+
+.tryForm__table {
+  font-size:90%;
+  width:calc(100% - 50px);
+  margin:0 25px;
+  margin-bottom:15px;
+}
+
+.tryForm__table td {
+  padding:5px 0;
+  background:#f8f8f8;
+}
+
+.tryForm__tableField {
+  border:0;
+  background:none;
+  border-bottom:1px solid #ccc;
+  padding:0;
+  padding-bottom:4px;
+  width:100%;
+  font:inherit;
+  color:#7f55ad;
+  font-weight:700;
+}
+
+.tryForm__tableField:focus {
+  border-color:#7f55ad;
+}
+
+.tryForm__button {
+  margin:15px 25px;
+  text-align: right;
+}
+
+.tryFormActivate {
+  margin:20px 0;
+}
+.tryFormActivate__button {
+  background:url(tool.svg) #fffce0 no-repeat 12px 7px;
+  background-size:12px;
+  border:1px solid #dad7bb;
+  color:#6c6a55;
+  border-radius:4px;
+  padding:6px 12px 6px 30px;
+  font-size:12px;
+  font-weight:700;
+}
+
+.tryForm__checkbox {
+  margin-bottom:4px;
+}
+
+.tryForm__checkbox:last-child {
+  margin-bottom:0;
+}
+
+.tryForm__checkbox input {
+  float:left;
+  margin-right:4px;
+  margin-top:4px;
+}

data/templates/basic/assets/tool.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8" viewBox="0 0 8 8">
+  <path fill="#6c6a55" d="M5.5 0c-1.38 0-2.5 1.12-2.5 2.5 0 .32.08.62.19.91l-2.91 2.88c-.39.39-.39 1.05 0 1.44.2.2.46.28.72.28.26 0 .52-.09.72-.28l2.88-2.91c.28.11.58.19.91.19 1.38 0 2.5-1.12 2.5-2.5 0-.16 0-.32-.03-.47l-.97.97h-2v-2l.97-.97c-.15-.03-.31-.03-.47-.03zm-4.5 6.5c.28 0 .5.22.5.5s-.22.5-.5.5-.5-.22-.5-.5.22-.5.5-.5z"
+  />
+</svg>