75 lines
1.3 KiB
Markdown
75 lines
1.3 KiB
Markdown
# Development
|
|
|
|
## Requirements
|
|
|
|
- Go 1.24 or later
|
|
|
|
## Setup
|
|
|
|
```sh
|
|
git clone https://git.rumginger.org/agent/dataxl.git
|
|
cd dataxl
|
|
go mod download
|
|
```
|
|
|
|
## Common Commands
|
|
|
|
Format code:
|
|
|
|
```sh
|
|
gofmt -w cmd/dataxl/*.go
|
|
```
|
|
|
|
Run tests:
|
|
|
|
```sh
|
|
go test ./...
|
|
```
|
|
|
|
Build:
|
|
|
|
```sh
|
|
go build ./cmd/dataxl
|
|
```
|
|
|
|
Run locally:
|
|
|
|
```sh
|
|
go run ./cmd/dataxl -from yaml -to tsv -i examples/people.yaml
|
|
```
|
|
|
|
## Test Coverage
|
|
|
|
The current tests cover:
|
|
|
|
- YAML -> TSV flattening
|
|
- TSV -> JSON path restoration
|
|
- JSON -> XLSX -> JSON round trip
|
|
|
|
When adding a new format or path rule, add tests around both directions where
|
|
possible.
|
|
|
|
## Release Notes
|
|
|
|
There is no automated release pipeline yet. A minimal release flow is:
|
|
|
|
```sh
|
|
go test ./...
|
|
git tag v0.1.0
|
|
git push origin main --tags
|
|
```
|
|
|
|
After tags exist, users can install a specific version:
|
|
|
|
```sh
|
|
go install git.rumginger.org/agent/dataxl/cmd/dataxl@v0.1.0
|
|
```
|
|
|
|
## Design Guidelines
|
|
|
|
- Keep stdin/stdout usable for shell pipelines.
|
|
- Keep TSV behavior predictable because it is the main Excel clipboard format.
|
|
- Preserve headers as the contract between spreadsheet data and structured data.
|
|
- Prefer explicit errors over silent best-effort conversion when a format is unsupported.
|
|
- Keep dependencies small unless a format needs a mature parser/writer.
|