fixture_fox 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7ae92cff06c14bdac0a19e36674ff3e41e964e4bdc9874db327426fc86d33c87
+  data.tar.gz: c0f91d36d6fc1320ce3670acb60568a5ccff746cedb94e9f54da8cf1d21c24b2
+SHA512:
+  metadata.gz: 1e0ef0e77b1c9d182b1451620d3d70a3af68f1e3fc999acec9f291984082c6167e980160475ab0c25c060c12d4857786a69b79dee711725b87df907b4401b886
+  data.tar.gz: 875f4974c220a7c2a832d83658c2e7ebf600953df91bea721e2bd52bd61fde141880047bfed0facb124efdba57176dad4f1fd70db11297ea2b83e2a103094272

data/.gitignore

@@ -0,0 +1,20 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# Ignore auto-generated main file
+/main
+
+# Ignore Gemfile.lock. See https://stackoverflow.com/questions/4151495/should-gemfile-lock-be-included-in-gitignore
+/Gemfile.lock
+
+# Put your personal ignore files in /home/clr/.config/git/ignore
+/bin/fox
+/*.fox

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.7.1

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.7.1
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in fox.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"

data/README.md

@@ -0,0 +1,36 @@
+# Fox
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/fox`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'fox'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install fox
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/fox.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/TODO

@@ -0,0 +1,79 @@
+
+o Rename #use -> #fox
+o Fix that functions are not available in #use (and #statement, probably):
+
+    Failure/Error:
+      def test_system() "test_system" end
+      ...
+      describe "Something"
+        use %(
+          #{test_system}: System
+            kind: #{test_system_kind}
+            name: #{test_system}
+
+    `test_system` is not available on an example group (e.g. a `describe` or
+    `context` block). It is only available from within individual examples
+    (e.g. `it` blocks) or from constructs that run in the scope of an example
+    (e.g. `before`, `let`, etc).
+
+o Allow dumping of state file per-directory. This can be used to make it easier
+  to run fox files by hand in a project
+o Push associations of superclasses down to subclasses
+o Scoped labels so that a label within a labelled record can be refered to at "*record_label.element_label"
+o Solve the default_id-backreference-problem by having a rule that if the back-reference is unspecified, then
+  the value is taken from the enclosing record:
+
+    auth_domain: Domain
+      default_permission:
+        name: default
+        none: [auth]
+        domain: *auth_domain
+
+  vs
+
+    auth_domain: Domain
+      default_permission:
+        name: default
+        none: [auth]
+
+o Allow functions ($do_something) - SQL vs. Ruby?
+o Allow identifying records by unique columns: user[name=Alice] (if name was unique) or system[kind=USER] or even system[user,role]=[Alice,ADMIN]
+o Kind references are fields that doesn't refer to the ID of the referenced table but to another unique column. Kind references use only the value of the field to address it: kind: USER
+
+o 'Unclass' anchors and turn it into a simple map from name to Anchor class
+
+o Check for missing not null values
+o Check for tables when records are expected and vice-versa
+o Check for illegal values (eg. "hello" when an integer is expected)
+o Change root-table syntax to /^table:/
+o Rename token so they all ends with "...Token"
+o Make it possible to dump data in fox format
+o Default records
+
++ Parse date/time (or maybe not)
++ Labels in IDR
++ Change fox to write SQL by default and require a -e/-x to execute against database
++ PG connection strings
++ Rewrite tokenization
++ Make it run on the mikras database
++ schema pragma
++ root table names including schema
++ Use link table link field names to create N:M and DAG/DCG relations 
++ Refresh materialized views
+
+- Single-line definitions: '*alice.age: 42'
+    Too complicated. Either the parser looks like shit (see branch
+    root-references-1) or the Ast hierarchy needs rework (see branch
+    root-references-2). In both cases resolving references becomes complicated
+    and we'll also have to consider circular dependencies
+
+? Allow reset of existing relations and then assign new 
+    &alice:
+      roles: [] <- Reset marker
+        - name: New role
+        - name: Another new role
+? Allow adding relations to existing objects
+    &alice:
+      roles:
+        - name: An addition role
+        - name: Yet another additional role

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "fox"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/doc/diagram.drawio

@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-04-17T00:20:45.771Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/14.5.1 Chrome/89.0.4389.82 Electron/12.0.1 Safari/537.36" etag="J5Jf62OiXnZKbLMMq6aF" version="14.5.1" type="device"><diagram id="Lc7oDIB2kMrwpjbDrJJE" name="Page-1">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</diagram></mxfile>

data/examples/1-1-subrecord.fox

@@ -0,0 +1,15 @@
+
+# This file illustrates that 0-1 relations can't automatically generate back-references
+domains
+  - &this_domain
+    name: Domain
+    default_permission:
+      name: Default permissions
+      domain: *this_domain # This can't be assigned automatically 
+
+permissions
+  - &alices_permissions
+    name: Alice's permissions
+    domain:
+      name: Alice's domain
+      default_permission: *alices_permissions

data/examples/1-1-subrecord.sql

@@ -0,0 +1,22 @@
+
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+
+create table domains (
+  id integer generated by default as identity primary key,
+  name text not null
+);
+
+create table permissions (
+  id integer generated by default as identity primary key,
+  domain_id integer not null references domains(id),
+  name text not null
+);
+
+alter table domains add column
+  default_permission_id integer unique references permissions(id);

data/examples/N-M.fox

@@ -0,0 +1,25 @@
+
+roles
+  - &sysadm_role
+    name: Sysadm
+  - &admin_role
+    name: Admin
+
+posts
+  - &alices_first_post
+    title: "FIRST"
+
+users
+  - name: Alice
+    roles:
+      - *sysadm_role
+      - &user_role
+        name: User
+    posts:
+      - *alices_first_post
+      - title: "SECOND"
+  - name: Bob
+    roles:
+      - *admin_role
+      - *user_role
+

data/examples/N-M.sql

@@ -0,0 +1,34 @@
+
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+create table roles (
+  id integer generated by default as identity primary key,
+  name text not null
+);
+
+create index on roles(name);
+
+create table users (
+  id integer generated by default as identity primary key,
+  name text not null unique
+);
+
+create table user_roles (
+  id integer generated by default as identity primary key,
+  role_id integer not null references roles(id),
+  user_id integer not null references users(id)
+);
+
+create unique index on user_roles(role_id, user_id);
+
+create table posts (
+  id integer generated by default as identity primary key,
+  user_id integer not null references users(id),
+  title text not null
+);
+

data/examples/anchors.sql

@@ -0,0 +1,13 @@
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+
+create table users (
+  id integer generated by default as identity primary key,
+  boss_id integer references users(id),
+  name text
+);

data/examples/anchors.yml

@@ -0,0 +1,4 @@
+---
+- :name: :alice
+  :table: public.users
+  :id: 1

data/examples/anchors1.fox

@@ -0,0 +1,4 @@
+
+users
+  - &alice
+    name: Alice

data/examples/anchors2.fox

@@ -0,0 +1,6 @@
+
+users
+  - &bob
+    name: Bob
+    boss: *alice
+

data/examples/array.fox

@@ -0,0 +1,84 @@
+
+# this is a comment
+
+# @schema "public"
+# @include "file"
+# @reserve table, table, table...
+#
+#@reflect users.last_post_id nil
+
+alice: Users
+  name: "Alice"
+  age: 20
+  groups: [supers, users]
+  picture:
+    title: Picture of Alice
+    blob: "image"
+  role: &alices_role # this is a comment
+    name: "Administrator" # this is a comment
+    active: true # this is a comment
+
+alice: Users
+  last_post: *alices_first_post
+
+alices_blog: Blogs
+  user: *alice
+  title: "Alice's Blog"
+
+Roles
+  - &user_role
+    name: "User"
+    active: true
+  - &anon_role
+    name: "Anon"
+    active: true
+
+Posts
+  - &alices_first_post
+    blog: *alices_blog
+    head: My first blog post
+    body: This is the first post in my new blog
+    created_at: "1970-01-01"
+
+bob: Users
+  name: "Bob"
+  role: *alices_role
+  last_post: *bobs_last_post
+  groups: ["42", "43"]
+  blogs:
+    - title: "Bob's Blog"
+      posts:
+        - &bobs_first_post
+          head: Bobs first blog post
+          body: Hi Alice!
+          created_at: "1970-01-01"
+        - &bobs_last_post
+          head: Happy birthday!
+          body: Cakeday!
+          created_at: "1970-01-02"
+
+bill: Users
+  name: Bill
+  role: *user_role
+  groups: []
+
+Comments
+  - author: *bill
+    post: *alices_first_post
+    head: Congratulations !
+    body: Good luck
+    created_at: "1970-01-01 00:00"
+  - author: &lizzy
+      name: Lizzy
+      role: *user_role
+      comments:
+        - post: *bobs_first_post
+          head: "Me too"
+          body: "Hugs from Lizzy"
+          created_at: "1970-01-03"
+
+    post: *alices_first_post
+    head: ""
+    body: Same from me
+    created_at: "1970-01-01 00:01"
+

data/examples/array.sql

@@ -0,0 +1,53 @@
+
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+create unlogged table roles (
+  id integer generated by default as identity primary key,
+  name text not null,
+  active boolean not null default true
+);
+
+create unlogged table pictures (
+  id integer generated by default as identity primary key,
+  title text not null,
+  blob text not null
+);
+
+create unlogged table users (
+  id integer generated by default as identity primary key,
+  name text not null,
+  age integer,
+  groups varchar[],
+  role_id integer not null references roles(id),
+  picture_id integer unique references pictures(id)
+);
+
+create unlogged table blogs (
+  id integer generated by default as identity primary key,
+  user_id integer not null references users(id),
+  title text not null
+);
+
+create unlogged table posts (
+  id integer generated by default as identity primary key,
+  blog_id integer not null references blogs(id),
+  head text not null,
+  body text not null,
+  created_at timestamp without time zone default (now() at time zone 'UTC')
+);
+
+create unlogged table comments (
+  id integer generated by default as identity primary key,
+  post_id integer not null references posts(id),
+  author_id integer not null references users(id),
+  head text not null,
+  body text not null,
+  created_at timestamp without time zone default (now() at time zone 'UTC')
+);
+
+alter table users add column last_post_id integer references posts(id);

data/examples/base.fox

@@ -0,0 +1,81 @@
+
+# this is a comment
+
+# @schema "public"
+# @include "file"
+# @reserve table, table, table...
+#
+#@reflect users.last_post_id nil
+
+alice: Users
+  name: "Alice"
+  age: 20
+  picture:
+    title: Picture of Alice
+    blob: "image"
+  role: &alices_role # this is a comment
+    name: "Administrator" # this is a comment
+    active: true # this is a comment
+
+alice: Users
+  last_post: *alices_first_post
+
+alices_blog: Blogs
+  user: *alice
+  title: "Alice's Blog"
+
+Roles
+  - &user_role
+    name: "User"
+    active: true
+  - &anon_role
+    name: "Anon"
+    active: true
+
+Posts
+  - &alices_first_post
+    blog: *alices_blog
+    head: My first blog post
+    body: This is the first post in my new blog
+    created_at: "1970-01-01"
+
+bob: Users
+  name: "Bob"
+  role: *alices_role
+  last_post: *bobs_last_post
+  blogs:
+    - title: "Bob's Blog"
+      posts:
+        - &bobs_first_post
+          head: Bobs first blog post
+          body: Hi Alice!
+          created_at: "1970-01-01"
+        - &bobs_last_post
+          head: Happy birthday!
+          body: Cakeday!
+          created_at: "1970-01-02"
+
+bill: Users
+  name: Bill
+  role: *user_role
+
+Comments
+  - author: *bill
+    post: *alices_first_post
+    head: Congratulations !
+    body: Good luck
+    created_at: "1970-01-01 00:00"
+  - author: &lizzy
+      name: Lizzy
+      role: *user_role
+      comments:
+        - post: *bobs_first_post
+          head: "Me too"
+          body: "Hugs from Lizzy"
+          created_at: "1970-01-03"
+
+    post: *alices_first_post
+    head: ""
+    body: Same from me
+    created_at: "1970-01-01 00:01"
+

data/examples/base.sql

@@ -0,0 +1,52 @@
+
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+create unlogged table roles (
+  id integer generated by default as identity primary key,
+  name text not null,
+  active boolean not null default true
+);
+
+create unlogged table pictures (
+  id integer generated by default as identity primary key,
+  title text not null,
+  blob text not null
+);
+
+create unlogged table users (
+  id integer generated by default as identity primary key,
+  name text not null,
+  age integer,
+  role_id integer not null references roles(id),
+  picture_id integer unique references pictures(id)
+);
+
+create unlogged table blogs (
+  id integer generated by default as identity primary key,
+  user_id integer not null references users(id),
+  title text not null
+);
+
+create unlogged table posts (
+  id integer generated by default as identity primary key,
+  blog_id integer not null references blogs(id),
+  head text not null,
+  body text not null,
+  created_at timestamp without time zone default (now() at time zone 'UTC')
+);
+
+create unlogged table comments (
+  id integer generated by default as identity primary key,
+  post_id integer not null references posts(id),
+  author_id integer not null references users(id),
+  head text not null,
+  body text not null,
+  created_at timestamp without time zone default (now() at time zone 'UTC')
+);
+
+alter table users add column last_post_id integer references posts(id);

data/examples/empty.fox

@@ -0,0 +1,8 @@
+
+role_schema.roles: []
+public.posts: []
+
+user_schema.users
+  - name: Alice
+  - name: Bob
+

data/examples/empty.sql

@@ -0,0 +1,33 @@
+
+\connect postgres
+
+drop database if exists fox;
+create database fox;
+
+\connect fox
+
+create schema user_schema;
+create schema role_schema;
+
+create table role_schema.roles (
+  id integer generated by default as identity primary key,
+  name text not null
+);
+
+create table user_schema.users (
+  id integer generated by default as identity primary key,
+  name text not null
+);
+
+create table public.user_roles (
+  id integer generated by default as identity primary key,
+  role_id integer not null references role_schema.roles(id),
+  user_id integer not null references user_schema.users(id)
+);
+
+create table public.posts (
+  id integer generated by default as identity primary key,
+  user_id integer not null references user_schema.users(id),
+  title text not null
+);
+

data/examples/include/schema-included.fox

@@ -0,0 +1,23 @@
+
+posts
+  - &alices_first_post
+    title: "FIRST"
+
+@schema user_schema
+
+users
+  - &alice
+    name: Alice
+    roles:
+      - *sysadm_role
+      - &user_role
+        name: User
+    posts:
+      - *alices_first_post
+      - title: "SECOND"
+  - &bob
+    name: Bob
+    roles:
+      - *admin_role
+      - *user_role
+