summaryrefslogtreecommitdiff
path: root/README
blob: 0a16002344d61d393ddb6a26b1fd5809ec085ce8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# GNU Taler Wallet

This repository contains the implementation of a wallet for GNU Taler written
in TypeScript.


## Dependencies

The following dependencies are required to build the wallet:

* python>=3.8
* nodejs>=12
* jq
* npm
* pnpm
* zip


## Installation

The CLI version of the wallet supports the normal GNU installation process.

```shell
./configure [ --prefix=$PREFIX ] && make install
```

### Building the WebExtension

The WebExtension can be built via the 'webextension' make target:

```shell
./configure && make webextension
```

This will create the zip file with the WebExtension in the location

```
packages/taler-wallet-webextension/taler-wallet-webextension-$VERSION.zip
```

We also provide a `Dockerfile` for a container that can build the WebExtension:

```shell
# Build the image
(host)$ docker build --tag walletbuilder contrib/wallet-docker

# Run container with wallet source mounted
(host)$ docker run -it -v $PWD:/wallet-core walletbuilder

# Run build inside container
(container)$ cd wallet-core
(container)$ ./configure && make webextension
```


### Compiling from Git

If you are compiling the code from git, you have to run `./bootstrap` before
running `./configure`.


# Integration Tests

This repository comes with integration tests for GNU Taler.  To run them,
install the wallet first.  Then use the test runner from the
taler-integrationtests package:

```shell
cd packages/taler-integrationtests/
./testrunner '*'
```

The test runner accepts a bash glob pattern as parameter.  Individual tests can
be run by specifying their name.

To check coverage, use nyc from the root of the repository and make sure that the taler-wallet-cli
from the source tree is executed, and not the globally installed one:

```
PATH="$PWD/packages/taler-wallet-cli/bin:$PATH" \
  nyc ./packages/taler-integrationtests/testrunner '*'
```