Skip to content

geostarters/icgc-js-common

Folders and files

NameName
Last commit message
Last commit date

Latest commit

74428ff · Dec 9, 2022
Mar 22, 2019
Apr 6, 2022
Apr 6, 2022
Mar 21, 2019
Apr 6, 2022
Nov 20, 2020
Feb 8, 2018
Mar 18, 2019
Mar 13, 2020
Apr 26, 2019
Mar 22, 2019
Apr 26, 2019
Apr 6, 2022
Apr 6, 2022
Mar 12, 2020
Dec 9, 2022
Dec 9, 2022

Repository files navigation

ICGC-COMMON

npm version

Build status

License

A Javascript lib with common functionalities to use across different projects.

INSTALLATION

npm i --save @geostarters/common

USAGE

Usage example with Svelte

import {GeoCommons} from "@geostarters/common/dist/commonjs";

 const geoCommons = new GeoCommons();

 geoCommons.getEmptyGeoJSON());

Usage with ES6 modules:

import * as ICGCCommon from " @geostarters/common";

Usage with Commonjs:

const Utils =  require("@geostarters/common");

Besides it, it is generated a single file package and its .map, using browserify:

dist/ICGCCommon.js

dist/ICGCCommon.map.js

DOCUMENTATION

DOCS API

Environment

Documenting the code

The documentation follows the JSDoc syntax.

To get started you can read the documentation.js start guide here or take a look at the provided example file here

Using types

Using flow provides a way to check for common syntax errors while calling functions. Flow provides a simple example of which kind of problems it can solve in their Type Annotations guide. There's also a list of annotations it supports there.

Writting tests

  • The project uses JEST.
  • test folder included

Provided scripts

  • build-dev: Creates a single file package with all the assertions intact to be ussed in browsers.
  • watch-dev: Watches the source
  • build-min: Creates a minified package with its map file and without assertions to be ussed in browsers
  • build-unflow: Builds ready-to-use modules in dist by removing flow types
  • build-react: Builds ready-to-use es modules in dist/es by removing flow types
  • build-modules: Builds ready-to-use commonjs modules in dist/commonjs
  • build-docs: Generates the documentation file
  • lint: Checks the code linting
  • lint-docs: Lints the documentation files
  • test: Runs the static type checker and runs the tests
  • test:unit: Runs the unit tests
  • test-flow: Runs the static type checks
  • test-cov: Runs the testing coverage

Folder structure

dist: Contains the built files generated by the scripts (dev package, minified package and map, commonjs folder and es folder)

src: Contains an index file that requires all the modules that should be exported and all the source files that compound the package.

test: Contains the unit and integration tests

License

Copyright (c) 2019 - Geostarters (MIT License) See LICENSE file for more info.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published