Release 21.3 (#20)

* Release 21.3

* Example changed

* Script for JS code extraction from README added

Author: Denis-Averin

Makefile

@@ -1,5 +1,9 @@
 .PHONY: all
-all: clean ci update_modules format lint cover
+all: clean ci lint build cover
+
+.PHONY: init
+init:
+	npm install
 
 .PHONY: format
 format:
@@ -27,8 +31,8 @@ cover:
 lint:
 	npm run lint
 
-.PHONY: update_modules
-update_modules:
+.PHONY: update
+update:
 	npm run check-updates
 	npm update
 	npm outdated

README.md

@@ -1,7 +1,7 @@
 # Aspose.BarCode Cloud SDK for Node.js
 
 + API version: 3.0
-+ Package version: 21.2.0
++ Package version: 21.3.0
 
 Aspose.BarCode for Cloud is a REST API for Linear, 2D and postal barcode generation and recognition in the cloud. API recognizes and generates barcode images in a variety of formats. Barcode REST API allows to specify barcode image attributes like image width, height, border style and output image format in order to customize the generation process. Developers can also specify the barcode type and text attributes such as text location and font styles in order to suit the application requirements.
 
@@ -34,18 +34,46 @@ const config = new Barcode.Configuration(
     'Client Secret from https://dashboard.aspose.cloud/applications'
 );
 
-async function generate(api) {
-    const oneBarcode = await api.getBarcodeGenerate(
+async function generateBarcode(api) {
+    const request = new Barcode.GetBarcodeGenerateRequest(
         Barcode.EncodeBarcodeType.Pdf417,
-        'Aspose.BarCode for Cloud Sample'
-    );
+        'Aspose.BarCode for Cloud Sample');
+    const oneBarcode = await api.getBarcodeGenerate(request);
 
-    fs.writeFileSync('out.png', oneBarcode.body);
-    console.log('Saved to out.png');
+    const fileName = 'Pdf417.png'
+    fs.writeFileSync(fileName, oneBarcode.body);
+
+    return fileName;
+}
+
+async function recognizeBarcode(api, fileName) {
+    const request = new Barcode.PostBarcodeRecognizeFromUrlOrContentRequest();
+    request.image = fs.readFileSync(fileName);
+    request.preset = Barcode.PresetType.HighPerformance;
+
+    const result = await api.postBarcodeRecognizeFromUrlOrContent(request);
+
+    return result.body.barcodes;
 }
 
 const api = new Barcode.BarcodeApi(config);
-generate(api).catch(err => console.error(err));
+
+console.log('Generating barcode...');
+generateBarcode(api)
+    .then(fileName => {
+        console.log('Barcode saved to ' + fileName);
+
+        console.log('Trying to recognize barcode...');
+        recognizeBarcode(api, fileName)
+            .then(barcodes => {
+                console.log('Recognized barcodes are:');
+                console.log(JSON.stringify(barcodes, null, 2));
+            });
+    })
+    .catch(err => {
+        console.error(JSON.stringify(err, null, 2));
+        process.exitCode = 1;
+    });
 ```
 
 Every method returns a chainable promise.

docs/models.md

@@ -290,6 +290,19 @@ interface CodablockParams {
 }
 ```
 
+## Code128Emulation
+
+
+
+```ts
+enum Code128Emulation {
+    None = 'None',
+    Code903 = 'Code903',
+    Code904 = 'Code904',
+    Code905 = 'Code905'
+}
+```
+
 ## Code16KParams
 
 Code16K parameters.
@@ -1425,6 +1438,11 @@ interface Pdf417Params {
      * Extended Channel Interpretation Identifiers. Applies for Macro PDF417 text fields.
      */
     macroECIEncoding?: ECIEncodings;
+
+    /**
+     * Function codeword for Code 128 emulation. Applied for MicroPDF417 only. Ignored for PDF417 and MacroPDF417 barcodes.
+     */
+    code128Emulation?: Code128Emulation;
 }
 ```
 

example.js

@@ -8,15 +8,43 @@ const config = new Barcode.Configuration(
     process.env['TEST_CONFIGURATION_ACCESS_TOKEN']
 );
 
-async function generate(api) {
-    const oneBarcode = await api.getBarcodeGenerate(
+async function generateBarcode(api) {
+    const request = new Barcode.GetBarcodeGenerateRequest(
         Barcode.EncodeBarcodeType.Pdf417,
-        'Aspose.BarCode for Cloud Sample'
-    );
+        'Aspose.BarCode for Cloud Sample');
+    const oneBarcode = await api.getBarcodeGenerate(request);
 
-    fs.writeFileSync('out.png', oneBarcode.body);
-    console.log('Saved to out.png');
+    const fileName = 'Pdf417.png'
+    fs.writeFileSync(fileName, oneBarcode.body);
+
+    return fileName;
+}
+
+async function recognizeBarcode(api, fileName) {
+    const request = new Barcode.PostBarcodeRecognizeFromUrlOrContentRequest();
+    request.image = fs.readFileSync(fileName);
+    request.preset = Barcode.PresetType.HighPerformance;
+
+    const result = await api.postBarcodeRecognizeFromUrlOrContent(request);
+
+    return result.body.barcodes;
 }
 
 const api = new Barcode.BarcodeApi(config);
-generate(api).catch(err => { console.error(err); process.exitCode = 1; });
+
+console.log('Generating barcode...');
+generateBarcode(api)
+    .then(fileName => {
+        console.log('Barcode saved to ' + fileName);
+
+        console.log('Trying to recognize barcode...');
+        recognizeBarcode(api, fileName)
+            .then(barcodes => {
+                console.log('Recognized barcodes are:');
+                console.log(JSON.stringify(barcodes, null, 2));
+            });
+    })
+    .catch(err => {
+        console.error(JSON.stringify(err, null, 2));
+        process.exitCode = 1;
+    });