Skip to content

Commit add3dc1

Browse files
committed
order
1 parent cf41cae commit add3dc1

File tree

1 file changed

+35
-34
lines changed

1 file changed

+35
-34
lines changed

PUBLISH.md

Lines changed: 35 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -53,41 +53,47 @@ yarn bump-versions
5353

5454
## Package Publishing Workflows
5555

56-
### 1. Parser Package (`pgsql-parser`)
56+
### 1. Deparser Package (`pgsql-deparser`)
5757

58-
The parser package uses a version preparation script to generate multiple version-specific packages.
58+
The deparser package uses a template-based approach for multi-version publishing.
5959

6060
#### Prepare Versions
6161
```bash
62-
cd packages/parser
62+
cd packages/deparser
6363
npm run prepare-versions
6464
```
6565

66-
This script (`scripts/prepare-versions.ts`):
67-
- Reads version configuration from `config/versions.json`
68-
- Creates version-specific directories in `packages/parser/versions/`
69-
- Generates `package.json`, `tsconfig.json`, and source files for each PostgreSQL version
70-
- Each version gets its own libpg-query dependency and npm tag
66+
This runs a complete preparation pipeline:
67+
1. `strip-transformer-types` - Clean up transformer types
68+
2. `strip-direct-transformer-types` - Clean up direct transformer types
69+
3. `strip-deparser-types` - Clean up deparser types
70+
4. `organize-transformers` - Organize transformers by version
71+
5. `generate-version-deparsers` - Generate version-specific deparsers
72+
6. `generate-packages` - Generate package.json files for each version
73+
74+
The `generate-packages` script (`scripts/generate-version-packages.ts`):
75+
- Uses the template from `config/deparser-versions.json`
76+
- Creates version-specific packages in `packages/deparser/versions/`
77+
- Sets up proper dependencies and npm tags for each PostgreSQL version
7178

7279
#### Build and Publish Individual Versions
7380
```bash
7481
# Navigate to a specific version directory
75-
cd packages/parser/versions/17
82+
cd packages/deparser/versions/17
7683

7784
# Build the package
7885
npm run build
7986

80-
# cd to dist/
81-
87+
# dist
8288
cd dist/
8389

8490
# Publish with the correct tag
8591
npm publish --tag pg17
8692
```
8793

88-
#### Publish All Parser Versions
94+
#### Publish All Deparser Versions
8995
```bash
90-
cd packages/parser
96+
cd packages/deparser
9197

9298
# Prepare all versions
9399
npm run prepare-versions
@@ -96,52 +102,47 @@ npm run prepare-versions
96102
for version in versions/*/; do
97103
cd "$version"
98104
npm run build
105+
cd dist/
99106
npm run publish:pkg # Uses the npmTag from config
100107
cd ..
101108
done
102109
```
103110

104-
### 2. Deparser Package (`pgsql-deparser`)
111+
### 2. Parser Package (`pgsql-parser`)
105112

106-
The deparser package uses a template-based approach for multi-version publishing.
113+
The parser package uses a version preparation script to generate multiple version-specific packages.
107114

108115
#### Prepare Versions
109116
```bash
110-
cd packages/deparser
117+
cd packages/parser
111118
npm run prepare-versions
112119
```
113120

114-
This runs a complete preparation pipeline:
115-
1. `strip-transformer-types` - Clean up transformer types
116-
2. `strip-direct-transformer-types` - Clean up direct transformer types
117-
3. `strip-deparser-types` - Clean up deparser types
118-
4. `organize-transformers` - Organize transformers by version
119-
5. `generate-version-deparsers` - Generate version-specific deparsers
120-
6. `generate-packages` - Generate package.json files for each version
121-
122-
The `generate-packages` script (`scripts/generate-version-packages.ts`):
123-
- Uses the template from `config/deparser-versions.json`
124-
- Creates version-specific packages in `packages/deparser/versions/`
125-
- Sets up proper dependencies and npm tags for each PostgreSQL version
121+
This script (`scripts/prepare-versions.ts`):
122+
- Reads version configuration from `config/versions.json`
123+
- Creates version-specific directories in `packages/parser/versions/`
124+
- Generates `package.json`, `tsconfig.json`, and source files for each PostgreSQL version
125+
- Each version gets its own libpg-query dependency and npm tag
126126

127127
#### Build and Publish Individual Versions
128128
```bash
129129
# Navigate to a specific version directory
130-
cd packages/deparser/versions/17
130+
cd packages/parser/versions/17
131131

132132
# Build the package
133133
npm run build
134134

135-
# dist
135+
# cd to dist/
136+
136137
cd dist/
137138

138139
# Publish with the correct tag
139140
npm publish --tag pg17
140141
```
141142

142-
#### Publish All Deparser Versions
143+
#### Publish All Parser Versions
143144
```bash
144-
cd packages/deparser
145+
cd packages/parser
145146

146147
# Prepare all versions
147148
npm run prepare-versions
@@ -150,8 +151,8 @@ npm run prepare-versions
150151
for version in versions/*/; do
151152
cd "$version"
152153
npm run build
153-
cd dist/
154154
npm run publish:pkg # Uses the npmTag from config
155155
cd ..
156156
done
157-
```
157+
```
158+

0 commit comments

Comments
 (0)