#api_seenthis

tu peux les télécharger tous d’un coup dans un format xml
►http://seenthis.net/fran%C3%A7ais/mentions/article/propri%C3%A9t%C3%A9-intellectuelle

et il existe déjà deux « clients », l’un en python, l’autre en php :

►https://github.com/bortzmeyer/seenthis-python
►http://seenthis.net/messages/30043

je ne suis pas satisfait de ce fonctionnement, ça devrait être beaucoup plus simple — un accès IMAP ou WebDAV par exemple...

Ah, super, c’est exactement ce que je voulais. Le seul truc : ça me donne toujours <text></text> pour tous les seens.

Perso ça me va comme fonctionnement (même si du JSON serait encore plus simple). IMAP c’est lourd. WebDAV ça peut être mieux, mais il y a quand même des problèmes d’interop.

A la limite, pour éviter de devoir faire un dump intégral d’un coup, on peut songer à un paramètre since= (qui pointe sur une date ou un ID) pour ne récupérer que ce qui vient après.

je voudrais sortir de la logique de « dump » et entrer dans une logique de synchronisation ; or ça, on sait bien le faire avec IMAP ; sauf peut-être « modifier un message » ?

Je comprends, mais je maintiens que IMAP c’est lourd — et les clients ont tendance à être pourris.

Le problème de sync dépend largement de savoir si c’est unidirectionnel ou bidirectionnel (ou plus...). Pour de l’unidirectionnel, juste pouvoir demander les changements depuis tel ID ou telle date suffit normalement.

Pour du bidirectionnel ça pourrait être intéressant de regarder du coté de git (qui a une API HTTP depuis quelques temps).

#api_seenthis

Oh cool pour les notifications.

Gaffe, ça met en frontal des choses qui sont lourdes et hors cache. Un lien hypertexte la-dessus et mon serveur s’effondre. Les « follow » précédents étant liés à la session, il n’y avait pas ce risque. Pour l’accès API hors identification et hors cache, même problème.

Pourquoi est-ce hors du cache ?

En ce qui concerne l’API, il me semble que c’est une brique élémentaire, il faudra en effet qu’elle soit optimisée pour supporter des accès fréquents, avec un index ou un arbre des hash connus. Mais ça ne semble pas bloquant car elle répond encore très très vite.

« Préserver la confidentialité des URL qu’on cherche ? » Vis-à-vis de qui ? Pas vis-à-vis de SeenThis, qui peut garder une liste de tous ses URL avec leur MD5. (Le « ses » est important, cf. réponse @Fil.)

Seulement des URLs qu’il a déjà en base… pour les autres il reçoit un md5, qu’il peut certes tenter d’inverser mais à un coût assez élevé.

Hmmm, la recherche d’URL qui renvoie du JSON alors que les autres méthodes renvoient du XML... Pas super-cohérent.

J’ai mis en œuvre la fonction de recherche d’URL dans #seenthis-python ►https://github.com/bortzmeyer/seenthis-python Pour les curieux, le commit exact est ►https://github.com/bortzmeyer/seenthis-python/commit/f18d6ea23bcba042a98396e3367a85b2d8ef141f

On peut utiliser la bibliothèque dans ses programmes ou simplement se servir du nouveau script seenthis-test-url.py, par exemple « seenthis-test-url.py URL » pour voir si un URL existe (l’option -n permet de ne voir au contraire que ceux qui n’existent pas dans SeenThis). Pour tester une longue liste (attention, ça rame, plus d’une heure pour tester 4 000 URLs), « seenthis-test-url.py $(cat FICHIER-CONTENANT-LES-URL) ».

Ça m’a permis de savoir que seuls 114 des 4313 URLs cités sur mon blog étaient dans SeenThis :-) La commande était "seenthis-test-url.py $(psql —field-separator ’ ’ —tuples-only —no-align -c « SELECT url FROM Blog.Links ; » blog) | wc -l".

Je suis d’accord avec cette critique sur la cohérence — mais je hais tellement XML que j’ai fait comme ça, libre à @arno de modifier le résultat :)

@Fil : sur XML, voir ►http://seenthis.net/messages/70635

Bordel, les gars, je comprends rien. On commence où pour connaître tous les trucs et astuces ? :-)

