GAnarchy is a Project Page Generator focused on giving forks of a project the same visibility as the original repo. https://ganarchy.autistic.space/
Go to file
SoniEx2 4c47abad7e Added multiple projects and non-default branches 2019-05-19 10:17:04 -03:00
LICENSE.txt [Project] GAnarchy 2019-04-16 22:58:00 -03:00
README.md Update README.md 2019-04-28 18:55:02 -03:00
ganarchy.py Added multiple projects and non-default branches 2019-05-19 10:17:04 -03:00
index.js Add protocol handler 2019-04-28 18:50:52 -03:00
requirements.txt venv support? 2019-05-07 15:51:21 -03:00

README.md

GAnarchy

GAnarchy is a Project Page Generator focused on giving forks of a project the same visibility as the original repo. More importantly, it's a tool to help fight against BDFLs and other forms of centralized project management.

Usage

Note: GAnarchy does not come with a main page. You need to provide one yourself. This should be in your website's / path (usually index.html). The protocol handler uses the path /?url=%s. Additionally, your main page needs to include the index.js provided by GAnarchy for the protocol handler to properly work.

First, initialize the database with ganarchy.py initdb. The database is stored in the XDG data home, as per XDG spec.

Then, set the project commit with ganarchy.py set-commit COMMIT, where COMMIT is the full commit hash. The commit must start with [Project] followed by the project name, and may have an optional description. (Note: This requirement isn't properly checked, but will be in the future. This is important for a future federation protocol that allows for automatically discovering forks based on the project commit.)

Once everything is initialized, add some repos with ganarchy.py repo add URL, and enable them with ganarchy.py repo enable URL (they come disabled by default). You are now ready to go.

Finally, add ganarchy.py cron-target > path/to/page.html to your cron. Optionally scp page.html scp://server@example.org/page.html.

Example shell session:

$ ganarchy.py initdb
$ ganarchy.py set-commit 385e734a52e13949a7a5c71827f6de920dbfea43
$ ganarchy.py set-project-name GAnarchy
$ ganarchy.py repo add https://cybre.tech/SoniEx2/ganarchy
$ ganarchy.py repo enable https://cybre.tech/SoniEx2/ganarchy
$ ganarchy.py cron-target > index.html
$ scp index.html scp://example.org/var/www/html/index.html

Example project commit:

[Project] GAnarchy

A Project Page Generator written in Python, focused on giving forks of a
project the same visibility as the original repo.