- Python >= 3.10
- Cookiecutter Python package >= 1.4.0: This can be installed with pip by or conda depending on how you manage your Python packages:
$ pip install cookiecutter
$ cookiecutter https://github.com/spc-group/cookiecutter-caproto-ioc# Use the cookiecutter
$ cookiecutter https://github.com/spc-group/cookiecutter-caproto-ioc
project_name [project_name]:
gitlab_repo_group [25ID]:
repo_name [project_name]:
default_prefix [SIM:]:
author_name [SLAC National Accelerator Laboratory]:
email []:
folder_name [project_name]:
import_name [project_name]:
description [project_name]:
Select license:
1 - SLAC
2 - BNL
3 - MIT
4 - BSD-3
Choose from 1, 2, 3, 4 [1]:
Select auto_gitlab_setup:
1 - no
2 - yes
Choose from 1, 2 [1]:
git_remote_name [origin]:
Select auto_doctr_setup:
1 - no
2 - yes
Choose from 1, 2 [1]:
Select use_x11_on_travis:
1 - no
2 - yes
Choose from 1, 2 [1]:
year [2020]:
# Create a test environment
$ conda create -n my_test_env python=3.7
$ conda activate my_test_env
# Install the project in that environment
$ cd project_name
$ pip install .
# Run the IOC
$ project_name --list-pvs
[I 17:33:28.970 server: 133] Asyncio server starting up...
[I 17:33:28.971 server: 146] Listening on 0.0.0.0:5064
[I 17:33:28.972 server: 205] Server startup complete.
[I 17:33:28.973 server: 207] PVs available:
SIM:SampleValue
SIM:SampleScanned
This happens at IOC boot!
Initial value was: 0.0
Now it is: 0.1
^C
[I 17:33:30.442 server: 212] Server task cancelled. Will shut down.
[I 17:33:30.442 server: 222] Server exiting....
# Alternatively:
$ python -m project_name --list-pvs
# Build the docs:
$ cd docs
$ make html
# Open them in your browser:
# (macOS)
$ open build/html/index.html
# (Linux)
$ xdg-open build/html/index.htmlTo manually setup versioneer, activate an environment with versioneer installed and run the following command and commit the new files it makes.
$ versioneer install
Doctr pushes automatically generated docs from travis to a github pages site. To manually begin using doctr first enable the use_doctr setting during cookiecutter setup and push the newly created repository to github. In the settings page on the github repository, make sure to enable pages on the gh-pages branch. Make sure travis has recognized and been set to process your new repository. Once setup has completed, activate an environment with doctr installed and run this command.
$ doctr configure
After entering your information, add the secure key to env/global/secure in the .travis.yml file. In the settings page on the github repository, make sure to enable pages on the gh-pages branch. Note: Branch protection should be enabled for all branches in the repository hosting the documentation as the key could potentially allow others to push to this repository.
$ pip install -Ur requirements.txt $ pip install -Ur dev-requirements.txt
To learn more about cookiecutter:
- Project Homepage: https://cookiecutter.readthedocs.io/en/latest/
- Github: https://github.com/audreyr/cookiecutter
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent