• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Assets
2======
3
4This directory contains tooling for managing assets used by the bots.  The
5primary entry point is assets.py, which allows a user to add, remove, upload,
6and download assets.
7
8Assets are stored in Google Storage, named for their version number.
9
10
11Individual Assets
12-----------------
13
14Each asset has its own subdirectory with the following contents:
15* VERSION:  The current version number of the asset.
16* [optional] create.py:  Script which creates the asset, implemented by the user and called by `sk asset upload`.
17* [optional] create\_and\_upload.py:  User-implemented convenience script which wraps `sk asset upload` in whatever way makes sense for the asset.
18
19
20Examples
21-------
22
23Add a new asset and upload an initial version.
24
25```
26$ sk asset add myasset
27Do you want to add a creation script for this asset? (y/n): n
28$ sk asset upload --in ${MY_ASSET_LOCATION} myasset
29$ git commit
30```
31
32Add an asset whose creation can be automated.
33
34```
35$ sk asset add myasset
36Do you want to add a creation script for this asset? (y/n): y
37Created infra/bots/assets/myasset/create.py; you will need to add implementation before uploading the asset.
38$ vi infra/bots/assets/myasset/create.py
39(implement the create_asset function)
40$ sk asset upload myasset
41$ git commit
42```
43