ZeroVer

ZeroVer is the world's most popular software versioning convention, and the only one shown to harness the innovative power of zero. The benefits are innumerable and the effects on the software world are profound.

Read more at 0ver.org.

Table of Contents

• Description
• Contributing
• Adding a Project
• Building
• CI/CD

Description

The site is statically generated using Chert. The configuration for the Chert site is defined in chert.yaml The pages for the site are located under entries/.

Tables of current and past ZeroVer users are generated from projects.yaml into projects.json by tools/gen_projects_json.py using the GitHub API. The project list has gotten long enough that you'll need a GitHub API key.

custom.py uses Chert hooks to render and inject tables based off of projects.json. custom.py and tools/gen_projects_json.py are both written to only depend on libraries required by Chert. To bring things full circle, Chert was 0ver for almost 3 years.

Contributing

Are you or someone you know a prominent ZeroVer user who's missing from our list? Feel free to contribute to the site and add this project!

Qualifications in notable 0ver.org entries:

• A current ZeroVer-compliant version (0.*) or long history of ZeroVer usage, and
• Very wide exposure (i.e., 1,000+ GitHub stars), or
• Active promotion as part of a paid product or service (e.g., Hashicorp Vault), or
• Relative maturity and infrastructural importance (e.g., Compiz, docutils)

To add a project, follow the guide below.

1. Fork and clone this repository, then create a new branch. GitHub has a great guide on contributing to open-source projects like this.
2. On the new branch, add your project to projects.yaml. See the project.yaml keys description below.
3. Commit the change and create a pull request on GitHub.

Adding a Project

Adding a project to projects.yaml is typically a simple task. You can find an 0verview of the allowable keys below, or find a more detailed guide with examples by directly navigating you the applicable section below from this list:

• Simple GitHub Projects (ZeroVer tags used)
• Complex GitHub Projects (ZeroVer tags not used)
• Non-GitHub Projects
• Emeritus Complex GitHub Projects
• Emeritus Non-GitHub Projects

0verview of Keys

Key	ZeroVer or Emeritus	When to Add	Description	Example Value
name	Either	Always	The name of the project	Big ZeroVer Project
url	Either	If the project has a webpage other than its repository	The project's home page	https://example.com
gh_url	Either	If the project has a GitHub repository	The project's GitHub repository link	https://github.com/example/test
repo_url	Either	If the project has a non-GitHub repository	The project's non-GitHub repository link	https://gitlab.com/example
wp_url	Either	If the project has a Wikipedia page	The project's Wikipedia link.	https://www.wikipedia.org/
emeritus	Emeritus only	If the project is no longer ZeroVer	true if the project is no longer ZeroVer	true
reason	Either	If the project is obscure or barely meets the 0ver requirements	The reason this project was added to the 0ver website listing.	This project is a core component of a large system used by millions of users around the world.
star_count	Either	If the project is not from GitHub and a star count can be obtained	The number of stars the project has	10000
release_count	ZeroVer only	If the project is currently ZeroVer and is not from GitHub or the repository on GitHub has an unusual tagging system	The number of releases the project has had	100
release_count_zv	Emeritus only	If the project is no longer ZeroVer and is not from GitHub or the repository on GitHub has an unusual tagging system	The number of releases the project has before it left 0ver	50
latest_release_date	ZeroVer only	If the project is currently ZeroVer and is not from GitHub or the repository on GitHub has an unusual tagging system	The date of the latest release at time of writing	2024-12-28
latest_release_version	ZeroVer only	If the project is currently ZeroVer and is not from GitHub or the repository on GitHub has an unusual tagging system	The version of the latest release	4.2.0
first_release_date	Either	If the project is not from GitHub, the repository on GitHub has an unusual tagging system, or the first release tag is not on the GitHub repository	The date of the first release	2000-01-01
first_release_version	Either	If the project is not from GitHub, the repository on GitHub has an unusual tagging system, or the first release tag is not on the GitHub repository	The version of the first release	0.0.1
first_nonzv_release_date	Emeritus only	If the project is no longer ZeroVer AND the project is not from GitHub or the repository on GitHub has an unusual tagging system	The date of the first non-0ver release	2010-01-01
first_nonzv_release_version	Emeritus only	If the project is no longer ZeroVer AND the project is not from GitHub or the repository on GitHub has an unusual tagging system	The version of the first non-0ver release	1.0.0
last_zv_release_version	Emeritus only	If the project is no longer ZeroVer AND the project is not from GitHub or the repository on GitHub has an unusual tagging system	The last 0ver release before the project left ZeroVer	0.9.9

