├── .github
    ├── FUNDING.yml
    ├── release.yml
    └── workflows
    │   ├── build.yml
    │   ├── pull_request.yml
    │   └── release.yml
├── .gitignore
├── .vscode
    └── launch.json
├── CHANGELOG.md
├── LICENSE
├── README.html
├── README.md
├── analysis_options.yaml
├── assets
    └── screenshots
    │   ├── demo.mp4
    │   └── screenshot.png
├── bin
    └── vscode_runner.dart
├── lib
    ├── database.dart
    ├── enums
    │   ├── enums.dart
    │   └── vscode_version.dart
    ├── helpers
    │   ├── directories.dart
    │   └── helpers.dart
    ├── logs
    │   ├── logging_manager.dart
    │   └── src
    │   │   ├── log_file_service.dart
    │   │   └── src.dart
    ├── notifications.dart
    └── vscode.dart
├── package
    ├── codes.merritt.vscode_runner.service
    ├── install.sh
    ├── plasma-runner-vscode_runner.desktop
    └── uninstall.sh
├── pubspec.lock
└── pubspec.yaml


/.github/FUNDING.yml:
--------------------------------------------------------------------------------
1 | github: Merrit
2 | ko_fi: merrit
3 | custom: ["https://paypal.me/KristenMcWilliam", "https://www.buymeacoffee.com/Merritt"]
4 | 


--------------------------------------------------------------------------------
/.github/release.yml:
--------------------------------------------------------------------------------
 1 | changelog:
 2 |   exclude:
 3 |     labels:
 4 |       - ignore-for-release
 5 |   categories:
 6 |     - title: Breaking Changes 🛠
 7 |       labels:
 8 |         - Semver-Major
 9 |         - breaking-change
10 |     - title: New Features 🎉
11 |       labels:
12 |         - Semver-Minor
13 |         - enhancement
14 |     - title: Fixes ✨
15 |       labels:
16 |         - bugfix
17 |     - title: Code Cleanup 🪥
18 |       labels:
19 |         - cleanup
20 |     - title: Other Changes
21 |       labels:
22 |         - "*"
23 | 


--------------------------------------------------------------------------------
/.github/workflows/build.yml:
--------------------------------------------------------------------------------
 1 | name: Build
 2 | on:
 3 |   # Enable manual run
 4 |   workflow_dispatch:
 5 |   # Allow being called by other workflows
 6 |   workflow_call:
 7 |     inputs:
 8 |       pre-release:
 9 |         description: "Whether the build is for a pre-release"
10 |         required: false
11 |         default: false
12 |         type: boolean
13 | 
14 | 
15 | jobs:
16 |   build:
17 |     name: Build
18 |     runs-on: ubuntu-20.04
19 | 
20 |     # ----------------------------------- Setup ------------------------------ #
21 | 
22 |     steps:
23 |       - uses: actions/checkout@v4
24 |       - uses: dart-lang/setup-dart@v1
25 | 
26 |       - name: Setup Linux build requirements
27 |         run: |
28 |           sudo apt-get update
29 |           sudo apt-get install libsqlite3-dev
30 | 
31 |       # ----------------------------------- Build ---------------------------- #
32 | 
33 |       - name: Build
34 |         run: |
35 |           dart pub get
36 |           dart compile exe -o package/vscode_runner bin/vscode_runner.dart
37 | 
38 |       # ---------------------------------- Upload ---------------------------- #
39 | 
40 |       - name: Create artifacts
41 |         run: |
42 |           mkdir -p output
43 |           # Compress the contents of the package directory
44 |           (cd package/ && tar -zcvf ../output/vscode_runner.tar.gz .)
45 | 
46 |       - name: Upload artifacts to workflow
47 |         uses: actions/upload-artifact@v4
48 |         with:
49 |           path: output/vscode_runner.tar.gz
50 | 


--------------------------------------------------------------------------------
/.github/workflows/pull_request.yml:
--------------------------------------------------------------------------------
 1 | # Verify tests pass and builds succeed for pull requests.
 2 | 
 3 | name: Verify Pull Request
 4 | 
 5 | on:
 6 |   # Enable manual run
 7 |   workflow_dispatch:
 8 |   pull_request:
 9 | 
10 | concurrency:
11 |   group: ci-verify-pr-${{ github.ref }}-1
12 |   cancel-in-progress: true
13 | 
14 | jobs:
15 | #   call-tests:
16 | #     uses: ./.github/workflows/tests.yml
17 | 
18 |   call-build:
19 |     # needs: call-tests
20 |     uses: ./.github/workflows/build.yml
21 |     with:
22 |       pre-release: true
23 |     secrets: inherit
24 | 
25 |   verify-pull-request:
26 |     name: Verify Pull Request
27 |     needs: call-build
28 |     runs-on: ubuntu-latest
29 |     steps:
30 |       - run: echo "Requirements passed, PR looks good!"
31 | 


--------------------------------------------------------------------------------
/.github/workflows/release.yml:
--------------------------------------------------------------------------------
 1 | # Create a new release
 2 | 
 3 | name: Release
 4 | 
 5 | on:
 6 |   # Build & deploy for tag events matching v*, i.e. v1.0.0, v20.15.10
 7 |   push:
 8 |     tags:
 9 |       - "v*"
