Project

General

Profile

unexist.dev

/

subtle

Assorted tidbits and projects

Specification » History » Version 1

Anonymous, 09/23/2010 05:54 PM

1 1
h1. Specification\015\012\015\012{{>toc}}\015\012\015\012In order to create a sublet, you need to create a [[specification]] which basically contains some information about your sublet. \015\012\015\012h2. Attributes\015\012\015\012Here is a list of known attributes:\015\012\015\012h3. name\015\012\015\012Name of the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.name = "Sublet"\015\012</code></pre>\015\012\015\012h3. authors\015\012\015\012List of authors of the sublet in case there are more than one\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012  spec.authors = [ "You" ]\015\012</code></pre>\015\012\015\012h3. date\015\012\015\012Date of creation\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.date = "Sat Sep 13 19:00 CET 2008"\015\012</code></pre>\015\012\015\012h3. contact\015\012\015\012Contact mail address\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.contact = "your@mail.com"\015\012</code></pre>\015\012\015\012h3. description\015\012\015\012Short description of the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.description = "A shiny new sublet"\015\012</code></pre>\015\012\015\012h3. notes\015\012\015\012Longer description of the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.notes = <<NOTES\015\012This sublet is just a dummy, have fun with it!\015\012NOTES\015\012</code></pre>\015\012\015\012h3. version\015\012\015\012Version of the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.version = "0.1"\015\012</code></pre>\015\012\015\012h3. tags\015\012\015\012List of tags to categorize the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.tags = [ "Broken" ]\015\012</code></pre>\015\012\015\012h3. files\015\012\015\012List of files in the sublet\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.files = [ "sublet.rb" ]\015\012</code></pre>\015\012\015\012h3. icons\015\012\015\012List of supplied icons\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.icons = [ "icon.xbm" ]\015\012</code></pre>\015\012\015\012h3. subtlext_version\015\012\015\012Required version of subtlext\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.subtlext_version = "0.9.10"\015\012</code></pre>\015\012\015\012h3. sur_version\015\012\015\012Required version of sur\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.sur_version = "0.2.3"\015\012</code></pre>\015\012\015\012h3. add_dependency(name, version)\015\012\015\012Add a gem dependency\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012spec.add_dependency("a_gem", "0.0")\015\012</code></pre>\015\012\015\012h2. Template\015\012\015\012If you use the *template* command [[sur]] will create an empty template with a spec file.\015\012\015\012+Example+:\015\012<pre><code class="ruby">\015\012# Dummy specification file\015\012# Created with sur-0.2.155\015\012Sur::Specification.new do |s|\015\012  s.name             = "Dummy"\015\012  s.authors          = [ "Christoph Kappel" ]\015\012  s.date             = "Sat Sep 13 19:00 CET 2008"\015\012  s.contact          = "unexist@dorfelite.net"\015\012  s.description      = "Does nothing"\015\012  s.version          = "0.0"\015\012  s.tags             = [ "Dummy" ]\015\012  s.files            = [ "dummy.rb" ]\015\012  s.icons            = [ "icons/dummy.xbm" ]\015\012\015\012  # Required versions\015\012  s.subtlext_version = "0.9.1883"\015\012  s.sur_version      = "0.2.155"\015\012\015\012  # Add gem requirements\015\012  s.add_dependency("a_gem", "0.0")\015\012end\015\012</code></pre>