cloudflare/cloudflare-typescript
Publicmirrored from https://github.com/cloudflare/cloudflare-typescriptAvailable
CONTRIBUTING.md
107lines · modeblame
2d51afdcstainless-app[bot]2 years ago | 1 | ## Setting up the environment |
| 2 | | |
| 3 | This repository uses [`yarn@v1`](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable). | |
| 4 | Other package managers may work but are not officially supported for development. | |
| 5 | | |
82949dd3stainless-app[bot]2 years ago | 6 | To set up the repository, run: |
2d51afdcstainless-app[bot]2 years ago | 7 | |
| 8 | ```bash | |
| 9 | yarn | |
| 10 | yarn build | |
| 11 | ``` | |
| 12 | | |
| 13 | This will install all the required dependencies and build output files to `dist/`. | |
| 14 | | |
| 15 | ## Modifying/Adding code | |
| 16 | | |
| 17 | Most of the SDK is generated code, and any modified code will be overridden on the next generation. The | |
| 18 | `src/lib/` and `examples/` directories are exceptions and will never be overridden. | |
| 19 | | |
| 20 | ## Adding and running examples | |
| 21 | | |
| 22 | All files in the `examples/` directory are not modified by the Stainless generator and can be freely edited or | |
| 23 | added to. | |
| 24 | | |
| 25 | ```bash | |
| 26 | // add an example to examples/<your-example>.ts | |
| 27 | | |
| 28 | #!/usr/bin/env -S npm run tsn -T | |
| 29 | … | |
| 30 | ``` | |
| 31 | | |
| 32 | ``` | |
| 33 | chmod +x examples/<your-example>.ts | |
| 34 | # run the example against your api | |
| 35 | yarn tsn -T examples/<your-example>.ts | |
| 36 | ``` | |
| 37 | | |
| 38 | ## Using the repository from source | |
| 39 | | |
| 40 | If you’d like to use the repository from source, you can either install from git or link to a cloned repository: | |
| 41 | | |
| 42 | To install via git: | |
| 43 | | |
| 44 | ```bash | |
c21db263stainless-app[bot]2 years ago | 45 | npm install git+ssh://git@github.com:cloudflare/cloudflare-typescript.git |
2d51afdcstainless-app[bot]2 years ago | 46 | ``` |
| 47 | | |
| 48 | Alternatively, to link a local copy of the repo: | |
| 49 | | |
| 50 | ```bash | |
| 51 | # Clone | |
24b75407stainless-app[bot]2 years ago | 52 | git clone https://www.github.com/cloudflare/cloudflare-typescript |
| 53 | cd cloudflare-typescript | |
2d51afdcstainless-app[bot]2 years ago | 54 | |
| 55 | # With yarn | |
| 56 | yarn link | |
| 57 | cd ../my-package | |
| 58 | yarn link cloudflare | |
| 59 | | |
| 60 | # With pnpm | |
| 61 | pnpm link --global | |
| 62 | cd ../my-package | |
| 63 | pnpm link -—global cloudflare | |
| 64 | ``` | |
| 65 | | |
| 66 | ## Running tests | |
| 67 | | |
82949dd3stainless-app[bot]2 years ago | 68 | Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests. |
2d51afdcstainless-app[bot]2 years ago | 69 | |
| 70 | ```bash | |
| 71 | npx prism path/to/your/openapi.yml | |
| 72 | ``` | |
| 73 | | |
| 74 | ```bash | |
| 75 | yarn run test | |
| 76 | ``` | |
| 77 | | |
| 78 | ## Linting and formatting | |
| 79 | | |
| 80 | This repository uses [prettier](https://www.npmjs.com/package/prettier) and | |
| 81 | [eslint](https://www.npmjs.com/package/eslint) to format the code in the repository. | |
| 82 | | |
| 83 | To lint: | |
| 84 | | |
| 85 | ```bash | |
| 86 | yarn lint | |
| 87 | ``` | |
| 88 | | |
| 89 | To format and fix all lint issues automatically: | |
| 90 | | |
| 91 | ```bash | |
| 92 | yarn fix | |
| 93 | ``` | |
| 94 | | |
| 95 | ## Publishing and releases | |
| 96 | | |
| 97 | Changes made to this repository via the automated release PR pipeline should publish to npm automatically. If | |
| 98 | the changes aren't made through the automated pipeline, you may want to make releases manually. | |
| 99 | | |
| 100 | ### Publish with a GitHub workflow | |
| 101 | | |
82949dd3stainless-app[bot]2 years ago | 102 | You can release to package managers by using [the `Publish NPM` GitHub action](https://www.github.com/cloudflare/cloudflare-typescript/actions/workflows/publish-npm.yml). This requires a setup organization or repository secret to be set up. |
2d51afdcstainless-app[bot]2 years ago | 103 | |
| 104 | ### Publish manually | |
| 105 | | |
| 106 | If you need to manually release a package, you can run the `bin/publish-npm` script with an `NPM_TOKEN` set on | |
| 107 | the environment. |