Skip to content

Commit e256d75

Browse files
authored
Merge pull request #8 from happy-game/docs
Docs: Update Documentation
2 parents a12c594 + f09c5f9 commit e256d75

39 files changed

+275
-1140
lines changed

CHANGELOG.md

Lines changed: 0 additions & 473 deletions
Large diffs are not rendered by default.

LICENSE

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
MIT License
22

33
Copyright (c) 2010 - 2021 Brian Carlson
4+
Copyright (c) 2025 happy-game
45

56
Permission is hereby granted, free of charge, to any person obtaining a copy
67
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 28 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,76 +1,66 @@
1-
# node-postgres
1+
# gaussdb-node
22

3-
![Build Status](https://github.com/brianc/node-postgres/actions/workflows/ci.yml/badge.svg)
4-
<span class="badge-npmversion"><a href="https://npmjs.org/package/pg" title="View this project on NPM"><img src="https://img.shields.io/npm/v/pg.svg" alt="NPM version" /></a></span>
5-
<span class="badge-npmdownloads"><a href="https://npmjs.org/package/pg" title="View this project on NPM"><img src="https://img.shields.io/npm/dm/pg.svg" alt="NPM downloads" /></a></span>
3+
<!-- TODO: 打包后再恢复 -->
4+
<!-- ![Build Status](https://github.com/HuaweiCloudDeveloper/gaussdb-node/actions/workflows/ci.yml/badge.svg)
5+
<span class="badge-npmversion"><a href="https://npmjs.org/package/gaussdb" title="View this project on NPM"><img src="https://img.shields.io/npm/v/gaussdb.svg" alt="NPM version" /></a></span>
6+
<span class="badge-npmdownloads"><a href="https://npmjs.org/package/gaussdb" title="View this project on NPM"><img src="https://img.shields.io/npm/dm/gaussdb.svg" alt="NPM downloads" /></a></span> -->
67

7-
Non-blocking PostgreSQL client for Node.js. Pure JavaScript and optional native libpq bindings.
8+
Non-blocking GaussDB client for Node.js. Pure JavaScript and optional native libpq bindings.
89

910
## Monorepo
1011

11-
This repo is a monorepo which contains the core [pg](https://github.com/brianc/node-postgres/tree/master/packages/pg) module as well as a handful of related modules.
12+
This repo is a monorepo which contains the core [gaussdb](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb) module as well as a handful of related modules.
1213

13-
- [pg](https://github.com/brianc/node-postgres/tree/master/packages/pg)
14-
- [pg-pool](https://github.com/brianc/node-postgres/tree/master/packages/pg-pool)
15-
- [pg-native](https://github.com/brianc/node-postgres/tree/master/packages/pg-native)
16-
- [pg-cursor](https://github.com/brianc/node-postgres/tree/master/packages/pg-cursor)
17-
- [pg-query-stream](https://github.com/brianc/node-postgres/tree/master/packages/pg-query-stream)
18-
- [pg-connection-string](https://github.com/brianc/node-postgres/tree/master/packages/pg-connection-string)
19-
- [pg-protocol](https://github.com/brianc/node-postgres/tree/master/packages/pg-protocol)
14+
- [gaussdb](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb)
15+
- [gaussdb-pool](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb-pool)
16+
- [pg-native](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/pg-native)
17+
- [gaussdb-cursor](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb-cursor)
18+
- [gaussdb-query-stream](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb-query-stream)
19+
- [gaussdb-connection-string](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb-connection-string)
20+
- [gaussdb-protocol](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/packages/gaussdb-protocol)
2021

2122
## Install
2223

2324
```
24-
npm install pg
25+
npm install gaussdb
2526
```
2627

2728
## Documentation
2829

29-
Each package in this repo should have its own readme more focused on how to develop/contribute. For overall documentation on the project and the related modules managed by this repo please see:
30+
Each package in this repo should have its own readme more focused on how to develop/contribute.
31+
<!-- TODO: 构建文档后恢复 -->
32+
<!-- For overall documentation on the project and the related modules managed by this repo please see: -->
3033

31-
### :star: [Documentation](https://node-postgres.com) :star:
34+
### :star: Documentation:star:
3235

33-
The source repo for the documentation is available for contribution [here](https://github.com/brianc/node-postgres/tree/master/docs).
36+
The source repo for the documentation is available for contribution [here](https://github.com/HuaweiCloudDeveloper/gaussdb-node/tree/master/docs).
3437

3538
### Features
3639

3740
- Pure JavaScript client and native libpq bindings share _the same API_
3841
- Connection pooling
39-
- Extensible JS ↔ PostgreSQL data-type coercion
40-
- Supported PostgreSQL features
42+
- Extensible JS ↔ GaussDB data-type coercion
43+
- Supported GaussDB features
4144
- Parameterized queries
4245
- Named statements with query plan caching
43-
- Async notifications with `LISTEN/NOTIFY`
4446
- Bulk import & export with `COPY TO/COPY FROM`
4547

4648
### Extras
4749

48-
node-postgres is by design pretty light on abstractions. These are some handy modules we've been using over the years to complete the picture.
49-
The entire list can be found on our [wiki](https://github.com/brianc/node-postgres/wiki/Extras).
50+
gaussdb-node is by design pretty light on abstractions. These are some handy modules we've been using over the years to complete the picture.
51+
<!-- TODO: 构建后恢复 -->
52+
<!-- The entire list can be found on our [wiki](https://github.com/HuaweiCloudDeveloper/gaussdb-node/wiki/Extras). -->
5053

5154
## Support
5255

53-
node-postgres is free software. If you encounter a bug with the library please open an issue on the [GitHub repo](https://github.com/brianc/node-postgres). If you have questions unanswered by the documentation please open an issue pointing out how the documentation was unclear & I will do my best to make it better!
56+
gaussdb-node is free software. If you encounter a bug with the library please open an issue on the [GitHub repo](https://github.com/HuaweiCloudDeveloper/gaussdb-node). If you have questions unanswered by the documentation please open an issue pointing out how the documentation was unclear & I will do my best to make it better!
5457

5558
When you open an issue please provide:
5659

5760
- version of Node
58-
- version of Postgres
61+
- version of GaussDB
5962
- smallest possible snippet of code to reproduce the problem
6063

61-
You can also follow me [@briancarlson](https://twitter.com/briancarlson) if that's your thing. I try to always announce noteworthy changes & developments with node-postgres on Twitter.
62-
63-
## Sponsorship :two_hearts:
64-
65-
node-postgres's continued development has been made possible in part by generous financial support from [the community](https://github.com/brianc/node-postgres/blob/master/SPONSORS.md).
66-
67-
If you or your company are benefiting from node-postgres and would like to help keep the project financially sustainable [please consider supporting](https://github.com/sponsors/brianc) its development.
68-
69-
### Featured sponsor
70-
71-
Special thanks to [medplum](https://medplum.com) for their generous and thoughtful support of node-postgres!
72-
73-
![medplum](https://raw.githubusercontent.com/medplum/medplum-logo/refs/heads/main/medplum-logo.png)
7464

7565
## Contributing
7666

@@ -89,14 +79,10 @@ If your change involves breaking backwards compatibility please please point tha
8979
1. Clone the repo
9080
2. Ensure you have installed libpq-dev in your system.
9181
3. From your workspace root run `yarn` and then `yarn lerna bootstrap`
92-
4. Ensure you have a PostgreSQL instance running with SSL enabled and an empty database for tests
82+
4. Ensure you have a GaussDB instance running with SSL enabled and an empty database for tests
9383
5. Ensure you have the proper environment variables configured for connecting to the instance
9484
6. Run `yarn test` to run all the tests
9585

96-
## Troubleshooting and FAQ
97-
98-
The causes and solutions to common errors can be found among the [Frequently Asked Questions (FAQ)](https://github.com/brianc/node-postgres/wiki/FAQ)
99-
10086
## License
10187

10288
Copyright (c) 2010-2020 Brian Carlson ([email protected])

SPONSORS.md

Lines changed: 0 additions & 56 deletions
This file was deleted.

docs/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# node-postgres docs website
1+
# gaussdb-node docs
22

3-
This is the documentation for node-postgres which is currently hosted at [https://node-postgres.com](https://node-postgres.com).
3+
This is the documentation for gaussdb-node.
44

55
## Development
66

docs/pages/_meta.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
{
22
"index": "Welcome",
3-
"announcements": "Announcements",
43
"apis": "API"
54
}

docs/pages/announcements.mdx

Lines changed: 0 additions & 146 deletions
This file was deleted.

docs/pages/apis/_meta.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
2-
"client": "pg.Client",
3-
"pool": "pg.Pool",
4-
"result": "pg.Result",
5-
"types": "pg.Types",
2+
"client": "gaussdb.Client",
3+
"pool": "gaussdb.Pool",
4+
"result": "gaussdb.Result",
5+
"types": "gaussdb.Types",
66
"cursor": "Cursor",
77
"utilities": "Utilities"
88
}

0 commit comments

Comments
 (0)