canoe 0.2.3 → 0.3.1

data/lib/workspace/new.rb

@@ -0,0 +1,28 @@
+class WorkSpace
+  def new
+    begin
+      Dir.mkdir(@name)
+    rescue
+      abort_on_err "workspace #{@name} already exsits"
+    end
+    Dir.mkdir(@src)
+    Dir.mkdir(@components)
+    Dir.mkdir("#{@workspace}/obj")
+    if @mode == :bin
+      DefaultFiles.create_main(@src, @source_suffix)
+    else
+      DefaultFiles.create_lib_header(@src, @name, @header_suffix)
+    end
+    File.new("#{@workspace}/.canoe", "w")
+    DefaultFiles.create_config @workspace, @source_suffix, @header_suffix
+    # DefaultFiles.create_emacs_dir_local @workspace
+
+    Dir.mkdir(@third)
+    Dir.mkdir(@target)
+    Dir.mkdir(@tests)
+    Dir.chdir(@workspace) do
+      system "git init"
+    end
+    puts "workspace #{@workspace.blue} is created"
+  end
+end

data/lib/workspace/run.rb

@@ -0,0 +1,9 @@
+class WorkSpace
+  def run(args)
+    return if @mode == :lib
+    build []
+    args = args.join " "
+    puts "./target/#{@name} #{args}"
+    exec "./target/#{@name} #{args}"
+  end
+end

data/lib/workspace/test.rb

@@ -0,0 +1,41 @@
+class WorkSpace
+  public
+
+  def test(args)
+    if args.empty?
+      test_all
+      return
+    end
+
+    args.each do |arg|
+      case arg
+      when "all"
+        test_all
+      else
+        test_single arg
+      end
+    end
+  end
+
+  private
+
+  def test_all
+    puts "tests all"
+  end
+
+  def test_single(name)
+    puts "#{@tests}/bin/test_#{name}"
+    # system "./#{@tests}/bin/test_#{name}"
+  end
+
+  ##
+  # how to build:
+  # each test file tests one or more components, indicated by included headers
+  # find corresponding object file in ../obj and link them to test file
+  # TODO
+  def build_test
+    build
+    deps = DepAnalyzer.new("./tests").build_to_file(["./src", "./src/components", "./tests", "./tests/common"], "./tests/.canoe.deps")
+    puts deps
+  end
+end

data/lib/workspace/update.rb

@@ -0,0 +1,5 @@
+class WorkSpace
+  def update
+    generate
+  end
+end

data/lib/workspace/workspace.rb

@@ -0,0 +1,52 @@
+require "fileutils"
+require_relative "../source_files"
+require_relative "../compiler"
+require_relative "../config_reader"
+require_relative "../default_files"
+require_relative "../err"
+require_relative "../dependence"
+require_relative "../coloring"
+
+class WorkSpace
+  include Err
+  attr_reader :name, :cwd, :src_prefix, :components_prefix, :obj_prefix, :source_suffix, :header_suffix, :mode
+
+  def initialize(name, mode, src_suffix = "cpp", hdr_suffix = "hpp")
+    @name = name
+    @compiler = Compiler.new "clang++", ["-Isrc/components"], []
+    @cwd = Dir.new(Dir.pwd)
+    @workspace = "#{Dir.pwd}/#{@name}"
+    @src = "#{@workspace}/src"
+    @components = "#{@src}/components"
+    @obj = "#{@workspace}/obj"
+    @third = "#{@workspace}/third-party"
+    @target = "#{@workspace}/target"
+    @tests = "#{@workspace}/tests"
+    @mode = mode
+    @deps = ".canoe.deps"
+
+    @src_prefix = "./src/"
+    @components_prefix = "./src/components/"
+    @obj_prefix = "./obj/"
+
+    @source_suffix = src_suffix
+    @header_suffix = hdr_suffix
+  end
+
+  def inspect
+    puts "name is #{@name}"
+    puts "name is #{@workspace}"
+  end
+end
+
+require_relative "help"
+require_relative "new"
+require_relative "add"
+require_relative "build"
+require_relative "generate"
+require_relative "run"
+require_relative "dep"
+require_relative "clean"
+require_relative "update"
+require_relative "test"
+require_relative "make"

metadata

@@ -1,19 +1,24 @@
 --- !ruby/object:Gem::Specification
 name: canoe
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.1
 platform: ruby
 authors:
 - XIONG Ziwei
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2021-02-15 00:00:00.000000000 Z
 dependencies: []
-description: |
-  Tired of writing Makefile, CMakeList and even SConstruct? Let Canoe help you wipe them out.
+description: |+
+  Canoe offers project management and building facilities to C/C++ projects.
+
+  If you are tired of writing Makefile, CMakeList and even SConstruct, please let Canoe help you wipe them out.
+
   Similar to Cargo for Rust, Canoe offers commands such as new, build, run, etc. to help you generate a C/C++ project and build it automatically.