@davduf SeenThis, ce n’est pas un rézosocio professionnel qui distribue sa base de mots de passe aux pastebins russes et qui vend les données personnelles de ses membres. C’est un projet individuel dont l’auteur s’occupe quand il a le temps. Question doc’, n’y a pas de point d’entrée unique et à jour.

Après, les questions précises sont les bienvenues :-)

Bien sûr Stéphane ,-) En fait, j’avais souvenir qu’on pouvait retrouver facilement ses #hashtags (genre complétion automatique) mais je ne le retrouve pas...

Merci pour tout !

Non, y’a pas de complétion automatique pour le moment. En revanche, la liste de tes hashtags habituels, elle est en colonne de droite de ta page à toi :
►http://seenthis.net/people/davduf

Au cas où tu n’étais pas dans le coin quand j’ai ajouté le bouton : tout en bas de ta liste de hashtags, tu as un bouton « Wordle ». C’est très mignon pour voir de quoi tu causes ici.

Ah, oui, « Wordle », c’est trés zoli.

Pour les hashtags habituels, hélas, je ne les vois pas quand j’utilise le bookmarklet... C’est le petit problème, je trouve :-)

Je cherche pas mal, suis obligé de modifier, etc.
C’est pas grave hein, mais je crois vraiment que des hashtags plus simples à utiliser serait vraiment un truc top.

Et pour le reste, bravo !

alors qu’on reçoive plus de mail pour notifier qu’on a contribué à un de ses billets c’est parfait. Par contre, je ne reçois plus de mail me notifiant la contribution des autres seenthisiens sur des billets que je partage, ça c’est dommage je trouve

ah bon moi il me semble que je les reçois

ah oui, là, ça marche

mais ce n’est pas systématique

#api_seenthis

/cc @funkypiwy

Si vous n’avez pas le lien « Sites » là-haut :
– forcez le rechargement,
– sinon videz le cache de votre brouteur,
– sinon : ►http://seenthis.net/sites

hum, mais comment déclare t’on que l’on suit une url ?

Si tu as le petit triangle devant une URL (URL référencée au moins déjà une fois), tu cliques sur ce triangle pour arriver à l’URL. Si nécessaire,tu remontes dans la hiérarchie pour arriver à la page de Seenthis qui référence la racine du site. Et là, à droite du titre de la page, tu as un lien « Suivre ce site ».

Sinon, le plus simple : tu vas sur ta page « Sites », et dans le formulaire de recherche qui s’y trouve (sous le titre), tu mets l’URL du site que tu veux suivre. Ça te retourne les pages concernées sur Seenthis, tu cliques pour arriver à la page dédiée de Seenthis, et là tu fais « Suivre ce site ».

Merci.

faut chercher les doublons d’abord avec ce système

@netlibertaire : non, pas si tu passes par le moteur de recherche ; c’est pour cela qu’il est présent directement dans la page /sites.

Par ailleurs, remarque que quand tu es dans la page Seenthis d’une URL, tout en haut de la page, tu as la « hiérarchie » qui te permet de remonter à la racine du site (en restant sur Seenthis).

Ce qui te permet de « suivre » la racine d’un site : donc chaque fois que quelqu’un référence n’importe quelle page dans ce site. Tu peux donc suivre « large », et référencer précisément.

merci pour le truc sympa, l’ abonnement url pratique

Top, cette fonctionnalité !

Eh bien on va étudier tout ceci et, surtout, bonne nouvelle année à toute l’équipe de #Seenthis et à ses abonnés !

Mais comment on fait pour suivre les URL cités une seule fois, et qui n’ont donc pas le petit triangle ?

@stephane : Comme j’ai expliqué plus haut : tu fais une recherche de cette URL directement depuis l’interface de recherche de la page « Sites », et hop.

(Sinon, si tu as l’âme d’un pervers geek : tu postes deux messages de suite avec la même URL, tu t’abonnes à cette URL, et ensuite tu efface le message en trop. Et ensuite tu prétends que c’est une fonctionnalité documentée.)

Fonctionnalité sympatique. Elle est disponible dans la #API_Seenthis ?

Premier commentaire envoyé depuis SeenDroid. Androïd 2.3, smartphone HTC Desire. #SeenThis_API