10 |   # Enable manual run
11 |   workflow_dispatch:
12 | 
13 | concurrency:
14 |   group: ci-release-${{ github.ref }}-1
15 |   cancel-in-progress: true
16 | 
17 | jobs:
18 |   # call-tests:
19 |     # uses: ./.github/workflows/tests.yml
20 | 
21 |   call-build:
22 |     # needs: call-tests
23 |     uses: ./.github/workflows/build.yml
24 |     with:
25 |       pre-release: false
26 |     secrets: inherit
27 | 
28 |   release:
29 |     name: "Release"
30 |     needs: call-build
31 |     runs-on: "ubuntu-latest"
32 | 
33 |     steps:
34 |       - uses: actions/checkout@v4
35 | 
36 |       - name: Download artifacts
37 |         uses: actions/download-artifact@v4
38 |         with:
39 |           path: artifacts
40 |  
41 |       - name: Create Draft Release & Upload artifacts
42 |         uses: marvinpinto/action-automatic-releases@v1.2.1
43 |         with:
44 |           repo_token: "${{ secrets.GITHUB_TOKEN }}"
45 |           draft: true
46 |           prerelease: false
47 |           files: |
48 |             artifacts/artifact/*
49 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | vscode_runner
 2 | 
 3 | 
 4 | # =====================
 5 | 
 6 | 
 7 | # Files and directories created by pub.
 8 | .dart_tool/
 9 | .packages
10 | 
11 | # Conventional directory for build output.
12 | build/
13 | 


--------------------------------------------------------------------------------
/.vscode/launch.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     // Use IntelliSense to learn about possible attributes.
 3 |     // Hover to view descriptions of existing attributes.
 4 |     // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
 5 |     "version": "0.2.0",
 6 |     "configurations": [
 7 |         {
 8 |             "name": "vscode_runner",
 9 |             "request": "launch",
10 |             "type": "dart",
11 |             "program": "bin/vscode_runner.dart"
12 |         }
13 |     ]
14 | }


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
1 | ## 1.0.0
2 | 
3 | - Initial version.
4 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 3, 29 June 2007
  3 | 
  4 |  Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
  5 |  Everyone is permitted to copy and distribute verbatim copies
  6 |  of this license document, but changing it is not allowed.
  7 | 
  8 |                             Preamble
  9 | 
 10 |   The GNU General Public License is a free, copyleft license for
 11 | software and other kinds of works.
 12 | 
 13 |   The licenses for most software and other practical works are designed
 14 | to take away your freedom to share and change the works.  By contrast,
 15 | the GNU General Public License is intended to guarantee your freedom to
 16 | share and change all versions of a program--to make sure it remains free
 17 | software for all its users.  We, the Free Software Foundation, use the
 18 | GNU General Public License for most of our software; it applies also to
 19 | any other work released this way by its authors.  You can apply it to
 20 | your programs, too.
 21 | 
 22 |   When we speak of free software, we are referring to freedom, not
 23 | price.  Our General Public Licenses are designed to make sure that you
 24 | have the freedom to distribute copies of free software (and charge for
 25 | them if you wish), that you receive source code or can get it if you
 26 | want it, that you can change the software or use pieces of it in new
 27 | free programs, and that you know you can do these things.
 28 | 
 29 |   To protect your rights, we need to prevent others from denying you
 30 | these rights or asking you to surrender the rights.  Therefore, you have
 31 | certain responsibilities if you distribute copies of the software, or if
 32 | you modify it: responsibilities to respect the freedom of others.
 33 | 
 34 |   For example, if you distribute copies of such a program, whether
 35 | gratis or for a fee, you must pass on to the recipients the same
 36 | freedoms that you received.  You must make sure that they, too, receive
 37 | or can get the source code.  And you must show them these terms so they
 38 | know their rights.
 39 | 
 40 |   Developers that use the GNU GPL protect your rights with two steps:
 41 | (1) assert copyright on the software, and (2) offer you this License
 42 | giving you legal permission to copy, distribute and/or modify it.
 43 | 
 44 |   For the developers' and authors' protection, the GPL clearly explains
 45 | that there is no warranty for this free software.  For both users' and
 46 | authors' sake, the GPL requires that modified versions be marked as
 47 | changed, so that their problems will not be attributed erroneously to
 48 | authors of previous versions.
 49 | 
 50 |   Some devices are designed to deny users access to install or run
 51 | modified versions of the software inside them, although the manufacturer
 52 | can do so.  This is fundamentally incompatible with the aim of
 53 | protecting users' freedom to change the software.  The systematic
 54 | pattern of such abuse occurs in the area of products for individuals to
 55 | use, which is precisely where it is most unacceptable.  Therefore, we
 56 | have designed this version of the GPL to prohibit the practice for those
 57 | products.  If such problems arise substantially in other domains, we
 58 | stand ready to extend this provision to those domains in future versions
 59 | of the GPL, as needed to protect the freedom of users.
 60 | 
 61 |   Finally, every program is threatened constantly by software patents.
 62 | States should not allow patents to restrict development and use of
 63 | software on general-purpose computers, but in those that do, we wish to
 64 | avoid the special danger that patents applied to a free program could
 65 | make it effectively proprietary.  To prevent this, the GPL assures that
 66 | patents cannot be used to render the program non-free.
 67 | 
 68 |   The precise terms and conditions for copying, distribution and
 69 | modification follow.
 70 | 
 71 |                        TERMS AND CONDITIONS
 72 | 
 73 |   0. Definitions.
 74 | 
 75 |   "This License" refers to version 3 of the GNU General Public License.
 76 | 
 77 |   "Copyright" also means copyright-like laws that apply to other kinds of
 78 | works, such as semiconductor masks.
 79 | 
 80 |   "The Program" refers to any copyrightable work licensed under this
 81 | License.  Each licensee is addressed as "you".  "Licensees" and
 82 | "recipients" may be individuals or organizations.
 83 | 
 84 |   To "modify" a work means to copy from or adapt all or part of the work
 85 | in a fashion requiring copyright permission, other than the making of an
 86 | exact copy.  The resulting work is called a "modified version" of the
 87 | earlier work or a work "based on" the earlier work.
 88 | 
 89 |   A "covered work" means either the unmodified Program or a work based
 90 | on the Program.
 91 | 
 92 |   To "propagate" a work means to do anything with it that, without
 93 | permission, would make you directly or secondarily liable for
 94 | infringement under applicable copyright law, except executing it on a
 95 | computer or modifying a private copy.  Propagation includes copying,
 96 | distribution (with or without modification), making available to the
 97 | public, and in some countries other activities as well.
 98 | 
 99 |   To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies.  Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 | 
103 |   An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License.  If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 | 
112 |   1. Source Code.
113 | 
114 |   The "source code" for a work means the preferred form of the work
115 | for making modifications to it.  "Object code" means any non-source
116 | form of a work.
117 | 
118 |   A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 | 
123 |   The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form.  A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 | 
134 |   The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities.  However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work.  For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 | 
147 |   The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 | 
151 |   The Corresponding Source for a work in source code form is that
152 | same work.
153 | 
154 |   2. Basic Permissions.
155 | 
156 |   All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met.  This License explicitly affirms your unlimited
159 | permission to run the unmodified Program.  The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work.  This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 | 
164 |   You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force.  You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright.  Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 | 
175 |   Conveying under any other circumstances is permitted solely under
176 | the conditions stated below.  Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 | 
179 |   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 | 
181 |   No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 | 
187 |   When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 | 
195 |   4. Conveying Verbatim Copies.
196 | 
197 |   You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 | 
205 |   You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 | 
208 |   5. Conveying Modified Source Versions.
209 | 
210 |   You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 | 
214 |     a) The work must carry prominent notices stating that you modified
215 |     it, and giving a relevant date.
216 | 
217 |     b) The work must carry prominent notices stating that it is
218 |     released under this License and any conditions added under section
219 |     7.  This requirement modifies the requirement in section 4 to
220 |     "keep intact all notices".
221 | 
222 |     c) You must license the entire work, as a whole, under this
223 |     License to anyone who comes into possession of a copy.  This
224 |     License will therefore apply, along with any applicable section 7
225 |     additional terms, to the whole of the work, and all its parts,
226 |     regardless of how they are packaged.  This License gives no
227 |     permission to license the work in any other way, but it does not
228 |     invalidate such permission if you have separately received it.
229 | 
230 |     d) If the work has interactive user interfaces, each must display
231 |     Appropriate Legal Notices; however, if the Program has interactive
232 |     interfaces that do not display Appropriate Legal Notices, your
233 |     work need not make them do so.
234 | 
235 |   A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit.  Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 | 
245 |   6. Conveying Non-Source Forms.
246 | 
247 |   You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 | 
252 |     a) Convey the object code in, or embodied in, a physical product
253 |     (including a physical distribution medium), accompanied by the
254 |     Corresponding Source fixed on a durable physical medium
255 |     customarily used for software interchange.
256 | 
257 |     b) Convey the object code in, or embodied in, a physical product
258 |     (including a physical distribution medium), accompanied by a
259 |     written offer, valid for at least three years and valid for as
260 |     long as you offer spare parts or customer support for that product
261 |     model, to give anyone who possesses the object code either (1) a
262 |     copy of the Corresponding Source for all the software in the
263 |     product that is covered by this License, on a durable physical
264 |     medium customarily used for software interchange, for a price no
265 |     more than your reasonable cost of physically performing this
266 |     conveying of source, or (2) access to copy the
267 |     Corresponding Source from a network server at no charge.
268 | 
269 |     c) Convey individual copies of the object code with a copy of the
270 |     written offer to provide the Corresponding Source.  This
271 |     alternative is allowed only occasionally and noncommercially, and
272 |     only if you received the object code with such an offer, in accord
273 |     with subsection 6b.
274 | 
275 |     d) Convey the object code by offering access from a designated
276 |     place (gratis or for a charge), and offer equivalent access to the
277 |     Corresponding Source in the same way through the same place at no
278 |     further charge.  You need not require recipients to copy the
279 |     Corresponding Source along with the object code.  If the place to
280 |     copy the object code is a network server, the Corresponding Source
281 |     may be on a different server (operated by you or a third party)
282 |     that supports equivalent copying facilities, provided you maintain
283 |     clear directions next to the object code saying where to find the
284 |     Corresponding Source.  Regardless of what server hosts the
285 |     Corresponding Source, you remain obligated to ensure that it is
286 |     available for as long as needed to satisfy these requirements.
287 | 
288 |     e) Convey the object code using peer-to-peer transmission, provided
289 |     you inform other peers where the object code and Corresponding
290 |     Source of the work are being offered to the general public at no
291 |     charge under subsection 6d.
292 | 
293 |   A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 | 
297 |   A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling.  In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage.  For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product.  A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 | 
310 |   "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source.  The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 | 
318 |   If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information.  But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 | 
329 |   The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed.  Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 | 
337 |   Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 | 
343 |   7. Additional Terms.
344 | 
345 |   "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law.  If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 | 
354 |   When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it.  (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.)  You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 | 
361 |   Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 | 
365 |     a) Disclaiming warranty or limiting liability differently from the
366 |     terms of sections 15 and 16 of this License; or
367 | 
368 |     b) Requiring preservation of specified reasonable legal notices or
369 |     author attributions in that material or in the Appropriate Legal
370 |     Notices displayed by works containing it; or
371 | 
372 |     c) Prohibiting misrepresentation of the origin of that material, or
373 |     requiring that modified versions of such material be marked in
374 |     reasonable ways as different from the original version; or
375 | 
376 |     d) Limiting the use for publicity purposes of names of licensors or
377 |     authors of the material; or
378 | 
379 |     e) Declining to grant rights under trademark law for use of some
380 |     trade names, trademarks, or service marks; or
381 | 
382 |     f) Requiring indemnification of licensors and authors of that
383 |     material by anyone who conveys the material (or modified versions of
384 |     it) with contractual assumptions of liability to the recipient, for
385 |     any liability that these contractual assumptions directly impose on
386 |     those licensors and authors.
387 | 
388 |   All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10.  If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term.  If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 | 
398 |   If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 | 
403 |   Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 | 
407 |   8. Termination.
408 | 
409 |   You may not propagate or modify a covered work except as expressly
410 | provided under this License.  Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 | 
415 |   However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 | 
422 |   Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 | 
429 |   Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License.  If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 | 
435 |   9. Acceptance Not Required for Having Copies.
436 | 
437 |   You are not required to accept this License in order to receive or
438 | run a copy of the Program.  Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance.  However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work.  These actions infringe copyright if you do
443 | not accept this License.  Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 | 
446 |   10. Automatic Licensing of Downstream Recipients.
447 | 
448 |   Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License.  You are not responsible
451 | for enforcing compliance by third parties with this License.
452 | 
453 |   An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations.  If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 | 
463 |   You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License.  For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 | 
471 |   11. Patents.
472 | 
473 |   A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based.  The
475 | work thus licensed is called the contributor's "contributor version".
476 | 
477 |   A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version.  For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 | 
487 |   Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 | 
492 |   In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement).  To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 | 
499 |   If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients.  "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 | 
513 |   If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 | 
521 |   A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License.  You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 | 
536 |   Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 | 
540 |   12. No Surrender of Others' Freedom.
541 | 
542 |   If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License.  If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all.  For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 | 
552 |   13. Use with the GNU Affero General Public License.
553 | 
554 |   Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work.  The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 | 
563 |   14. Revised Versions of this License.
564 | 
565 |   The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time.  Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 | 
570 |   Each version is given a distinguishing version number.  If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation.  If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 | 
579 |   If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 | 
584 |   Later license versions may give you additional or different
585 | permissions.  However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 | 
589 |   15. Disclaimer of Warranty.
590 | 
591 |   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 | 
600 |   16. Limitation of Liability.
601 | 
602 |   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 | 
612 |   17. Interpretation of Sections 15 and 16.
613 | 
614 |   If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 | 
621 |                      END OF TERMS AND CONDITIONS
622 | 
623 |             How to Apply These Terms to Your New Programs
624 | 
625 |   If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 | 
629 |   To do so, attach the following notices to the program.  It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 | 
634 |     <one line to give the program's name and a brief idea of what it does.>
635 |     Copyright (C) <year>  <name of author>
636 | 
637 |     This program is free software: you can redistribute it and/or modify
638 |     it under the terms of the GNU General Public License as published by
639 |     the Free Software Foundation, either version 3 of the License, or
640 |     (at your option) any later version.
641 | 
642 |     This program is distributed in the hope that it will be useful,
643 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
644 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645 |     GNU General Public License for more details.
646 | 
647 |     You should have received a copy of the GNU General Public License
648 |     along with this program.  If not, see <https://www.gnu.org/licenses/>.
649 | 
650 | Also add information on how to contact you by electronic and paper mail.
651 | 
652 |   If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 | 
655 |     <program>  Copyright (C) <year>  <name of author>
656 |     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 |     This is free software, and you are welcome to redistribute it
658 |     under certain conditions; type `show c' for details.
659 | 
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License.  Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 | 
664 |   You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | <https://www.gnu.org/licenses/>.
668 | 
669 |   The GNU General Public License does not permit incorporating your program
670 | into proprietary programs.  If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library.  If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License.  But first, please read
674 | <https://www.gnu.org/licenses/why-not-lgpl.html>.
675 | 


--------------------------------------------------------------------------------
/README.html:
--------------------------------------------------------------------------------
  1 | <!doctype html>
  2 | <html style='font-size:18px !important'>
  3 | <head>
  4 | <meta charset='UTF-8'><meta name='viewport' content='width=device-width initial-scale=1'>
  5 | <title>README</title><style type='text/css'>html {overflow-x: initial !important;}:root { --bg-color:#ffffff; --text-color:#333333; --select-text-bg-color:#B5D6FC; --select-text-font-color:auto; --monospace:"Lucida Console",Consolas,"Courier",monospace; --title-bar-height:20px; }
  6 | .mac-os-11 { --title-bar-height:28px; }
  7 | html { font-size: 14px; background-color: var(--bg-color); color: var(--text-color); font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; }
  8 | body { margin: 0px; padding: 0px; height: auto; bottom: 0px; top: 0px; left: 0px; right: 0px; font-size: 1rem; line-height: 1.42857; overflow-x: hidden; background: inherit; tab-size: 4; }
  9 | iframe { margin: auto; }
 10 | a.url { word-break: break-all; }
 11 | a:active, a:hover { outline: 0px; }
 12 | .in-text-selection, ::selection { text-shadow: none; background: var(--select-text-bg-color); color: var(--select-text-font-color); }
 13 | #write { margin: 0px auto; height: auto; width: inherit; word-break: normal; overflow-wrap: break-word; position: relative; white-space: normal; overflow-x: visible; padding-top: 36px; }
 14 | #write.first-line-indent p { text-indent: 2em; }
 15 | #write.first-line-indent li p, #write.first-line-indent p * { text-indent: 0px; }
 16 | #write.first-line-indent li { margin-left: 2em; }
 17 | .for-image #write { padding-left: 8px; padding-right: 8px; }
 18 | body.typora-export { padding-left: 30px; padding-right: 30px; }
 19 | .typora-export .footnote-line, .typora-export li, .typora-export p { white-space: pre-wrap; }
 20 | .typora-export .task-list-item input { pointer-events: none; }
 21 | @media screen and (max-width: 500px) {
 22 |   body.typora-export { padding-left: 0px; padding-right: 0px; }
 23 |   #write { padding-left: 20px; padding-right: 20px; }
 24 |   .CodeMirror-sizer { margin-left: 0px !important; }
 25 |   .CodeMirror-gutters { display: none !important; }
 26 | }
 27 | #write li > figure:last-child { margin-bottom: 0.5rem; }
 28 | #write ol, #write ul { position: relative; }
 29 | img { max-width: 100%; vertical-align: middle; image-orientation: from-image; }
 30 | button, input, select, textarea { color: inherit; font: inherit; }
 31 | input[type="checkbox"], input[type="radio"] { line-height: normal; padding: 0px; }
 32 | *, ::after, ::before { box-sizing: border-box; }
 33 | #write h1, #write h2, #write h3, #write h4, #write h5, #write h6, #write p, #write pre { width: inherit; }
 34 | #write h1, #write h2, #write h3, #write h4, #write h5, #write h6, #write p { position: relative; }
 35 | p { line-height: inherit; }
 36 | h1, h2, h3, h4, h5, h6 { break-after: avoid-page; break-inside: avoid; orphans: 4; }
 37 | p { orphans: 4; }
 38 | h1 { font-size: 2rem; }
 39 | h2 { font-size: 1.8rem; }
 40 | h3 { font-size: 1.6rem; }
 41 | h4 { font-size: 1.4rem; }
 42 | h5 { font-size: 1.2rem; }
 43 | h6 { font-size: 1rem; }
 44 | .md-math-block, .md-rawblock, h1, h2, h3, h4, h5, h6, p { margin-top: 1rem; margin-bottom: 1rem; }
 45 | .hidden { display: none; }
 46 | .md-blockmeta { color: rgb(204, 204, 204); font-weight: 700; font-style: italic; }
 47 | a { cursor: pointer; }
 48 | sup.md-footnote { padding: 2px 4px; background-color: rgba(238, 238, 238, 0.7); color: rgb(85, 85, 85); border-radius: 4px; cursor: pointer; }
 49 | sup.md-footnote a, sup.md-footnote a:hover { color: inherit; text-transform: inherit; text-decoration: inherit; }
 50 | #write input[type="checkbox"] { cursor: pointer; width: inherit; height: inherit; }
 51 | figure { overflow-x: auto; margin: 1.2em 0px; max-width: calc(100% + 16px); padding: 0px; }
 52 | figure > table { margin: 0px; }
 53 | tr { break-inside: avoid; break-after: auto; }
 54 | thead { display: table-header-group; }
 55 | table { border-collapse: collapse; border-spacing: 0px; width: 100%; overflow: auto; break-inside: auto; text-align: left; }
 56 | table.md-table td { min-width: 32px; }
 57 | .CodeMirror-gutters { border-right: 0px; background-color: inherit; }
 58 | .CodeMirror-linenumber { user-select: none; }
 59 | .CodeMirror { text-align: left; }
 60 | .CodeMirror-placeholder { opacity: 0.3; }
 61 | .CodeMirror pre { padding: 0px 4px; }
 62 | .CodeMirror-lines { padding: 0px; }
 63 | div.hr:focus { cursor: none; }
 64 | #write pre { white-space: pre-wrap; }
 65 | #write.fences-no-line-wrapping pre { white-space: pre; }
 66 | #write pre.ty-contain-cm { white-space: normal; }
 67 | .CodeMirror-gutters { margin-right: 4px; }
 68 | .md-fences { font-size: 0.9rem; display: block; break-inside: avoid; text-align: left; overflow: visible; white-space: pre; background: inherit; position: relative !important; }
 69 | .md-diagram-panel { width: 100%; margin-top: 10px; text-align: center; padding-top: 0px; padding-bottom: 8px; overflow-x: auto; }
 70 | #write .md-fences.mock-cm { white-space: pre-wrap; }
 71 | .md-fences.md-fences-with-lineno { padding-left: 0px; }
 72 | #write.fences-no-line-wrapping .md-fences.mock-cm { white-space: pre; overflow-x: auto; }
 73 | .md-fences.mock-cm.md-fences-with-lineno { padding-left: 8px; }
 74 | .CodeMirror-line, twitterwidget { break-inside: avoid; }
 75 | .footnotes { opacity: 0.8; font-size: 0.9rem; margin-top: 1em; margin-bottom: 1em; }
 76 | .footnotes + .footnotes { margin-top: 0px; }
 77 | .md-reset { margin: 0px; padding: 0px; border: 0px; outline: 0px; vertical-align: top; background: 0px 0px; text-decoration: none; text-shadow: none; float: none; position: static; width: auto; height: auto; white-space: nowrap; cursor: inherit; -webkit-tap-highlight-color: transparent; line-height: normal; font-weight: 400; text-align: left; box-sizing: content-box; direction: ltr; }
 78 | li div { padding-top: 0px; }
 79 | blockquote { margin: 1rem 0px; }
 80 | li .mathjax-block, li p { margin: 0.5rem 0px; }
 81 | li blockquote { margin: 1rem 0px; }
 82 | li { margin: 0px; position: relative; }
 83 | blockquote > :last-child { margin-bottom: 0px; }
 84 | blockquote > :first-child, li > :first-child { margin-top: 0px; }
 85 | .footnotes-area { color: rgb(136, 136, 136); margin-top: 0.714rem; padding-bottom: 0.143rem; white-space: normal; }
 86 | #write .footnote-line { white-space: pre-wrap; }
 87 | @media print {
 88 |   body, html { border: 1px solid transparent; height: 99%; break-after: avoid; break-before: avoid; font-variant-ligatures: no-common-ligatures; }
 89 |   #write { margin-top: 0px; padding-top: 0px; border-color: transparent !important; }
 90 |   .typora-export * { -webkit-print-color-adjust: exact; }
 91 |   .typora-export #write { break-after: avoid; }
 92 |   .typora-export #write::after { height: 0px; }
 93 |   .is-mac table { break-inside: avoid; }
 94 | }
 95 | .footnote-line { margin-top: 0.714em; font-size: 0.7em; }
 96 | a img, img a { cursor: pointer; }
 97 | pre.md-meta-block { font-size: 0.8rem; min-height: 0.8rem; white-space: pre-wrap; background: rgb(204, 204, 204); display: block; overflow-x: hidden; }
 98 | p > .md-image:only-child:not(.md-img-error) img, p > img:only-child { display: block; margin: auto; }
 99 | #write.first-line-indent p > .md-image:only-child:not(.md-img-error) img { left: -2em; position: relative; }
100 | p > .md-image:only-child { display: inline-block; width: 100%; }
101 | #write .MathJax_Display { margin: 0.8em 0px 0px; }
102 | .md-math-block { width: 100%; }
103 | .md-math-block:not(:empty)::after { display: none; }
104 | .MathJax_ref { fill: currentcolor; }
105 | [contenteditable="true"]:active, [contenteditable="true"]:focus, [contenteditable="false"]:active, [contenteditable="false"]:focus { outline: 0px; box-shadow: none; }
106 | .md-task-list-item { position: relative; list-style-type: none; }
107 | .task-list-item.md-task-list-item { padding-left: 0px; }
108 | .md-task-list-item > input { position: absolute; top: 0px; left: 0px; margin-left: -1.2em; margin-top: calc(1em - 10px); border: none; }
109 | .math { font-size: 1rem; }
110 | .md-toc { min-height: 3.58rem; position: relative; font-size: 0.9rem; border-radius: 10px; }
111 | .md-toc-content { position: relative; margin-left: 0px; }
112 | .md-toc-content::after, .md-toc::after { display: none; }
113 | .md-toc-item { display: block; color: rgb(65, 131, 196); }
114 | .md-toc-item a { text-decoration: none; }
115 | .md-toc-inner:hover { text-decoration: underline; }
116 | .md-toc-inner { display: inline-block; cursor: pointer; }
117 | .md-toc-h1 .md-toc-inner { margin-left: 0px; font-weight: 700; }
118 | .md-toc-h2 .md-toc-inner { margin-left: 2em; }
119 | .md-toc-h3 .md-toc-inner { margin-left: 4em; }
120 | .md-toc-h4 .md-toc-inner { margin-left: 6em; }
121 | .md-toc-h5 .md-toc-inner { margin-left: 8em; }
122 | .md-toc-h6 .md-toc-inner { margin-left: 10em; }
123 | @media screen and (max-width: 48em) {
124 |   .md-toc-h3 .md-toc-inner { margin-left: 3.5em; }
125 |   .md-toc-h4 .md-toc-inner { margin-left: 5em; }
126 |   .md-toc-h5 .md-toc-inner { margin-left: 6.5em; }
127 |   .md-toc-h6 .md-toc-inner { margin-left: 8em; }
128 | }
129 | a.md-toc-inner { font-size: inherit; font-style: inherit; font-weight: inherit; line-height: inherit; }
130 | .footnote-line a:not(.reversefootnote) { color: inherit; }
131 | .md-attr { display: none; }
132 | .md-fn-count::after { content: "."; }
133 | code, pre, samp, tt { font-family: var(--monospace); }
134 | kbd { margin: 0px 0.1em; padding: 0.1em 0.6em; font-size: 0.8em; color: rgb(36, 39, 41); background: rgb(255, 255, 255); border: 1px solid rgb(173, 179, 185); border-radius: 3px; box-shadow: rgba(12, 13, 14, 0.2) 0px 1px 0px, rgb(255, 255, 255) 0px 0px 0px 2px inset; white-space: nowrap; vertical-align: middle; }
135 | .md-comment { color: rgb(162, 127, 3); opacity: 0.8; font-family: var(--monospace); }
136 | code { text-align: left; vertical-align: initial; }
137 | a.md-print-anchor { white-space: pre !important; border-width: initial !important; border-style: none !important; border-color: initial !important; display: inline-block !important; position: absolute !important; width: 1px !important; right: 0px !important; outline: 0px !important; background: 0px 0px !important; text-decoration: initial !important; text-shadow: initial !important; }
138 | .md-inline-math .MathJax_SVG .noError { display: none !important; }
139 | .html-for-mac .inline-math-svg .MathJax_SVG { vertical-align: 0.2px; }
140 | .md-math-block .MathJax_SVG_Display { text-align: center; margin: 0px; position: relative; text-indent: 0px; max-width: none; max-height: none; min-height: 0px; min-width: 100%; width: auto; overflow-y: hidden; display: block !important; }
141 | .MathJax_SVG_Display, .md-inline-math .MathJax_SVG_Display { width: auto; margin: inherit; display: inline-block !important; }
142 | .MathJax_SVG .MJX-monospace { font-family: var(--monospace); }
143 | .MathJax_SVG .MJX-sans-serif { font-family: sans-serif; }
144 | .MathJax_SVG { display: inline; font-style: normal; font-weight: 400; line-height: normal; zoom: 90%; text-indent: 0px; text-align: left; text-transform: none; letter-spacing: normal; word-spacing: normal; overflow-wrap: normal; white-space: nowrap; float: none; direction: ltr; max-width: none; max-height: none; min-width: 0px; min-height: 0px; border: 0px; padding: 0px; margin: 0px; }
145 | .MathJax_SVG * { transition: none 0s ease 0s; }
146 | .MathJax_SVG_Display svg { vertical-align: middle !important; margin-bottom: 0px !important; margin-top: 0px !important; }
147 | .os-windows.monocolor-emoji .md-emoji { font-family: "Segoe UI Symbol", sans-serif; }
148 | .md-diagram-panel > svg { max-width: 100%; }
149 | [lang="flow"] svg, [lang="mermaid"] svg { max-width: 100%; height: auto; }
150 | [lang="mermaid"] .node text { font-size: 1rem; }
151 | table tr th { border-bottom: 0px; }
152 | video { max-width: 100%; display: block; margin: 0px auto; }
153 | iframe { max-width: 100%; width: 100%; border: none; }
154 | .highlight td, .highlight tr { border: 0px; }
155 | mark { background: rgb(255, 255, 0); color: rgb(0, 0, 0); }
156 | .md-html-inline .md-plain, .md-html-inline strong, mark .md-inline-math, mark strong { color: inherit; }
157 | mark .md-meta { color: rgb(0, 0, 0); opacity: 0.3 !important; }
158 | @media print {
159 |   .typora-export h1, .typora-export h2, .typora-export h3, .typora-export h4, .typora-export h5, .typora-export h6 { break-inside: avoid; }
160 | }
161 | .md-diagram-panel .messageText { stroke: none !important; }
162 | .md-diagram-panel .start-state { fill: var(--node-fill); }
163 | .md-diagram-panel .edgeLabel rect { opacity: 1 !important; }
164 | .md-require-zoom-fix foreignobject { font-size: var(--mermaid-font-zoom); }
165 | 
166 | 
167 | .CodeMirror { height: auto; }
168 | .CodeMirror.cm-s-inner { background: inherit; }
169 | .CodeMirror-scroll { overflow: auto hidden; z-index: 3; }
170 | .CodeMirror-gutter-filler, .CodeMirror-scrollbar-filler { background-color: rgb(255, 255, 255); }
171 | .CodeMirror-gutters { border-right: 1px solid rgb(221, 221, 221); background: inherit; white-space: nowrap; }
172 | .CodeMirror-linenumber { padding: 0px 3px 0px 5px; text-align: right; color: rgb(153, 153, 153); }
173 | .cm-s-inner .cm-keyword { color: rgb(119, 0, 136); }
174 | .cm-s-inner .cm-atom, .cm-s-inner.cm-atom { color: rgb(34, 17, 153); }
175 | .cm-s-inner .cm-number { color: rgb(17, 102, 68); }
176 | .cm-s-inner .cm-def { color: rgb(0, 0, 255); }
177 | .cm-s-inner .cm-variable { color: rgb(0, 0, 0); }
178 | .cm-s-inner .cm-variable-2 { color: rgb(0, 85, 170); }
179 | .cm-s-inner .cm-variable-3 { color: rgb(0, 136, 85); }
180 | .cm-s-inner .cm-string { color: rgb(170, 17, 17); }
181 | .cm-s-inner .cm-property { color: rgb(0, 0, 0); }
182 | .cm-s-inner .cm-operator { color: rgb(152, 26, 26); }
183 | .cm-s-inner .cm-comment, .cm-s-inner.cm-comment { color: rgb(170, 85, 0); }
184 | .cm-s-inner .cm-string-2 { color: rgb(255, 85, 0); }
185 | .cm-s-inner .cm-meta { color: rgb(85, 85, 85); }
186 | .cm-s-inner .cm-qualifier { color: rgb(85, 85, 85); }
187 | .cm-s-inner .cm-builtin { color: rgb(51, 0, 170); }
188 | .cm-s-inner .cm-bracket { color: rgb(153, 153, 119); }
189 | .cm-s-inner .cm-tag { color: rgb(17, 119, 0); }
190 | .cm-s-inner .cm-attribute { color: rgb(0, 0, 204); }
191 | .cm-s-inner .cm-header, .cm-s-inner.cm-header { color: rgb(0, 0, 255); }
192 | .cm-s-inner .cm-quote, .cm-s-inner.cm-quote { color: rgb(0, 153, 0); }
193 | .cm-s-inner .cm-hr, .cm-s-inner.cm-hr { color: rgb(153, 153, 153); }
194 | .cm-s-inner .cm-link, .cm-s-inner.cm-link { color: rgb(0, 0, 204); }
195 | .cm-negative { color: rgb(221, 68, 68); }
196 | .cm-positive { color: rgb(34, 153, 34); }
197 | .cm-header, .cm-strong { font-weight: 700; }
198 | .cm-del { text-decoration: line-through; }
199 | .cm-em { font-style: italic; }
200 | .cm-link { text-decoration: underline; }
201 | .cm-error { color: red; }
202 | .cm-invalidchar { color: red; }
203 | .cm-constant { color: rgb(38, 139, 210); }
204 | .cm-defined { color: rgb(181, 137, 0); }
205 | div.CodeMirror span.CodeMirror-matchingbracket { color: rgb(0, 255, 0); }
206 | div.CodeMirror span.CodeMirror-nonmatchingbracket { color: rgb(255, 34, 34); }
207 | .cm-s-inner .CodeMirror-activeline-background { background: inherit; }
208 | .CodeMirror { position: relative; overflow: hidden; }
209 | .CodeMirror-scroll { height: 100%; outline: 0px; position: relative; box-sizing: content-box; background: inherit; }
210 | .CodeMirror-sizer { position: relative; }
211 | .CodeMirror-gutter-filler, .CodeMirror-hscrollbar, .CodeMirror-scrollbar-filler, .CodeMirror-vscrollbar { position: absolute; z-index: 6; display: none; }
212 | .CodeMirror-vscrollbar { right: 0px; top: 0px; overflow: hidden; }
213 | .CodeMirror-hscrollbar { bottom: 0px; left: 0px; overflow: hidden; }
214 | .CodeMirror-scrollbar-filler { right: 0px; bottom: 0px; }
215 | .CodeMirror-gutter-filler { left: 0px; bottom: 0px; }
216 | .CodeMirror-gutters { position: absolute; left: 0px; top: 0px; padding-bottom: 30px; z-index: 3; }
217 | .CodeMirror-gutter { white-space: normal; height: 100%; box-sizing: content-box; padding-bottom: 30px; margin-bottom: -32px; display: inline-block; }
218 | .CodeMirror-gutter-wrapper { position: absolute; z-index: 4; background: 0px 0px !important; border: none !important; }
219 | .CodeMirror-gutter-background { position: absolute; top: 0px; bottom: 0px; z-index: 4; }
220 | .CodeMirror-gutter-elt { position: absolute; cursor: default; z-index: 4; }
221 | .CodeMirror-lines { cursor: text; }
222 | .CodeMirror pre { border-radius: 0px; border-width: 0px; background: 0px 0px; font-family: inherit; font-size: inherit; margin: 0px; white-space: pre; overflow-wrap: normal; color: inherit; z-index: 2; position: relative; overflow: visible; }
223 | .CodeMirror-wrap pre { overflow-wrap: break-word; white-space: pre-wrap; word-break: normal; }
224 | .CodeMirror-code pre { border-right: 30px solid transparent; width: fit-content; }
225 | .CodeMirror-wrap .CodeMirror-code pre { border-right: none; width: auto; }
226 | .CodeMirror-linebackground { position: absolute; left: 0px; right: 0px; top: 0px; bottom: 0px; z-index: 0; }
227 | .CodeMirror-linewidget { position: relative; z-index: 2; overflow: auto; }
228 | .CodeMirror-wrap .CodeMirror-scroll { overflow-x: hidden; }
229 | .CodeMirror-measure { position: absolute; width: 100%; height: 0px; overflow: hidden; visibility: hidden; }
230 | .CodeMirror-measure pre { position: static; }
231 | .CodeMirror div.CodeMirror-cursor { position: absolute; visibility: hidden; border-right: none; width: 0px; }
232 | .CodeMirror div.CodeMirror-cursor { visibility: hidden; }
233 | .CodeMirror-focused div.CodeMirror-cursor { visibility: inherit; }
234 | .cm-searching { background: rgba(255, 255, 0, 0.4); }
235 | @media print {
236 |   .CodeMirror div.CodeMirror-cursor { visibility: hidden; }
237 | }
238 | 
239 | 
240 | 
241 | 
242 | .cm-s-inner .cm-variable {
243 |   color: #fff;
244 | }
245 | 
246 | .cm-s-inner .cm-keyword,
247 | .cm-s-inner .cm-property {
248 |   color: #6699CC;
249 | }
250 | 
251 | .cm-s-inner .cm-tag {
252 |   color: #EC5F67;
253 | }
254 | 
255 | .CodeMirror div.CodeMirror-cursor {
256 |   border-left: 1px solid #b8bfc6;
257 |   z-index: 3;
258 | }
259 | 
260 | .cm-s-inner .cm-string {
261 |   color: #99C794;
262 | }
263 | 
264 | .cm-s-inner .cm-comment,
265 | .cm-s-inner.cm-comment {
266 |   color: #65737E;
267 | }
268 | 
269 | .cm-s-inner .cm-header,
270 | .cm-s-inner .cm-def,
271 | .cm-s-inner.cm-header,
272 | .cm-s-inner.cm-def,
273 | .cm-s-inner .cm-attribute,
274 | .cm-s-inner .cm-operator {
275 |   color: #C594C5;
276 | }
277 | 
278 | .cm-s-inner .cm-quote,
279 | .cm-s-inner.cm-quote {
280 |   color: #99C794;
281 | }
282 | 
283 | .cm-s-inner .cm-hr {
284 |   color: #d8d5d5;
285 | }
286 | 
287 | .cm-s-inner .cm-link {
288 |   color: #d3d3ef;
289 | }
290 | 
291 | .cm-s-inner .cm-negative {
292 |   color: #EC5F67;
293 | }
294 | 
295 | .cm-s-inner .cm-positive {
296 |   color: #99C794;
297 | }
298 | 
299 | .cm-s-inner .cm-string-2 {
300 |   color: #EC5F67;
301 | }
302 | 
303 | .cm-s-inner .cm-meta,
304 | .cm-s-inner .cm-qualifier {
305 |   color: #b7b3b3;
306 | }
307 | 
308 | .cm-s-inner .cm-builtin {
309 |   color: #f3b3f8;
310 | }
311 | 
312 | .cm-s-inner .cm-bracket {
313 |   color: #5FB3B3;
314 | }
315 | 
316 | .cm-s-inner .cm-atom,
317 | .cm-s-inner.cm-atom {
318 |   color: #84B6CB;
319 | }
320 | 
321 | .cm-s-inner .cm-number {
322 |   color: #F99157;
323 | }
324 | 
325 | .cm-s-inner .cm-variable {
326 |   color: #b8bfc6;
327 | }
328 | 
329 | .cm-s-inner .cm-variable-2 {
330 |   color: #9FBAD5;
331 | }
332 | 
333 | .cm-s-inner .cm-variable-3 {
334 |   color: #1cc685;
335 | }
336 | 
337 | .CodeMirror-selectedtext,
338 | .CodeMirror-selected {
339 |   background: #4a89dc;
340 |   color: #fff !important;
341 |   text-shadow: none;
342 | }
343 | 
344 | .CodeMirror-gutters {
345 |   border-right: none;
346 | }@import '';
347 | 
348 | :root {
349 |   --primary-color: #fcba03;
350 |   --primary-color-rgb: 252, 186, 3;
351 | 
352 |   --bg-color: #292929;
353 |   --bg-color-dark: #1f1f1f;
354 |   --dark-trait: #141414;
355 |   --light-trait-100: #3d3d3d;
356 |   --light-trait-200: #545454;
357 |   --light-trait-300: #777;
358 |   --light-trait-400: #8c8c8c;
359 | 
360 |   --text-color: #f8f8f2;
361 |   --text-color-secondary: #d2d3d3;
362 |   --text-highlight-color: #fff;
363 |   --text-highlight-bg: rgba(var(--primary-color-rgb), 0.3);
364 |   --select-text-bg-color: rgba(255, 255, 255, 0.2);
365 |   --search-select-text-color: var(--text-highlight-color);
366 |   --search-select-bg-color: var(--text-highlight-bg);
367 | 
368 |   --code-color: #f3b3f8;
369 | 
370 |   --border-radius: 3px;
371 | 
372 |   --font-size: 14px;
373 |   --font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Ubuntu, "Helvetica Neue", sans-serif;
374 |   --monospace: 'Fira Mono', 'Cousine', 'Consolas', monospace;
375 | 
376 |   --heading-char-color: var(--light-trait-400);
377 |   --color-popover-bg-color: var(--text-color);
378 |   --rawblock-edit-panel-bd: var(--bg-color-dark);
379 |   --control-text-color: var(--text-color);
380 |   --meta-content-color: var(--primary-color);
381 |   --primary-btn-border-color: var(--primary-color);
382 |   --side-bar-bg-color: var(--bg-color-dark);
383 |   --item-hover-bg-color: var(--bg-color);
384 |   --active-file-bg-color: var(--bg-color);
385 |   --active-file-border-color: var(--bg-color);
386 |   --window-border: 1px solid var(--bg-color);
387 |   --focus-ring-color: transparent;
388 | }
389 | 
390 | html {
391 |   font-size: var(--font-size);
392 | }
393 | 
394 | body {
395 |   font-family: var(--font-family);
396 |   -webkit-font-smoothing: antialiased;
397 |   color: var(--text-color);
398 |   line-height: 1.6;
399 | }
400 | 
401 | #write {
402 |   max-width: 860px;
403 |   margin: 0 auto;
404 |   padding: 30px;
405 |   padding-bottom: 100px;
406 | }
407 | 
408 | @media only screen and (min-width: 1400px) {
409 |   #write {
410 |     max-width: 1024px;
411 |   }
412 | }
413 | 
414 | @media only screen and (min-width: 1800px) {
415 |   #write {
416 |     max-width: 1200px;
417 |   }
418 | }
419 | 
420 | #write > ul:first-child,
421 | #write > ol:first-child {
422 |   margin-top: 30px;
423 | }
424 | 
425 | a {
426 |   color: var(--primary-color);
427 | }
428 | 
429 | h1,
430 | h2,
431 | h3,
432 | h4,
433 | h5,
434 | h6 {
435 |   position: relative;
436 |   margin-top: 1rem;
437 |   margin-bottom: 1rem;
438 |   font-weight: bold;
439 |   line-height: 1.4;
440 |   cursor: text;
441 | }
442 | 
443 | h1:hover a.anchor,
444 | h2:hover a.anchor,
445 | h3:hover a.anchor,
446 | h4:hover a.anchor,
447 | h5:hover a.anchor,
448 | h6:hover a.anchor {
449 |   text-decoration: none;
450 | }
451 | 
452 | h1 tt,
453 | h1 code,
454 | h2 tt,
455 | h2 code,
456 | h3 tt,
457 | h3 code,
458 | h4 tt,
459 | h4 code,
460 | h5 tt,
461 | h5 code,
462 | h6 tt,
463 | h6 code {
464 |   font-size: inherit;
465 | }
466 | 
467 | h1 {
468 |   padding-bottom: 0.3em;
469 |   font-size: 2.2em;
470 |   line-height: 1.3;
471 |   border-bottom: 1px solid var(--light-trait-100);
472 | }
473 | 
474 | h2 {
475 |   padding-bottom: 0.3em;
476 |   font-size: 1.75em;
477 |   line-height: 1.225;
478 |   border-bottom: 1px solid var(--light-trait-100);
479 | }
480 | 
481 | h3 {
482 |   font-size: 1.4em;
483 |   line-height: 1.43;
484 | }
485 | 
486 | h4 {
487 |   font-size: 1.2em;
488 | }
489 | 
490 | h5 {
491 |   font-size: 1em;
492 | }
493 | 
494 | h6 {
495 |   font-size: 1em;
496 |   color: var(--light-trait-300);
497 | }
498 | 
499 | p,
500 | blockquote,
501 | ul,
502 | ol,
503 | dl,
504 | table {
505 |   margin: 0.8em 0;
506 | }
507 | 
508 | li > ol,
509 | li > ul {
510 |   margin: 0 0;
511 | }
512 | 
513 | hr {
514 |   height: 2px;
515 |   padding: 0;
516 |   margin: 16px 0;
517 |   background-color: var(--light-trait-100);
518 |   border: 0 none;
519 |   overflow: hidden;
520 |   box-sizing: content-box;
521 | }
522 | 
523 | sup.md-footnote {
524 |   background-color: var(--light-trait-400);
525 |   color: var(--light-trait-100);
526 | }
527 | 
528 | li p.first {
529 |   display: inline-block;
530 | }
531 | 
532 | ul,
533 | ol {
534 |   padding-left: 30px;
535 | }
536 | 
537 | ul:first-child,
538 | ol:first-child {
539 |   margin-top: 0;
540 | }
541 | 
542 | ul:last-child,
543 | ol:last-child {
544 |   margin-bottom: 0;
545 | }
546 | 
547 | mark,
548 | .ty-file-search-match-text,
549 | .md-search-hit {
550 |   background: var(--search-select-bg-color);
551 |   color: var(--search-select-text-color);
552 | }
553 | .md-search-hit * {
554 |   color: var(--search-select-text-color);
555 | }
556 | .cm-search-hit.CodeMirror-selectedtext,
557 | .md-search-hit.md-search-select,
558 | .md-search-select {
559 |   outline: 2px solid var(--primary-color);
560 | }
561 | .outline-item.select, .ty-search-item-line.select, .ty-search-item.select {
562 |   outline-width: 2px;
563 | }
564 | .outline-item.select {
565 |   outline-offset: 0px;
566 | }
567 | 
568 | blockquote {
569 |   margin-left: -14px;
570 |   margin-right: -14px;
571 |   border-radius: var(--border-radius);
572 |   border-left: 4px solid var(--light-trait-300);
573 |   background-color: var(--light-trait-100);
574 |   padding: 7px 14px 7px 10px;
575 | }
576 | 
577 | blockquote blockquote {
578 |   padding-right: 0;
579 | }
580 | 
581 | table {
582 |   padding: 0;
583 |   word-break: initial;
584 | }
585 | 
586 | table tr {
587 |   border-top: 1px solid var(--dark-trait);
588 |   margin: 0;
589 |   padding: 0;
590 | }
591 | 
592 | table tr:nth-child(2n),
593 | thead {
594 |   background-color: var(--side-bar-bg-color);
595 | }
596 | 
597 | table tr th {
598 |   font-weight: bold;
599 |   border: 1px solid var(--dark-trait);
600 |   border-bottom: 0;
601 |   margin: 0;
602 |   padding: 6px 13px;
603 | }
604 | 
605 | table tr td {
606 |   border: 1px solid var(--dark-trait);
607 |   margin: 0;
608 |   padding: 6px 13px;
609 | }
610 | 
611 | table tr th:first-child,
612 | table tr td:first-child {
613 |   margin-top: 0;
614 | }
615 | 
616 | table tr th:last-child,
617 | table tr td:last-child {
618 |   margin-bottom: 0;
619 | }
620 | 
621 | kbd {
622 |   font-size: 0.875rem;
623 |   background: var(--bg-color-dark);
624 |   border: 1px solid var(--dark-trait);
625 |   box-shadow: 0 2px 0 var(--dark-trait);
626 |   color: var(--text-color-secondary);
627 | }
628 | 
629 | .md-fences,
630 | code,
631 | tt {
632 |   border: 1px solid var(--dark-trait);
633 |   background-color: var(--bg-color-dark);
634 |   border-radius: var(--border-radius);
635 |   padding: 2px 4px 0px 4px;
636 |   font-size: 0.9em;
637 |   font-family: var(--monospace);
638 | }
639 | 
640 | .md-fences {
641 |   margin-bottom: 15px;
642 |   margin-top: 15px;
643 |   padding-top: 8px;
644 |   padding-bottom: 6px;
645 |   background-color: var(--side-bar-bg-color);
646 | }
647 | 
648 | #write pre.md-meta-block {
649 |   padding: 1rem;
650 |   font-size: 85%;
651 |   line-height: 1.45;
652 |   background-color: var(--bg-color-dark);
653 |   border: 0;
654 |   border-radius: var(--border-radius);
655 |   color: var(--light-trait-400);
656 |   margin-top: 0 !important;
657 | }
658 | 
659 | #write .mathjax-block .md-rawblock-tooltip {
660 |   border-top-left-radius: var(--border-radius);
661 |   border-top-right-radius: var(--border-radius);
662 | }
663 | 
664 | #write .mathjax-block .md-math-container {
665 |   border-top-left-radius: var(--border-radius);
666 |   border-bottom-right-radius: var(--border-radius);
667 |   border-bottom-left-radius: var(--border-radius);
668 | }
669 | 
670 | #write .md-mathblock-panel .md-rawblock-control:first-of-type {
671 |   border-top-left-radius: var(--border-radius);
672 | }
673 | 
674 | .md-mathjax-midline {
675 |   background-color: var(--bg-color);
676 |   color: var(--text-color);
677 | }
678 | 
679 | .md-inline-math script {
680 |   color: var(--code-color);
681 | }
682 | 
683 | code {
684 |   padding: 0 2px 0 2px;
685 | }
686 | 
687 | .CodeMirror-lines {
688 |   padding-left: 4px;
689 | }
690 | 
691 | .code-tooltip {
692 |   box-shadow: none;
693 |   border-radius: var(--border-radius);
694 | }
695 | 
696 | #write .code-tooltip {
697 |   bottom: initial;
698 |   top: 100%;
699 |   left: initial;
700 |   right: -1px;
701 |   background: var(--bg-color-dark);
702 |   border: 1px solid var(--dark-trait);
703 |   border-top-left-radius: 0;
704 |   border-top-right-radius: 0;
705 |   border-top: 0;
706 |   font-family: var(--monospace);
707 | }
708 | 
709 | #write .md-mathblock-panel .code-tooltip {
710 |   right: 0;
711 |   border: none;
712 | }
713 | 
714 | #write .md-task-list-item > input {
715 |   -webkit-appearance: initial;
716 |   display: block;
717 |   position: absolute;
718 |   border: 1px solid var(--light-trait-200);
719 |   border-radius: 50%;
720 |   margin-left: -1.8rem;
721 |   height: 1.2rem;
722 |   width: 1.2rem;
723 |   transition: background 0.3s;
724 | }
725 | 
726 | #write .md-task-list-item > input:focus {
727 |   outline: none;
728 |   box-shadow: none;
729 | }
730 | 
731 | #write .md-task-list-item > input[checked] {
732 |   background: var(--primary-color);
733 |   border: 1px solid var(--primary-color);
734 | }
735 | 
736 | #write .md-task-list-item > input[checked]::before {
737 |   content: '✓';
738 |   position: absolute;
739 |   top: 0;
740 |   left: 0;
741 |   height: 100%;
742 |   width: 100%;
743 |   text-align: center;
744 |   color: var(--dark-trait);
745 |   font-size: 12px;
746 |   font-weight: 500;
747 | }
748 | 
749 | .md-image > .md-meta {
750 |   border-radius: var(--border-radius);
751 |   padding: 2px 0px 0px 4px;
752 |   font-size: 0.9em;
753 |   color: inherit;
754 | }
755 | 
756 | .md-toc {
757 |   margin-top: 20px;
758 |   padding-bottom: 20px;
759 | }
760 | 
761 | /* Source mode */
762 | .CodeMirror.cm-s-typora-default *,
763 | .cm-s-typora-default * {
764 |   background: inherit;
765 |   color: var(--text-color);
766 |   font-family: var(--monospace);
767 |   font-size: var(--font-size) !important;
768 |   font-style: normal;
769 |   font-weight: normal;
770 | }
771 | .CodeMirror.cm-s-typora-default div.CodeMirror-cursor {
772 |   border-left: 2px solid var(--light-trait-400);
773 | }
774 | 
775 | .sidebar-tabs {
776 |   border-bottom: none;
777 | }
778 | 
779 | .outline-expander {
780 |   width: 1.5rem;
781 |   vertical-align: initial;
782 | }
783 | .outline-expander:before,
784 | .outline-expander:hover:before,
785 | .outline-item-open > .outline-item > .outline-expander:before,
786 | .outline-item-open > .outline-item > .outline-expander:hover:before {
787 |   content: "\f125";
788 |   transition: transform 125ms ease-in-out;
789 | }
790 | .outline-item-open > .outline-item > .outline-expander:hover:before,
791 | .outline-item-open > .outline-item > .outline-expander:before {
792 |   transform: rotate(90deg);
793 | }
794 | .outline-label:hover {
795 |   text-decoration: none;
796 | }
797 | 
798 | #toc-dropmenu {
799 |   background: var(--bg-color-dark);
800 | }
801 | #toc-dropmenu .outline-title {
802 |   font-size: 1rem;
803 |   text-transform: uppercase;
804 | }
805 | .dropdown-menu .divider {
806 |   display: none;
807 | }
808 | 
809 | .context-menu {
810 |   background-color: var(--bg-color-dark);
811 | }
812 | 
813 | .file-node-background {
814 |   height: 31px;
815 | }
816 | .file-node-content:hover .file-node-icon,
817 | .file-node-content:hover .file-node-open-state {
818 |   visibility: visible;
819 | }
820 | .file-node-icon {
821 |   margin-right: 8px;
822 | }
823 | .file-library-node:not(.file-node-root):focus>.file-node-content {
824 |   outline: none;
825 | }
826 | 
827 | /* New file animation */
828 | .blink-area {
829 |   animation: none;
830 | }
831 | 
832 | .file-list-item-summary {
833 |   font-size: var(--font-size);
834 |   font-family: var(--font-family);
835 | }
836 | 
837 | #md-searchpanel input {
838 |   border-radius: var(--border-radius);
839 |   box-shadow: none;
840 | }
841 | #md-searchpanel input:focus {
842 |   box-shadow: none;
843 |   border-color: var(--meta-content-color);
844 | }
845 | #md-searchpanel .search-type-selection {
846 |   width: auto;
847 | }
848 | #md-searchpanel .btn:not(.close-btn):hover {
849 |   box-shadow: none;
850 | }
851 | 
852 | .mac-seamless-mode #typora-sidebar {
853 |   background-color: var(--side-bar-bg-color);
854 | }
855 | 
856 | #md-notification .btn {
857 |   border: 0;
858 | }
859 | 
860 | 
861 | 
862 | </style>
863 | </head>
864 | <body class='typora-export'>
865 | <div id='write'  class=''><p><span>A KRunner plugin / &quot;runner&quot; that searches recent workspaces in VSCode and lists</span>
866 | <span>results to quickly re-open the workspace in VSCode by pressing </span><code>Enter</code><span>, or open</span>
867 | <span>the project&#39;s directory by pressing </span><code>Shift</code><span> + </span><code>Enter</code><span>.</span></p><p><span>... get from store.kde.org ...</span></p><video>
868 |     <source src="assets/screenshots/demo.mp4">
869 | </video><p><img src="assets/screenshots/demo.mp4" referrerpolicy="no-referrer">
870 | <span>... screenshots ...</span></p><h2><a name="building" class="md-header-anchor"></a><span>Building</span></h2><pre spellcheck="false" class="md-fences md-end-block ty-contain-cm modeLoaded" lang="bash"><div class="CodeMirror cm-s-inner CodeMirror-wrap" lang="bash"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 0px; left: 7.97898px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">dart pub <span class="cm-builtin">get</span></span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 25px;"></div><div class="CodeMirror-gutters" style="display: none; height: 25px;"></div></div></div></pre><pre spellcheck="false" class="md-fences md-end-block ty-contain-cm modeLoaded" lang="bash"><div class="CodeMirror cm-s-inner CodeMirror-wrap" lang="bash"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 0px; left: 7.97898px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">dart compile exe <span class="cm-attribute">-o</span> package/vscode_runner bin/vscode_runner.dart</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 25px;"></div><div class="CodeMirror-gutters" style="display: none; height: 25px;"></div></div></div></pre><h2><a name="install-plugin" class="md-header-anchor"></a><span>Install plugin</span></h2><pre spellcheck="false" class="md-fences md-end-block ty-contain-cm modeLoaded" lang="bash"><div class="CodeMirror cm-s-inner CodeMirror-wrap" lang="bash"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 0px; left: 7.97898px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"><pre><span>xxxxxxxxxx</span></pre></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">package/install.sh</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 25px;"></div><div class="CodeMirror-gutters" style="display: none; height: 25px;"></div></div></div></pre><h2><a name="uninstall-plugin" class="md-header-anchor"></a><span>Uninstall plugin</span></h2><pre spellcheck="false" class="md-fences md-end-block ty-contain-cm" lang="bash"><div class="CodeMirror cm-s-inner CodeMirror-wrap" lang="bash"><div style="overflow: hidden; position: relative; width: 3px; height: 0px; top: 0px; left: 7.97898px;"><textarea autocorrect="off" autocapitalize="off" spellcheck="false" tabindex="0" style="position: absolute; bottom: -1em; padding: 0px; width: 1000px; height: 1em; outline: none;"></textarea></div><div class="CodeMirror-scrollbar-filler" cm-not-content="true"></div><div class="CodeMirror-gutter-filler" cm-not-content="true"></div><div class="CodeMirror-scroll" tabindex="-1"><div class="CodeMirror-sizer" style="margin-left: 0px; margin-bottom: 0px; border-right-width: 0px; padding-right: 0px; padding-bottom: 0px;"><div style="position: relative; top: 0px;"><div class="CodeMirror-lines" role="presentation"><div role="presentation" style="position: relative; outline: none;"><div class="CodeMirror-measure"></div><div class="CodeMirror-measure"></div><div style="position: relative; z-index: 1;"></div><div class="CodeMirror-code" role="presentation"><div class="CodeMirror-activeline" style="position: relative;"><div class="CodeMirror-activeline-background CodeMirror-linebackground"></div><div class="CodeMirror-gutter-background CodeMirror-activeline-gutter" style="left: 0px; width: 0px;"></div><pre class=" CodeMirror-line " role="presentation"><span role="presentation" style="padding-right: 0.1px;">package/uninstall.sh</span></pre></div></div></div></div></div></div><div style="position: absolute; height: 0px; width: 1px; border-bottom: 0px solid transparent; top: 25px;"></div><div class="CodeMirror-gutters" style="display: none; height: 25px;"></div></div></div></pre></div>
871 | </body>
872 | </html>


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | A KRunner plugin / "runner" that lists VSCode's recent workspaces
 2 | 
 3 | - Quickly re-open the workspace in VSCode by pressing `Enter`.
 4 | - Open a file browser to the workspace's directory by pressing `Shift` + `Enter`.
 5 | - Supports: Stable, Insiders, VSCodium
 6 | 
 7 | 
 8 | <br>
 9 | 
