fresno 0.0.2-java → 0.0.3-java

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/Rakefile

@@ -0,0 +1,150 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+task :default => :test
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/fresno.gemspec

@@ -0,0 +1,88 @@
+## This is the rakegem gemspec template. Make sure you read and understand
+## all of the comments. Some sections require modification, and others can
+## be deleted if you don't need them. Once you understand the contents of
+## this file, feel free to delete any comments that begin with two hash marks.
+## You can find comprehensive Gem::Specification documentation, at
+## http://docs.rubygems.org/read/chapter/20
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+  s.platform = 'java'
+  
+  ## Leave these as is they will be modified for you by the rake gemspec task.
+  ## If your rubyforge_project name is different, then edit it and comment out
+  ## the sub! line in the Rakefile
+  s.name              = 'fresno'
+  s.version           = '0.0.3'
+  s.date              = '2012-11-10'
+  s.rubyforge_project = 'fresno'
+
+  ## Make sure your summary is short. The description may be as long
+  ## as you like.
+  s.summary     = "Framework for scripting FRC bots."
+  s.description = "Framework for scripting FRC bots with Mirah."
+
+  ## List the primary authors. If there are a bunch of authors, it's probably
+  ## better to set the email to an email list or something. If you don't have
+  ## a custom homepage, consider using your GitHub URL or the like.
+  s.authors  = ["Jeremy McAnally"]
+  s.email    = 'jeremy@github.com'
+  s.homepage = 'http://github.com/jm/fresno'
+
+  ## This gets added to the $LOAD_PATH so that 'lib/NAME.rb' can be required as
+  ## require 'NAME.rb' or'/lib/NAME/file.rb' can be as require 'NAME/file.rb'
+  s.require_paths = %w[lib]
+
+  ## This sections is only necessary if you have C extensions.
+  # s.require_paths << 'ext'
+  # s.extensions = %w[ext/extconf.rb]
+
+  ## If your gem includes any executables, list them here.
+  s.executables = ["fresno"]
+
+  ## Specify any RDoc options here. You'll want to add your README and
+  ## LICENSE files to the extra_rdoc_files list.
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = %w[README.md LICENSE]
+
+  ## List your runtime dependencies here. Runtime dependencies are those
+  ## that are needed for an end user to actually USE your code.
+  s.add_dependency('mirah')
+
+  ## List your development dependencies here. Development dependencies are
+  ## those that are only needed during development
+  s.add_development_dependency('contest')
+
+  ## Leave this section as-is. It will be automatically generated from the
+  ## contents of your Git repository via the gemspec task. DO NOT REMOVE
+  ## THE MANIFEST COMMENTS, they are used as delimiters by the task.
+  # = MANIFEST =
+  s.files = %w[
+    Gemfile
+    LICENSE
+    README.md
+    Rakefile
+    bin/fresno
+    fresno.gemspec
+    lib/fresno.rb
+    lib/fresno/app_generator.rb
+    lib/fresno/generator_data/BSD_FOR_WPILIB
+    lib/fresno/generator_data/MITLICENSE
+    lib/fresno/generator_data/README.md.template
+    lib/fresno/generator_data/build.properties.template
+    lib/fresno/generator_data/build.xml.template
+    lib/fresno/generator_data/command.mirah.template
+    lib/fresno/generator_data/gitignore.template
+    lib/fresno/generator_data/iterative.mirah.template
+    lib/fresno/generator_data/netbeans.template
+    lib/fresno/generator_data/simple.mirah.template
+    src/extensions/fields.mirah
+    src/fresno.mirah
+  ]
+  # = MANIFEST =
+
+  ## Test files will be grabbed from the file list. Make sure the path glob
+  ## matches what you actually use.
+  s.test_files = s.files.select { |path| path =~ /^test\/test_.*\.rb/ }
+end

data/lib/fresno.rb

@@ -0,0 +1,7 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'fresno/app_generator'
+
+module Fresno
+  VERSION = '0.0.3'
+end

data/lib/fresno/app_generator.rb

@@ -0,0 +1,59 @@
+require 'fileutils'
+
+module Fresno
+  class AppGenerator < Thor
+    include Thor::Actions
+
+    def self.source_root
+      @source_root ||= File.join(File.dirname(__FILE__), 'generator_data')
+    end
+
+    def initialize(args=[], options={}, config={})
+      @args = args
+      @options = options
+      @config = config
+    end
+
+    no_tasks do
+      def generate(name)
+        @name = name
+        puts "Generating new project in `#{name}`..."
+        puts
+
+        # Where are these files going?
+        self.destination_root = File.join(Dir.pwd, name)
+
+        # Build files for Ant
+        template('build.xml.template', "build.xml")
+        template('build.properties.template', "build.properties")
+
+        # Which project template are we starting with?
+        robot_filename = "src/#{@name.capitalize}Robot.mirah"
+        if @options["command"]
+          template('command.mirah.template', robot_filename)          
+        elsif @options["simple"]
+          template('simple.mirah.template', robot_filename)
+        else
+          template('iterative.mirah.template', robot_filename)
+        end
+
+        # IDE MADNESS
+        if @options["netbeans"]
+          template('netbeans.template', "netbeans/project.xml")
+        end
+        
+        # Licenses!
+        copy_file "MITLICENSE", "LICENSE"
+        copy_file "BSD_FOR_WPILIB", "WPILIB_LICENSE"
+
+        # Git goodness
+        copy_file "gitignore.template", ".gitignore"
+
+        template('README.md.template', "README.md")
+
+        puts
+        puts "All done!"
+      end
+    end
+  end
+end

data/lib/fresno/generator_data/BSD_FOR_WPILIB

@@ -0,0 +1,24 @@
+* Copyright (c) 2009 FIRST
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without
+* modification, are permitted provided that the following conditions are met:
+*     * Redistributions of source code must retain the above copyright
+*       notice, this list of conditions and the following disclaimer.
+*     * Redistributions in binary form must reproduce the above copyright
+*       notice, this list of conditions and the following disclaimer in the
+*       documentation and/or other materials provided with the distribution.
+*     * Neither the name of the FIRST nor the
+*       names of its contributors may be used to endorse or promote products
+*       derived from this software without specific prior written permission.
+*
+* THIS SOFTWARE IS PROVIDED BY FIRST AND CONTRIBUTORS``AS IS'' AND ANY
+* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+* WARRANTIES OF MERCHANTABILITY NONINFRINGEMENT AND FITNESS FOR A PARTICULAR 
+* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL FIRST OR CONTRIBUTORS BE LIABLE FOR 
+* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/lib/fresno/generator_data/MITLICENSE

@@ -0,0 +1,7 @@
+Copyright (c) <%= Time.now.year %> [[YOUR NAME HERE!]]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/fresno/generator_data/README.md.template

@@ -0,0 +1,9 @@
+<%= @name %>
+===========
+
+Our robot...
+
+And it will also...
+
+And yeah, it'll totally...
+

data/lib/fresno/generator_data/build.properties.template

@@ -0,0 +1 @@
+user.classpath=${wpilibj.home}/src

