@naanlang/naan 1.0.0

package/frameworks/project/proj_folder.nlg

@@ -0,0 +1,143 @@
+/*
+ * proj_folder.nlg
+ * Naanlib/frameworks/project/
+ *
+ * Controllers for generic folder projects.
+ *
+ * column positioning:                          //                          //                      !
+ *
+ * Copyright (c) 2019-2021 by Richard C. Zulch
+ *
+ */
+
+
+/*
+ * proj_folderInstance
+ *
+ *     Create an instance of the folder projects type. Folder projects are generic for any folder in
+ * a filesystem. Given a new instance you can either load (which fails of the project is not valid)
+ * or create (which fails if the project already exists.) Unless other noted the methods all return
+ * standard (error, data) tuples.
+ *
+ */
+
+closure proj_folderInstance(projman, where, projID, local project) {
+    project = new(object, this)
+    project.name = where.name
+    project.where = where
+    project.projID = projID
+    
+    // create
+    //
+    // Create the project with the specified name, and leave it loaded if no error.
+    project.create = function create() {
+        load()
+    }
+
+    // load
+    //
+    // Load the project, which fails if it does not already exist.
+    project.load = closure load(local error, info) {
+        if project.loaded
+            return (list(false, { ok: true }))
+        `(error, data) = projman.locate.connect(where.locationID, "NideFS", where.path)
+        if !data
+            return (list(Error("project load failed", error)))
+        project.fs = data
+       `(error, info) = project.fs.info("")
+        if info {
+            if info.type == "directory" {
+                project.fm = storageFileManager.FileManager(project.fs)
+                project.fm.load()
+                project.loaded = true }
+            else {
+                info = false
+                error = Error("project root must be directory", where.path)
+            }
+        }
+        list(error, info)
+    }
+
+    // run
+    //
+    // Run the project by building and then launching.
+    project.run = closure run(buildonly) {
+        debuglog("folder run project stub")
+        list(false, { ok: true })
+    }
+
+    // close
+    //
+    // Close the project, releasing resources.
+    project.close = function close() {
+        project.fm = false
+        project.loaded = false
+    }
+
+    // finis
+    project
+};
+
+
+/*
+ * proj_folderType
+ *
+ *     Create a project type object for folder objects.
+ *
+ */
+
+closure proj_folderType(projman, local folderProj) {
+    folderProj = new(object, this)
+    folderProj.classID = "folder"
+    folderProj.classLabel = "folder tree"
+    folderProj.connect = projConnector(projman, folderProj)
+    
+    // testActiveLocation
+    //
+    // Test if we can handle a project at the specified location.
+    
+    folderProj.testActiveLocation = function testActiveLocation(where, local error, fs, info) {
+        if !where.locationID || !where.path
+            return (false)
+        `(error, fs) = projman.locate.connect(where.locationID, "NideFS", where.path)
+        if fs
+            `(error, info) = fs.info("")
+        if info.type == "directory" {
+            where.name = fs.path.basename(where.path)
+            if where.name == ""
+                where.name = "root"                                         // an empty name wouldn't be pretty
+            where.typeID = folderProj.classID                               // use this because there's no config to read
+            100                                                             // type of last resort
+        }
+    }
+
+    // instantiate
+    //
+    // Instantiate a project object for the specified where data.
+    
+    folderProj.instantiate = function instantiate(where, projID) {
+        proj_folderInstance(projman, where, projID)
+    }
+
+    // finis
+    folderProj
+};
+
+
+/*
+ * proj_folderInit
+ *
+ *     Initialize the module.
+ *
+ */
+
+function proj_folderInit(local manifest) {
+
+    manifest = `(proj_folderInstance, proj_folderType, proj_folderInit)
+
+    Naan.module.build(module.id, "proj_folder", function(modobj, compobj) {
+        require("./project.nlg")
+        storageFileManager = require("../storage/file_manager.nlg")
+        compobj.manifest = manifest
+    })
+}();

package/frameworks/project/proj_lambda.nlg

@@ -0,0 +1,137 @@
+/*
+ * proj_lambda.nlg
+ * Naanlib/frameworks/project/
+ *
+ * Controllers for lambda-based projects.
+ *
+ * column positioning:                          //                          //                      !
+ *
+ * Copyright (c) 2021 by Richard C. Zulch
+ *
+ */
+
+
+/*
+ * proj_lambdaInstance
+ *
+ *     Create an instance of the lambda projects type. Lambda projects run on a clould platform that
+ * supports such functionality, which is initially AWS Lambda, and respond according to their cloud
+ * configuration.
+ *     Given a new project instance you can either load an existing project or create a new one.
+ * Unless other noted the methods all return standard (error, data) tuples.
+ *
+ */
+
+closure proj_lambdaInstance(projman, where, projID, local project) {
+    project = new(object, this)
+    project.name = where.name
+    project.where = where
+    project.projID = projID
+    project.config = projConfig(projman, where)
+    project.runPageDebug = true                                             // switch to Debug page on run
+
+    // create
+    //
+    // Create the project with the specified name, and leave it loaded if no error.
+    project.create = function create(name, local result) {
+        result = project.config.create(name)
+        project.fs = project.config.fs
+        if project.fs {
+            project.fm = storageFileManager.FileManager(project.fs)
+            project.fm.load()
+            project.loaded }
+        result
+    }
+
+    // load
+    //
+    // Load the project, which fails if it does not already exist.
+    project.load = closure load(local error, info) {
+        if project.loaded
+            return (list(false, { ok: true }))
+        result = project.config.load()
+        project.fs = project.config.fs
+        if project.fs {
+            project.fm = storageFileManager.FileManager(project.fs)
+            project.fm.load()
+            project.loaded }
+        result
+    }
+
+    // run
+    //
+    // Run the project by building and then launching.
+    project.run = closure run(buildonly) {
+        project.config.run(buildonly)
+    }
+
+    // close
+    //
+    // Close the project, releasing resources.
+    project.close = function close() {
+        project.config.close()
+        project.fm = false
+        project.loaded = false
+    }
+
+    // finis
+    project
+};
+
+
+/*
+ * proj_lambdaType
+ *
+ *     Create a project type object for folder objects.
+ *
+ */
+
+closure proj_lambdaType(projman, local lambdaProj) {
+    lambdaProj = new(object, this)
+    lambdaProj.classID = "lambda"
+    lambdaProj.classLabel = "lambda"
+    lambdaProj.connect = projConnector(projman, lambdaProj)
+    
+    // testActiveLocation
+    //
+    // Test if we can handle a project at the specified location.
+    
+    lambdaProj.testActiveLocation = function testActiveLocation(where, local error, config, proj) {
+        if !where.locationID || !where.path
+            return (false)
+        config = projConfig(projman, where)                                 // updates where.name and where.typeID
+        `(error, proj) = config.load()
+        if !error && proj["nide-type"] == lambdaProj.classID
+            20
+    }
+
+    // instantiate
+    //
+    // Instantiate a project object for the specified where data.
+    
+    lambdaProj.instantiate = function instantiate(where, projID) {
+        proj_lambdaInstance(projman, where, projID)
+    }
+
+    // finis
+    lambdaProj
+};
+
+
+/*
+ * proj_lambdaInit
+ *
+ *     Initialize the module.
+ *
+ */
+
+function proj_lambdaInit(local manifest) {
+
+    manifest = `(proj_lambdaInstance, proj_lambdaType, proj_lambdaInit)
+
+    Naan.module.build(module.id, "proj_lambda", function(modobj, compobj) {
+        require("./project.nlg")
+        storageFileManager = require("../storage/file_manager.nlg")
+        compobj.manifest = manifest
+    })
+}();

package/frameworks/project/proj_static.nlg

@@ -0,0 +1,138 @@
+/*
+ * proj_static.nlg
+ * Naanlib/frameworks/project/
+ *
+ * Controllers for static projects, where browser-resident Naan is served from static website.
+ *
+ * column positioning:                          //                          //                      !
+ *
+ * Copyright (c) 2021 by Richard C. Zulch
+ *
+ */
+
+
+/*
+ * proj_staticInstance
+ *
+ *     Create an instance of the static projects type. Static projects support a web browser front
+ * end and a static web server on the backend. Given a new instance you can either load (which fails
+ * if the project is not valid)  or create (which fails if the project already exists.) Unless other-
+ * wise noted the methods all return standard (error, data) tuples.
+ *
+ */
+
+closure proj_staticInstance(projman, where, projID, local project) {
+    project = new(object, this)
+    project.name = where.name
+    project.where = where
+    project.projID = projID
+    project.config = projConfig(projman, where)
+    
+    // create
+    //
+    // Create the project with the specified name.
+    //
+    project.create = closure create(name, local result) {
+        result = project.config.create(name)
+        project.fs = project.config.fs
+        if project.fs {
+            project.fm = storageFileManager.FileManager(project.fs)
+            project.fm.load()
+            project.loaded }
+        result
+    }
+
+    // load
+    //
+    //     Load the project.
+    //
+    project.load = closure load(local result) {
+        if project.loaded
+            return (list(false, { ok: true }))
+        result = project.config.load()
+        project.fs = project.config.fs
+        if project.fs {
+            project.fm = storageFileManager.FileManager(project.fs)
+            project.fm.load()
+            project.loaded }
+        result
+    }
+
+    // run
+    //
+    //     Run the project by building and then launching.
+    //
+    project.run = closure run(buildonly) {
+        project.config.run(buildonly)
+    }
+
+    // close()
+    //
+    //     Close the project.
+
+    project.close = function close() {
+        project.config.close()
+        project.fm = false
+        project.loaded = false
+    }
+
+    project
+};
+
+
+/*
+ * proj_staticType
+ *
+ *     Create a project type object for folder objects.
+ *
+ */
+
+closure proj_staticType(projman, local staticProj) {
+    staticProj = new(object, this)
+    staticProj.classID = "static"
+    staticProj.classLabel = "static"
+    staticProj.connect = projConnector(projman, staticProj)
+    
+    // testActiveLocation
+    //
+    // Test if we can handle a project at the specified location.
+    
+    staticProj.testActiveLocation = function testActiveLocation(where, local error, config, proj) {
+        if !where.locationID || !where.path
+            return (false)
+        config = projConfig(projman, where)                                 // updates where.name and where.typeID
+        `(error, proj) = config.load()
+        if !error && proj["nide-type"] == staticProj.classID
+            20
+    }
+
+    // instantiate
+    //
+    // Instantiate a project object for the specified where data.
+    
+    staticProj.instantiate = function instantiate(where, projID) {
+        proj_staticInstance(projman, where, projID)
+    }
+
+    // finis
+    staticProj
+};
+
+
+/*
+ * proj_staticInit
+ *
+ *     Initialize the module.
+ *
+ */
+
+function proj_staticInit(local manifest) {
+
+    manifest = `(proj_staticInstance, proj_staticType, proj_staticInit)
+
+    Naan.module.build(module.id, "proj_static", function(modobj, compobj) {
+        require("./project.nlg")
+        storageFileManager = require("../storage/file_manager.nlg")
+        compobj.manifest = manifest
+    })
+}();

package/frameworks/project/project.nlg

@@ -0,0 +1,29 @@
+/*
+ * project.nlg
+ * Naanlib/frameworks/project/
+ *
+ *     Root component for Naanide projects.
+ *
+ * column positioning:                          //                          //                      !
+ *
+ * Copyright (c) 2020-2021 by Richard C. Zulch
+ *
+ */
+
+
+/*
+ * prorInit
+ *
+ *     Initialize the project module.
+ *
+ *
+ */
+
+function prorInit(local manifest) {
+    manifest = `(prorInit)
+
+    Naan.module.build(module.id, "project", function(modobj, compobj) {
+        require("../common").LiveImport()
+        compobj.manifest = manifest
+    })
+} ();