10 | 
11 | ## Download
12 | 
13 | <a href="https://store.kde.org/p/1653111/"><img alt="Download from the KDE Store" height="50px"
14 | src="https://img.shields.io/badge/KDE_Store-blue?style=for-the-badge&logo=kde"></a>
15 | 
16 | **NixOS**
17 | 
18 | ```bash
19 | nix-shell --packages vscode-runner
20 | ```
21 | 
22 | 
23 | <br>
24 | 
25 | 
26 | ## Screenshot
27 | 
28 | ![Screenshot](assets/screenshots/screenshot.png)
29 | 
30 | 
31 | <br>
32 | 
33 | 
34 | https://user-images.githubusercontent.com/9575627/143503598-47a7ca08-644d-4ba8-9f33-3baf8143fcbf.mp4
35 | 
36 | 
37 | <br>
38 | 
39 | 
40 | ## Requirements
41 | 
42 | - sqlite3
43 |   - Fedora: `sudo dnf install sqlite-devel`
44 |   - Debian/Ubuntu: `sudo apt install libsqlite3-dev`
45 | 
46 | 
47 | ## Building
48 | 
49 | ```bash
50 | dart pub get
51 | ```
52 | 
53 | ```bash
54 | dart compile exe -o package/vscode_runner bin/vscode_runner.dart
55 | ```
56 | 
57 | 
58 | <br>
59 | 
60 | 
61 | ## Install plugin
62 | 
63 | ```bash
64 | package/install.sh
65 | ```
66 | 
67 | 
68 | <br>
69 | 
70 | 
71 | ## Uninstall plugin
72 | 
73 | ```bash
74 | package/uninstall.sh
75 | ```
76 | 


--------------------------------------------------------------------------------
/analysis_options.yaml:
--------------------------------------------------------------------------------
 1 | # This file configures the static analysis results for your project (errors,
 2 | # warnings, and lints).
 3 | #
 4 | # This enables the 'recommended' set of lints from `package:lints`.
 5 | # This set helps identify many issues that may lead to problems when running
 6 | # or consuming Dart code, and enforces writing Dart using a single, idiomatic
 7 | # style and format.
 8 | #
 9 | # If you want a smaller set of lints you can change this to specify
10 | # 'package:lints/core.yaml'. These are just the most critical lints
11 | # (the recommended set includes the core lints).
12 | # The core lints are also what is used by pub.dev for scoring packages.
13 | 
14 | include: package:lints/recommended.yaml
15 | 
16 | # Uncomment the following section to specify additional rules.
17 | 
18 | linter:
19 |   rules:
20 |     prefer_final_locals: true
21 |     prefer_relative_imports: true
22 |     sort_pub_dependencies: true
23 | # analyzer:
24 | #   exclude:
25 | #     - path/to/excluded/files/**
26 | 
27 | # For more information about the core and recommended set of lints, see
28 | # https://dart.dev/go/core-lints
29 | 
30 | # For additional information about configuring this file, see
31 | # https://dart.dev/guides/language/analysis-options
32 | 


--------------------------------------------------------------------------------
/assets/screenshots/demo.mp4:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Merrit/vscode-runner/61d0aca941a485f9df539f8c1fe78dbca5ec539b/assets/screenshots/demo.mp4


--------------------------------------------------------------------------------
/assets/screenshots/screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Merrit/vscode-runner/61d0aca941a485f9df539f8c1fe78dbca5ec539b/assets/screenshots/screenshot.png


--------------------------------------------------------------------------------
/bin/vscode_runner.dart:
--------------------------------------------------------------------------------
  1 | import 'dart:async';
  2 | import 'dart:io';
  3 | 
  4 | import 'package:krunner/krunner.dart';
  5 | import 'package:vscode_runner/database.dart';
  6 | import 'package:vscode_runner/enums/enums.dart';
  7 | import 'package:vscode_runner/logs/logging_manager.dart';
  8 | import 'package:vscode_runner/vscode.dart';
  9 | 
 10 | Future<void> main(List<String> arguments) async {
 11 |   await checkIfAlreadyRunning();
 12 |   await LoggingManager.initialize(verbose: true);
 13 | 
 14 |   log.i('Starting VSCode runner.');
 15 | 
 16 |   final bool vscodeExists = await _executableExists('code');
 17 |   if (vscodeExists) {
 18 |     _vscodeInstances.add(VSCode(
 19 |       VSCodeVersion.stable,
 20 |       database: VSCodeDatabase(DatabaseFilePath.stable),
 21 |     ));
 22 |   }
 23 | 
 24 |   final bool vscodeInsidersExists = await _executableExists('code-insiders');
 25 |   if (vscodeInsidersExists) {
 26 |     _vscodeInstances.add(VSCode(
 27 |       VSCodeVersion.insiders,
 28 |       database: VSCodeDatabase(DatabaseFilePath.insiders),
 29 |     ));
 30 |   }
 31 | 
 32 |   final bool codiumExists = await _executableExists('codium');
 33 |   if (codiumExists) {
 34 |     _vscodeInstances.add(VSCode(
 35 |       VSCodeVersion.codium,
 36 |       database: VSCodeDatabase(DatabaseFilePath.codium),
 37 |     ));
 38 |   }
 39 | 
 40 |   if (_vscodeInstances.isEmpty) {
 41 |     log.e('Unable to find any instances of VSCode. '
 42 |         'Please make sure at least one is installed and on your PATH.\n'
 43 |         'e.g. `which code` or `which code-insiders`');
 44 |     exit(1);
 45 |   }
 46 | 
 47 |   final runner = KRunnerPlugin(
 48 |     identifier: 'codes.merritt.vscode_runner',
 49 |     name: '/vscode_runner',
 50 |     matchQuery: _debouncedMatchQuery,
 51 |     retrieveActions: retrieveActions,
 52 |     runAction: runAction,
 53 |   );
 54 | 
 55 |   await runner.init();
 56 | }
 57 | 
 58 | /// A list of all instances of VSCode detected on the system.
 59 | List<VSCode> _vscodeInstances = [];
 60 | 
 61 | /// Check if an instance of this plugin is already running.
 62 | ///
 63 | /// If we don't check KRunner will just launch a new instance every time.
 64 | Future<void> checkIfAlreadyRunning() async {
 65 |   final result = await Process.run('pidof', ['vscode_runner']);
 66 |   final hasError = result.stderr != '';
 67 |   if (hasError) {
 68 |     print('Issue checking for existing process: ${result.stderr}');
 69 |     return;
 70 |   }
 71 |   final output = result.stdout as String;
 72 |   final runningInstanceCount = output.trim().split(' ').length;
 73 |   if (runningInstanceCount != 1) {
 74 |     print('An instance of vscode_runner appears to already be running. '
 75 |         'Aborting run of new instance.');
 76 |     exit(0);
 77 |   }
 78 | }
 79 | 
 80 | /// Checks if [executable] exists on the system.
 81 | Future<bool> _executableExists(String executable) async {
 82 |   final result = await Process.run('which', [executable]);
 83 |   final hasError = result.stderr != '';
 84 | 
 85 |   if (hasError) {
 86 |     log.d('Unable to locate code executable: ${result.stderr}');
 87 |     return false;
 88 |   }
 89 | 
 90 |   final output = result.stdout as String;
 91 |   final path = output.trim();
 92 |   log.i('Found VSCode executable at $path');
 93 |   return true;
 94 | }
 95 | 
 96 | /// A timer that is used to debounce the query.
 97 | Timer? _debounceTimer;
 98 | 
 99 | /// The amount of time to wait before running the query.
100 | const _debounceTime = Duration(milliseconds: 500);
101 | 
102 | /// A completer that is used to complete the query.
103 | ///
104 | /// The Completer is kept outside of the [_debouncedMatchQuery] function so that
105 | /// we can be sure that a previous query is cancelled before starting a new one.
106 | Completer<List<QueryMatch>>? _completer;
107 | 
108 | /// Debounces the query.
109 | ///
110 | /// If the user is typing, we don't want to run the query for every keystroke or
111 | /// we will run into performance issues.
112 | ///
113 | /// Instead, we wait until the user has stopped typing for a short period of
114 | /// time, and then run the query.
115 | Future<List<QueryMatch>> _debouncedMatchQuery(String query) async {
116 |   _debounceTimer?.cancel();
117 | 
118 |   if (_completer == null || _completer!.isCompleted) {
119 |     _completer = Completer();
120 |   }
121 | 
122 |   _debounceTimer = Timer(_debounceTime, () async {
123 |     try {
124 |       final matches = await matchQuery(query);
125 |       _completer!.complete(matches);
126 |     } catch (e) {
127 |       _completer!.completeError(e);
128 |     }
129 |   });
130 |   return _completer!.future;
131 | }
132 | 
133 | /// Returns a list of [QueryMatch]es for the given [query].
134 | Future<List<QueryMatch>> matchQuery(String query) async {
135 |   log.i('Running query for: $query');
136 | 
137 |   final List<QueryMatch> matches = [];
138 | 
139 |   for (final instance in _vscodeInstances) {
140 |     final instanceMatches = _getMatchesFor(query, instance.version);
141 |     log.i(
142 |       'Found ${instanceMatches.length} matches for ${instance.version}.',
143 |     );
144 |     matches.addAll(instanceMatches);
145 |   }
146 | 
147 |   return matches;
148 | }
149 | 
150 | /// Returns a list of [QueryMatch]es for the given [query], for the version of
151 | /// VSCode specified by [vscodeVersion].
152 | List<QueryMatch> _getMatchesFor(String query, VSCodeVersion vscodeVersion) {
153 |   final vscode = _vscodeInstances.firstWhere((e) => e.version == vscodeVersion);
154 |   final recentWorkspacePaths = List<String>.from(vscode.recentWorkspacePaths);
155 |   final regex = RegExp(query, caseSensitive: false);
156 |   recentWorkspacePaths.removeWhere((element) => !regex.hasMatch(element));
157 |   if (recentWorkspacePaths.isEmpty) return [];
158 |   final matches = _workspacePathsToQueryMatches(
159 |     recentWorkspacePaths,
160 |     vscodeVersion,
161 |   );
162 |   return matches;
163 | }
164 | 
165 | /// Converts a list of workspace paths into a list of [QueryMatch]es.
166 | List<QueryMatch> _workspacePathsToQueryMatches(
167 |   List<String> recentWorkspacePaths,
168 | 
169 |   /// The version of VSCode that the paths are from. This is used to determine
170 |   /// which icon to use.
171 |   VSCodeVersion vscodeVersion,
172 | ) {
173 |   final icon = vscodeIconNameFor(vscodeVersion);
174 | 
175 |   final matches = recentWorkspacePaths.map((path) {
176 |     final uri = pathToUri(path);
177 |     final relativePath = parseRelativePath(uri);
178 |     final projectName = path.split('/').last;
179 | 
180 |     final String idPrefix;
181 |     switch (vscodeVersion) {
182 |       case VSCodeVersion.codium:
183 |         idPrefix = 'codium';
184 |         break;
185 |       case VSCodeVersion.insiders:
186 |         idPrefix = 'insiders';
187 |         break;
188 |       case VSCodeVersion.stable:
189 |         idPrefix = 'stable';
190 |         break;
191 |     }
192 | 
193 |     final id = '$idPrefix-$path';
194 | 
195 |     log.i('Found match: $id');
196 | 
197 |     return QueryMatch(
198 |       id: id, // id is the raw folderUri starting with file:// or vscode-remote://
199 |       title: projectName,
200 |       icon: icon,
201 |       rating: QueryMatchRating.exact,
202 |       relevance: 1.0,
203 |       properties: QueryMatchProperties(subtitle: relativePath ?? uri.path),
204 |     );
205 |   }).toList();
206 | 
207 |   return matches;
208 | }
209 | 
210 | Uri pathToUri(String path) {
211 |   // Remove the leading "file://" or "vscode-remote://"
212 |   final trimmed = path
213 |       .replaceFirst('file://', '') //
214 |       .replaceFirst('vscode-remote://', '');
215 |   final uri = Uri.directory(trimmed);
216 |   return uri;
217 | }
218 | 
219 | String? parseRelativePath(Uri uri) {
220 |   var homeDir = Process.runSync('xdg-user-dir', []).stdout as String;
221 |   homeDir = homeDir.trim();
222 |   final pathIsUnderHome = uri.path.contains(homeDir);
223 |   if (pathIsUnderHome) {
224 |     // If the path is under the user's home directory, we return
225 |     // the relative path so that the subtitle in KRunner can be a shorter
226 |     // path that will fit better in limited space, eg:
227 |     // `~/Development/project` rather than `/home/user/Development/project`.
228 |     final withoutHomePrefix = uri.path.substring(homeDir.length);
229 |     final relativePath = '~$withoutHomePrefix';
230 |     return relativePath;
231 |   } else {
232 |     return null;
233 |   }
234 | }
235 | 
236 | Future<List<SecondaryAction>> retrieveActions() async {
237 |   return [
238 |     SecondaryAction(
239 |       id: 'openContainingFolder',
240 |       text: 'Open Containing Folder',
241 |       icon: 'document-open-folder',
242 |     ),
243 |   ];
244 | }
245 | 
246 | Future<void> runAction({
247 |   required String actionId,
248 |   required String matchId,
249 | }) async {
250 |   log.i('Running action. actionId: $actionId, matchId: $matchId');
251 | 
252 |   final matchPrefix = matchId.split('-').first;
253 |   final vscodeVersion = VSCodeVersion.values.byName(matchPrefix);
254 |   final path = matchId.replaceFirst('$matchPrefix-', '');
255 | 
256 |   final isOpenFolderRequest = (actionId == "openContainingFolder") //
257 |       ? true
258 |       : false;
259 | 
260 |   if (isOpenFolderRequest) {
261 |     openContainingFolder(path);
262 |   } else {
263 |     openWorkspace(path, vscodeVersion);
264 |   }
265 | }
266 | 
267 | Future<void> openWorkspace(String uri, VSCodeVersion vscodeVersion) async {
268 |   log.i('Opening workspace at $uri with $vscodeVersion');
269 | 
270 |   final executable = vscodeExecutableFor(vscodeVersion);
271 | 
272 |   /// Pass the raw uri with `--folder-uri` and VSCode will handle it.
273 |   // see https://stackoverflow.com/questions/60144074/how-to-open-a-remote-folder-from-command-line-in-vs-code
274 |   final result = await Process.run(executable, ['--folder-uri=$uri']);
275 | 
276 |   if (result.exitCode != 0) {
277 |     log.e('Issue opening workspace: ${result.stderr}');
278 |   } else {
279 |     log.i('Successfully opened workspace at $uri with $vscodeVersion');
280 |   }
281 | }
282 | 
283 | Future<void> openContainingFolder(String path) async {
284 |   log.i('Opening containing folder at $path');
285 |   final result = await Process.run('xdg-open', [path]);
286 | 
287 |   if (result.exitCode != 0) {
288 |     log.e('Issue opening containing folder: ${result.stderr}');
289 |   } else {
290 |     log.i('Successfully opened containing folder at $path');
291 |   }
292 | }
293 | 


--------------------------------------------------------------------------------
/lib/database.dart:
--------------------------------------------------------------------------------
  1 | import 'dart:async';
  2 | import 'dart:convert';
  3 | import 'dart:io';
  4 | 
  5 | import 'package:sqlite3/sqlite3.dart';
  6 | import 'package:xdg_directories/xdg_directories.dart';
  7 | 
  8 | import 'logs/logging_manager.dart';
  9 | 
 10 | class MissingSQLite3Exception implements Exception {
 11 |   @override
 12 |   String toString() {
 13 |     return 'The sqlite3 package is required to read the VSCode database file.\n'
 14 |         'Make sure sqlite3 is installed.\n'
 15 |         '\n'
 16 |         'Details: https://github.com/Merrit/vscode-runner?tab=readme-ov-file#requirements';
 17 |   }
 18 | }
 19 | 
 20 | /// The paths to the database files that various verions of VSCode use.
 21 | abstract class DatabaseFilePath {
 22 |   /// The VSCodium version of VSCode.
 23 |   static String codium =
 24 |       '${configHome.path}/VSCodium/User/globalStorage/state.vscdb';
 25 | 
 26 |   /// The Insiders version of VSCode.
 27 |   static String insiders =
 28 |       '${configHome.path}/Code - Insiders/User/globalStorage/state.vscdb';
 29 | 
 30 |   /// The stable version of VSCode.
 31 |   static String stable =
 32 |       '${configHome.path}/Code/User/globalStorage/state.vscdb';
 33 | }
 34 | 
 35 | /// Represents the database from the `state.vscdb` file that VSCode uses for
 36 | /// configurations.
 37 | class VSCodeDatabase {
 38 |   final String _dbFilePath;
 39 | 
 40 |   VSCodeDatabase(this._dbFilePath) {
 41 |     _watchDatabaseFile();
 42 |   }
 43 | 
 44 |   /// A stream that emits an event whenever the database file changes.
 45 |   ///
 46 |   /// This is used to detect when VSCode adds a new workspace to its "recent
 47 |   /// workspaces" list.
 48 |   Stream<void> get databaseChangedStream =>
 49 |       _databaseChangedStreamController.stream;
 50 | 
 51 |   /// Controller for the [databaseChangedStream].
 52 |   final _databaseChangedStreamController = StreamController<void>.broadcast();
 53 | 
 54 |   /// Watch the database file for changes, and emit an event to the
 55 |   /// [databaseChangedStream] whenever it changes.
 56 |   Future<void> _watchDatabaseFile() async {
 57 |     final databaseFile = File(_dbFilePath);
 58 |     final databaseFileExists = await databaseFile.exists();
 59 | 
 60 |     if (!databaseFileExists) {
 61 |       log.e('Unable to watch database file. File does not exist.');
 62 |       return;
 63 |     }
 64 | 
 65 |     log.i('Watching database file at $_dbFilePath');
 66 | 
 67 |     final databaseFileWatcher = databaseFile.watch(events: FileSystemEvent.all);
 68 |     Timer? databaseFileWatcherTimer;
 69 | 
 70 |     await for (final event in databaseFileWatcher) {
 71 |       if (event.type == FileSystemEvent.modify) {
 72 |         // If the file is modified multiple times in a short period of time,
 73 |         // we only want to emit one event.
 74 |         databaseFileWatcherTimer?.cancel();
 75 |         databaseFileWatcherTimer = Timer(const Duration(seconds: 30), () {
 76 |           _databaseChangedStreamController.add(null);
 77 |         });
 78 |       }
 79 |     }
 80 |   }
 81 | 
 82 |   /// Returns a list where each is the path of a workspace that is remembered
 83 |   /// by VSCode, in its "recent workspaces" list.
 84 |   List<String> getRecentWorkspacePaths() {
 85 |     final Database db;
 86 | 
 87 |     try {
 88 |       db = sqlite3.open(_dbFilePath, mode: OpenMode.readOnly);
 89 |     } catch (e) {
 90 |       log.e('Unable to open VSCode database file.\n'
 91 |           'Expected file at $_dbFilePath\n'
 92 |           'Make sure sqlite3 is installed.\n'
 93 |           'Error: $e');
 94 | 
 95 |       throw MissingSQLite3Exception();
 96 |     }
 97 | 
 98 |     log.i('Opened VSCode database file at $_dbFilePath');
 99 | 
100 |     final rows = db.select(
101 |       "SELECT value FROM ItemTable WHERE key = 'history.recentlyOpenedPathsList'",
102 |     );
103 |     db.dispose();
104 | 
105 |     final jsonString = rows.first.values.first as String;
106 |     final recentPaths = _recentPathsFromJson(jsonString);
107 | 
108 |     return List<String>.unmodifiable([...recentPaths]);
109 |   }
110 | 
111 |   /// Converts the json from the db query into a `List<String>` of paths.
112 |   List<String> _recentPathsFromJson(String data) {
113 |     final dataMap = json.decode(data) as Map<String, dynamic>;
114 |     final rawPathList = dataMap['entries'] as List;
115 |     final pathMaps = rawPathList.cast<Map<String, dynamic>>();
116 |     final paths =
117 |         pathMaps.map((e) => e['folderUri'] ?? '').toList().cast<String>();
118 |     return paths;
119 |   }
120 | }
121 | 


--------------------------------------------------------------------------------
/lib/enums/enums.dart:
--------------------------------------------------------------------------------
1 | export 'vscode_version.dart';
2 | 


--------------------------------------------------------------------------------
/lib/enums/vscode_version.dart:
--------------------------------------------------------------------------------
 1 | /// The different versions of VSCode that might be installed.
 2 | enum VSCodeVersion {
 3 |   /// The Insiders (beta) version of VSCode.
 4 |   codium,
 5 | 
 6 |   /// The VSCodium version of VSCode.
 7 |   insiders,
 8 | 
 9 |   /// The stable version of VSCode.
10 |   stable,
11 | }
12 | 


--------------------------------------------------------------------------------
/lib/helpers/directories.dart:
--------------------------------------------------------------------------------
 1 | import 'dart:io';
 2 | 
 3 | import 'package:xdg_directories/xdg_directories.dart';
 4 | 
 5 | /// Returns the Directory for `~/.local/share/vscode-runner`.
 6 | ///
 7 | /// This is the directory for storing the plugin's data, configs, logs, etc.
 8 | Future<Directory> getAppSupportDirectory() async {
 9 |   final appSupportDir = Directory('${dataHome.path}/vscode-runner');
10 |   final exists = await appSupportDir.exists();
11 |   if (!exists) await appSupportDir.create(recursive: true);
12 |   return appSupportDir;
13 | }
14 | 


--------------------------------------------------------------------------------
/lib/helpers/helpers.dart:
--------------------------------------------------------------------------------
1 | export 'directories.dart';
2 | 


--------------------------------------------------------------------------------
/lib/logs/logging_manager.dart:
--------------------------------------------------------------------------------
 1 | import 'dart:io';
 2 | 
 3 | import 'package:logger/logger.dart';
 4 | 
 5 | import '../helpers/helpers.dart';
 6 | import 'src/src.dart';
 7 | 
 8 | /// Globally available instance available for easy logging.
 9 | late Logger log;
10 | 
11 | /// Manages logging for the app.
12 | class LoggingManager {
13 |   /// The file to which logs are saved.
14 |   ///
15 |   /// If there was an issue creating the log file, this will be null.
16 |   final File? _logFile;
17 | 
18 |   /// Whether verbose logging is enabled.
19 |   final bool verbose;
20 | 
21 |   /// Singleton instance for easy access.
22 |   static late LoggingManager instance;
23 | 
24 |   LoggingManager._(
25 |     this._logFile, {
26 |     required this.verbose,
27 |   }) {
28 |     instance = this;
29 |   }
30 | 
31 |   static Future<LoggingManager> initialize({bool verbose = false}) async {
32 |     final appDir = await getAppSupportDirectory();
33 |     final String logDirPath = '${appDir.path}${Platform.pathSeparator}logs';
34 |     final Directory logDir = Directory(logDirPath);
35 |     final logFileService = LogFileService(logDir);
36 |     final File? logFile = await logFileService.getLogFile();
37 | 
38 |     final List<LogOutput> outputs = [
39 |       ConsoleOutput(),
40 |       if (logFile != null) FileOutput(file: logFile),
41 |     ];
42 | 
43 |     log = Logger(
44 |       filter: ProductionFilter(),
45 |       level: (verbose) ? Level.trace : Level.warning,
46 |       output: MultiOutput(outputs),
47 |       // Colors false because it outputs ugly escape characters to log file.
48 |       printer: PrefixPrinter(
49 |         PrettyPrinter(
50 |           colors: false,
51 |           dateTimeFormat: DateTimeFormat.dateAndTime,
52 |         ),
53 |       ),
54 |     );
55 | 
56 |     log.i('Logger initialized.');
57 | 
58 |     return LoggingManager._(
59 |       logFile,
60 |       verbose: verbose,
61 |     );
62 |   }
63 | 
64 |   /// Read the logs for this run from the log file.
65 |   Future<String> getLogs() async {
66 |     if (_logFile == null) {
67 |       return 'There was an issue creating the log file.';
68 |     }
69 | 
70 |     return await _logFile!.readAsString();
71 |   }
72 | 
73 |   /// Close the logger and release resources.
74 |   void close() => log.close();
75 | }
76 | 


--------------------------------------------------------------------------------
/lib/logs/src/log_file_service.dart:
--------------------------------------------------------------------------------
  1 | import 'dart:io';
  2 | 
  3 | /// Manages log files.
  4 | class LogFileService {
  5 |   /// The maximum size of a log file.
  6 |   static const int _maxLogFileSize = 2 * 1024 * 1024; // 2MB
  7 | 
  8 |   /// The directory where log files are stored.
  9 |   final Directory _logDir;
 10 | 
 11 |   LogFileService(this._logDir) : _today = _getTodayDate();
 12 | 
 13 |   /// Today's date in the format yyyy-mm-dd.
 14 |   final String _today;
 15 | 
 16 |   /// Get the log file.
 17 |   ///
 18 |   /// There should be one log file per day, with a maximum of 7 days.
 19 |   ///
 20 |   /// If a log file we are appending to is larger than 2MB, a new log file will
 21 |   /// be created. For example, if today's log file is called 2021-01-01.txt and
 22 |   /// it is larger than 2MB, a new log file will be created called
 23 |   /// 2021-01-01_2.txt. If the current log file is called 2021-01-01_2.txt and
 24 |   /// it is larger than 2MB, a new log file will be created called
 25 |   /// 2021-01-01_3.txt.
 26 |   ///
 27 |   /// If the desired log file is not accessible, an alternative will be used.
 28 |   ///
 29 |   /// If the log file cannot be created, returns null.
 30 |   ///
 31 |   /// If appending to a log file, will insert a divider between the old and new
 32 |   /// logs.
 33 |   Future<File?> getLogFile() async {
 34 |     if (!await _logDir.exists()) {
 35 |       try {
 36 |         await _logDir.create();
 37 |       } on Exception catch (e) {
 38 |         print('Could not create log directory: $e');
 39 |         return null;
 40 |       }
 41 |     }
 42 | 
 43 |     await _deleteOldLogFiles();
 44 |     final String fileName = '$_today.txt';
 45 |     File logFile = File('${_logDir.path}${Platform.pathSeparator}$fileName');
 46 |     final bool exists = await logFile.exists();
 47 | 
 48 |     if (!exists) {
 49 |       return _createLogFile(logFile);
 50 |     }
 51 | 
 52 |     final size = await logFile.length();
 53 | 
 54 |     if (size < _maxLogFileSize) {
 55 |       await _appendDivider(logFile);
 56 |       return logFile;
 57 |     }
 58 | 
 59 |     final List<File> logFiles = await getAllLogFiles();
 60 | 
 61 |     // List all log files that start with the current date.
 62 | 
 63 |     final List<File> todayLogFiles =
 64 |         logFiles.where((file) => file.path.contains(_today)).toList();
 65 | 
 66 |     logFile = await _getNumberedLogFile(todayLogFiles);
 67 |     return logFile;
 68 |   }
 69 | 
 70 |   /// Get a list of all log files.
 71 |   ///
 72 |   /// The list will be sorted from newest to oldest.
 73 |   Future<List<File>> getAllLogFiles() async {
 74 |     if (!await _logDir.exists()) {
 75 |       try {
 76 |         await _logDir.create();
 77 |       } on Exception catch (e) {
 78 |         print('Could not create log directory: $e');
 79 |         return [];
 80 |       }
 81 |     }
 82 | 
 83 |     final List<FileSystemEntity> files = _logDir.listSync();
 84 | 
 85 |     final List<File> logFiles = files
 86 |         .whereType<File>()
 87 |         .where((file) => file.path.endsWith('.txt'))
 88 |         .toList();
 89 | 
 90 |     logFiles.sort((a, b) => b.path.compareTo(a.path));
 91 | 
 92 |     return logFiles;
 93 |   }
 94 | 
 95 |   /// Append a divider to the log file.
 96 |   ///
 97 |   /// The divider will be a line of 80 dashes with a newline before and after.
 98 |   Future<void> _appendDivider(File logFile) async {
 99 |     final dateTime = DateTime.now().toLocal();
100 |     // Current local time, in format of: 2023-08-07 13:52:40
101 |     final currentTime = dateTime.toString().split('.').first;
102 | 
103 |     final String divider = '''
104 | 
105 | --------------------------------------------------------------------------------
106 | 
107 | $currentTime
108 | 
109 | ''';
110 | 
111 |     try {
112 |       await logFile.writeAsString(divider, mode: FileMode.append);
113 |     } on Exception catch (e) {
114 |       print('Could not append divider to log file: $e');
115 |     }
116 |   }
117 | 
118 |   /// Create a new log file.
119 |   ///
120 |   /// If the log file cannot be created, returns null.
121 |   Future<File?> _createLogFile(File logFile) async {
122 |     try {
123 |       await logFile.create();
124 |     } on Exception catch (e) {
125 |       print('Could not create log file: $e');
126 |       return null;
127 |     }
128 | 
129 |     return logFile;
130 |   }
131 | 
132 |   /// If there are more than 7 days of logs, delete the oldest log files.
133 |   Future<void> _deleteOldLogFiles() async {
134 |     final List<File> logFiles = await getAllLogFiles()
135 |       // Remove any numbered log files.
136 |       ..removeWhere(
137 |           (file) => file.path.split(Platform.pathSeparator).last.contains('_'));
138 | 
139 |     if (logFiles.length <= 7) {
140 |       return;
141 |     }
142 | 
143 |     final List<File> oldLogFiles = logFiles.sublist(7);
144 | 
145 |     for (final logFile in oldLogFiles) {
146 |       try {
147 |         await logFile.delete();
148 |       } on Exception catch (e) {
149 |         print('Could not delete old log file: $e');
150 |       }
151 |     }
152 |   }
153 | 
154 |   /// Get the highest number from a list of numbered log files.
155 |   int _getHighestNumber(List<File> todayLogFiles) {
156 |     if (todayLogFiles.length == 1) {
157 |       return 0;
158 |     }
159 | 
160 |     // Remove any log files that are not numbered.
161 |     todayLogFiles.removeWhere((file) =>
162 |         file.path.split(Platform.pathSeparator).last.contains('_') == false);
163 | 
164 |     final int highestNumber = todayLogFiles
165 |         .map((file) => int.parse(file.path.split('_').last.split('.').first))
166 |         .reduce((value, element) => value > element ? value : element);
167 | 
168 |     return highestNumber;
169 |   }
170 | 
171 |   /// Get the current numbered log file.
172 |   ///
173 |   /// [todayLogFiles] is a list of existing log files for today.
174 |   ///
175 |   /// The first log file of the day will not have a number, subsequent log files
176 |   /// will have an underscore and a number. For example, 2021-01-01.txt and
177 |   /// 2021-01-01_2.txt.
178 |   ///
179 |   /// Returns the most recent log file that is not at the maximum size.
180 |   ///
181 |   /// If all log files are at the maximum size, creates a new log file.
182 |   Future<File> _getNumberedLogFile(List<File> todayLogFiles) async {
183 |     for (final logFile in todayLogFiles) {
184 |       final size = await logFile.length();
185 | 
186 |       if (size < _maxLogFileSize) {
187 |         await _appendDivider(logFile);
188 |         return logFile;
189 |       }
190 |     }
191 | 
192 |     // If all log files are at the maximum size, create a new log file.
193 |     final int highestNumber = _getHighestNumber(todayLogFiles);
194 |     final String newFileName = '${_today}_${highestNumber + 1}.txt';
195 | 
196 |     final File newLogFile =
197 |         File('${_logDir.path}${Platform.pathSeparator}$newFileName');
198 | 
199 |     await newLogFile.create();
200 | 
201 |     return newLogFile;
202 |   }
203 | 
204 |   /// Get today's date in the format yyyy-mm-dd.
205 |   static String _getTodayDate() {
206 |     final DateTime now = DateTime.now();
207 |     return '${now.year}-${now.month}-${now.day}';
208 |   }
209 | }
210 | 


