Skip to content
This repository was archived by the owner on Apr 25, 2025. It is now read-only.

Commit a102eb3

Browse files
Firas QutishatGerrit Code Review
authored andcommitted
Merge "[FAB-6079] Update README"
2 parents 7cdef1d + bbc0200 commit a102eb3

File tree

2 files changed

+31
-17
lines changed

2 files changed

+31
-17
lines changed

README.md

Lines changed: 21 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ This SDK enables Go developers to build solutions that interact with [Hyperledge
1010

1111
Obtain the client SDK packages for Fabric and Fabric CA.
1212

13-
```
14-
# Hyperledger Fabric client package
15-
go get -u github.com/hyperledger/fabric-sdk-go/pkg/fabric-client
13+
```bash
14+
go get -u github.com/hyperledger/fabric-sdk-go
1615

17-
# Hyperledger Fabric CA client package
18-
go get -u github.com/hyperledger/fabric-sdk-go/pkg/fabric-ca-client
16+
# Optional - populate vendor directory (if needed by your downstream vendoring solution)
17+
# cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/
18+
# make populate
1919
```
2020

2121
You're good to go, happy coding! Check out the examples for usage demonstrations.
@@ -30,8 +30,7 @@ You're good to go, happy coding! Check out the examples for usage demonstrations
3030

3131
- Discussion is happening in [Rocket Chat](https://chat.hyperledger.org/channel/fabric-sdk-go).
3232
- Issue tracking is handled in [Jira](https://jira.hyperledger.org/secure/RapidBoard.jspa?projectKey=FAB&rapidView=7&view=planning).
33-
- Active development occurs in the [Gerrit](https://gerrit.hyperledger.org/r/#/admin/projects/fabric-sdk-go)
34-
repository.
33+
- Active development occurs in the [Gerrit](https://gerrit.hyperledger.org/r/#/admin/projects/fabric-sdk-go) repository.
3534

3635
## Client SDK
3736

@@ -44,7 +43,7 @@ repository.
4443

4544
### Running the test suite
4645

47-
```
46+
```bash
4847
# In the Fabric SDK Go directory
4948
cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/
5049

@@ -63,8 +62,9 @@ make clean
6362
If you want to contribute to the Go SDK, please run the test suite and submit patches to the Gerrit git repostory for review. For general guidelines, please refer to the Fabric project's [contribution page](http://hyperledger-fabric.readthedocs.io/en/latest/CONTRIBUTING.html).
6463

6564
You need:
65+
6666
- Go
67-
- [Dep](https://github.com/golang/dep)
67+
- [Dep](https://github.com/golang/dep)
6868
- Make
6969
- Docker
7070
- Docker Compose
@@ -76,7 +76,7 @@ To contribute patches, you will need to clone (or add a remote) from [Gerrit](ht
7676

7777
### Running a portion of the test suite
7878

79-
```
79+
```bash
8080
# In the Fabric SDK Go directory
8181
cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/
8282

@@ -95,23 +95,24 @@ make integration-test
9595

9696
### Running package unit tests manually
9797

98-
```
98+
```bash
9999
# In a package directory
100100
go test
101101
```
102102

103103
### Running integration tests manually
104104

105105
You need:
106+
106107
- A working fabric and fabric-ca set up. It is recommended that you use the docker-compose file provided in `test/fixtures`. It is also recommended that you use the default .env settings provided in `test/fixtures`. See steps below.
107108
- Customized settings in the `test/fixtures/config/config_test.yaml` in case your Hyperledger Fabric network is not running on `localhost` or is using different ports.
108109

109-
*Testing with Fabric Images at Docker Hub*
110+
#### Testing with Fabric Images at Docker Hub
110111

111112
The test suite defaults to the latest compatible tag of fabric images at Docker Hub.
112113
The following commands starts Fabric:
113114

114-
```
115+
```bash
115116
# In the Fabric SDK Go directory
116117
cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/
117118

@@ -123,19 +124,21 @@ cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/test/fixtures/
123124
docker-compose up --force-recreate
124125
```
125126

126-
*Running Integration Tests*
127+
#### Running Integration Tests
127128

128129
Fabric should now be running. In a different shell, run integration tests
129-
```
130+
131+
```bash
130132
# In the Fabric SDK integration tests directory
131133
cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/test/integration/
132134
go test
133135
```
134136

135-
*Testing with Local Build of Fabric (Advanced)*
137+
#### Testing with Local Build of Fabric (Advanced)
136138

137139
Alternatively you can build and run Fabric on your own box using the following commands:
138-
```
140+
141+
```bash
139142
# Build fabric:
140143
cd $GOPATH/src/github.com/hyperledger/
141144
git clone https://github.com/hyperledger/fabric
@@ -156,6 +159,7 @@ cd $GOPATH/src/github.com/hyperledger/fabric-sdk-go/test/fixtures/
156159
```
157160

158161
## License
162+
159163
Hyperledger Fabric SDK Go software is licensed under the [Apache License Version 2.0](LICENSE).
160164

161165
---

doc.go

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
/*
2+
Copyright SecureKey Technologies Inc. All Rights Reserved.
3+
4+
SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
/*
8+
Package fabricsdk enables Go developers to build solutions that interact with Hyperledger Fabric.
9+
*/
10+
package fabricsdk

0 commit comments

Comments
 (0)