mirrors/ArchiveBox
1
0
Fork 0
mirror of https://github.com/ArchiveBox/ArchiveBox.git synced 2025-05-15 07:34:27 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README.md

Browse source
This commit is contained in:
Nick Sweeting 2021-04-08 06:01:04 -04:00 • committed by GitHub
parent 2e12738c1f
commit d4687a72cc
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 60 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

61
README.md
View file

@ -616,8 +616,13 @@ All contributions to ArchiveBox are welcomed! Check our [issues](https://github.
Low hanging fruit / easy first tickets:<br/> Low hanging fruit / easy first tickets:<br/>
<a href="https://lgtm.com/projects/g/ArchiveBox/ArchiveBox/alerts/"><img alt="Total alerts" src="https://img.shields.io/lgtm/alerts/g/ArchiveBox/ArchiveBox.svg?logo=lgtm&logoWidth=18"/></a> <a href="https://lgtm.com/projects/g/ArchiveBox/ArchiveBox/alerts/"><img alt="Total alerts" src="https://img.shields.io/lgtm/alerts/g/ArchiveBox/ArchiveBox.svg?logo=lgtm&logoWidth=18"/></a>
<details>
<summary>
### Setup the dev environment ### Setup the dev environment
</summary>
#### 1. Clone the main code repo (making sure to pull the submodules as well) #### 1. Clone the main code repo (making sure to pull the submodules as well)
```bash ```bash
@ -660,42 +665,78 @@ docker run -it -p 8000:8000 \
# (remove the --reload flag and add the --nothreading flag when profiling with the django debug toolbar) # (remove the --reload flag and add the --nothreading flag when profiling with the django debug toolbar)
``` ```
</details>
### Common development tasks ### Common development tasks
See the `./bin/` folder and read the source of the bash scripts within. See the `./bin/` folder and read the source of the bash scripts within.
You can also run all these in Docker. For more examples see the Github Actions CI/CD tests that are run: `.github/workflows/*.yaml`. You can also run all these in Docker. For more examples see the Github Actions CI/CD tests that are run: `.github/workflows/*.yaml`.
<details>
<summary>
#### Run in DEBUG mode #### Run in DEBUG mode
</summary>
```bash ```bash
archivebox config --set DEBUG=True archivebox config --set DEBUG=True
# or # or
archivebox server --debug ... archivebox server --debug ...
``` ```
</details>
<details>
<summary>
#### Build and run a Github branch #### Build and run a Github branch
</summary>
```bash ```bash
docker build -t archivebox:dev https://github.com/ArchiveBox/ArchiveBox.git#dev docker build -t archivebox:dev https://github.com/ArchiveBox/ArchiveBox.git#dev
docker run -it -v $PWD:/data archivebox:dev ... docker run -it -v $PWD:/data archivebox:dev ...
``` ```
</details>
<details>
<summary>
#### Run the linters #### Run the linters
</summary>
```bash ```bash
./bin/lint.sh ./bin/lint.sh
``` ```
(uses `flake8` and `mypy`) (uses `flake8` and `mypy`)
</details>
<details>
<summary>
#### Run the integration tests #### Run the integration tests
</summary>
```bash ```bash
./bin/test.sh ./bin/test.sh
``` ```
(uses `pytest -s`) (uses `pytest -s`)
</details>
<details>
<summary>
#### Make migrations or enter a django shell #### Make migrations or enter a django shell
</summary>
Make sure to run this whenever you change things in `models.py`. Make sure to run this whenever you change things in `models.py`.
```bash ```bash
cd archivebox/ cd archivebox/
@ -707,8 +748,15 @@ archivebox manage dbshell
``` ```
(uses `pytest -s`) (uses `pytest -s`)
</details>
<details>
<summary>
#### Build the docs, pip package, and docker image #### Build the docs, pip package, and docker image
</summary>
(Normally CI takes care of this, but these scripts can be run to do it manually) (Normally CI takes care of this, but these scripts can be run to do it manually)
```bash ```bash
./bin/build.sh ./bin/build.sh
@ -721,8 +769,15 @@ archivebox manage dbshell
./bin/build_docker.sh ./bin/build_docker.sh
``` ```
</details>
<details>
<summary>
#### Roll a release #### Roll a release
</summary>
(Normally CI takes care of this, but these scripts can be run to do it manually) (Normally CI takes care of this, but these scripts can be run to do it manually)
```bash ```bash
./bin/release.sh ./bin/release.sh
@ -735,7 +790,11 @@ archivebox manage dbshell
./bin/release_docker.sh ./bin/release_docker.sh
``` ```
### ArchiveBox Resources </details>
---
## More ArchiveBox Resources
- Main site: https://archivebox.io (via Github Pages) - Main site: https://archivebox.io (via Github Pages)
- Demo site: https://demo.archivebox.io (hosted by Monadical.com) - Demo site: https://demo.archivebox.io (hosted by Monadical.com)