npm package: @pratapdd/kquery
Description: kQuery - a jquery alike simple replacement library for jquery
Author: Pratap Dessai
Latest version: 1.1.5


<h1 align="center" style="border-bottom: none;">🚀 kQuery 🚀</h1>
<h3 align="center">A light-weight clone of your oldie goldie jQuery </h>
<p align="center">
  <a href="https://travis-ci.org/github/pratapdd/kQuery">
    <img alt="Travis" src="https://img.shields.io/travis/pratapdd/kQuery?style=flat-square">
  </a>
  <a href="https://codecov.io/gh/pratapdd/kQuery">
    <img alt="Codecov" src="https://img.shields.io/codecov/c/github/pratapdd/kQuery?style=flat-square">
  </a>
  <a href="https://github.com/pratapdd/kQuery/actions">
    <img alt="GitHub Workflow" src="https://img.shields.io/github/workflow/status/pratapdd/kQuery/Release%20npm%20package?style=flat-square">
  </a>
  <a href="https://github.com/pratapdd/kQuery/releases/tag/v1.0.0">
    <img alt="Semantic Release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
  </a>
  <a href="https://github.com/pratapdd/kQuery/releases/tag/v1.0.0">
    <img alt="Commitizen friendly" src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg">
  </a>
</p>
<p align="center">
  <a href="https://www.npmjs.com/package/@pratapdd/kquery">
    <img alt="npm latest version" src="https://img.shields.io/npm/v/@pratapdd/kquery?style=flat-square">
  </a>
</p>

**kQuery** A light-weight clone of your oldie goldie jQuery.



## Table of contents : for Evaluation

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->


- [Local Setup](#local-setup)
- [API Documentation github pages](#API-Documentation-github-pages)
- [Playground](#Playground-to-check-library-in-action)
- [Best Practices and Build Setup](#Best-Practices-and-Build-setup)
- [Future Enhancements](#future-enhancements)
- [API](#api)
- [Authors and Contributors](#authors-and-contributors)


<!-- END doctoc generated TOC please keep comment here to allow auto update -->


## Local Setup
### Prerequisite
 - node v12.14.1 and above
/ for Yarn users
 - yarn v1.22.5

### Steps to install
 - npm install
/
 - yarn

### Steps to run Tests
 - npm run test
/
 - yarn test

### Steps to commit
- git commit and follow instructions to match the semenatic release commit format


### code coverage
- You can find code coverage report here in codecov
<a href="https://codecov.io/github/pratapdd/kQuery" target="_blank">Click here to go to code coverage report</a>


### API Documentation github pages
<a href="https://pratapdd.github.io/kQuery" target="_blank">Click here to go API Documentation</a>

***Two new apis added
### `kCollection.before(kCollection | htmlString)`***
### `kCollection.after(kCollection | htmlString)`***



### Playground to check library in action
<a href="https://pratapdd.github.io/kQuery/playground" target="_blank">Click here to go to playground</a>


### Npm repository here
<a href="https://www.npmjs.com/package/@pratapdd/kquery" target="_blank">Click here to go to npm artifactory</a>

### github link to check gitflow and releases repository here
<a href="https://github.com/pratapdd/kQuery/actions" target="_blank">Click here to go to github actions</a>

<a href="https://github.com/pratapdd/kQuery/releases" target="_blank">Click here to go to github releases</a>


## Best Practices and Build setup
- Eslint for lint
- Prettier for better code file formatting
- Jest for writing tests with coverage report
- husky - precommit hook to run lint and test always during new commit changes.
- added codecov support to publish coverage
- added travis build for running build
https://travis-ci.com/github/pratapdd/kQuery
- I also tried another pipeline out of curiosity
gitHub Actions and with that we can move away from travis and setup
the workflow closely related to github. This gave advantages to create changeLog and release inside github and also with managing secrets
- added commitizine and auto validation for commit messages and proper formatting of messages.
- used rollup for bundling file to create bundles for various target environments
- gitub pages for api documentation, presently put the documentation in different 
directory docs/ .We can put this on different branch for document release in future.



## Future Enhancements
- Introduce typescript for types.
- auto generate API documentation out of codebase something like js-doc
- Integrate Issues in github with proper ticketing in pull request template.



## API

Below APIs will be made available by kQuery.

- `kQuery(cssSelectorString)`

- `kCollection.replaceWith(kCollection)`

- `kCollection.style(Object)`

- `kCollection.remove()`

- `kCollection.find(cssSelectorString)`

- `kCollection.get()`

- `kCollection.before(kCollection | htmlString)`***

- `kCollection.after(kCollection | htmlString)`***

***New APIs


## Authors and Contributors

@pratapdd
... list awaiting awesome people like you


## Contributors

This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].

Take your first steps by committing your changes and raise a pull request.

## Backers

Thank you to all our backers! 🙏 [[Become a backer]