You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ignite.apache.org by Alexey Kosenchuk <al...@nobitlost.com> on 2018/07/01 12:57:54 UTC
NodeJS client: npm publishing instruction
Denis,
below is instruction how to publish/update npm module with Ignite NodeJS
client on npmjs.
Use it when you decide to publish the client.
Another short instruction is how to generate the API spec using jsdoc.
Pls place the instructions to appropriate locations.
Thanks,
-Alexey
How to publish Ignite NodeJS Client on npmjs.com:
-------------------------------------------------
1. Install NodeJS npm (https://nodejs.org/en/), if not installed yet.
2. Register an account at npmjs (https://www.npmjs.com/signup), if not
registered yet.
3. Execute `npm login` command and provide your npmjs account credentials.
4. Clone or download Ignite repository
https://github.com/apache/ignite.git to `local_ignite_path`
5. Go to `local_ignite_path/modules/platforms/nodejs`
6. Prepare/update
`local_ignite_path/modules/platforms/nodejs/package.json` file. Pay
attention to:
- "name" - name of the npm module
- "version" - version of the npm module, increment it if you update
the module
- "description" - description of the npm module
- "repository" - type and link to the repository with the source code
- "keywords" - keywords for the search of the module on npmjs
- "license" - license type
- other properties depend on the implementation/tests, do not touch them
Example of the package.json file is attached.
7. Prepare/update `local_ignite_path/modules/platforms/nodejs/README.md`
file. It should exist and should not be empty. Eg. add a link to a place
with the documentation.
8. Execute `npm publish` command from the
`local_ignite_path/modules/platforms/nodejs` folder.
9. Check the module is published and well-described at
https://www.npmjs.com/package/apache-ignite-client (assuming
`apache-ignite-client` is the name of the module)
Common instruction about npm publishing:
https://docs.npmjs.com/getting-started/publishing-npm-packages
How to generate Ignite NodeJS Client API specification:
-------------------------------------------------------
It should be done if a public API class/method has been changed.
1. Execute `npm install -g jsdoc` to install jsdoc
(https://www.npmjs.com/package/jsdoc)
2. Clone or download Ignite repository
https://github.com/apache/ignite.git to `local_ignite_path`
3. Go to `local_ignite_path/modules/platforms/nodejs/api_spec`
4. Only if a class has been removed from the public API, remove all
files from `local_ignite_path/modules/platforms/nodejs/api_spec` except
conf.json file.
5. Execute `jsdoc -c conf.json` command.
Note: `local_ignite_path/modules/platforms/nodejs/api_spec/conf.json` is
a file with jsdoc configuration.
Re: NodeJS client: npm publishing instruction
Posted by Denis Magda <dm...@gridgain.com>.
Alexey,
Thanks for the instructions. Please put them on Ignite wiki as a sub-page
of Development Process:
https://cwiki.apache.org/confluence/display/IGNITE/Development+Process
Tell me your Wiki ID and I'll grant required permissions.
--
Denis
On Mon, Jul 2, 2018 at 1:35 AM Igor Sapego <is...@apache.org> wrote:
> I believe, we need to put this instruction on wiki page.
>
> Best Regards,
> Igor
>
>
> On Sun, Jul 1, 2018 at 3:58 PM Alexey Kosenchuk <
> alexey.kosenchuk@nobitlost.com> wrote:
>
> > Denis,
> >
> > below is instruction how to publish/update npm module with Ignite NodeJS
> > client on npmjs.
> > Use it when you decide to publish the client.
> >
> > Another short instruction is how to generate the API spec using jsdoc.
> >
> > Pls place the instructions to appropriate locations.
> >
> > Thanks,
> > -Alexey
> >
> >
> > How to publish Ignite NodeJS Client on npmjs.com:
> > -------------------------------------------------
> > 1. Install NodeJS npm (https://nodejs.org/en/), if not installed yet.
> > 2. Register an account at npmjs (https://www.npmjs.com/signup), if not
> > registered yet.
> > 3. Execute `npm login` command and provide your npmjs account
> credentials.
> > 4. Clone or download Ignite repository
> > https://github.com/apache/ignite.git to `local_ignite_path`
> > 5. Go to `local_ignite_path/modules/platforms/nodejs`
> > 6. Prepare/update
> > `local_ignite_path/modules/platforms/nodejs/package.json` file. Pay
> > attention to:
> > - "name" - name of the npm module
> > - "version" - version of the npm module, increment it if you update
> > the module
> > - "description" - description of the npm module
> > - "repository" - type and link to the repository with the source code
> > - "keywords" - keywords for the search of the module on npmjs
> > - "license" - license type
> > - other properties depend on the implementation/tests, do not touch
> them
> > Example of the package.json file is attached.
> > 7. Prepare/update `local_ignite_path/modules/platforms/nodejs/README.md`
> > file. It should exist and should not be empty. Eg. add a link to a place
> > with the documentation.
> > 8. Execute `npm publish` command from the
> > `local_ignite_path/modules/platforms/nodejs` folder.
> > 9. Check the module is published and well-described at
> > https://www.npmjs.com/package/apache-ignite-client (assuming
> > `apache-ignite-client` is the name of the module)
> >
> > Common instruction about npm publishing:
> > https://docs.npmjs.com/getting-started/publishing-npm-packages
> >
> > How to generate Ignite NodeJS Client API specification:
> > -------------------------------------------------------
> > It should be done if a public API class/method has been changed.
> > 1. Execute `npm install -g jsdoc` to install jsdoc
> > (https://www.npmjs.com/package/jsdoc)
> > 2. Clone or download Ignite repository
> > https://github.com/apache/ignite.git to `local_ignite_path`
> > 3. Go to `local_ignite_path/modules/platforms/nodejs/api_spec`
> > 4. Only if a class has been removed from the public API, remove all
> > files from `local_ignite_path/modules/platforms/nodejs/api_spec` except
> > conf.json file.
> > 5. Execute `jsdoc -c conf.json` command.
> >
> > Note: `local_ignite_path/modules/platforms/nodejs/api_spec/conf.json` is
> > a file with jsdoc configuration.
> >
>
Re: NodeJS client: npm publishing instruction
Posted by Igor Sapego <is...@apache.org>.
I believe, we need to put this instruction on wiki page.
Best Regards,
Igor
On Sun, Jul 1, 2018 at 3:58 PM Alexey Kosenchuk <
alexey.kosenchuk@nobitlost.com> wrote:
> Denis,
>
> below is instruction how to publish/update npm module with Ignite NodeJS
> client on npmjs.
> Use it when you decide to publish the client.
>
> Another short instruction is how to generate the API spec using jsdoc.
>
> Pls place the instructions to appropriate locations.
>
> Thanks,
> -Alexey
>
>
> How to publish Ignite NodeJS Client on npmjs.com:
> -------------------------------------------------
> 1. Install NodeJS npm (https://nodejs.org/en/), if not installed yet.
> 2. Register an account at npmjs (https://www.npmjs.com/signup), if not
> registered yet.
> 3. Execute `npm login` command and provide your npmjs account credentials.
> 4. Clone or download Ignite repository
> https://github.com/apache/ignite.git to `local_ignite_path`
> 5. Go to `local_ignite_path/modules/platforms/nodejs`
> 6. Prepare/update
> `local_ignite_path/modules/platforms/nodejs/package.json` file. Pay
> attention to:
> - "name" - name of the npm module
> - "version" - version of the npm module, increment it if you update
> the module
> - "description" - description of the npm module
> - "repository" - type and link to the repository with the source code
> - "keywords" - keywords for the search of the module on npmjs
> - "license" - license type
> - other properties depend on the implementation/tests, do not touch them
> Example of the package.json file is attached.
> 7. Prepare/update `local_ignite_path/modules/platforms/nodejs/README.md`
> file. It should exist and should not be empty. Eg. add a link to a place
> with the documentation.
> 8. Execute `npm publish` command from the
> `local_ignite_path/modules/platforms/nodejs` folder.
> 9. Check the module is published and well-described at
> https://www.npmjs.com/package/apache-ignite-client (assuming
> `apache-ignite-client` is the name of the module)
>
> Common instruction about npm publishing:
> https://docs.npmjs.com/getting-started/publishing-npm-packages
>
> How to generate Ignite NodeJS Client API specification:
> -------------------------------------------------------
> It should be done if a public API class/method has been changed.
> 1. Execute `npm install -g jsdoc` to install jsdoc
> (https://www.npmjs.com/package/jsdoc)
> 2. Clone or download Ignite repository
> https://github.com/apache/ignite.git to `local_ignite_path`
> 3. Go to `local_ignite_path/modules/platforms/nodejs/api_spec`
> 4. Only if a class has been removed from the public API, remove all
> files from `local_ignite_path/modules/platforms/nodejs/api_spec` except
> conf.json file.
> 5. Execute `jsdoc -c conf.json` command.
>
> Note: `local_ignite_path/modules/platforms/nodejs/api_spec/conf.json` is
> a file with jsdoc configuration.
>