Simple GitHub Projects

If the project you are adding is hosted on GitHub with ZeroVer compatible tags, you simply need to add the following snippet to the projects.yaml file. This will work with currently ZeroVer projects and emeritus projects.

- name: Project Name
  gh_url: https://github.com/example/test

Additionally, you can add a homepage URL, Wikipedia URL and/or reasoning like this:

- name: Project Name
  url: https://example.com
  gh_url: https://github.com/example/test
  wp_url: https://www.wikipedia.org/
  reason: This project is a core component of a large system used by millions of users around the world.

If the project did not begin on GitHub, the tags may not extend to the origin of the project. You may want to fix these by manually entering the first release data found on the project website or other sources.

- name: Project Name
  url: https://example.com
  gh_url: https://github.com/example/test
  reason: This project is a core component of a large system used by millions of users around the world.
  first_release_date: 2000-01-01
  first_release_version: 0.1 # This release isn't tagged on GitHub, see here: https://example.com/releases/0.1

Complex GitHub Projects or Non-GitHub Projects

If the project you are adding is hosted on GitHub with incompatible ZeroVer tags (e.g. tags are prefixed with odd text) or the project is not on GitHub, you will need to fill out a more detailed entry in the projects.yaml file.

- name: Project Name
  url: https://example.com
  first_release_date: 2000-01-01
  first_release_version: 0.1 # Reference: https://example.com/releases
  latest_release_date: 2024-12-28
  latest_release_version: 0.37.2 # Reference: https://example.com/releases

If the repository is available but not on GitHub, you can add the repo_url key.

- name: Project Name
  url: https://example.com
  repo_url: https://gitlab.com/example
  first_release_date: 2000-01-01
  first_release_version: 0.1 # Reference: https://example.com/releases
  latest_release_date: 2024-12-28
  latest_release_version: 0.37.2 # Reference: https://example.com/releases

If the release count is available you can add the release_count key.

- name: Project Name
  url: https://example.com
  repo_url: https://gitlab.com/example
  first_release_date: 2000-01-01
  first_release_version: 0.1 # Reference: https://example.com/releases
  latest_release_date: 2024-12-28
  latest_release_version: 0.37.2 # Reference: https://example.com/releases
  release_count: 100 # Reference: https://example.com/releases

Emeritus Complex GitHub Projects or Emeritus Non-GitHub Projects

If a complex GitHub project or non-GitHub project is no longer ZeroVer and needs to be added to the emeritus list, you will need to change several keys.

- name: Project Name
  url: https://example.com
  emeritus: true
  first_release_date: 2000-01-01
  first_release_version: 0.1 # Reference: https://example.com/releases
  first_nonzv_release_date: 2024-12-30
  first_nonzv_release_version: 1.0.0
  last_zv_release_version: 0.37.2 # Reference: https://example.com/releases
  release_count_zv: 100 # Reference: https://example.com/releases

Building

1. Create and enter a virtual environment if you haven't already
2. pip install -r requirements.txt

Updating projects.json

1. Obtain a personal access token from GitHub. This token will not need any special permissions, the default options should be fine.
2. Create a file named gh_token and paste in your personal access token.
3. Run python tools/gen_projects_json.py --user YOUR_USERNAME --token gh_token

Serving the site

Simply run chert serve.

CI/CD

0ver uses GitHub Actions to validate projects.yaml, test, and update project.json.