--------------------------------------------------------------------------------
/lib/logs/src/src.dart:
--------------------------------------------------------------------------------
1 | export 'log_file_service.dart';
2 | 


--------------------------------------------------------------------------------
/lib/notifications.dart:
--------------------------------------------------------------------------------
 1 | import 'package:xdg_desktop_portal/xdg_desktop_portal.dart';
 2 | 
 3 | /// A very basic notifications implementation, added so we can inform the
 4 | /// user of any errors that occur.
 5 | 
 6 | /// Sends a notification with the given [title] and [body].
 7 | Future<void> sendNotification({
 8 |   required String title,
 9 |   required String body,
10 | }) async {
11 |   final client = XdgDesktopPortalClient();
12 | 
13 |   await client.notification.addNotification(
14 |     title,
15 |     title: 'VS Code Runner: $title',
16 | 
17 |     /// TODO: Once the notification package supports `markup-body`, use it here
18 |     /// so that for example notifications can contain clickable links, the way
19 |     /// that [MissingSQLite3Exception] is trying to do.
20 |     /// See: https://flatpak.github.io/xdg-desktop-portal/docs/doc-org.freedesktop.portal.Notification.html#org-freedesktop-portal-notification-addnotification
21 |     body: body,
22 |     priority: XdgNotificationPriority.urgent,
23 |   );
24 | 
25 |   await client.close();
26 | }
27 | 


--------------------------------------------------------------------------------
/lib/vscode.dart:
--------------------------------------------------------------------------------
 1 | import 'database.dart';
 2 | import 'enums/enums.dart';
 3 | import 'notifications.dart';
 4 | 
 5 | class VSCode {
 6 |   final VSCodeDatabase _database;
 7 | 
 8 |   List<String> recentWorkspacePaths = [];
 9 |   final VSCodeVersion version;
10 | 
11 |   VSCode(
12 |     this.version, {
13 |     required VSCodeDatabase database,
14 |   }) : _database = database {
15 |     // Populate the recentWorkspacePaths list.
16 |     _updateRecentWorkspacePaths();
17 | 
18 |     // Listen for changes to the database file, and update the recentWorkspacePaths.
19 |     database.databaseChangedStream.listen((_) {
20 |       _updateRecentWorkspacePaths();
21 |     });
22 |   }
23 | 
24 |   /// Populates the [recentWorkspacePaths] list with the most recent workspace
25 |   /// paths.
26 |   Future<void> _updateRecentWorkspacePaths() async {
27 |     try {
28 |       recentWorkspacePaths = _database.getRecentWorkspacePaths();
29 |     } on MissingSQLite3Exception catch (e) {
30 |       await sendNotification(
31 |         title: 'SQLite3 Error',
32 |         body: e.toString(),
33 |       );
34 |     }
35 |   }
36 | }
37 | 
38 | /// Returns the executable name for the given [version].
39 | String vscodeExecutableFor(VSCodeVersion version) {
40 |   switch (version) {
41 |     case VSCodeVersion.codium:
42 |       return 'codium';
43 |     case VSCodeVersion.insiders:
44 |       return 'code-insiders';
45 |     case VSCodeVersion.stable:
46 |       return 'code';
47 |   }
48 | }
49 | 
50 | /// Returns the icon name for the given [version].
51 | ///
52 | /// This is used to determine which icon will be shown in the search results.
53 | String vscodeIconNameFor(VSCodeVersion version) {
54 |   switch (version) {
55 |     case VSCodeVersion.codium:
56 |       return 'vscodium';
57 |     case VSCodeVersion.insiders:
58 |       return 'vscode-insiders';
59 |     case VSCodeVersion.stable:
60 |       return 'vscode';
61 |   }
62 | }
63 | 


--------------------------------------------------------------------------------
/package/codes.merritt.vscode_runner.service:
--------------------------------------------------------------------------------
1 | [D-BUS Service]
2 | Name=codes.merritt.vscode_runner
3 | Exec=
4 | 


--------------------------------------------------------------------------------
/package/install.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Exit script if we encounter an error.
 4 | set -e
 5 | 
 6 | # Unique identifier, ideally a reverse-domain identifier.
 7 | # Should match the $identifier.service file for this runner.
 8 | identifier=codes.merritt.vscode_runner
 9 | 
10 | # Name of this runner, should match the plasma-runner-$name.desktop file.
11 | name=vscode_runner
12 | 
13 | # Ensure our working directory is the scripts directory.
14 | cd "$(dirname "$0")"
15 | 
16 | # Check where to install.
17 | if [[ -n "$XDG_DATA_HOME" ]]
18 | then
19 |     dataHome="$XDG_DATA_HOME"
20 | else
21 |     dataHome=~/.local/share
22 | fi
23 | 
24 | # Make install directories in case they don't yet exist.
25 | mkdir -p ~/.local/bin
26 | mkdir -p "$dataHome"/krunner/dbusplugins/
27 | mkdir -p "$dataHome"/dbus-1/services/
28 | 
29 | serviceFileName=$identifier.service
30 | desktopFileName=plasma-runner-$name.desktop
31 | 
32 | # Install the runner's executable.
33 | cp $name ~/.local/bin/$name
34 | 
35 | # Install the service file, adding the path to the runner's executable $name.
36 | executableFullPath=$(readlink -m ~/.local/bin/$name)
37 | cat $serviceFileName | sed "s|Exec=|Exec=$executableFullPath|" - > "$dataHome"/dbus-1/services/$serviceFileName
38 | 
39 | # Install the desktop file for KRunner to see the plugin.
40 | cp $desktopFileName "$dataHome"/krunner/dbusplugins/$desktopFileName
41 | 
42 | # Close KRunner, it will start again when the hotkey is invoked.
43 | kquitapp5 krunner
44 | 


--------------------------------------------------------------------------------
/package/plasma-runner-vscode_runner.desktop:
--------------------------------------------------------------------------------
 1 | [Desktop Entry]
 2 | Name=VSCode
 3 | Comment=Easily access VSCode recent workspaces
 4 | X-KDE-ServiceTypes=Plasma/Runner
 5 | Type=Service
 6 | Icon=com.visualstudio.code
 7 | X-KDE-PluginInfo-Author=Kristen McWilliam
 8 | X-KDE-PluginInfo-Email=kmcwilliampublic@gmail.com
 9 | X-KDE-PluginInfo-Name=vscode_runner
10 | X-KDE-PluginInfo-Version=1.0
11 | X-KDE-PluginInfo-License=LGPL
12 | X-KDE-PluginInfo-EnabledByDefault=true
13 | X-Plasma-API=DBus
14 | X-Plasma-DBusRunner-Service=codes.merritt.vscode_runner
15 | X-Plasma-DBusRunner-Path=/vscode_runner
16 | 


--------------------------------------------------------------------------------
/package/uninstall.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Unique identifier, ideally a reverse-domain identifier.
 4 | # Should match the $identifier.service file for this runner.
 5 | identifier=codes.merritt.vscode_runner
 6 | 
 7 | # Name of this runner, should match the plasma-runner-$name.desktop file.
 8 | name=vscode_runner
 9 | 
10 | # Stop the runner process.
11 | kill "$(pidof $name)" &> /dev/null
12 | 
13 | # Ensure our working directory is the scripts directory.
14 | cd "$(dirname "$0")" || exit
15 | 
16 | # Check for install location.
17 | if [[ -n "$XDG_DATA_HOME" ]]
18 | then
19 |     dataHome="$XDG_DATA_HOME"
20 | else
21 |     dataHome=~/.local/share
22 | fi
23 | 
24 | # Remove the executable & plugin files.
25 | rm ~/.local/bin/$name
26 | rm "$dataHome"/krunner/dbusplugins/plasma-runner-$name.desktop
27 | rm "$dataHome"/dbus-1/services/$identifier.service
28 | 
29 | # Remove any old version that may be in the depreciated kservices5 directory.
30 | depreciatedDesktopFile="$dataHome"/kservices5/krunner/dbusplugins/plasma-runner-$name.desktop
31 | if [[ -f "$depreciatedDesktopFile" ]]
32 | then
33 |     rm "$depreciatedDesktopFile"
34 | fi
35 | 
36 | # Close KRunner, it will start again when the hotkey is invoked.
37 | kquitapp5 krunner
38 | 


--------------------------------------------------------------------------------
/pubspec.lock:
--------------------------------------------------------------------------------
  1 | # Generated by pub
  2 | # See https://dart.dev/tools/pub/glossary#lockfile
  3 | packages:
  4 |   _fe_analyzer_shared:
  5 |     dependency: transitive
  6 |     description:
  7 |       name: _fe_analyzer_shared
  8 |       sha256: dc27559385e905ad30838356c5f5d574014ba39872d732111cd07ac0beff4c57
  9 |       url: "https://pub.dev"
 10 |     source: hosted
 11 |     version: "80.0.0"
 12 |   analyzer:
 13 |     dependency: transitive
 14 |     description:
 15 |       name: analyzer
 16 |       sha256: "192d1c5b944e7e53b24b5586db760db934b177d4147c42fbca8c8c5f1eb8d11e"
 17 |       url: "https://pub.dev"
 18 |     source: hosted
 19 |     version: "7.3.0"
 20 |   args:
 21 |     dependency: transitive
 22 |     description:
 23 |       name: args
 24 |       sha256: bf9f5caeea8d8fe6721a9c358dd8a5c1947b27f1cfaa18b39c301273594919e6
 25 |       url: "https://pub.dev"
 26 |     source: hosted
 27 |     version: "2.6.0"
 28 |   async:
 29 |     dependency: transitive
 30 |     description:
 31 |       name: async
 32 |       sha256: "758e6d74e971c3e5aceb4110bfd6698efc7f501675bcfe0c775459a8140750eb"
 33 |       url: "https://pub.dev"
 34 |     source: hosted
 35 |     version: "2.13.0"
 36 |   boolean_selector:
 37 |     dependency: transitive
 38 |     description:
 39 |       name: boolean_selector
 40 |       sha256: "8aab1771e1243a5063b8b0ff68042d67334e3feab9e95b9490f9a6ebf73b42ea"
 41 |       url: "https://pub.dev"
 42 |     source: hosted
 43 |     version: "2.1.2"
 44 |   collection:
 45 |     dependency: transitive
 46 |     description:
 47 |       name: collection
 48 |       sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76"
 49 |       url: "https://pub.dev"
 50 |     source: hosted
 51 |     version: "1.19.1"
 52 |   convert:
 53 |     dependency: transitive
 54 |     description:
 55 |       name: convert
 56 |       sha256: b30acd5944035672bc15c6b7a8b47d773e41e2f17de064350988c5d02adb1c68
 57 |       url: "https://pub.dev"
 58 |     source: hosted
 59 |     version: "3.1.2"
 60 |   coverage:
 61 |     dependency: transitive
 62 |     description:
 63 |       name: coverage
 64 |       sha256: e3493833ea012784c740e341952298f1cc77f1f01b1bbc3eb4eecf6984fb7f43
 65 |       url: "https://pub.dev"
 66 |     source: hosted
 67 |     version: "1.11.1"
 68 |   crypto:
 69 |     dependency: transitive
 70 |     description:
 71 |       name: crypto
 72 |       sha256: "1e445881f28f22d6140f181e07737b22f1e099a5e1ff94b0af2f9e4a463f4855"
 73 |       url: "https://pub.dev"
 74 |     source: hosted
 75 |     version: "3.0.6"
 76 |   dbus:
 77 |     dependency: transitive
 78 |     description:
 79 |       name: dbus
 80 |       sha256: "79e0c23480ff85dc68de79e2cd6334add97e48f7f4865d17686dd6ea81a47e8c"
 81 |       url: "https://pub.dev"
 82 |     source: hosted
 83 |     version: "0.7.11"
 84 |   ffi:
 85 |     dependency: transitive
 86 |     description:
 87 |       name: ffi
 88 |       sha256: "289279317b4b16eb2bb7e271abccd4bf84ec9bdcbe999e278a94b804f5630418"
 89 |       url: "https://pub.dev"
 90 |     source: hosted
 91 |     version: "2.1.4"
 92 |   file:
 93 |     dependency: transitive
 94 |     description:
 95 |       name: file
 96 |       sha256: a3b4f84adafef897088c160faf7dfffb7696046cb13ae90b508c2cbc95d3b8d4
 97 |       url: "https://pub.dev"
 98 |     source: hosted
 99 |     version: "7.0.1"
