NewsBlur Download – Download NewsBlur Quellcodes

NewsBlur

Python

1.0.0

Herunterladen

NewsBlur

NewsBlur ist ein persönlicher Newsreader, der Menschen zusammenbringt, um über die Welt zu sprechen. Ein neuer Klang eines alten Instruments.
www.newsblur.com.
Erstellt von Samuel Clay.
X/Twitter: @samuelclay und @newsblur.

Merkmale

Zeigt die Originalseite (man muss sie gesehen haben, um es zu glauben).
Versteckt Geschichten, die Sie nicht lesen möchten, basierend auf Tags, Schlüsselwörtern, Autoren usw.
Hebt Geschichten hervor, die Sie lesen möchten, basierend auf denselben Kriterien.

Technologien

Serverseitig

Python 3.7+: Die Sprache der Wahl.
Django: In Python geschriebenes Web-Framework, das zur Bereitstellung aller Seiten verwendet wird.
Celery & RabbitMQ: Asynchroner Warteschlangenserver, der zum Abrufen und Analysieren von RSS-Feeds verwendet wird.
MongoDB, Pymongo und Mongoengine: Nicht relationale Datenbank, die zum Speichern von Storys, Lesen von Storys, Feed-/Seitenabrufverläufen und Proxy-Sites verwendet wird.
PostgreSQL: Relationale Datenbank, die zum Speichern von Feeds, Abonnements und Benutzerkonten verwendet wird.
Redis: Datenbank des Programmierers, die zum Zusammenstellen von Storys für den Fluss, zum Speichern von Story-IDs, zum Verwalten von Feed-Abrufplänen und dem winzigen Caching verwendet wird, das NewsBlur verwendet.
Elasticsearch: Datenbank durchsuchen, zum Durchsuchen von Storys verwenden. Optional.

Kundenseitig und Design

jQuery: Browserübergreifender JavaScript-Code. IE funktioniert ohne Aufwand.
Underscore.js: Funktionale Programmierung für JavaScript. Unverzichtbar.
Backbone.js: Framework für die Web-App. Auch unverzichtbar.
Verschiedene jQuery-Plugins: Alles von skalierbaren Layouts bis hin zu Fortschrittsbalken, sortierbaren Elementen, Datumsverarbeitung, Farben, Ecken, JSON und Animationen. Sehen Sie sich die vollständige Liste an.

Voraussetzungen

 * Docker
* Docker-compose

Installationsanweisungen

Klonen Sie dieses Repo
Führen Sie make nb aus, um alle NewsBlur-Container zu erstellen. Dadurch werden alle erforderlichen Datenbanken, Front-End-Django-Apps, Sellerie-Aufgaben, Knoten-Apps, Flask-Datenbankmonitor und -Metriken, Nginx und ein Haproxy-Load-Balancer eingerichtet.
Navigieren Sie zu:
```
 https://localhost
```
Hinweis: Sie werden gewarnt, dass Sie ein selbstsigniertes Zertifikat verwenden. Um diese Warnung zu umgehen, müssen Sie gemäß diesem Blogbeitrag „thisisunsafe“ eingeben.

Verwenden einer benutzerdefinierten Domäne

Führen Sie das benutzerdefinierte Domänenskript aus
```
 bash ./utils/custom_domain.sh <domain name>
```
Dieses Skript führt Folgendes aus:
- Ändern Sie NEWSBLUR_URL und SESSION_COOKIE_DOMAIN in newsblur_web/docker_local_settings.py
- Ändern Sie die Domäne in config/fixtures/bootstrap.json

Sie können Domänen auch ändern: bash ./utils/custom_domain.sh <old domain> <new domain>

