Download and upload seeding files from the OrderCloud platform.
npm install @ordercloud/seedingnpm i @ordercloud/seeding -g and then run seeding --help.
npx @ordercloud/seeding --help.
docker run --mount type=bind,source=,target=/app oliverheywood/ordercloud-seeding --help .
for an absolute path in order for local file reading and writing to be mounted on the container.
./seeding-win.exe --help.
npx @ordercloud/seeding seed Simple-B2C -u={username} -p={password}
`
Create a marketplace based on data in a local file. Looks for files based on the directory the command is run from.
`
npx @ordercloud/seeding seed seed-data-file.yml -u={username} -p={password}
`
Create a marketplace based on a public url.
`
npx @ordercloud/seeding seed https://raw.githubusercontent.com/ordercloud-api/ordercloud-seed/main/seeds/Simple-B2C.yml -u={username} -p={password}
`
Download the data from an existing marketplace to a seed file.
`
npx @ordercloud/seeding download new-file-to-create.yml -i={existing-marketplace-id} -u={username} -p={password}
`
Validate that a local file would seed successfully.
`
npx @ordercloud/seeding validate my-file.yml
`
Javascript API Usage
`typescript
import { download, seed, validate, SerializedMarketplace } from "@ordercloud/seeding";
var myData: SerializedMarketplace = { ... };
await seed({
portalJWT: "xxxxxx",
rawData: myData,
logger: (message:string, type: MessageType) => {
console.log(message)
}
});
`
Marketplace Templates
These are seeding files maintained as part of this repo that represent templates for common ordercloud use cases.
| Command Alias | Raw URL |
| --- | --- |
| seed Simple-B2C | https://raw.githubusercontent.com/ordercloud-api/ordercloud-seed/main/seeds/Simple-B2C.yml |
Development
- Run npm install
- Run npm run build everytime you change source files.
- Run node ./dist/cli.js [command] to debug a command.
- Run npm run test to run unit tests.
Nice to Have features
- JSON as an option
- Reference other files
- Template variables in YAML for imports. Including allowing OC to define an ID and then applying it later.
Steps to release new version
> Note: You must have node version 16 to build the package, you will get errors on node v17 and higher
1. Make your code changes
2. Run npm run build to build the code
3. Run npm run test to run the unit tests against your built code
4. Run npm run pkg to generate the executables (The following warning can be safely ignored: Warning Cannot resolve 'config.)
5. Update "version" field in package.json (use semver)
6. Commit all changes and push to master
7. Create a git release/tag
8. Run npm publish`