-  No more Makefiles, Canoe would analyze dependencies and build like our old friend make if you follow a few conventions over file names
+
+  Different from tools like Scons and Blade, Canoe requires users to write NO building scripts, Canoe would analyze dependencies and build like our old friend 'make' if a few conventions over file names are followed.
+
 email: noahxiong@outlook.com
 executables:
 - canoe
@@ -23,13 +28,25 @@ files:
 - bin/canoe
 - lib/canoe.rb
 - lib/cmd.rb
+- lib/coloring.rb
 - lib/compiler.rb
 - lib/config_reader.rb
 - lib/default_files.rb
 - lib/dependence.rb
 - lib/err.rb
 - lib/source_files.rb
-- lib/workspace.rb
+- lib/workspace/add.rb
+- lib/workspace/build.rb
+- lib/workspace/clean.rb
+- lib/workspace/dep.rb
+- lib/workspace/generate.rb
+- lib/workspace/help.rb
+- lib/workspace/make.rb
+- lib/workspace/new.rb
+- lib/workspace/run.rb
+- lib/workspace/test.rb
+- lib/workspace/update.rb
+- lib/workspace/workspace.rb
 homepage: https://github.com/Dicridon/canoe
 licenses:
 - MIT
@@ -52,5 +69,5 @@ requirements: []
 rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: a C/C++ project management and build tool
+summary: a C/C++ project management and building tool
 test_files: []

data/lib/workspace.rb

