coffee-toaster/src/toaster/core/script.coffee

Minimalist manager and build system for CoffeeScript, an alternative for AMD's or CJS's OOP patterns, but with similar results. Made for those who dare to use class definitions in CoffeeScript while being able to easily inherit from external files. Powered with imports directives that use wildcards facilities, exposed scopes and excluded files filter options. The system can even use folders-as-namespaces to help you avoid naming collisions in architecture.

#<< toaster/utils/array-util

class Script

	# requires
	fs = require "fs"
	path = require 'path'
	pn = path.normalize
	cs = require "coffee-script"

	ArrayUtil = toaster.utils.ArrayUtil

	constructor: (@builder, @folderpath, @realpath, @alias, @opts) ->
		@getinfo()



	getinfo:( declare_ns = true )->
		# read file content and initialize dependencies and baseclasses array
		@raw = fs.readFileSync @realpath, "utf-8"
		@dependencies_collapsed = []
		@baseclasses = []

		# assemble some information about the file
		@filepath = @realpath.replace( @folderpath, "" )
		@filepath = pn "#{@alias}/#{@filepath}" if @alias?
		@filepath = @filepath.replace /^[\/]+/, ""

		@filename = /[\w-]+\.[\w-]+/.exec( @filepath )[ 0 ]
		@filefolder = @filepath.replace( "/#{@filename}", "") + "/"
		@namespace = ""

		# if the file is in the top level
		if @filepath.indexOf("/") is -1
			@filefolder = ""

		# assemble namespace info about the file
		@namespace = @filefolder.replace(/\//g, ".").replace /^\.?(.*)\.$/g, "$1"

		# filter files that have class declarations inside of it
		rgx = /^(class)+\s+([^\s]+)+(\s(extends)\s+([\w.]+))?/mg

		# filter classes that extends another classes
		rgx_ext = /(^|=\s*)(class)\s(\w+)\s(extends)\s(\\w+)\s*$/gm

		# if there is a class inside the file
		if @raw.match( rgx )?

			# if the file is not in the root src folder (outside any
			# folder/package ) and packaging is enabled
			if @namespace != "" and @builder.packaging

				# then modify the class declarations before starting
				# the parser thing, adding the package headers declarations
				# as well as the expose thing

				for decl in [].concat (@raw.match rgx)

					# name
					name = (decl.match /class\s([^\s]+)/)
					name = (name[1].split '.').pop()

					# extends
					extending = (decl.match /(\sextends\s[^\s]+$)/m)
					extending = extending[0] if extending
					extending ||= ""

					# file modification (declaring namespaces for classes)
					repl = "class #{@namespace}.#{name}#{extending}"

					# write full declaration to the file if it's not right yet
					if decl isnt repl
						@raw = @raw.replace decl, repl
						fs.writeFileSync @realpath, @raw

				@classpath = "#{@namespace}.#{@classname}"

			# assemble some more infos about the file.
			#		classname: ClassName
			#		namespace: package.subpackage
			#		classpath: package.subpackage.ClassName
			@classname = @raw.match( rgx )[3]

			# colletcts the base classes, in case some class in the file
			# extends something
			for klass in @raw.match( rgx_ext ) ? []
				baseclass = klass.match( rgx_ext )[5]
				@baseclasses.push baseclass

		# then if there's other dependencies
		if /(#<<\s)(.*)/g.test @raw

			# collect all and loop through them
			requirements = @raw.match /(#<<\s)(.*)/g
			for item in requirements
				# 1. filter dependency name
				# 2. trim it 
				# 3. split all dependencies
				# 4. concat it with the dependencies array
				item         = /(#<<\s)(.*)/.exec( item )[ 2 ]
				item         = item.replace /\s/g, ""
				item         = [].concat item.split ","
				@dependencies_collapsed = @dependencies_collapsed.concat item

	expand_dependencies:()->

		# referencies the builder's files array
		files = @builder.files

		# resets the dependencies array
		@dependencies = []

		# looping through file dependencies
		for dependency, index in @dependencies_collapsed
			
			# if dependency is not a wild-card (namespace.*)
			if dependency.substr(-1) != "*"

				# then add file extension to it and continue
				@dependencies.push "#{dependency}.coffee"
				continue

			# otherwise find all files under that namespace
			reg = new RegExp dependency.replace /(\/)/g, "\\$1"
			found = ArrayUtil.find_all files, reg, "filepath", true, true

			# if nothing is found under the given namespace
			if found.length <= 0
				warn "Nothing found inside #{("'"+dependency).white}'".yellow
				continue
			
			# otherwise rewrites found array with filepath info only
			for expanded in found
				if expanded.item.filepath isnt @filepath
					@dependencies.push expanded.item.filepath

		@dependencies