Remove v1 DF API from Python and Ruby (#1497)

* rm most of it

* rm the rest from python

* py docs update

* sequel adapter

* rm node df test

* rm node add-to-your-app

* no node

* rm references to removed doc

* rm another node example

* restore node app

Co-authored-by: Stephen Olsen <[email protected]>

docs/content/node/getting-started/application/enforce/index.md

@@ -0,0 +1,11 @@
+---
+title: Enforce authorization
+description: |
+    Add authorization enforcement throughout your application using the
+    authorize API to reject or accept requests that users make.
+weight: 2
+---
+
+# Enforce authorization
+
+{{% coming_soon %}}

docs/content/node/getting-started/application/filter-data/index.md

@@ -0,0 +1,19 @@
+---
+title: Filter collections of data
+description: |
+  Many applications perform authorization over large collections of data
+  that cannot be loaded into memory. Often index pages showing users a
+  number of resources, like the repositories they can access, will need to
+  use data filtering. The data filtering API provides support for these
+  use cases.
+weight: 4
+---
+
+# Filter collections of data
+
+{{% coming_soon %}}
+
+## What's next
+
+This is the end of __Add to your app__! For more detail on using
+Oso, see the [How to guides](/guides).

docs/content/node/getting-started/application/model/index.md

@@ -0,0 +1,15 @@
+---
+title: Model your authorization logic
+description: |
+    Authorization in Oso starts with the policy. Authorization policies
+    define the resources that you want to control access to, and rules that
+    specify when an actor (the user making the request) can perform an
+    action on a resource. Because Oso is a library, you can write
+    authorization policies directly over the same data types that are
+    already used in your application.
+weight: 1
+---
+
+# Model your authorization logic
+
+{{% coming_soon %}}

docs/examples/add-to-your-application/Makefile

@@ -2,17 +2,14 @@
 # Gemfile defined in `docs/examples/Makefile`.
 unexport BUNDLE_GEMFILE
 
-test: test-python test-policy-extensions test-ruby test-node test-go
+test: test-python test-policy-extensions test-ruby test-go
 
 test-policy-extensions: venv
 	. venv/bin/activate; pytest test_policy_extensions.py
 
 test-python:
 	$(MAKE) -C python test
 
-test-node:
-	$(MAKE) -C node test
-
 test-ruby:
 	$(MAKE) -C ruby test
 
@@ -26,4 +23,4 @@ venv/touchfile: requirements.txt
 	. venv/bin/activate; pip install -r requirements.txt
 	touch $@
 
-.PHONY: test test-policy-extensions test-python test-node test-ruby test-go
+.PHONY: test test-policy-extensions test-python test-ruby test-go

docs/examples/add-to-your-application/node/main.polar

@@ -0,0 +1,21 @@
+actor User {}
+
+resource Repository {
+    permissions = ["read", "push", "delete"];
+    roles = ["contributor", "maintainer", "admin"];
+
+    "read" if "contributor";
+    "push" if "maintainer";
+    "delete" if "admin";
+
+    "maintainer" if "admin";
+    "contributor" if "maintainer";
+}
+
+has_role(actor: User, role_name: String, repository: Repository) if
+    role in actor.roles and
+    role_name = role.name and
+    repository = role.repository;
+
+allow(actor, action, resource) if
+    has_permission(actor, action, resource);

docs/examples/add-to-your-application/node/test.js

@@ -14,21 +14,9 @@ async function routeWorks() {
     .expect(200);
 }
 
-async function dataFilteringWorks() {
-  const { app } = require('./dataFiltering');
-  await request(app)
-    .get('/repos')
-    .expect(200)
-    .then(response => {
-      console.log(response.text);
-      assert(response.text.length >= 3);
-    });
-}
-
 async function runTests() {
   await osoInits();
   await routeWorks();
-  await dataFilteringWorks();
 }
 
 (async () => {

docs/examples/add-to-your-application/python/app/data_filtering.py

@@ -4,6 +4,7 @@
 from . import models
 
 from oso import Oso
+from polar.data.adapter.sqlalchemy_adapter import SqlAlchemyAdapter
 
 from sqlalchemy import Column, String, Boolean
 from sqlalchemy.ext.declarative import declarative_base
@@ -16,17 +17,19 @@
 
 oso = Oso()
 
-engine = create_engine('sqlite://')
+engine = create_engine("sqlite://")
 Session = sessionmaker(bind=engine)
 
 Base = declarative_base(bind=engine)
 
+
 class Repository(Base):
-    __tablename__ = 'repo'
+    __tablename__ = "repo"
 
     name = Column(String(128), primary_key=True)
     is_public = Column(Boolean)
 
+
 Base.metadata.create_all()
 
 # docs: begin-data-filtering
@@ -58,33 +61,36 @@ def get_repositories(filters):
 
     return query
 
+
 oso.register_class(models.User)
 oso.register_class(
     Repository,
     fields={
-		# Tell Oso the types of fields you will use in your policy.
-		"is_public": bool
-	},
-    build_query=get_repositories,
-    exec_query=lambda q: q.all(),
-    combine_query=lambda q1, q2: q1.union(q2),
+        # Tell Oso the types of fields you will use in your policy.
+        "is_public": bool
+    },
 )
 
+oso.set_data_filtering_adapter(SqlAlchemyAdapter(Session()))
+
 oso.load_files([Path(__file__).parent / "main.polar"])
 # docs: end-data-filtering
 
+
 class User:
     @staticmethod
     def get_current_user():
-        return models.User(roles=[{"name": "admin", "repository": Repository(name="gmail")}])
+        return models.User(
+            roles=[{"name": "admin", "repository": Repository(name="gmail")}]
+        )
+
 
 # docs: begin-list-route
 @app.route("/repos")
 def repo_list():
-    repositories = oso.authorized_resources(
-        User.get_current_user(),
-        "read",
-        Repository)
+    repositories = oso.authorized_resources(User.get_current_user(), "read", Repository)
 
     return serialize(repositories)
+
+
 # docs: end-list-route

docs/examples/add-to-your-application/python/app/models.py

@@ -1,29 +1,30 @@
 from dataclasses import dataclass
 from typing import List
 
+
 @dataclass
 class Repository:
     name: str
 
     def get_by_name(name):
         return repos_db[name]
 
-repos_db = {
-    "gmail": Repository("gmail")
-}
+
+repos_db = {"gmail": Repository("gmail")}
 
 # docs: start
 @dataclass
 class Role:
     name: str
     repository: Repository
 
+
 @dataclass
 class User:
     roles: List[Role]
 
+
 users_db = {
-    "larry": User([Role(name="admin",
-                        repository=repos_db["gmail"])]),
+    "larry": User([Role(name="admin", repository=repos_db["gmail"])]),
 }
 # docs: end