Wenn Sie eine benutzerdefinierte Subdomain verwenden, sollten Sie diese auch zu ALLOWED_SUBDOMAINS in apps/reader/views.py hinzufügen
So stellen Sie sicher, dass Sie alle richtigen Orte aktualisiert haben:
- Gehen Sie in Ihrem Browser zur Website-Adresse
- Öffnen Sie die Entwicklertools und sehen Sie sich die Registerkarte „Netzwerk“ an
- Versuchen Sie, sich anzumelden
- Schauen Sie sich noch einmal die Entwicklertools an. Dort sollte ein POST-Aufruf an /login vorhanden sein
- Beachten Sie die Antwortheader für diesen Anruf
- Der Wert des „set-cookie“-Headers sollte eine „Domain="-Zeichenfolge enthalten
Wenn die Zeichenfolge nach Domain= nicht die Domäne ist, die Sie für den Zugriff auf die Website verwenden, benötigt Ihre Konfiguration weiterhin Ihre benutzerdefinierte Domäne.
Sie können auch bestätigen, dass in der Datenbank eine Nichtübereinstimmung des Domänennamens vorliegt, indem Sie make shell ausführen und Site.objects.all()[0] eingeben, um die Domäne anzuzeigen, die NewsBlur erwartet.

Sorgen Sie dafür, dass Docker-Compose mit Ihrer vorhandenen Datenbank funktioniert

Damit Docker-Compose mit Ihrer Datenbank funktioniert, aktualisieren Sie Ihre lokale Datenbank auf die Docker-Compose-Version und voluminisieren Sie dann den Datenbankdatenpfad, indem Sie den ./docker/volumes/ der Volume-Direktive im Dienst so ändern, dass er auf Ihre lokalen Datenbanken verweist Datenverzeichnis.

Damit Docker-Compose mit einer älteren Datenbankversion funktioniert, ändern Sie die Image-Version für den Datenbankdienst in der Docker-Compose-Datei.

Beitragsanweisungen

Änderungen vornehmen:
- Um Änderungen am Python- oder JavaScript-Code anzuwenden, verwenden Sie den Befehl make .
- Um Änderungen an der Datei docker-compose.yml anzuwenden, verwenden Sie den Befehl make rebuild .
- Um Änderungen an der Datei docker/haproxy/haproxy.conf, Knotenpaketen oder neuen Datenbankmigrationen anzuwenden, müssen Sie den Befehl make nb verwenden.
Hinzufügen von Python-Paketen: Derzeit verwendet die Datei docker-compose.yml das Bild newsblur/newsblur_python3. Es wird mit der Docker-Datei erstellt, die sich in docker/newsblur_base_image.Dockerfile befindet. Aufgrund der Einrichtung des Docker-Images müssen Sie Ihr eigenes Image erstellen und Ihre Datei „docker-compose.yml“ anweisen, es zu verwenden. Bitte befolgen Sie dazu die folgenden Schritte.
1. Fügen Sie Ihre neuen Site-Pakete zu config/requirements.txt hinzu.
2. Fügen Sie Ihrer docker-compose.yml-Datei die folgenden Codezeilen hinzu, um sie an der Stelle zu ersetzen, an der image: newsblur/newsblur_python3
build: context: . dockerfile: docker/newsblur_base_image.Dockerfile
1. Führen Sie den Befehl make nb aus, um Ihre Docker-Compose-Container neu zu erstellen
Debuggen von Python
- Um Ihren Code zu debuggen, löschen Sie import pdb; pdb.set_trace() in den Python-Code ein, in dem Sie mit dem Debuggen beginnen möchten, führen Sie make aus und führen Sie dann make debug .
Verwendung der Django-Shell in Docker
- Stellen Sie sicher, dass Ihre Docker-Container aktiv sind und führen Sie make shell aus, um die Django-Shell im Newsblur_web-Container zu öffnen.

Ausführen von Unit- und Integrationstests

NewsBlur wird komplett mit einer Testsuite geliefert, die die Funktionalität von rss_feeds, Reader und Feed-Importer testet. So führen Sie die Testsuite aus:

 `make test`

Ausführen eines Leistungstests

Leistungstests verwenden das Leistungstesttool Locust. Um Leistungstests über die CLI auszuführen, verwenden Sie make perf-cli users=1 rate=1 host=https://localhost . Fühlen Sie sich frei, die Benutzer-, Rate- und Hostvariablen im Befehl entsprechend Ihren Anforderungen zu ändern.

Sie können Locust-Leistungstests auch über eine Benutzeroberfläche ausführen, indem Sie make perf-ui ausführen und dann zu http://127.0.0.1:8089 navigieren. Dadurch können Sie Ihre Leistungsdaten grafisch darstellen und exportieren.

Um Locust mit Docker auszuführen, führen Sie einfach make perf-docker aus und navigieren Sie zu http://127.0.0.1:8089