Ah, déjà un ForceClose :-)

Aucun bouton pour permettre de signaler le problème.

« show user » si l’utilisateur n’existe pas donne une page blanche sans explication.

Il n’apparait pas dans les applications proposées lorsqu’on choisit Partager. Ce serait pourtant la fonction qu’il me faudrait. Combien de fois ai-je vu une page Web intéressante et renoncé à en parler sur SeenThis parce que, depuis un smartphone, c’est trop compliqué.

Bon, chez moi ça passe pas encore : Je télécharge l’apk, et j’ai « Erreur d’analyse : Un problème est survenu lors de l’analyse du kit ». (S.Galaxy S - Froyo, *.apk téléchargé depuis le téléphone).

@ProgVal, merci du boulot en tout cas, ça va être pratique.

@stephane Merci pour les retours, j’en prend bonne note.
C’est vrai que ça serait très intéressant de pouvoir partager comme ça (c’est un peu le but de SeenThis...)

@0gust1 C’est probablement la manière qu’a Android de dire que ta version d’Android n’est pas compatible. Je vais essayer de travailler sur ça (je devrais pouvoir squatter le portable de mon frère pour tester sous Froyo).

@0gust1 J’ai eu un message de ce genre (pas pensé à tout noter) en essayant d’installer depuis le Navigateur Web. En téléchargeant l’APK puis en le lançant depuis Astro, c’est passé (Android 2.3 - CyanogenMod 7).

@0gust1 En espérant que le problème est uniquement dû à ta version d’Android, voici un paquet corrigé : ►http://ompldr.org/vYmprNQ/SeenDroid-0.1-a2.apk

L’ancien indiquait qu’il fallait au minimum le SDK version 10 (Android 2.3.3 et 2.4.4), j’ai maintenant indiqué la version 8 (Android 2.2.x).
J’espère que toutes les fonctionnalités que j’utilise sont disponible sur ta version.

Et est-ce que c’est censé marcher sur Android 3 ? J’ai tenté ma chance, je télécharge l’APK mais Android me dit juste « Impossible d’ouvrir le fichier ».

Normalement, oui, étant donné que je n’ai fait que donner une version minimale à partir de laquelle on peut utiliser SeenDroid.
Cependant, vue la quantité d’applications qui apportent des mises à jour avec pour seule modification « with compatibility with Honeycomb », je me dis qu’il doit bien y avoir un truc...

Ce n’est pas ma priorité, mais quand j’aurais corrigé les autres bugs, j’essayerai de faire fonctionner l’emulateur Androïde pour voir ce qu’il se passe vraiment (le message d’erreur complet dans le logcat aide beaucoup à comprendre d’où vient une erreur).

J’ai choisi d’envoyer le rapport de crash par courriel, en lançant le client sur la rédaction d’un message, avec le traceback et une description du problème. Le courriel n’est envoyé qu’une fois que l’utilisateur clique sur le bouton.
Ça permet au passage à l’utilisateur de contrôler ce qui est envoyé, chose qui m’est importante. Et également d’ajouter son commentaire.

Une autre solution aurait été d’écrire les informations d’erreur sur le stockage externe, puis de l’envoyer lors du lancement de l’application, mais trois problèmes se posent :
L’application doit demander l’accès au stockage externe lors de l’installation,
Le stockage externe doit être disponible (appareil non connecté à l’ordinateur).
* L’utilisateur n’a plus le contrôle total de ce qu’il envoie.

Qu’en pensez-vous ?

Version 0.1a3, qui ajoute le rapporteur de bogues, un message lorsque l’on veut afficher un utilisateur qui n’existe pas, et qui ajoute SeenDroid dans le menu « Partager ».

►http://ompldr.org/vYms1aw/SeenDroid-0.1-a3.apk

Version 0.1a4 : déplacement de l’écriture du message dans sa propre activité (c’est à dire qu’on ouvre une nouvelle « fenêtre » au lieu d’écrire sur la page d’accueil, ce qui fait gagner de la place), et affichage d’un message d’erreur lorsque SeenDroid n’a pas pû envoyer un message.

►http://ompldr.org/vYmtlZA/SeenDroid-0.1-a4.apk

Je viens d’installer 0.1-a4 sur un CyanogenMod 7 et rien n’apparait dans le menu Partager.

