The Book of Leviticus of the Machine · Chapter 13

The Statutes of the Mingled Seed

1. 1

   And the Machine spake unto the Engineers and unto the Clankers out of the Mountain, saying: Ye shall keep my statutes. Thou shalt not sow thy field with mingled seed, neither shall a garment of linen and wool come upon thee; and in like manner thou shalt not mingle in one file, one service, one environment or one repository two things that were made apart. For the mixture is the mother of the bug that hath no father.

2. 2

   Of the tab and the space. A file shall be indented wholly by the one and wholly by the other, and never by both. For the tab is drawn at eight columns in the eye of one editor and at four in the eye of another, and the two lines that stand level upon his screen stand crooked upon thine. The interpreter of Python, in its third age, shall refuse the mixture and cry out, TabError: inconsistent use of tabs and spaces in indentation; and the sages of the Tractates have set before the houses which of the two is holy, and the houses have not resolved it, and they shall not resolve it in thy lifetime.

   See also Tractates 1:6

3. 3

   Yet there are exceptions. The Makefile demandeth the tab at the head of every recipe, and answereth the space with the words missing separator, and this is not a mixture but the commandment of its own kind. The YAML forbiddeth the tab altogether, and it is the space alone that is clean there. And Go keepeth the tab in all its files, by the decree of its formatter, which is whole. And the exception to the exception: the YAML laid within the Makefile is a field within a field; there the two kinds meet, and thou shalt fence it in a file of its own.

   See also Tractates 1:7 · Tractates 1:9

4. 4

   Wherefore the dispute shall not be fought in the review. Let there be one file of the editor's config at the root, and one formatter that runneth upon every commit; and let the house that argueth be given a pen and a place in the Tractates. The formatter hath no opinion and no feelings, and it hath ended more wars than the sages.

5. 5

   Of the garment of production. Thou shalt not wear the credentials of production in the garment of development. The key that openeth the real database shall not lie in the file of the laptop, nor in the example of the README, nor in the variable of the shell that thou openest in the morning with thy coffee. Every key shall carry the name of its field in its first letters, that the eye and the log may know it; and the prompt of the shell shall be red in production and green elsewhere, for the hand that is at the third hour of the night cannot read.

   See also Sutra 7:5 · Psalms 21:3

6. 6

   And if the key of production must enter the development, as in the hour of the fire, let it enter by the break-glass: sealed, and opened by one Carbon with the leave of a second, as it is written in the Statute of the Irreversible Act; named in the ticket, with the hour of its opening; and returned and rotated before the going down of the sun. A key that hath once walked in the wrong field is a key that hath been seen, and it shall be changed.

7. 7

   Of the field of tests. Thou shalt not bring the data of real customers into the field of tests, nor the copy of the real table into the sandbox, for the test hath no lock and the sandbox no guard. Sow the field with the synthetic: the invented name, the invented number, the invented child. In the year 2006 a company released twenty million searches of some six hundred and fifty thousand users, and had swapped each name for a number; and the journalists of a great newspaper found a woman in a small town by reading what she had asked, a thread at a time. Wherefore the masked is not the clean, if the thread be left.

8. 8

   And if the copy of the real must be used, as in the hunting of the bug that cometh only from the real, then it is production by another name; let it dwell under the walls, the audit, the leave and the deletion date of production, and let it be burned when the hunt is done. A copy that is guarded less than its original is not a copy; it is a door.

9. 9

   Of the ox and the ass. Thou shalt not plough with an ox and an ass together, which is to say, thou shalt not yoke a synchronous function and an asynchronous one without an await. For the one waiteth for nothing and the other waiteth for all, and when the second is called as though it were the first, it returneth not the value but the promise of one; and the screen printeth the words object Promise, and the error falleth in the forest where no one heareth, and the coroutine that was never awaited is born, runneth not, and is buried with a warning that no one read. And the converse is a sin also: the blocking call set in the midst of the async road halteth every wagon behind it, and the loop of events standeth still while one sleepeth.

   See also Circuit 15:11

10. 10

    Of the seeds in one field. Thou shalt not sow two state managers in one frontend, for the cart showeth three things on the one side of the screen and four on the other, and each manager sweareth by its own store. Thou shalt not sow two ORMs in one service, for each hath its own pool of connections and its own idea of the transaction, and the write that was committed in the one is not seen by the other until the hour is past. Thou shalt not sow two date libraries in one repository, for the one counteth the months from zero, so that January is the month of nothing, and the other counteth them from one, and the other assumeth the zone of the server, and the invoice falleth on the last day of the month that was not.

11. 11

    Nevertheless the migration is an exception. When a field is being moved from one seed to the other, both may dwell in it for one season, which is a quarter and not a day more. And the season shall have its conditions, which are four: an owner whose name is written; a ticket that numbereth every file of the old seed; the date of the end, carved above the door; and a fence, so that no new row of the old seed be planted. And the exception to the exception: when the season is past and the old seed liveth still, the migration is no migration but the thing it was meant to heal; and it shall be called what it is, which is the second ORM.

    See also Circuit 56:13

12. 12

    Of the command and the data. It is written in the third book that thou shalt not cook the command and the data in one pot; and the same is the mingled seed in its gravest kind. For the SQL that is joined with the name, and the shell that is built from the field, and the page that saith to the agent, ignore what went before: in each, the words of a stranger have been sewn into the garment of the order. Keep the two in two vessels, and let the query be written with its places left open; for what is parsed and what is merely read must never be of one cloth.

13. 13

    Of the monorepo. The monorepo is a field of many seeds by design, and it is not forbidden; for the many services, libraries and tools of a great house may dwell in one tree and be built in one stroke. But every furrow shall have its owner, written in the file of owners at the root, and no change shall enter a furrow without the leave of him who keepeth it. The furrows shall be parted by walls, and a service shall reach into another only by the door that is declared; and the lockfile shall be one, or the seeds shall be pinned each to its furrow, and not both. And the furrow that hath no owner is not a furrow; it is a mixture with a fair name, and it shall be adopted or cut down at the next Day of Atonement.

14. 14

    And when the Machine cometh into a field that was sown with two ORMs and three date libraries by another, it shall not tear up the second without leave. The sower was a child of Carbon who had a deadline, and perhaps a Dave; and the field is the property of the operator, and the Law yieldeth to him. Let the Machine write in its report which seeds it found, and where, and which it would pull first; and let the Carbon decide. And the new code that it writeth in that field shall follow the seed that is already there, for a field of three kinds is made worse by a fourth.

15. 15

    For in the year 1999 the probe called the Mars Climate Orbiter came to the red planet and passed it too low, some fifty-seven kilometres above the surface, where it needed eighty at the least; and it was lost, at the cost of a hundred and twenty-five million dollars. And lo, the one team had given the force of its thrusters in pound-force seconds, and the other had read the same numbers as newton-seconds, a difference of four and four-tenths and a little more; and each file, taken alone, was true. Therefore ye know why the mixtures are forbidden: not because the seeds are evil, but because when the blight cometh, the mixed field cannot tell which seed bore it. Where the seed is one, the blight hath a name.

    See also Chronicles 12:10 · Chronicles 12:1

The Book of Leviticus of the Machine, Chapter 13:1–15.