Cleanup

cache.go

@@ -69,7 +69,7 @@ func (cache *cache) storeFile(context *Context, outputFile *File, inputFiles []*
 
 func (cache *cache) buildCachePath(context *Context, outputPath string, inputFiles []*File) (string, error) {
 	uintBuff := make([]byte, 4)
-	binary.LittleEndian.PutUint32(uintBuff, context.hash)
+	binary.LittleEndian.PutUint32(uintBuff, context.chainHash)
 
 	hasher := crc32.NewIEEE()
 	hasher.Write(uintBuff)

context.go

@@ -15,13 +15,15 @@ type Context struct {
 	goldsmith *Goldsmith
 
 	plugin    Plugin
-	hash   uint32
+	chainHash uint32
 
-	filtersExternal filterStack
-	filtersInternal filterStack
+	filtersExt filterStack
+	filtersInt filterStack
 
-	inputFiles  chan *File
-	outputFiles chan *File
+	threads int
+
+	filesIn  chan *File
+	filesOut chan *File
 }
 
 // CreateFileFrom data creates a new file instance from the provided data buffer.
@@ -58,7 +60,7 @@ func (*Context) CreateFileFromAsset(sourcePath, dataPath string) (*File, error)
 
 // DispatchFile causes the file to get passed to the next link in the chain.
 func (context *Context) DispatchFile(file *File) {
-	context.outputFiles <- file
+	context.filesOut <- file
 }
 
 // DispatchAndCacheFile caches the file data (excluding the metadata), taking
@@ -69,7 +71,7 @@ func (context *Context) DispatchAndCacheFile(outputFile *File, inputFiles ...*Fi
 		context.goldsmith.fileCache.storeFile(context, outputFile, inputFiles)
 	}
 
-	context.outputFiles <- outputFile
+	context.filesOut <- outputFile
 }
 
 // RetrieveCachedFile looks up file data (excluding the metadata), given an
@@ -86,12 +88,18 @@ func (context *Context) RetrieveCachedFile(outputPath string, inputFiles ...*Fil
 
 // Specify internal filter(s) that exclude files from being processed.
 func (context *Context) Filter(filters ...Filter) *Context {
-	context.filtersInternal = filters
+	context.filtersInt = filters
+	return context
+}
+
+// Specify the maximum number of threads used for processing.
+func (context *Context) Threads(threads int) *Context {
+	context.threads = threads
 	return context
 }
 
 func (context *Context) step() {
-	defer close(context.outputFiles)
+	defer close(context.filesOut)
 
 	if initializer, ok := context.plugin.(Initializer); ok {
 		if err := initializer.Initialize(context); err != nil {
@@ -100,16 +108,21 @@ func (context *Context) step() {
 		}
 	}
 
-	if context.inputFiles != nil {
+	if context.filesIn != nil {
 		processor, _ := context.plugin.(Processor)
 
+		threads := context.threads
+		if threads < 1 {
+			threads = runtime.NumCPU()
+		}
+
 		var wg sync.WaitGroup
-		for i := 0; i < runtime.NumCPU(); i++ {
+		for i := 0; i < threads; i++ {
 			wg.Add(1)
 			go func() {
 				defer wg.Done()
-				for inputFile := range context.inputFiles {
-					if processor != nil && context.filtersInternal.accept(inputFile) && context.filtersExternal.accept(inputFile) {
+				for inputFile := range context.filesIn {
+					if processor != nil && context.filtersInt.accept(inputFile) && context.filtersExt.accept(inputFile) {
 						if _, err := inputFile.Seek(0, os.SEEK_SET); err != nil {
 							context.goldsmith.fault("core", inputFile, err)
 						}
@@ -117,7 +130,7 @@ func (context *Context) step() {
 							context.goldsmith.fault(context.plugin.Name(), inputFile, err)
 						}
 					} else {
-						context.outputFiles <- inputFile
+						context.filesOut <- inputFile
 					}
 				}
 			}()

goldsmith.go

@@ -17,7 +17,6 @@ type Goldsmith struct {
 	contextHasher hash.Hash32
 
 	fileCache *cache
-
 	filters   filterStack
 	clean     bool
 
@@ -55,14 +54,14 @@ func (goldsmith *Goldsmith) Chain(plugin Plugin) *Goldsmith {
 	context := &Context{
 		goldsmith: goldsmith,
 		plugin:    plugin,
-		hash:        goldsmith.contextHasher.Sum32(),
-		outputFiles: make(chan *File),
+		chainHash: goldsmith.contextHasher.Sum32(),
+		filesOut:  make(chan *File),
 	}
 
-	context.filtersExternal = append(context.filtersExternal, goldsmith.filters...)
+	context.filtersExt = append(context.filtersExt, goldsmith.filters...)
 
 	if len(goldsmith.contexts) > 0 {
-		context.inputFiles = goldsmith.contexts[len(goldsmith.contexts)-1].outputFiles
+		context.filesIn = goldsmith.contexts[len(goldsmith.contexts)-1].filesOut
 	}
 
 	goldsmith.contexts = append(goldsmith.contexts, context)
@@ -87,7 +86,6 @@ func (goldsmith *Goldsmith) End(targetDir string) []error {
 
 	goldsmith.Chain(&saver{
 		clean: goldsmith.clean,
-		tokens: make(map[string]bool),
 	})
 
 	for _, context := range goldsmith.contexts {

loader.go

@@ -8,16 +8,16 @@ func (*loader) Name() string {
 	return "loader"
 }
 
-func (*loader) Initialize(ctx *Context) error {
+func (*loader) Initialize(context *Context) error {
 	infos := make(chan fileInfo)
-	go scanDir(ctx.goldsmith.sourceDir, infos)
+	go scanDir(context.goldsmith.sourceDir, infos)
 
 	for info := range infos {
 		if info.IsDir() {
 			continue
 		}
 
-		relPath, _ := filepath.Rel(ctx.goldsmith.sourceDir, info.path)
+		relPath, _ := filepath.Rel(context.goldsmith.sourceDir, info.path)
 
 		file := &File{
 			sourcePath: relPath,
@@ -27,7 +27,7 @@ func (*loader) Initialize(ctx *Context) error {
 			dataPath:   info.path,
 		}
 
-		ctx.DispatchFile(file)
+		context.DispatchFile(file)
 	}
 
 	return nil

saver.go

@@ -3,24 +3,24 @@ package goldsmith
 import (
 	"os"
 	"path/filepath"
-	"sync"
 )
 
 type saver struct {
 	clean  bool
-
 	tokens map[string]bool
-	mutex  sync.Mutex
 }
 
 func (*saver) Name() string {
 	return "saver"
 }
 
-func (saver *saver) Process(context *Context, file *File) error {
-	saver.mutex.Lock()
-	defer saver.mutex.Unlock()
+func (saver *saver) Initialize(context *Context) error {
+	saver.tokens = make(map[string]bool)
+	context.Threads(1)
+	return nil
+}
 
+func (saver *saver) Process(context *Context, file *File) error {
 	for token := cleanPath(file.sourcePath); token != "."; token = filepath.Dir(token) {
 		saver.tokens[token] = true
 	}