rf-touchstone 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/development.md DELETED
@@ -1,205 +0,0 @@
1
- # Development for RF Touchstone
2
-
3
- ## Setup Node.js environment
4
-
5
- ### Download and install [Node.js](https://nodejs.org/en/download/package-manager) from the official website
6
-
7
- ### Check the current version of Node.js
8
-
9
- ```sh
10
- node -v
11
- ```
12
-
13
- ### Install yarn
14
-
15
- ```sh
16
- yarn set version stable
17
- ```
18
-
19
- ### Check the current version of yarn
20
-
21
- ```sh
22
- yarn -v
23
- ```
24
-
25
- ### Install packages
26
-
27
- ```sh
28
- yarn
29
- ```
30
-
31
- ### Check for outdated packages, and upgrade packages
32
-
33
- ```sh
34
- yarn upgrade-interactive
35
- ```
36
-
37
- ## Setup Python environment
38
-
39
- ### Create and Use Virtual Environments
40
-
41
- #### Install uv
42
-
43
- `uv` is a fast Python package installer and virtual environment manager. You can install `uv` by running the following command:
44
-
45
- ```sh
46
- curl -LsSf https://astral.sh/uv/install.sh | sh
47
- ```
48
-
49
- #### Add the `uv` executable to your system's PATH
50
-
51
- Source the appropriate environment file for your shell:
52
-
53
- ```sh
54
- # On Bash, Zsh, or Sh:
55
- source $HOME/.local/bin/env
56
- # On Fish:
57
- source $HOME/.local/bin/env.fish
58
- ```
59
-
60
- You may need to restart your shell or open a new terminal session for the changes to take effect.
61
-
62
- #### Create and Use Virtual Environments with uv
63
-
64
- Create a new virtual environment:
65
-
66
- ```sh
67
- uv venv .venv
68
- ```
69
-
70
- #### Activate the virtual environment
71
-
72
- ```sh
73
- # On Windows:
74
- .venv\Scripts\activate
75
- # On MacOS/Linux:
76
- source .venv/bin/activate
77
- ```
78
-
79
- #### To confirm the virtual environment is activated, check the location of your Python interpreter:
80
-
81
- ```sh
82
- # On Windows:
83
- where python
84
- # On MacOS/Linux:
85
- which python
86
- ```
87
-
88
- #### Check python version
89
-
90
- ```sh
91
- python --version
92
- ```
93
-
94
- #### Install packages using uv
95
-
96
- Install packages using a requirements file:
97
-
98
- ```sh
99
- uv pip install -r requirements.txt
100
- ```
101
-
102
- #### Check packages available for update
103
-
104
- ```sh
105
- uv pip list --outdated
106
- ```
107
-
108
- #### Upgrade packages
109
-
110
- ```sh
111
- uv pip install -r requirements.txt --upgrade
112
- ```
113
-
114
- #### Deactivate a virtual environment
115
-
116
- ```sh
117
- # On Windows:
118
- .venv\Scripts\deactivate
119
- # On MacOS/Linux:
120
- deactivate
121
- ```
122
-
123
- ## Development
124
-
125
- ### Lint with [ESLint](https://eslint.org/)
126
-
127
- ```sh
128
- yarn lint
129
- ```
130
-
131
- ### Format with [Prettier](https://prettier.io/)
132
-
133
- ```sh
134
- yarn format
135
- ```
136
-
137
- ### Unit test with [Vitest](https://vitest.dev/)
138
-
139
- #### Interactive development
140
-
141
- Runs the tests in interactive watch mode:
142
-
143
- ```sh
144
- yarn test:watch
145
- ```
146
-
147
- #### Command line
148
-
149
- ```sh
150
- yarn test:unit
151
- ```
152
-
153
- #### Check test coverage
154
-
155
- ```sh
156
- yarn test:coverage
157
- ```
158
-
159
- ### All tests
160
-
161
- Convenient command includes: lint, format, unit:test, test:coverage, build, and generate API docs
162
-
163
- ```sh
164
- yarn test
165
- ```
166
-
167
- ### Compile, build and minify for production
168
-
169
- ```sh
170
- yarn build
171
- ```
172
-
173
- ### Documentation (using [VitePress](https://vitepress.dev/) and [TypeDoc](https://typedoc.org/))
174
-
175
- #### Generate API documentation from TSDoc comments
176
-
177
- This command uses TypeDoc to parse TSDoc comments in the TypeScript source files and generates markdown files in the `docs/api` directory.
178
-
179
- ```sh
180
- yarn docs:md
181
- ```
182
-
183
- #### Start local development server for documentation
184
-
185
- This command starts the VitePress development server. You can view your documentation site locally, usually at `http://localhost:5173`.
186
-
187
- ```sh
188
- yarn docs:dev
189
- ```
190
-
191
- #### Build documentation for deployment
192
-
193
- This command builds the static HTML, CSS, and JavaScript files for the documentation site. The output will be in the `docs/.vitepress/dist` directory.
194
-
195
- ```sh
196
- yarn docs:build
197
- ```
198
-
199
- #### Preview the built documentation locally
200
-
201
- After building the documentation, this command allows you to preview the production build locally before deploying it.
202
-
203
- ```sh
204
- yarn docs:preview
205
- ```
File without changes