Package Exports

class-annotations

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (class-annotations) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

class-annotations

use a reader of annotations for write you models with ES6 new syntax , easy usage.

auto persist the data type of all the natives type

can read multiples `class` inner single file

support value multilines

can read all items from directories ( beta features )

A comment not starting with an: "@" character not be considered as an annotation, but may be brought up in the data provided via the table: excludes

npm install class-annotations --save
yarn add class-annotations

for next exemples the physical path of file have been replace with: `{{pathFile}}`

foo.js

/**
 * @Route( { name: "foo" , path: "/foo" , exactPath: true , methods=['GET'] } )
 * @Another = 35
 *
 * should be an excludes values
 *
 * @Another2: "hello"
 *
 * @Another3( {
 *  foo: "bar" ,
 *  foo2: "bar2" ,
 * } )
 */
class Foo {

    constructor() {

        // ...
        // ...
    }

    // ...
} ;

app.js

const createClassAnnotations = require('class-annotations') ;

const ClassAnnotations = createClassAnnotations( __dirname ) ;

const annotations = new ClassAnnotations('./foo.js') ;

console.log( annotations ) ;

output log of annotations:

{
    pathFile: '{{pathFile}}',
    classCount: 1 ,
    success: true,

    readers: {

        Foo: {
            data: {
                exludes: ['','should be an excludes values','']
                Route: {
                    name: { valueBrut: "foo", value: "foo" } ,
                    path: { valueBrut: "/foo" , value: "/foo" } ,
                    exactPath: { valueBrut: "true" , value: true } ,
                    methods: { valueBrut: "['GET']" , value: [ 'GET' ] }
                } ,
                Another: {
                    valueBrut: "35" ,
                    value: 35
                } ,
                Another2: {
                    valueBrut: "hello" ,
                    value: "hello"
                } ,
                Another3: {
                    valueBrut: '{ foo: "bar" ,foo2: "bar2" ,}' ,
                    value: { foo: "bar" ,foo2: "bar2" }
                }
            } ,
            classname: "Foo"
        }
    }
}

you can check `success` property before use data

if success is false you can get details property e.g:

app.js

const createClassAnnotations = require('class-annotations') ;

const ClassAnnotations = createClassAnnotations( __dirname ) ;

const annotations = new ClassAnnotations('./not-exists.js') ;

console.log( annotations ) ;

output log of annotations data:

{
    pathFile: '{{pathFile}}',
    success: false,
    details: 'ClassAnnotations Error: file not found from: {{pathFile}}'
}

npm install class-annotations --save
yarn add class-annotations

Read an directory:

structure directories e.g:

app.js
models/
- foo.js
- foo2.js
- submodels/
  - foo3.js

app.js

const createClassAnnotations = require('class-annotations') ;

const ClassAnnotations = createClassAnnotations( __dirname ) ;

// read models directory
const annotations = new ClassAnnotations('./models') ;

console.log( annotations ) ;

output log of annotations data:

{
    directories: {
        models: {
            'foo.js': {
                readers: {
                    Foo: {
                        data: {
                            // your annotations data
                        }
                    }
                } ,
                success: boolean ,
                ?details: string
            } ,
            'foo2.js': {
                readers: {
                    Foo2: {
                        data: {
                            // your annotaions data
                        }
                    }
                } ,
                success: boolean,
                ?details: string
            } ,
            submodels: {

                directories: {

                    // because recursive reader
                    submodels: {
                        'foo3.js': {
                            readers: {
                                Foo3: {
                                    data: {
                                        // your annotations data
                                    }
                                } ,
                                success: boolean ,
                                ?details: string
                            }
                        }
                    }
                }
            }
        }
    }
}

console.log(
    annotations // ClassAnnotations
    .directories // object
    .models // ReadDirectory
    .submodels // ClassAnnotations
    .directories // object
    .submodels // ReadDirectory
    ['foo3.js'] // ClassAnnotations
    .readers // object
    .Foo3 // object
    .data // object
) ;