-
Notifications
You must be signed in to change notification settings - Fork 24
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
c782de4
commit 7f51477
Showing
4 changed files
with
129 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
qr-scanner-cli / [Exports](modules.md) | ||
|
||
# QR Scanner CLI | ||
|
||
[![Build Status](https://github.com/victorperin/qr-scanner-cli/workflows/pr-check/badge.svg?branch=master)](https://github.com/victorperin/qr-scanner-cli/actions?query=workflow%3Apr-check+branch%3Amaster) | ||
[![Coverage Status](https://coveralls.io/repos/github/victorperin/qr-scanner-cli/badge.svg?branch=master)](https://coveralls.io/github/victorperin/qr-scanner-cli?branch=master) | ||
[![Known Vulnerabilities](https://snyk.io/test/github/victorperin/qr-scanner-cli/badge.svg)](https://snyk.io/test/github/victorperin/qr-scanner-cli) | ||
[![Maintainability](https://api.codeclimate.com/v1/badges/db529f4bc96d3bc44341/maintainability)](https://codeclimate.com/github/victorperin/qr-scanner-cli/maintainability) | ||
|
||
QR Scanner CLI is a project that can resolve any QR code from an image on your desktop. | ||
|
||
## Installation | ||
|
||
Installation is done using the npm install command: | ||
|
||
``` | ||
npm i -g qr-scanner-cli | ||
``` | ||
|
||
## Usage | ||
|
||
``` | ||
$ qrscanner <input file> | ||
``` | ||
|
||
![New Demo Gif](https://media.giphy.com/media/u5FnaAB5tqlSJr9GuT/source.gif) | ||
|
||
## Options | ||
|
||
Access all available and updated options passing the `--help` argument: | ||
|
||
``` | ||
qrscanner --help | ||
``` | ||
|
||
A view of the options at release [v1.0.0](https://github.com/victorperin/qr-scanner-cli/releases/tag/v1.0.0): | ||
|
||
``` | ||
--clean, -c Clear output, just print the QR Code scan result | ||
--clipboard, -p copy the qr code value to your clipboard | ||
--version Show installed version | ||
--help Show this help | ||
``` | ||
|
||
> Consider that this list may be outdated, always refer to the `help` option described above. | ||
## Examples | ||
|
||
``` | ||
$ qrscanner ./qrCode.jpg | ||
╔══════════════════════════════════════════╗ | ||
║ ║ | ||
║ This message is written in a QR Code ║ | ||
║ ║ | ||
╚══════════════════════════════════════════╝ | ||
$ qrscanner ./qrCode.jpg --clean | ||
This message is written in a QR Code | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
[qr-scanner-cli](README.md) / Exports | ||
|
||
# qr-scanner-cli | ||
|
||
## Table of contents | ||
|
||
### Type aliases | ||
|
||
- [Flags](modules.md#flags) | ||
|
||
### Functions | ||
|
||
- [scanFromFile](modules.md#scanfromfile) | ||
|
||
## Type aliases | ||
|
||
### Flags | ||
|
||
Ƭ **Flags**: { `clear?`: *boolean* ; `clipboard?`: *boolean* ; `open?`: *boolean* } | ||
|
||
#### Type declaration: | ||
|
||
Name | Type | | ||
------ | ------ | | ||
`clear?` | *boolean* | | ||
`clipboard?` | *boolean* | | ||
`open?` | *boolean* | | ||
|
||
Defined in: [cli/flags.ts:13](https://github.com/victorperin/qr-scanner-cli/blob/c782de4/src/cli/flags.ts#L13) | ||
|
||
## Functions | ||
|
||
### scanFromFile | ||
|
||
▸ `Const`**scanFromFile**(`filePath`: *string*, `flags?`: [*Flags*](modules.md#flags)): *Promise*<*string*\> | ||
|
||
This function reads a file, get it's bitmap, searches and read a qrcode from it. | ||
``` | ||
const value = await scanFromFile('./image.jpg') | ||
``` | ||
|
||
#### Parameters: | ||
|
||
Name | Type | Description | | ||
------ | ------ | ------ | | ||
`filePath` | *string* | A file path for an image file containing a QR Code | | ||
`flags?` | [*Flags*](modules.md#flags) | | | ||
|
||
**Returns:** *Promise*<*string*\> | ||
|
||
Value read from the QR Code inside the image | ||
|
||
Defined in: [pipelines/scanFromFile.ts:17](https://github.com/victorperin/qr-scanner-cli/blob/c782de4/src/pipelines/scanFromFile.ts#L17) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters