# Copyright 2020 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import datetime from flask import Blueprint, url_for, render_template, current_app, Response, redirect, request from markupsafe import escape from slugify import slugify, SLUG_OK from . import config from . import db from . import forms from . import util bp = Blueprint('agora', __name__) G = db.G # Special @bp.route('/index') @bp.route('/') def index(): return redirect(url_for('.node', node='index')) @bp.route('/help') def help(): current_app.logger.warning('Not implemented.') return 'If I had implemented help already, here you\'d see documentation on all URL endpoints. For now, please refer to the code.' @bp.route('/Δ') @bp.route('/latest') def latest(): return render_template('subnodes.html', header="Latest", subnodes=db.latest()) @bp.route('/today') def today(): today = datetime.datetime.now().date() return redirect("https://anagora.org/node/%s" % today.strftime("%Y-%m-%d")) @bp.route('/search', methods=('GET', 'POST')) def search(): form = forms.SearchForm() if form.validate_on_submit(): return render_template('search.html', form=form, subnodes=db.search_subnodes(form.query.data)) return render_template('search.html', form=form) # Actions @bp.route('/go/') def go(node): """Redirects to the URL in the given node in a block that starts with [[go]], if there is one.""" # TODO(flancian): all node-scoped stuff should move to actually use node objects. try: n = db.nodes_by_wikilink(node) except KeyError: return redirect("https://anagora.org/node/%s" % node) if len(n) > 1: current_app.logger.warning('nodes_by_wikilink returned more than one node, should not happen.') if len(n) == 0: # No nodes with this name -- redirect to node 404. return redirect("https://anagora.org/node/%s" % node) links = n[0].go() if len(links) == 0: # No go links detected in this node -- just redirect to the node. # TODO(flancian): flash an explanation :) return redirect("https://anagora.org/node/%s" % node) if len(links) > 1: # TODO(flancian): to be implemented. # Likely default to one of the links, show all of them but redirect to default within n seconds. current_app.logger.warning('Code to manage nodes with more than one go link is not Not implemented.') return redirect(links[0]) @bp.route('/pull/') def pull(node): """In the context of a node, "pulls attention" from the parameter node to the current subnode. Here it "broadcasts": it renders all nodes that pull from a given node. Unclear at this point if this should exist at all, or whether it should do something else. TODO: probably remove this, [[pull]] changed. """ return redirect('/node/{}'.format(node)) @bp.route('/jump') def jump(): """Redirects to a context; in "jump" mode, a node *always* exists (nodes map one to one to all possible queries).""" q = request.args.get('q') return redirect(url_for('.node', node=slugify(q))) # Entities @bp.route('/wikilink/') @bp.route('/node/') def node(node): n = G.node(node) # earlier in the list means more highly ranked. n.subnodes = util.uprank(n.subnodes, users=['agora', 'flancian']) search_subnodes = db.search_subnodes(node) return render_template( 'node_rendered.html', node=n, backlinks=n.back_links(), pull_nodes=n.pull_nodes() if n else [], forwardlinks=n.forward_links() if n else [], search=search_subnodes, pulling_nodes=n.pulling_nodes(), pushing_nodes=n.pushing_nodes(), query=n.wikilink.replace('-', '%20') ) @bp.route('/node/@') @bp.route('/@/') def subnode(node, user): n = G.node(node) n.subnodes = util.filter(n.subnodes, user) search_subnodes = db.search_subnodes_by_user(node, user) return render_template( 'subnode_rendered.html', node=n, ) @bp.route('/subnode/') def old_subnode(subnode): return render_template('subnode_rendered.html', subnode=db.subnode_by_uri(subnode), backlinks=db.subnodes_by_outlink(subnode)) @bp.route('/u/') @bp.route('/user/') @bp.route('/@') def user(user): return render_template('user.html', user=user, readmes=db.user_readmes(user), subnodes=db.subnodes_by_user(user)) @bp.route('/garden/') def garden(garden): current_app.logger.warning('Not implemented.') return 'If I had implemented rendering gardens already, here you would see garden named "%s".' % escape(garden) # Lists @bp.route('/nodes') def nodes(): return render_template('nodes.html', nodes=G.nodes(include_journals=False)) @bp.route('/notes') # alias @bp.route('/subnodes') def subnodes(): return render_template('subnodes.html', subnodes=G.subnodes()) @bp.route('/@') @bp.route('/users') def users(): return render_template('users.html', users=db.all_users()) @bp.route('/journals') def journals(): return render_template('nodes.html', header="Journals", nodes=db.all_journals()) # Searching with GET: potentially useful but probably not a good idea. # @bp.route('/search/') # def search(query): # return render_template('subnodes.html', subnodes=db.search_subnodes(query)) @bp.route('/asset//') def asset(user, asset): # An asset is a binary in someone's garden//assets directory. # Currently unused. path = '/'.join(["garden", user, 'assets', asset]) return current_app.send_static_file(path) @bp.route('/raw/') def raw(node): # Currently unused. # hack hack # outlinks return Response("\n\n".join([str(n.outlinks) for n in db.nodes_by_wikilink(node)]), mimetype="text/plain") # content # return Response("\n\n".join([n.content for n in db.nodes_by_wikilink(node)]), mimetype="text/plain") @bp.route('/backlinks/') def backlinks(node): # Currently unused. return render_template('nodes.html', nodes=db.nodes_by_outlink(node))