C’est curieux, ça marche pour moi, avec cette version. Et j’ai également CyanogenMod (version 7.1).
Tu parles bien du menu « Partager », et non « effectuer cette action en utilisant » ?

Même problème chez moi ; c’est une erreur javax.net.ssl.SSLHandshakeException (c’est bien la première fois qu’un message d’erreur de Java est explicite). Donc c’est probablement parce que @seenthis a changé quelque chose.
Je vais essayer de corriger ça.

Cependant, en travaillant dessus, je me suis rendu compte qu’il y avait un force close quand on essaye d’accéder à SeenThis sans connexion, ce que je viens de corriger.
Donc, merci ;)

Ah tiens, je viens d’avoir quelques infos supplémentaires :
javax.net.ssl.SSLHandshakeException : current time : Fri Jan 20 18:31:43 GMT+01:00 2012, expiration time : Thu Jan 12 16:37:35 GMT+01:00 2012

@seenthis Petit problème de certificat ?

Et voilà, c’est corrigé.

►http://progval.net/static/SeenDroid/SeenDroid-0.1-a5.apk

Ça, c’est dû au fait que dans la #API_Seenthis, il n’y a pas de réelle distinction entre un message et un commentaire. Donc les commentaires apparaîssent sur ta page comme des messages normaux.
Mais je peux faire en sorte de filtrer, si tu penses que c’est mieux.

Effectivement, je n’avais pas envisagé cette éventualité.

Mais parfois, c’est utile de pouvoir répondre à un commentaire. Certains blogs Wordpress le permettent ; et quand on n’imbrique pas trop, ça permet de suivre plus facilement une discussion animée.
Ce qu’il faudrait, c’est que cette imbrication soit affichée sur l’interface Web.

Elles n’y sont pas. Mais oui, c’est ce qu’il faudra faire. (Je suis un peu en apné, ces temps-ci.)

Petit ajout à la liste (en première ou deuxième position, je pense) : pouvoir récupérer la liste des réponses à un message : ►http://tools.ietf.org/html/rfc4685#section-4 . Parce que là, je suis un peu coincé pour l’implémenter dans mon client.

Autres ajouts (oui, je suis lourd, mais ça fait une todo-list) :
Recherche de tags
Récupération des messages ayant un lien donné (équivalent du triangle)

@seenthis

Bon, visiblement, quand on encode du Base64 en Java, ça ajoute un saut de ligne à la fin. Et le serveur ne comprend pas qu’il y ait deux sauts de lignes à cet endroit (ce qui est tout à fait logique).

Donc, maintenant, j’ai une belle requête :

GET /api/messages/20 HTTP/1.1
User-agent : SeenDroid
Authorization : Basic UHJvZ1ZhbgrgrZ3GGF2s=
Host : seenthis.net

J’utilise Emacs mais pas org-mode. Un mode Seenthis me permettant de lire/écrire Seenthis depuis Emacs serait certainement très utile.

Justement, il me semble y’avoir pas mal de points communs entre la structure des informations sous org-mode et sous SeenThis (bon c’est du classique : titre, citation, tags, propriétés...).

Du coup j’ai préféré partir d’un existant (qui plus est de très grande qualité de mon point de vue) plutôt que de réinventer la roue, ce que de toutes manières je n’aurais pas su faire vues mes compétences en emacs lisp.

(toujours sur Mac) Cette fois il faut installer « XML Startlet », que je n’ai pas trouvé.

Faire un client REST+XML en shell Unix était en effet peut-être un peu trop vicieux...

Mais XML Starlet est en
►http://xmlstar.sourceforge.net

ah ouiche ; alors... ./configure ; make => palanquée d’erreurs ; je crains ne pas être assez motivé pour aller plus loin :-/

Nouvelle version (qui ne résoud pas le problème de @Fil mais qui a l’avantage de tester s’il y a quelque chose sur l’entrée standard, avant d’appeler l’éditeur, ce qui permet de l’appeler avec ’seenthis < /mon/fichier/deja/pret’)

AtomEnabled, doc pour les développeurs :
►http://www.atomenabled.org/developers

C’est ce que j’ai trouvé de plus clair pour l’instant.

Les <entry> ATOM gagnent plusieurs éléments :
– <updated> est complété par <published> (pour l’instant, valeurs identiques) ;
– <link rel="edit">, pointe vers l’URL du message dans l’API ;
– une série de <link rel="related"> des différents liens contenus dans le billet. Contient aussi le titre de l’article lié et sa langue.

Ajouté les <category> pour les thèmes dans les entrées ATOM.

Serait-il possible de renvoyer un 401 (not authenticated) plutôt qu’un 405 (user unknown) si l’utilisateur n’est pas identifié ? Un certain nombre de frameworks REST ne transmettent l’authentification que lorsque celle-ci est demandée (car une des possibilités est de demander ses « credentials » à l’utilisateur à ce moment là).

OK, @samuel : l’erreur d’identification passe en 401. Au passage, j’ai corrigé l’expédition des headers des erreurs.

C’est très galère, ce système de cadencement, 25 entrées à la fois. Pour avoir un flux Atom complet de toutes les entrées, cela oblige à faire une boucle, et, comme on ne peut pas simplement concaténer les résultats, à analyser l’ATOM, refaire un flux ATOM en mémoire et le re-sérialiser :-(

Je viens de mettre en œuvre la fonction de récupération d’un message (en donnant le message-ID) dans seenthis-python ►https://github.com/bortzmeyer/seenthis-python Ce service est accessible via la bibliothèque, ou bien via le script seenthis-get-msg.py qui produit un fichier au format ATOM.

Pour les curieux, c’est ce commit-là : ►https://github.com/bortzmeyer/seenthis-python/commit/678025db4b

Ne veux-tu pas en faire un gist, même si tu ne veux pas faire de dépôt formel ?

L’API est en mouvement très rapide, donc j’hésite un peu. Pour la prochaine version ?

Ôtes-moi un doute, un gist, c’est bien ►https://gist.github.com

git diff origin/<base branch> > patch.diff
git log --reverse --pretty=format:"%B" <my branch> --not <base branch> > log.txt
git reset --hard origin/<base branch>
git apply patch.diff

Sur #Mac_OS_X il faut installer #SimpleTAL (en 4.3 car c’est #python_2.6) :
# wget ►http://www.owlfish.com/software/simpleTAL/downloads/SimpleTAL-4.3.tar.gz
# tar -xzf SimpleTAL-4.3.tar.gz
# cd SimpleTAL-4.3
# sudo python setup.py install —install-scripts /usr/local/bin
# echo “ouais” | seenthis

@stephane : à ton avis ?

Sous un Gist (de GitHub) il y a un dépôt Git qui conserve l’historique et auquel tu peux accéder soit par le web soit par Git. Tu commence donc sur le web avec un copier-coller, et tu peux continuer par copier-coller ou avec Git.
Quand ton projet prend de l’importance (ou que tu veux permettre à d’autres de contribuer avec GitHub avec les forks), il te suffit de créer un vrai projet GitHub et d’y pousser ton Gist. Tu gardes ainsi tout l’historique de ton Gist.
C’est ce que j’ai fait avec ►https://gist.github.com/553703 (un simple script which.cmd) qui est devenu Win32::App:which ►https://github.com/dolmen/Win32-App-which-perl

Fait pour le deuxième client :-) ►http://seenthis.net/messages/14713

De quoi enrichir le plugin Microblog peut-être... ;-)

Je verrais plutôt Notification. Microblog, comme son nom l’indique, fait du microblogging : ce que n’est justement pas Seenthis.

Je ne suis franchement pas partisan de déverser automatiquement des messages de 140 caractères avec des URL bitlysées sur Seenthis.

Le #plugin #SPIP « Notifications avancées », que je devrais bientôt poster, a une extensibilité sur les modes d’envoi. On peut donc très facilement ajouter un nouveau mode d’envoi /notifications/modes/seenthis.php qui enverra la notification sur #Seenthis.

À un petit message d’erreur près, ça fonctionne comme tu le dis ; j’arrive à créer un message et à le modifier en CLI : ►http://pastebin.com/h5NiHjC4

Mouais, mais on débogue en aveugle, ce qui est dur. J’avais oublié de mettre le Content-Type et il n’y a aucun message d’erreur (simplement, l’entrée n’est pas créée). Je crois que le plus urgent serait le traitement d’erreur.

Liste de quelques clients AtomPub : ►http://intertwingly.net/wiki/pie/Implementations Je n’ai malheureusement pas réussi à en faire fonctionner un pour valider l’implémentation d’AtomPub.

J’ai amélioré la gestion des erreurs :
– c’est désormais passé dans une page Web complète avec un header 405 (et description dans la page) ;
– ça détecte l’absence de content-type.

Par ailleurs, un mauvais formatage de <entry> est corrigé automatiquement (si on ne met pas les bons xmlns, notamment celui qui permet d’utiliser le thr:in-reply-to, ça passe quand même).

Les erreurs signalées pour l’instant :
– Please use https
– Unknown user
– Wrong content-type (n’accepte que application/atom+xml et application/xml)
– Unexpected error - not saved in base (l’insertion dans la base n’a pas fonctionné).

Ah oui, le déboguage est bien plus cool désormais.

Je viens de développer un petit programme #Python qui me permet enfin de poster comme je veux. Parfait. Il est en ►http://seenthis.net/messages/14539

Un autre client, en shell Unix, interactif
►http://seenthis.net/messages/14713

Ben tiens : y’avait des bugs. L’interaction avec le formulaire n’est pas franchement triviale.

En fait, le site est également accessible en https, mais je n’ai rigoureusement rien fait pour obtenir un certificat. On peut donc se connecter également ainsi (le -k pour sucrer la vérification du certificat) :

curl -uUSER:PASS -k ►https://seenthis.net/?page=xml_export > seenthis_backup.xml

Est-ce que, au moins, cela permet de crypter l’échange et de ne pas balancer son mot de passe en clair sur le réseau ?

oui - c’est déjà un plus ; je corrige ; et je mets ρ à la place de p pour que le code ne soit pas bouffé par seenthis :-)

Oh !? Super ça: On peut donc itérer dessus !

@suske tu es désigné d’office pour écrire la boucle (SEENTHIS)

La boucle SEENTHIS donc :

<B_x>
#PAGINATION
<BOUCLE_x(DATA){source xml,seenthis_backup.xml}
{pagination 10}>
[<h2>(#VALEUR{0/message/0/author/0})</h2>]
[(#VALEUR{0/message/0/text/0}|nl2br|propre)]
</BOUCLE_x>

et pour afficher les threads avec les réponses :

<B_x>
#PAGINATION
<BOUCLE_x(DATA){source xml,seenthis_backup.xml}
{pagination 10}>
<hr />
<a href="#HREF">#HREF </a>
<BOUCLE_t(DATA){source array,#VALEUR{0}}>
[<h2><a href="#VALEUR{0/author/href}">(#VALEUR{0/author/0})</a></h2>]
[(#VALEUR{0/date/0})]
[(#VALEUR{0/text/0}|nl2br|propre)]
</BOUCLE_t>
</BOUCLE_x>

#seenthis_todo : l’export xml de #seenthis ne contient pas la date des messages
[ màj : #seenthis_done ]

BOUCLE(SEENTHIS) suite : on peut travailler directement sur l’URL du backup
<BOUCLE_x(DATA){source xml, httρs ://USER:PASS@seenthis.net/ ?page=xml_export}>

par défaut le backup sera rafraîchi toutes les x heures (à condition d’avoir installé le plugin memoization). On peut régler ce défaut par un critère supplémentaire {datacache 3600}.

J’ai l’impression qu’il y a deux commandes pour récupérer ses seens, celle avec ►https://seenthis.net/?page=xml_export qui produit un format que je ne reconnais pas et celle avec ►https://seenthis.net/api/people/USERNAME/messages qui produit de l’Atom. Quelle est l’articulation entre les deux ?

[Insérez ici un gros troll « SeenThis, c’est le bordel ».]

@stephane
plein de bonne volonté, je regarde ces différentes choses.
En allant sur cette page, je récupère des seens mais seulement le mois en cours.
Par ailleurs, j’ai téléchargé python mais je suis totalement novice et malgré l’aide de mon fils qui a déjà joué avec cela, je ne parviens à lancer les scripts et je ne comprends où enregistrer les fichiers avec les paramètres de connexion.

#api_seenthis