Heya tison ... thanks for reaching out. My dev environment has been built
organically as I work, so I don't have a simple quickstart guide, but with
your help, we can get one written.
In short, we're working with just with the v3/ subdirectory. After cloning
the repository, you'll want to create a python virtual environment using
Poetry (helper tool for venv and packaging). Something like so:
$ cd v3
$ pip3 install poetry
$ poetry install # this uses pyproject.toml in this v3/ directory
$ cd server
Then create your steve.db:
### ensure you have the sqlite3 command/sys-package installed
$ sqlite3 steve.db < ../schema.sql
I've been loading steve.db's "person" table with ASF userids. That is done
with:
$ cat > bin/bind.txt
<2 magic lines for user/pass; talk to me on Slack>
$ bin/asf-load-ldap.py
Then some fake testing data:
$ bin/load_fakedata.py
Before loading fake data, I think it is probably easiest to make you the
owner of all created elections. Edit load_fakedata.py, line 81 to read:
main(owner_pid='tison')
Then run the script. You can always blow away the db, and repeat the steps.
Nothing lost.
Next up is running the server. Create certs by following the instructions
in server/certs/README.md (easily readable on github.com). Next, copy
config.yaml.example to config.yaml. You probably don't need to change
anything. Then start the thing up:
$ poetry run server/main.py
Point your browser to https://localhost:58383/
That "should" be the list of steps to get a local/dev/test server running.
If you modify anything (code, templates), then the server should
automatically reload the change.
If you run into a problem, come back here to dev@ or find me on Slack in
the #steve channel and we can iterate. Then create a quickstart.md for
others with your working results.
Thanks!
Cheers,
-g
On Thu, Oct 9, 2025 at 8:05 AM tison <[email protected]> wrote:
> Great!
>
> If you can share some quickstart guide I can help in testing and I'm
> glad to clean up old code if it's desired.
>
> Best,
> tison.
>
> Greg Stein <[email protected]> 于2025年10月6日周一 08:19写道：
> >
> > Hey all,
> >
> > I just realized that people may not be subscribed to [email protected]
> and
> > are missing the v3 stuff that I've been working on. You can catch up on
> > changes here:
> > https://github.com/apache/steve/commits/trunk/
> >
> > The short description of this development arc is:
> >
> > * strong cryptography backend
> > * asfquart-based frontend webapp
> >
> > The crypto is solid, and I'm moving forward the frontend over the past
> > month or two. The webapp skeleton is functional, and once it gets "real",
> > then I'll load it onto the demo VM. It isn't there yet.
> >
> > The overall goal is to have v3 ready by January, providing a good lead
> time
> > to be useful for the 2026 ASF Member Annual Meeting.
> >
> > Check out the github repos for docs, and ask here if you have questions.
> >
> > Obviously, throw in if you have ideas and want to help! Grab me on Slack
> > any time.
> >
> > Cheers,
> > -g
>