data/lib/fresno/generator_data/build.xml.template

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!-- 
+
+  Some useful command line properties:
+              
+    -Dbasestation.addr=1234   set the address of the basestation
+    -DremoteId=1234           set the target for remote run/deploy/debug-proxy-run
+    -Dsquawk.startup.class=com.example.MyStartUp
+                              set an alternative startup class name
+    -Dspotport=COM2           set the port name for communicating with the SPOT
+    -Djar.file=example.jar    set the jar file for jar-app, jar-deploy and make-host-jar
+    -Dmidlet=2                select a midlet to run for selectapplication
+                              or deploy targets (defaults to 1)
+    -Dutility.jars=utils.jar  a classpath separator delimited list of jars to be 
+                              included with the application
+
+-->
+
+<project basedir="." default="help" name="<%= @name.capitalize %>Project">
+    <!-- 
+    
+    If you want to change your source directory, uncomment the
+    following:
+    
+    <property name="src.dir" value="mysrc"/> 
+    
+    -->
+
+    <property name="user.properties.file" value="build.properties"/>
+    <property file="${user.home}/.sunspotfrc.properties"/>
+
+    <!--
+
+    This setup requires the master Sun SPOT build file, but if you
+    don't have the property file set for some reason, you can use
+    the following property to specify it explicitly:
+
+    <property name="sunspot.home" value="/opt/sunspot"/>
+    
+    -->
+
+    <import file="${sunspot.home}/build.xml"/>
+
+    <!--
+
+    This file imports the master build file for compiling and deploying sunspot
+    applications.  This file provides hooks for the user build file, so that
+    you can accomplish almost anything without having to rewrite any of the
+    build procedures.  However, if need be, you can just look at the imported
+    build file to determine how exactly any step is accomplished.
+
+    There exist several targets which are by default empty and which can be 
+    used for execution of your tasks. These targets are usually executed 
+    before and after some main targets. They are defined as follows:
+
+    For each target above (except help),
+
+        -pre-<target>:  called before the target
+        -post-<target>: called after the target
+
+    For example, inserting an echo statement after compilation could look like this:
+
+        <target name="-post-compile">
+            <echo>Compile finished!</echo>
+        </target>    
+
+    For more information on using ant, see http://ant.apache.org.
+
+    -->
+
+    <!--
+
+    Compile the Mirah files down to Java.
+
+    -->
+    <target name="-pre-compile">
+        <exec executable="mirahc" dir="src">
+            <arg value="--java" />
+            <arg line="--classpath ${sunspot.classpath}:${sunspot.bootclasspath}" />
+            <arg value="." />
+        </exec>
+    </target>
+
+</project>

data/lib/fresno/generator_data/command.mirah.template

@@ -0,0 +1 @@
+# TODO

data/lib/fresno/generator_data/gitignore.template

@@ -0,0 +1,2 @@
+/build
+*.class

data/lib/fresno/generator_data/iterative.mirah.template

@@ -0,0 +1,25 @@
+#
+# <%= @name.capitalize %>Robot
+# Iterative robot class
+#
+# Based on IterativeRobotTemplate that is
+# Copyright (c) FIRST 2008. All Rights Reserved.
+# 
+package org.fresnoframework.<%= @name.downcase %>
+
+import edu.wpi.first.wpilibj.IterativeRobot
+
+class <%= @name.capitalize %>Robot < IterativeRobot
+  def robotInit:void
+  end
+
+  # Called periodically during autonomous control
+  def autonomousPeriodic:void
+
+  end
+
+  # Called periodically during operator control
+  def teleopPeriodic:void
+  
+  end
+end

data/lib/fresno/generator_data/netbeans.template

@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8"?>
+    <!--
+
+    This is a sample netbeans project file for a Sun Spot Application project.
+    You may edit it freely, it doesn't affect the ant-powered build.
+
+    -->
+
+    <project xmlns="http://www.netbeans.org/ns/project/1">
+    
+    <type>org.netbeans.modules.ant.freeform</type>
+    <configuration>
+        <general-data xmlns="http://www.netbeans.org/ns/freeform-project/1">
+            <name><%= @name.capitalize %>RobotProject</name>
+            <properties>
+                <property-file>${user.home}/.sunspotfrc.properties</property-file>
+                <property-file>build.properties</property-file>
+                <property-file>${sunspot.home}/default.properties</property-file>
+            </properties>
+            <folders>
+                <source-folder>
+                    <label>src</label>
+                    <type>java</type>
+                    <location>src</location>
+                </source-folder>
+            </folders>
+            <ide-actions>
+                <action name="build">
+                    <target>jar-app</target>
+                </action>
+                <action name="clean">
+                    <target>clean</target>
+                </action>
+                <action name="run">
+                    <target>deploy</target>
+                    <target>run</target>
+                </action>
+                <action name="rebuild">
+                    <target>clean</target>
+                    <target>jar-app</target>
+                </action>
+                <action name="debug">
+                    <target>deploy</target>
+                    <target>debug-run</target>
+                </action>
+                <action name="javadoc">
+                    <target>javadoc</target>
+                </action>
+            </ide-actions>
+            <export>
+                <type>folder</type>
+                <location>build</location>
+                <build-target>jar-app</build-target>
+            </export>
+            <view>
+                <items>
+                    <source-folder style="packages">
+                        <label>src</label>
+                        <location>src</location>
+                    </source-folder>
+                    <source-file>
+                        <location>build.xml</location>
+                    </source-file>
+                </items>
+                <context-menu>
+                    <ide-action name="build"/>
+                    <ide-action name="clean"/>
+                    <ide-action name="run"/>
+                    <ide-action name="rebuild"/>
+                    <ide-action name="debug"/>
+                    <ide-action name="javadoc"/>
+                    <action>
+                        <label>Sun SPOT-deploy</label>
+                        <target>deploy</target>
+                    </action>
+                    <action>
+                        <label>Sun SPOT-jar-deploy</label>
+                        <target>jar-deploy</target>
+                    </action>
+                    <separator/>
+                </context-menu>
+            </view>
+            <subprojects/>
+        </general-data>
+        <java-data xmlns="http://www.netbeans.org/ns/freeform-project-java/1">
+            <compilation-unit>
+                <package-root>src</package-root>
+                <classpath mode="boot">${sunspot.bootclasspath}</classpath>
+                <classpath mode="compile">${wpilibj.home}/classes.jar</classpath>
+                <built-to>build</built-to>
+                <source-level>1.4</source-level>
+            </compilation-unit>
+        </java-data>
+    </configuration>
+</project>

