Skip to content

Commit

Permalink
1.0.0
Browse files Browse the repository at this point in the history
Documentation updated
  • Loading branch information
PonteIneptique committed Apr 28, 2017
1 parent 1f552b1 commit 9bea0c3
Show file tree
Hide file tree
Showing 5 changed files with 39 additions and 236 deletions.
28 changes: 26 additions & 2 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Capitains Nautilus
================
==================

.. image:: https://coveralls.io/repos/github/Capitains/Nautilus/badge.svg?branch=master
:target: https://coveralls.io/github/Capitains/Nautilus?branch=master
Expand All @@ -16,7 +16,31 @@ Capitains Nautilus
Documentation
#############

Documentation will be built in time.
CapiTainS Nautilus provides a Flask extension to build upon MyCapytain resolver. The finale goal of the application, built
upon `MyCapytain <https://github.com/capitains/MyCapytain>`_, is to serve either as a Web-API provider (Currently supporting
CTS, partly DTS. OAI-PMH and a Sparql endpoint are scheduled.) These API can be used to access portion of or complete texts
using standards. Metadata are exposed as well.

A second goal of Nautilus is to serve as a cache wrapper for resolver, in order to speed up serving texts for user interfaces
such as `Nemo <https://github.com/capitains/flask-capitains-nemo>`_ .

A known implementation can be found at `the University of Leipzig <http://cts.dh.uni-leipzig.de/api>`_ . You can find the
set-up files on `Github <https://github.com/OpenGreekAndLatin/leipzig_cts>`_

Trying Nautilus with a test dataset example
###########################################

With Python 3 only !

.. code-block:: shell
git clone https://github.com/Capitains/Nautilus.git
virtualenv -p /usr/bin/python3 venv
source venv/bin/activate
python app.py
Now go to http://localhost:5000 and check out http://localhost:5000/api/cts , http://localhost:5000/api/dts/collections,
http://localhost:5000/api/cts?request=GetValidReff

Running Nautilus from the command line
######################################
Expand Down
58 changes: 13 additions & 45 deletions doc/Nautilus.API.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,6 @@
Capitains Nautilus API Documentation
============================
CapiTainS Nautilus API Documentation
====================================

Library Structure
#################

.. image:: assets/api_architecture.png
:alt: Library Software Architecture
:align: center

Resolvers
#########
Expand All @@ -16,33 +10,7 @@ Resolver provides a system to retrieve a text file and an inventory from local r
CapiTainS formatted repository
******************************

.. autoclass:: capitains_nautilus.inventory.local.XMLFolderResolver
:members:

Prototype
*********

.. autoclass:: capitains_nautilus.inventory.proto.InventoryResolver
:members:

Retriever
#########

Extension of MyCapytains resources
**********************************

.. automodule:: capitains_nautilus.mycapytain
:members:
:undoc-members:
:show-inheritance:

Responses builders
******************

.. automodule:: capitains_nautilus.response
:members:
:undoc-members:
:show-inheritance:
.. autoclass:: capitains_nautilus.cts.resolver.NautilusCTSResolver

Errors
######
Expand All @@ -52,14 +20,6 @@ Errors
:undoc-members:
:show-inheritance:

Cache
#####

.. automodule:: capitains_nautilus.cache
:members:
:undoc-members:
:show-inheritance:

Flask Extension
###############

Expand All @@ -68,9 +28,17 @@ Flask Extension
:undoc-members:
:show-inheritance:

Commandline
***********
Command-line Interface
**********************
.. automodule:: capitains_nautilus.cmd
:members:
:undoc-members:
:show-inheritance:

Cache Manager
#############

.. automodule:: capitains_nautilus.manager
:members:
:undoc-members:
:show-inheritance:
188 changes: 0 additions & 188 deletions doc/Nautilus.production.rst

This file was deleted.

Binary file removed doc/assets/api_architecture.png
Binary file not shown.
1 change: 0 additions & 1 deletion doc/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,6 @@ Contents
.. toctree::
:maxdepth: 2

Nautilus.production
Nautilus.API


Expand Down

0 comments on commit 9bea0c3

Please sign in to comment.