@@ -1,272 +0,0 @@
-require 'fileutils'
-require 'open3'
-require_relative 'source_files'
-require_relative 'compiler'
-require_relative 'config_reader'
-require_relative 'default_files'
-require_relative 'err'
-require_relative 'dependence'
-
-class WorkSpace
-  include Err
-  attr_reader :name, :cwd
-  def self.help
-    info = <<~INFO
-            canoe is a C/C++ project manager, inspired by Rust cargo.
-            usage:
-                canoe new tada: create a project named 'tada' in current directory
-                
-                canoe build: compile current project (execute this command in project directory)
-
-                canoe generate: generate dependency relationship and store it in '.canoe.deps'
-                
-                canoe run: compile and execute current project (execute this command in project directory)
-                
-                canoe clean: remove all generated object files and binary files
-                
-                canoe help: show this help message
-
-                canoe add tada: add a folder named tada under workspace/components,
-                                two files tada.hpp and tada.cpp would be craeted and intialized
-                
-                canoe verion: version information
-
-            new project_name [mode] [suffixes]:
-                create a new project with project_name.
-                In this project, four directories obj, src, target and third-party will be generated in project directory.
-                in src, directory 'components' will be generated if [mode] is '--lib', an extra main.cpp will be generated if [mode] is '--bin'
-
-                [mode]: --lib for a library and --bin for executable binaries
-                [suffixes]: should be in 'source_suffix:header_suffix" format, notice the ':' between two suffixes
-
-            generate: 
-                generate dependence relationship for each file, this may accelarate
-                `canoe buid` command. It's recommanded to execute this command everytime
-                headers are added or removed from any file.
-
-            build [options]:
-                build current project, arguments in [options] will be passed to C++ compiler
-            
-            run [options]:
-                build current project with no specific compilation flags, and run this project, passing [options] as command line arguments to the binary
-
-            clean:
-                remove all generated object files and binary files
-
-            help:
-                show this help message
-
-            verion: 
-                display version information
-
-            dep:
-                display file dependencies in a better readable way
-
-            @author: written by XIONG Ziwei, ICT, CAS
-            @contact: noahxiong@outlook.com
-        INFO
-    puts info
-  end
-
-
-  def initialize(name, mode, src_suffix='cpp', hdr_suffix='hpp')
-    @name = name
-    @compiler = Compiler.new 'clang++', '-Isrc/components'
-    @cwd = Dir.new(Dir.pwd)
-    @workspace = "#{Dir.pwd}/#{@name}"
-    @src = "#{@workspace}/src"
-    @components = "#{@src}/components"
-    @obj = "#{@workspace}/obj"
-    @third = "#{@workspace}/third-party"
-    @target = "#{@workspace}/target"
-    @mode = mode
-    @deps = '.canoe.deps'
-
-    @src_prefix = './src/'
-    @components_prefix = './src/components/'
-    @obj_prefix = './obj/'
-
-    @source_suffix = src_suffix
-    @header_suffix = hdr_suffix
-  end
-
-  def new
-    Dir.mkdir(@name)
-    Dir.mkdir(@src)
-    Dir.mkdir(@components)
-    Dir.mkdir("#{@workspace}/obj")
-    DefaultFiles.create_main(@src, @source_suffix) if @mode == :bin
-    File.new("#{@workspace}/.canoe", "w")
-    DefaultFiles.create_config @workspace, @source_suffix, @header_suffix
-    DefaultFiles.create_emacs_dir_local @workspace
-
-    Dir.mkdir(@third)
-    Dir.mkdir(@target)
-    puts "workspace #{@workspace} is created"
-  end
-
-  # args are commandline parameters passed to `canoe build`    
-  def build(args)
-    deps = File.exist?(@deps) ? 
-             DepAnalyzer.read_from(@deps) :
-             DepAnalyzer.new('./src').build_to_file(['./src', './src/components'], @deps)
-    target = "./target/#{@name}"
-    build_time = File.exist?(target) ? File.mtime(target) : Time.new(0)
-    files = DepAnalyzer.compiling_filter(deps, build_time, @source_suffix, @header_suffix)
-
-    if files.empty?
-      puts "nothing to do, all up to date"
-      return
-    end
-    
-    self.send "build_#{@mode.to_s}", files, args 
-  end
-
-  def generate
-    DepAnalyzer.new('./src', @source_suffix, @header_suffix)
-               .build_to_file ['./src', './src/components'], @deps
-  end
-
-  def update
-    generate
-  end
-
-  def clean
-    self.send "clean_#{@mode.to_s}"
-  end
-
-  def run(args)
-    build []
-    args = args.join " "
-    puts "./target/#{@name} #{args}"
-    exec "./target/#{@name} #{args}"
-  end
-
-  def add(args)
-    args.each do |i|
-      dir = @components
-      filenames = i.split("/")
-      prefix = []
-      filenames.each do |filename|
-        dir += "/#{filename}"
-        prefix << filename
-        unless Dir.exist? dir
-          FileUtils.mkdir dir 
-          Dir.chdir(dir) do
-            puts "created " + Dir.pwd
-            create_working_files prefix.join('__'), filename
-          end
-        end
-      end
-    end
-  end
-
-  def dep
-    deps = DepAnalyzer.read_from(@deps) if File.exist?(@deps)
-    deps.each do |k, v|
-      unless v.empty?
-        puts "#{k} depends on: "
-        v.each {|f| puts "    #{f}"}
-        puts ""
-      end
-    end
-  end
-  
-  private
-  def create_working_files(prefix, filename)
-    DefaultFiles.create_cpp filename, @source_suffix, @header_suffix
-    DefaultFiles.create_hpp @name, prefix, filename, @header_suffix
-  end
-
-  def build_compiler_from_config(args)
-    Dir.chdir(@workspace) do
-      flags = ConfigReader.extract_flags "config.json"
-      compiler_name = flags['compiler'] ? flags['compiler'] : "clang++"
-      abort_on_err "compiler #{compiler_name} not found" unless File.exists?("/usr/bin/#{compiler_name}")
-      compiler_flags = ['-Isrc/components'] + args
-      
-      if opts = flags['flags'] 
-        opts.each do |k, v|
-          case v
-          when String
-            compiler_flags << v
-          when Array
-            v.each do |o|
-              compiler_flags << o
-            end
-          else
-            abort_on_err "unknown options in config.json, #{v}"
-          end
-        end
-      end
-
-      @compiler = Compiler.new compiler_name, compiler_flags
-    end
-  end
-
-  def compile(f, o)
-    @compiler.compile f, o
-  end
-
-  def link(odir, objs)
-    status = system "#{@compiler} -o #{odir}/#{@name} #{objs.join(" ")}"
-    unless status
-      puts "compilation failed"
-      return
-    end
-    
-    @compiler.link "#{odir}/#{@name}", objs
-  end
-
-  def build_bin(files, args)
-    build_compiler_from_config args
-    comps = files.select {|f| f.start_with? @components_prefix}
-    srcs = files - comps
-    
-    srcs.each do |f|
-      puts "compiling #{f}"
-      fname = f.split("/")[-1]
-      o = @obj_prefix + fname.delete_suffix(File.extname(fname)) + '.o'
-      compile f, o
-    end
-    
-    comps.each do |f|
-      puts "compiling #{f}"
-      o = @obj_prefix + f.delete_suffix(File.extname(f))[@components_prefix.length..]
-                         .gsub('/', '_') + '.o'
-      compile f, o
-    end
-    
-    link('./target', Dir.glob("obj/*.o")) unless files.empty?
-  end
-
-  def build_lib
-    puts "build a lib"
-  end
-
-  def clean_obj
-    puts "rm -f ./obj/*.o"
-    system "rm -f ./obj/*.o"
-  end
-
-  def clean_target
-    puts "rm -f ./target/*"
-    system "rm -f ./target/*"
-  end
-
-  def clean_bin
-    clean_obj
-    clean_target
-  end
-
-  def clean_lib
-    clean_obj
-    clean_target
-  end
-
-  public
-  def inspect 
-    puts "name is #{@name}"
-    puts "name is #{@workspace}"
-  end
-end