100 |   frontend_server_client:
101 |     dependency: transitive
102 |     description:
103 |       name: frontend_server_client
104 |       sha256: f64a0333a82f30b0cca061bc3d143813a486dc086b574bfb233b7c1372427694
105 |       url: "https://pub.dev"
106 |     source: hosted
107 |     version: "4.0.0"
108 |   glob:
109 |     dependency: transitive
110 |     description:
111 |       name: glob
112 |       sha256: c3f1ee72c96f8f78935e18aa8cecced9ab132419e8625dc187e1c2408efc20de
113 |       url: "https://pub.dev"
114 |     source: hosted
115 |     version: "2.1.3"
116 |   http_multi_server:
117 |     dependency: transitive
118 |     description:
119 |       name: http_multi_server
120 |       sha256: aa6199f908078bb1c5efb8d8638d4ae191aac11b311132c3ef48ce352fb52ef8
121 |       url: "https://pub.dev"
122 |     source: hosted
123 |     version: "3.2.2"
124 |   http_parser:
125 |     dependency: transitive
126 |     description:
127 |       name: http_parser
128 |       sha256: "178d74305e7866013777bab2c3d8726205dc5a4dd935297175b19a23a2e66571"
129 |       url: "https://pub.dev"
130 |     source: hosted
131 |     version: "4.1.2"
132 |   io:
133 |     dependency: transitive
134 |     description:
135 |       name: io
136 |       sha256: dfd5a80599cf0165756e3181807ed3e77daf6dd4137caaad72d0b7931597650b
137 |       url: "https://pub.dev"
138 |     source: hosted
139 |     version: "1.0.5"
140 |   js:
141 |     dependency: transitive
142 |     description:
143 |       name: js
144 |       sha256: "53385261521cc4a0c4658fd0ad07a7d14591cf8fc33abbceae306ddb974888dc"
145 |       url: "https://pub.dev"
146 |     source: hosted
147 |     version: "0.7.2"
148 |   krunner:
149 |     dependency: "direct main"
150 |     description:
151 |       name: krunner
152 |       sha256: "3ed3bb599505ceb62dccc7c60dc69de85c9439aaadf42c8bccdb01edee1f474c"
153 |       url: "https://pub.dev"
154 |     source: hosted
155 |     version: "1.0.2"
156 |   lints:
157 |     dependency: "direct dev"
158 |     description:
159 |       name: lints
160 |       sha256: c35bb79562d980e9a453fc715854e1ed39e24e7d0297a880ef54e17f9874a9d7
161 |       url: "https://pub.dev"
162 |     source: hosted
163 |     version: "5.1.1"
164 |   logger:
165 |     dependency: "direct main"
166 |     description:
167 |       name: logger
168 |       sha256: be4b23575aac7ebf01f225a241eb7f6b5641eeaf43c6a8613510fc2f8cf187d1
169 |       url: "https://pub.dev"
170 |     source: hosted
171 |     version: "2.5.0"
172 |   logging:
173 |     dependency: transitive
174 |     description:
175 |       name: logging
176 |       sha256: c8245ada5f1717ed44271ed1c26b8ce85ca3228fd2ffdb75468ab01979309d61
177 |       url: "https://pub.dev"
178 |     source: hosted
179 |     version: "1.3.0"
180 |   matcher:
181 |     dependency: transitive
182 |     description:
183 |       name: matcher
184 |       sha256: dc58c723c3c24bf8d3e2d3ad3f2f9d7bd9cf43ec6feaa64181775e60190153f2
185 |       url: "https://pub.dev"
186 |     source: hosted
187 |     version: "0.12.17"
188 |   meta:
189 |     dependency: transitive
190 |     description:
191 |       name: meta
192 |       sha256: e3641ec5d63ebf0d9b41bd43201a66e3fc79a65db5f61fc181f04cd27aab950c
193 |       url: "https://pub.dev"
194 |     source: hosted
195 |     version: "1.16.0"
196 |   mime:
197 |     dependency: transitive
198 |     description:
199 |       name: mime
200 |       sha256: "41a20518f0cb1256669420fdba0cd90d21561e560ac240f26ef8322e45bb7ed6"
201 |       url: "https://pub.dev"
202 |     source: hosted
203 |     version: "2.0.0"
204 |   node_preamble:
205 |     dependency: transitive
206 |     description:
207 |       name: node_preamble
208 |       sha256: "6e7eac89047ab8a8d26cf16127b5ed26de65209847630400f9aefd7cd5c730db"
209 |       url: "https://pub.dev"
210 |     source: hosted
211 |     version: "2.0.2"
212 |   package_config:
213 |     dependency: transitive
214 |     description:
215 |       name: package_config
216 |       sha256: "92d4488434b520a62570293fbd33bb556c7d49230791c1b4bbd973baf6d2dc67"
217 |       url: "https://pub.dev"
218 |     source: hosted
219 |     version: "2.1.1"
220 |   path:
221 |     dependency: transitive
222 |     description:
223 |       name: path
224 |       sha256: "75cca69d1490965be98c73ceaea117e8a04dd21217b37b292c9ddbec0d955bc5"
225 |       url: "https://pub.dev"
226 |     source: hosted
227 |     version: "1.9.1"
228 |   petitparser:
229 |     dependency: transitive
230 |     description:
231 |       name: petitparser
232 |       sha256: "07c8f0b1913bcde1ff0d26e57ace2f3012ccbf2b204e070290dad3bb22797646"
233 |       url: "https://pub.dev"
234 |     source: hosted
235 |     version: "6.1.0"
236 |   pool:
237 |     dependency: transitive
238 |     description:
239 |       name: pool
240 |       sha256: "20fe868b6314b322ea036ba325e6fc0711a22948856475e2c2b6306e8ab39c2a"
241 |       url: "https://pub.dev"
242 |     source: hosted
243 |     version: "1.5.1"
244 |   pub_semver:
245 |     dependency: transitive
246 |     description:
247 |       name: pub_semver
248 |       sha256: "7b3cfbf654f3edd0c6298ecd5be782ce997ddf0e00531b9464b55245185bbbbd"
249 |       url: "https://pub.dev"
250 |     source: hosted
251 |     version: "2.1.5"
252 |   shelf:
253 |     dependency: transitive
254 |     description:
255 |       name: shelf
256 |       sha256: e7dd780a7ffb623c57850b33f43309312fc863fb6aa3d276a754bb299839ef12
257 |       url: "https://pub.dev"
258 |     source: hosted
259 |     version: "1.4.2"
260 |   shelf_packages_handler:
261 |     dependency: transitive
262 |     description:
263 |       name: shelf_packages_handler
264 |       sha256: "89f967eca29607c933ba9571d838be31d67f53f6e4ee15147d5dc2934fee1b1e"
265 |       url: "https://pub.dev"
266 |     source: hosted
267 |     version: "3.0.2"
268 |   shelf_static:
269 |     dependency: transitive
270 |     description:
271 |       name: shelf_static
272 |       sha256: c87c3875f91262785dade62d135760c2c69cb217ac759485334c5857ad89f6e3
273 |       url: "https://pub.dev"
274 |     source: hosted
275 |     version: "1.1.3"
276 |   shelf_web_socket:
277 |     dependency: transitive
278 |     description:
279 |       name: shelf_web_socket
280 |       sha256: "3632775c8e90d6c9712f883e633716432a27758216dfb61bd86a8321c0580925"
281 |       url: "https://pub.dev"
282 |     source: hosted
283 |     version: "3.0.0"
284 |   source_map_stack_trace:
285 |     dependency: transitive
286 |     description:
287 |       name: source_map_stack_trace
288 |       sha256: c0713a43e323c3302c2abe2a1cc89aa057a387101ebd280371d6a6c9fa68516b
289 |       url: "https://pub.dev"
290 |     source: hosted
291 |     version: "2.1.2"
292 |   source_maps:
293 |     dependency: transitive
294 |     description:
295 |       name: source_maps
296 |       sha256: "190222579a448b03896e0ca6eca5998fa810fda630c1d65e2f78b3f638f54812"
297 |       url: "https://pub.dev"
298 |     source: hosted
299 |     version: "0.10.13"
300 |   source_span:
301 |     dependency: transitive
302 |     description:
303 |       name: source_span
304 |       sha256: "254ee5351d6cb365c859e20ee823c3bb479bf4a293c22d17a9f1bf144ce86f7c"
305 |       url: "https://pub.dev"
306 |     source: hosted
307 |     version: "1.10.1"
308 |   sqlite3:
309 |     dependency: "direct main"
310 |     description:
311 |       name: sqlite3
312 |       sha256: "32b632dda27d664f85520093ed6f735ae5c49b5b75345afb8b19411bc59bb53d"
313 |       url: "https://pub.dev"
314 |     source: hosted
315 |     version: "2.7.4"
316 |   stack_trace:
317 |     dependency: transitive
318 |     description:
319 |       name: stack_trace
320 |       sha256: "8b27215b45d22309b5cddda1aa2b19bdfec9df0e765f2de506401c071d38d1b1"
321 |       url: "https://pub.dev"
322 |     source: hosted
323 |     version: "1.12.1"
324 |   stream_channel:
325 |     dependency: transitive
326 |     description:
327 |       name: stream_channel
328 |       sha256: "969e04c80b8bcdf826f8f16579c7b14d780458bd97f56d107d3950fdbeef059d"
329 |       url: "https://pub.dev"
330 |     source: hosted
331 |     version: "2.1.4"
332 |   string_scanner:
333 |     dependency: transitive
334 |     description:
335 |       name: string_scanner
336 |       sha256: "921cd31725b72fe181906c6a94d987c78e3b98c2e205b397ea399d4054872b43"
337 |       url: "https://pub.dev"
338 |     source: hosted
339 |     version: "1.4.1"
340 |   term_glyph:
341 |     dependency: transitive
342 |     description:
343 |       name: term_glyph
344 |       sha256: "7f554798625ea768a7518313e58f83891c7f5024f88e46e7182a4558850a4b8e"
345 |       url: "https://pub.dev"
346 |     source: hosted
347 |     version: "1.2.2"
348 |   test:
349 |     dependency: "direct dev"
350 |     description:
351 |       name: test
352 |       sha256: "301b213cd241ca982e9ba50266bd3f5bd1ea33f1455554c5abb85d1be0e2d87e"
353 |       url: "https://pub.dev"
354 |     source: hosted
355 |     version: "1.25.15"
356 |   test_api:
357 |     dependency: transitive
358 |     description:
359 |       name: test_api
360 |       sha256: fb31f383e2ee25fbbfe06b40fe21e1e458d14080e3c67e7ba0acfde4df4e0bbd
361 |       url: "https://pub.dev"
362 |     source: hosted
363 |     version: "0.7.4"
364 |   test_core:
365 |     dependency: transitive
366 |     description:
367 |       name: test_core
368 |       sha256: "84d17c3486c8dfdbe5e12a50c8ae176d15e2a771b96909a9442b40173649ccaa"
369 |       url: "https://pub.dev"
370 |     source: hosted
371 |     version: "0.6.8"
372 |   typed_data:
373 |     dependency: transitive
374 |     description:
375 |       name: typed_data
376 |       sha256: f9049c039ebfeb4cf7a7104a675823cd72dba8297f264b6637062516699fa006
377 |       url: "https://pub.dev"
378 |     source: hosted
379 |     version: "1.4.0"
380 |   vm_service:
381 |     dependency: transitive
382 |     description:
383 |       name: vm_service
384 |       sha256: ddfa8d30d89985b96407efce8acbdd124701f96741f2d981ca860662f1c0dc02
385 |       url: "https://pub.dev"
386 |     source: hosted
387 |     version: "15.0.0"
388 |   watcher:
389 |     dependency: transitive
390 |     description:
391 |       name: watcher
392 |       sha256: "69da27e49efa56a15f8afe8f4438c4ec02eff0a117df1b22ea4aad194fe1c104"
393 |       url: "https://pub.dev"
394 |     source: hosted
395 |     version: "1.1.1"
396 |   web:
397 |     dependency: transitive
398 |     description:
399 |       name: web
400 |       sha256: "868d88a33d8a87b18ffc05f9f030ba328ffefba92d6c127917a2ba740f9cfe4a"
401 |       url: "https://pub.dev"
402 |     source: hosted
403 |     version: "1.1.1"
404 |   web_socket:
405 |     dependency: transitive
406 |     description:
407 |       name: web_socket
408 |       sha256: "3c12d96c0c9a4eec095246debcea7b86c0324f22df69893d538fcc6f1b8cce83"
409 |       url: "https://pub.dev"
410 |     source: hosted
411 |     version: "0.1.6"
412 |   web_socket_channel:
413 |     dependency: transitive
414 |     description:
415 |       name: web_socket_channel
416 |       sha256: "0b8e2457400d8a859b7b2030786835a28a8e80836ef64402abef392ff4f1d0e5"
417 |       url: "https://pub.dev"
418 |     source: hosted
419 |     version: "3.0.2"
420 |   webkit_inspection_protocol:
421 |     dependency: transitive
422 |     description:
423 |       name: webkit_inspection_protocol
424 |       sha256: "87d3f2333bb240704cd3f1c6b5b7acd8a10e7f0bc28c28dcf14e782014f4a572"
425 |       url: "https://pub.dev"
426 |     source: hosted
427 |     version: "1.2.1"
428 |   xdg_desktop_portal:
429 |     dependency: "direct main"
430 |     description:
431 |       name: xdg_desktop_portal
432 |       sha256: "10d56d2212bfa33a676d209b312a82fe5862fed5a91d2cfcb39143da75d084c1"
433 |       url: "https://pub.dev"
434 |     source: hosted
435 |     version: "0.1.13"
436 |   xdg_directories:
437 |     dependency: "direct main"
438 |     description:
439 |       name: xdg_directories
440 |       sha256: "7a3f37b05d989967cdddcbb571f1ea834867ae2faa29725fd085180e0883aa15"
441 |       url: "https://pub.dev"
442 |     source: hosted
443 |     version: "1.1.0"
444 |   xml:
445 |     dependency: transitive
446 |     description:
447 |       name: xml
448 |       sha256: b015a8ad1c488f66851d762d3090a21c600e479dc75e68328c52774040cf9226
449 |       url: "https://pub.dev"
450 |     source: hosted
451 |     version: "6.5.0"
452 |   yaml:
453 |     dependency: transitive
454 |     description:
455 |       name: yaml
456 |       sha256: b9da305ac7c39faa3f030eccd175340f968459dae4af175130b3fc47e40d76ce
457 |       url: "https://pub.dev"
458 |     source: hosted
459 |     version: "3.1.3"
460 | sdks:
461 |   dart: ">=3.7.0 <4.0.0"
462 | 


--------------------------------------------------------------------------------
/pubspec.yaml:
--------------------------------------------------------------------------------
 1 | name: vscode_runner
 2 | description: KRunner plugin for quickly opening recent VSCode workspaces
 3 | version: 1.8.0
 4 | publish_to: none
 5 | homepage: https://github.com/Merrit/vscode-runner
 6 | environment:
 7 |   sdk: ">=3.0.0 <4.0.0"
 8 | 
 9 | dependencies:
10 |   krunner: ^1.0.1
11 |   logger: ^2.0.2+1
12 |   sqlite3: ^2.4.6
13 |   xdg_desktop_portal: ^0.1.13
14 |   xdg_directories: ^1.0.3
15 | 
16 | dev_dependencies:
17 |   lints: ^5.0.0
18 |   test: ^1.16.0
19 | 


--------------------------------------------------------------------------------