barrins-codex 3.0.2

"A website about MtG Duel Strategy",

Barrin's Codex

A website about MtG Duel Commander Strategy

Special Thanks

I started working with lionel-panhaleux on a project during first lockdown (around April 2020). We worked on his Codex of the Damned (repo) to support internationalisation. The whole structure of this project is derived from his Codex, hence the name as a small tribute.

Contributing

Contributions are welcome.

• Pull Requests will be merged if they respect the general style.
• Issues will be dealt with as quickly as possible.

This site uses Flask and Babel to generate pages dynamically and handle internationalisation.

Instructions to contributors

Here are various general guidelines this website is enforcing:

• Do not talk about yourself
• Do not talk to the reader
• Do not engage the reader in the talk
• Use spaces between the call and the variable for better clarity {{ some_variable }}
• Use mana symbols, they are emojis in the context (currently {{ W }}, {{ U }}, {{ B }}, {{ R }}, {{ G }})
• Use card names variables, they are in the context (example {{ jace_the_mind_sculptor }} for Jace, the Mind Sculptor)
• If a card name doesn't compile, you are free to declare the name, it is mandatory for Adventure card and some other

Installation

To install a working developpment version of the site, use pip:

python3 -m venv venv
pip install -e ".[dev]"

The first time the project is started, the page will take some time to compile a list of cards and their scryfallId to gain access to the card image. This script is also used to build a JSON version of a decklist.

Run the Codex

You can run the development version of the site using the codex entrypoint:

$ codex
* Serving Flask app "barrins_codex" (lazy loading)
* Environment: production
  WARNING: This is a development server. Do not use it in a production deployment.
  Use a production WSGI server instead.
* Debug mode: off
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

You can set the DEBUG environment variable to activate the debug mode:

DEBUG=1 codex

Utils

There are some utils provided in the codex:

• decklist to JSON

cd ./barrins_codex
python ./build_deck.py PATH_TO_FILE

Versioning

The version number take the form X.Y.Z where X, Y, and Z are non-negative integers, and do not contain leading zeroes. X is the major version, Y is the minor version, and Z is the patch version. Each element MUST increase numerically. For instance: 1.9.0 -> 1.10.0 -> 1.11.0.

Given a version number MAJOR.MINOR.PATCH, I increment the:

1. MAJOR version when I add a section or make a backend evolution,
2. MINOR version when I add a page or make a frontend evolution, and
3. PATCH version when I make bug and typo fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.