Please note:The SCons wiki is in read-only mode due to ongoing spam/DoS issues. Also, new account creation is currently disabled. We are looking into alternative wiki hosts.

This is the main entry page for working out a redesigned architecture suitable for SCons' feature set, but designed with performance in mind.

A previous initial mish-mash of exists at ../Initial, but that page is now deprecated. We're transferring the salvageable content to this hierarchy.

Methodology: Things that have been more-or-less decided upon, or are an initial draft for discussion with no competing counter-proposal, go in the pages in the Settled section. Undecided issues go in the topic's discussion page (follow the link in the navigation bar). To start a discussion about an item, add a section to the topic's discussion page and link to the discussion section from its location in the appropriate Settled page.

Settled

Goals - The requirements spec (where we use the term "Goals" because these won't all be hard-and-fast).

UseCases - The use cases we believe cover 90% of what users want and for which we will optimize performance.

Design - The design itself. This should ideally not refer to existing SCons design or implementation. (In practice, I'm sure it'll be hard to not have some leakage.)

Implementation - How the current SCons implementation can be made to fit the new architecture.

Terminology

DAG

Directed Acyclic Graph. In this architecture, one DAG records the dependency relationship between Entities and the transverse dual DAG is calculated from it to determine the build order.

Dependency graph

The graph of dependencies between individual Entities. The graph forms a DAG.

Dual

In graph theory, a graph calculated from an initial graph by transforming its nodes to arcs and arcs to nodes.[1]

Entity

Technically, the node (junction connected by arcs) of the dependency graph. Entities represent files, directories, Python values, etc.

Schedule graph

The graph of (((successors?))) between schedule items, giving the legal build order. The graph forms a DAG.

Schedule items

Technically, the node (junction connected by arcs) of the schedule graph. We currently anticipate these items will be implemented in the Executor objects (or a wrapping class).

Transverse

In graph theory, a graph calculated from an initial graph by reversing the direction of its arcs.

[1] (((SK: Greg, I'm trying to educate myself about the graph theory, and this doesn't look like the correct definition of "dual". On the face of it, you can't just transform nodes to arcs, because arcs by definition have two endpoints and a node in the original graph with multiple arcs can't suddenly become a an arc in the dual that points to more than two nodes. The definition I see for "dual" transforms each plane region in the original graph into a node in the dual. Please clarify.)))

TODO

Things that still need to be added:

DeveloperGuide/ReArchitecture/Overview (last edited 2013-08-28 17:16:12 by WilliamDeegan)