mirror of
https://gitlab.archlinux.org/archlinux/aurweb.git
synced 2025-02-03 10:43:03 +01:00
Update Testing Guide
parent
c0312f0615
commit
b57fb83af9
1 changed files with 53 additions and 13 deletions
|
@ -31,7 +31,6 @@ If poetry is configured to create virtualenvs with
|
|||
`poetry config virtualenvs.create true --local` (recommended), users can install
|
||||
aurweb dependencies and the aurweb project into their poetry virtualenv:
|
||||
|
||||
$ poetry lock # Ensure that poetry dep resolution is up to date.
|
||||
$ poetry update # Update/fetch all dependencies in the virtualenv.
|
||||
$ poetry install # Install project-specific package and scripts.
|
||||
|
||||
|
@ -74,11 +73,12 @@ For a complete rundown on all of the services available, see the
|
|||
As a bit of a guide to the guide, I'd like to help you navigate around
|
||||
a bit:
|
||||
|
||||
1. Read [User Experience](#user-experience)
|
||||
2. Read [Edge Cases](#edge-cases)
|
||||
3. Read [Getting Started](#getting-started)
|
||||
1. Read [Accounts](#accounts)
|
||||
2. Read [User Experience](#user-experience)
|
||||
3. Read [Edge Cases](#edge-cases)
|
||||
4. Read [Getting Started](#getting-started)
|
||||
- Follow the link to [Development Servers](#development-servers) at the end
|
||||
4. Go back and focus on [User Experience](#user-experience) or any of the
|
||||
5. Go back and focus on [User Experience](#user-experience) or any of the
|
||||
other needs specified in [What We Need Tested](#what-we-need-tested) and [What Else?](#what-else)
|
||||
|
||||
## What We Need Tested
|
||||
|
@ -181,14 +181,6 @@ as the mysql client does something other than reach the mariadb server with
|
|||
`localhost` (assumed some type of confusion with localhost, didn't look much
|
||||
further).
|
||||
|
||||
###### Add User
|
||||
|
||||
<small>**Note**: To use the script, you'll need a valid AUR_CONFIG to the
|
||||
target database and aurweb Python dependencies (see [poetry](#poetry-python-dependencies)).</small>
|
||||
|
||||
You can create a user account in the database using the
|
||||
[util/adduser.py](https://gitlab.archlinux.org/archlinux/aurweb/-/tree/pu/util/adduser.py) script.
|
||||
|
||||
###### Generating Dummy Data
|
||||
|
||||
<small>
|
||||
|
@ -264,6 +256,54 @@ by the Root CA certificate `ca.root.pem`.
|
|||
| [php-fpm](#php-fpm) | https://localhost:8443 |
|
||||
| [fastapi](#fastapi) | https://localhost:8444 |
|
||||
|
||||
## Accounts
|
||||
|
||||
If you have not created or requested an account, users can login
|
||||
to all users generated by `gendummydata.py` (most of the users on
|
||||
aur-dev.archlinux.org) using a password which is exactly the same as
|
||||
the account's username.
|
||||
|
||||
Example:
|
||||
|
||||
Username: some-generated-user
|
||||
Password: some-generated-user
|
||||
|
||||
Test users are completely free to change the password of a dummy
|
||||
user, but this is highly discourages in favor of requesting an
|
||||
account of your own (see below).
|
||||
|
||||
#### aur-dev.archlinux.org Accounts
|
||||
|
||||
`aur-dev.archlinux.org` does not expose its database to users. For this
|
||||
reason, we don't allow users to freely create accounts on their own.
|
||||
|
||||
For users testing Trusted User or Developer-specific routes, requests
|
||||
for a Trusted User account can be made to aur-dev@lists.archlinux.org.
|
||||
|
||||
Send an email to aur-dev@lists.archlinux.org titled
|
||||
`[Test Account Request] your_username` with details about which account type
|
||||
you would like the account to have.
|
||||
|
||||
Upon receiving account requests, DevOps will be able to generate
|
||||
an account for you in `aur-dev.archlinux.org`'s database, as long
|
||||
as there is no existing email/username conflict.
|
||||
|
||||
#### Local Docker Accounts
|
||||
|
||||
Users who take advantage of a local Docker instance for testing have full
|
||||
access to the Docker database and can use the [adduser.py](#add-user) script
|
||||
described below.
|
||||
|
||||
###### Add User
|
||||
|
||||
<small>**Note**: To use the script, you'll need a valid AUR_CONFIG to the
|
||||
target database and aurweb Python dependencies (see [poetry](#poetry-python-dependencies)).
|
||||
Users can also `docker exec python /aurweb/util/adduser.py ...` from a
|
||||
Docker host if you wish to avoid installing poetry dependencies.</small>
|
||||
|
||||
You can create a user account in the database using the
|
||||
[util/adduser.py](https://gitlab.archlinux.org/archlinux/aurweb/-/tree/pu/util/adduser.py) script.
|
||||
|
||||
## User Experience
|
||||
|
||||
Some of the most important testing we could do for aurweb at this
|
||||
|
|
Loading…
Add table
Reference in a new issue