data/lib/fresno/generator_data/simple.mirah.template

@@ -0,0 +1,23 @@
+#
+# <%= @name.capitalize %>Robot
+# Simple robot class
+#
+# Based on SimpleRobotTemplate that is
+# Copyright (c) FIRST 2008. All Rights Reserved.
+# 
+package org.fresnoframework.<%= @name.downcase %>
+
+import edu.wpi.first.wpilibj.SimpleRobot
+
+class <%= @name.capitalize %>Robot < SimpleRobot
+  # Called when the robot enters autonomous controller
+  def autonomous:void
+
+  end
+
+  # Called when the robot enters operator control
+  def operatorControl:void
+
+  end
+end
+

data/src/extensions/fields.mirah

@@ -0,0 +1,32 @@
+package org.fresnoframework.extensions.fields
+
+# Add the ability to have fields a la attr_accessor in Ruby
+# Implementation based on: http://www.mirah.org/wiki/Macros
+#
+#   class Robot
+#     implements Fields
+#
+#     field :name, :string
+#     field :team, :int
+#   end
+#   
+#   r = Robot.new
+#   r.name = "Mr. Awesometron 9000"
+#   puts r
+#   # => "Mr. Awesometron 9000"
+#
+interface Fields do
+  macro def field(name_node, type)
+    name = name_node.string_value
+
+    quote do
+      def `name`
+        @`name`
+      end
+
+      def `"#{name}_set"`(value:`type`)
+        @`name` = value
+      end
+    end
+  end
+end

data/src/fresno.mirah

@@ -0,0 +1 @@
+# TODO: Start adding convenience classes

metadata

@@ -2,7 +2,7 @@
 name: fresno
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.2
+  version: 0.0.3
 platform: java
 authors: 
   - Jeremy McAnally
@@ -45,9 +45,26 @@ extra_rdoc_files:
   - README.md
   - LICENSE
 files: 
-  - bin/fresno
-  - README.md
+  - Gemfile
   - LICENSE
+  - README.md
+  - Rakefile
+  - bin/fresno
+  - fresno.gemspec
+  - lib/fresno.rb
+  - lib/fresno/app_generator.rb
+  - lib/fresno/generator_data/BSD_FOR_WPILIB
+  - lib/fresno/generator_data/MITLICENSE
+  - lib/fresno/generator_data/README.md.template
+  - lib/fresno/generator_data/build.properties.template
+  - lib/fresno/generator_data/build.xml.template
+  - lib/fresno/generator_data/command.mirah.template
+  - lib/fresno/generator_data/gitignore.template
+  - lib/fresno/generator_data/iterative.mirah.template
+  - lib/fresno/generator_data/netbeans.template
+  - lib/fresno/generator_data/simple.mirah.template
+  - src/extensions/fields.mirah
+  - src/fresno.mirah
 has_rdoc: true
 homepage: http://github.com/jm/fresno
 licenses: []