aboutsummaryrefslogtreecommitdiff
path: root/documentation
diff options
context:
space:
mode:
authorCédric Bonhomme <cedric@cedricbonhomme.org>2015-11-26 18:47:10 +0100
committerCédric Bonhomme <cedric@cedricbonhomme.org>2015-11-26 18:47:10 +0100
commitd8d46c33dc766b904124eaad2dee5d7964711060 (patch)
treef549b7cd3acfa99425d4c7248e8b431de695bc7f /documentation
parentBug fix in the crawler when logging the creation of articles. (diff)
downloadnewspipe-d8d46c33dc766b904124eaad2dee5d7964711060.tar.gz
newspipe-d8d46c33dc766b904124eaad2dee5d7964711060.tar.bz2
newspipe-d8d46c33dc766b904124eaad2dee5d7964711060.zip
More refactorization.
Diffstat (limited to 'documentation')
-rw-r--r--documentation/conf.py2
-rw-r--r--documentation/deployment.rst24
-rw-r--r--documentation/index.rst6
-rw-r--r--documentation/web-services.rst30
4 files changed, 30 insertions, 32 deletions
diff --git a/documentation/conf.py b/documentation/conf.py
index ed031f9a..972d748b 100644
--- a/documentation/conf.py
+++ b/documentation/conf.py
@@ -40,7 +40,7 @@ source_suffix = '.rst'
master_doc = 'index'
# General information about the project.
-project = u'jarr'
+project = u'JARR (Just Another RSS Reader)'
copyright = u'2015, Cédric Bonhomme'
# The version info for the project you're documenting, acts as replacement for
diff --git a/documentation/deployment.rst b/documentation/deployment.rst
index 59080b89..82fa3988 100644
--- a/documentation/deployment.rst
+++ b/documentation/deployment.rst
@@ -4,7 +4,7 @@ Deployment
This application can be deployed on Heroku or on a traditional server.
After installation, you will be able to connect with the email
-*root@pyAggr3g470r.localhost* and the password *password*.
+*root@jarr.localhost* and the password *password*.
Deploying the application with Vagrant
--------------------------------------
@@ -17,12 +17,12 @@ Installation of VirtualBox and Vagrant
$ wget https://dl.bintray.com/mitchellh/vagrant/vagrant_1.7.2_x86_64.deb
$ sudo dpkg -i vagrant_1.7.2_x86_64.deb
-Deployment of pyAggr3g470r
+Deployment of JARR
.. code-block:: bash
- $ git clone https://bitbucket.org/cedricbonhomme/pyaggr3g470r.git
- $ cd pyaggr3g470r/vagrant/
+ $ git clone https://github.com/JARR-aggregator/JARR.git
+ $ cd JARR/vagrant/
$ vagrant up
Once the VM configured, go to the address http://127.0.0.1:5000.
@@ -30,15 +30,15 @@ Once the VM configured, go to the address http://127.0.0.1:5000.
Deploying the application on Heroku
-----------------------------------
-An instance of pyAggr3g470r is running `here <https://pyaggr3g470r.herokuapp.com>`_.
+An instance of JARR is running `here <https://jarr.herokuapp.com>`_.
The geek way
''''''''''''
.. code-block:: bash
- $ git clone https://bitbucket.org/cedricbonhomme/pyaggr3g470r.git
- $ cd pyaggr3g470r
+ $ git clone https://github.com/JARR-aggregator/JARR.git
+ $ cd JARR
$ heroku create
$ heroku addons:add heroku-postgresql:dev
$ heroku config:set HEROKU=1
@@ -71,7 +71,7 @@ The simple way
Alternatively, you can deploy your own copy of the app using this button:
.. image:: https://www.herokucdn.com/deploy/button.png
- :target: https://heroku.com/deploy?template=https://github.com/cedricbonhomme/pyAggr3g470r
+ :target: https://heroku.com/deploy?template=https://github.com/JARR-aggregator/JARR.git
You will be prompted to choose an email and a password for the administrator's account.
And some other optional environment variables, as previously presented.
@@ -81,8 +81,8 @@ Deploying the application on a traditional server
.. code-block:: bash
- $ git clone https://bitbucket.org/cedricbonhomme/pyaggr3g470r.git
- $ cd pyaggr3g470r/
+ $ git clone https://github.com/JARR-aggregator/JARR.git
+ $ cd JARR/
If you want to use PostgreSQL
'''''''''''''''''''''''''''''
@@ -114,7 +114,7 @@ Configuration (database url, email, proxy, user agent, etc.) is done via the
file `conf/conf.cfg`.
Check this file before initializing the database (with `manager.py`).
-If you want to use pyAggr3g470r with Tor/Privoxy, you just have to set the value
+If you want to use JARR with Tor/Privoxy, you just have to set the value
of `http_proxy` (most of the time: `http_proxy = 127.0.0.1:8118`). Else leave
the value blank.
@@ -128,4 +128,4 @@ your cron rules (*crontab -e*):
.. code-block:: bash
- */30 * * * * cd ~/.pyaggr3g470r/ ; python manager.py fetch_asyncio None None
+ */30 * * * * cd ~/.JARR/ ; python manager.py fetch_asyncio None None
diff --git a/documentation/index.rst b/documentation/index.rst
index 947612a1..8f84c8a7 100644
--- a/documentation/index.rst
+++ b/documentation/index.rst
@@ -1,9 +1,9 @@
-.. pyAggr3g470r documentation master file, created by
+.. JARR documentation master file, created by
sphinx-quickstart on Fri Feb 20 07:23:42 2015.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
-Welcome to pyAggr3g470r's documentation!
+Welcome to JARR's documentation!
========================================
@@ -31,5 +31,3 @@ Migrations
:maxdepth: 2
migrations
-
-
diff --git a/documentation/web-services.rst b/documentation/web-services.rst
index 16a425ad..53035c3c 100644
--- a/documentation/web-services.rst
+++ b/documentation/web-services.rst
@@ -7,7 +7,7 @@ Articles
.. code-block:: python
>>> import requests, json
- >>> r = requests.get("https://pyaggr3g470r.herokuapp.com/api/v2.0/article/1s",
+ >>> r = requests.get("https://jarr.herokuapp.com/api/v2.0/article/1s",
... headers={'Content-type': 'application/json'},
... auth=("your-nickname", "your-password"))
>>> r.status_code
@@ -17,7 +17,7 @@ Articles
'Sponsors required for KDE code sprint in Randa'
>>> rjson["date"]
'Wed, 18 Jun 2014 14:25:18 GMT'
- >>> r = requests.get("https://pyaggr3g470r.herokuapp.com/api/v2.0/article/1s",
+ >>> r = requests.get("https://jarr.herokuapp.com/api/v2.0/article/1s",
... headers={'Content-type': 'application/json'},
... auth=("your-nickname", "your-password"),
... data=json.dumps({'id__in': [1, 2]}))
@@ -36,20 +36,20 @@ Add an article:
... 'content':'La page principale de pyAggr3g470r a été améliorée...',
... 'date':'2014/06/23T11:42:20 GMT',
... 'feed_id':'42'}
- >>> r = requests.post("https://pyaggr3g470r.herokuapp.com/api/v2.0/article",
+ >>> r = requests.post("https://jarr.herokuapp.com/api/v2.0/article",
... headers=headers, auth=("your-nickname", "your-password"),
... data=json.dumps(payload))
>>> r.status_code
201 # Created
>>> # creating several articles at once
- >>> r = requests.post("https://pyaggr3g470r.herokuapp.com/api/v2.0/article",
+ >>> r = requests.post("https://jarr.herokuapp.com/api/v2.0/article",
... headers=headers, auth=("your-nickname", "your-password"),
... data=json.dumps([payload, payload]))
>>> r.status_code
201 # Created
>>> r.json()
[123456, 234567]
- >>> r = requests.get("https://pyaggr3g470r.herokuapp.com/api/v2.0/articles",
+ >>> r = requests.get("https://jarr.herokuapp.com/api/v2.0/articles",
... auth=("your-nickname", "your-password")
... data=json.dumps({'feed_id': 42, 'limit': 1}))
>>> r.json()[0]["title"]
@@ -60,13 +60,13 @@ Update an article:
.. code-block:: python
>>> import requests, json
- >>> r = requests.put("https://pyaggr3g470r.herokuapp.com/api/v2.0/article/65",
+ >>> r = requests.put("https://jarr.herokuapp.com/api/v2.0/article/65",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password"),
... data=json.dumps({"like":True, "readed": False}))
>>> r.status_code
200 # OK
- >>> r = requests.put("https://pyaggr3g470r.herokuapp.com/api/v2.0/articles",
+ >>> r = requests.put("https://jarr.herokuapp.com/api/v2.0/articles",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password"),
... data=json.dumps([[1, {"like": True, "readed": False}],
@@ -79,29 +79,29 @@ Delete one or several article(s):
.. code-block:: python
>>> import json, requests
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/article/84574",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/article/84574",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password"))
>>> r.status_code
204 # deleted - No content
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/article/84574",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/article/84574",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password"))
>>> r.status_code
404 # not found
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/articles",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/articles",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password")
... data=json.dumps([84574]))
>>> r.status_code
500 # already deleted
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/articles",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/articles",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password")
... data=json.dumps([84575, 84576]))
>>> r.status_code
204 # deleted - No content
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/articles",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/articles",
... headers={'Content-Type': 'application/json'},
... auth=("your-nickname", "your-password")
... data=json.dumps([84575, 84576, 84577]))
@@ -119,7 +119,7 @@ Add a feed:
.. code-block:: python
>>> import json, requests
- >>> r = requests.post("https://pyaggr3g470r.herokuapp.com/api/v2.0/feeds",
+ >>> r = requests.post("https://jarr.herokuapp.com/api/v2.0/feeds",
... auth=("your-nickname", "your-password"),
... headers={'Content-Type': 'application/json'},
... data=json.dumps({'link': 'http://blog.cedricbonhomme.org/feed'}))
@@ -131,7 +131,7 @@ Update a feed:
.. code-block:: python
>>> import json, requests
- >>> r = requests.put("https://pyaggr3g470r.herokuapp.com/api/v2.0/feeds/42",
+ >>> r = requests.put("https://jarr.herokuapp.com/api/v2.0/feeds/42",
... auth=("your-nickname", "your-password"),
... headers={'Content-Type': 'application/json'},
... data=json.dumps({"title":"Feed new title", "description":"New description"})
@@ -143,5 +143,5 @@ Delete a feed:
.. code-block:: python
>>> import requests
- >>> r = requests.delete("https://pyaggr3g470r.herokuapp.com/api/v2.0/feeds/29",
+ >>> r = requests.delete("https://jarr.herokuapp.com/api/v2.0/feeds/29",
... auth=("your-nickname", "your-password"))
bgstack15