TechLife devBlog

Zeal - dokumentacja pod ręką

Kodowanie, Linux 31 lipca 2015 00:30

Zeal to inspirowana swoim Mac-owym płatnym odpowiednikiem (Dash) zgrabna przeglądarka dokumentacji dostępna na platformach Linux i Windows. Co ciekawe autorzy obu projektów dogadali się (Zeal reklamuje Dasha) dzięki czemu Zeal korzysta z dokumentacji przygotowanej dla Dash-a.

zeal

Pełną listę dostępnych dokumentacji znajdziecie pod adresem kapeli.com/dash#docsets. Obecnie jest ich ponad 150 i bardzo łatwo można dorzucić samemu kolejne lub podłączyć się do zewnętrznych dostawców.

Kluczowa w Zeal jest jednak integracja z większością znanych edytorów/IDE dzięki czemu dokumentację mamy zawsze pod ręką (zwłaszcza pracując offline), w miejscu gdzie jest nam najbardziej potrzebna.

pluginy

W przypadku Sublime'a instalacja jest banalna, wystarczy odnaleźć odpowiedni plugin i gotowe.

sublime

Po pierwszym uruchomieniu, należy wejść do opcji, przejść na zakładkę docsets i tam wybrać interesujące nas dokumentacje. Po ich pobraniu można już zabrać się za przeglądanie a Zeal będzie na bieżąco śledził ich aktualność.

django

Kiedy chcemy znaleźć dokumentację do interesującej nas komendy z poziomu edytora wystarczy ją zaznaczyć i wcisnąć odpowiedni dla edytora skrót klawiszowy (zazwyczaj F1).

wyszukiwanie w edytorze

Spowoduje to otwarcie Zeal-a dokładnie na szukanej komendzie.

wynik wyszukiwania

Możliwe jest również wyszukiwanie bezpośrednio w odpowiedniej dokumentacji. W tym celu używamy drugiego skrótu (Shift + F1 w przypadku Sublime'a) i wpisujemy odpowiednią formułkę korzystając ze składni kategoria:szukany_obiekt

wyszukiwanie w JavaScripcie

Wyniki zostaną ograniczone do podanej kategorii.

wyniki wyszukiwania w kategorii JavaScript

Pozostało zainstalować i używać, z pewnością przyśpieszy to naszą pracę i zastąpi ciągłe googlowanie. Użytkownikom Archa polecam instalację pakietu zeal-git dostępnego w AUR.

Strona projektu - zealdocs.org

Python, Postgres i aplikacje czasu rzeczywistego

Kodowanie, Python 17 lipca 2015 09:20

Wczoraj trafiłem na bardzo fajną prezentację autorstwa Brenta Tubbsa, która pokazuje jak wykorzystać postgresowego PubSuba, postgresowego JSONa, minimalny backend w Pythonie oraz któryś z popularnych frameworków JS do budowy webaplikacji czasu rzeczywistego.

Link do przykładowej aplikacji - bitbucket.org/btubbs/todopy-pg

pgpubsub - pypi.python.org/pypi/pgpubsub

Społecznościowe manuale

Linux 3 lipca 2015 09:15

Jeżeli stale lub okazyjnie możesz nazwać się użytkownikiem Linuksa to z pewnością znany jest Ci problem niezbyt często wykonywanych komend, których składni nigdy się nie pamięta. Oczywiście można zajrzeć do systemowego manuala, ale najczęściej oprócz ściany tekstu objaśniającej nam wszystkie możliwe parametry nie znajdziemy tam zbyt wielu przykładów użycia. Niestety nie tak łatwo jest wpłynąć na treść systemowych manuali dlatego społeczność rozwinęła własne rozwiązania.

Bropages

Bropages to właśnie jeden z projektów starających się wypełnić dziury w manualach skupiając się wyłącznie na przykładach użycia. Sposób działa jest prosty, wystarczy zainstalować napisanego w Ruby klienta.

$ gem install bropages

Następnie używamy go poprzez wywołanie komendy bro jako argument podając nazwę komendy, której przykładów użycia szukamy.

$ bro zip

5 entries for zip -- submit your own example with "bro add zip"

# Zips up everything in my current directory recursively into the file archive.zip 
zip -r archive.zip *

 bro thanks to upvote (36) 
 bro ...no to downvote (0)

.........................................................................................

# put README.txt and test.c into the zip file named archive.zip 
zip archive.zip README.txt test.c

 bro thanks 2 to upvote (15) 
 bro ...no 2 to downvote (0)

.........................................................................................

# Recursively zip all files in the directory foo into foo.zip 
zip -r foo foo

 bro thanks 3 to upvote (8) 
 bro ...no 3 to downvote (2)

.........................................................................................

# Recursively zip everything, starting from the current directory, that matches the given pattern into archive.zip 
# Note: the `R` flag is case sensitive! 
zip -R archive "*.png" 
zip --recurse-patterns archive "*.png"

 bro thanks 4 to upvote (2) 
 bro ...no 4 to downvote (0)

.........................................................................................

# Use the `unzip` command to extract a zip file, unlike `tar` and `gzip` where you use a command line argument to decompress 
unzip file.zip # Extracts to current directory 
unzup file.zip -d dir # Extracts to specified directory

 bro thanks 5 to upvote (1) 
 bro ...no 5 to downvote (0)

Jeżeli któraś podpowiedź przydała się w naszym przypadku, możemy na nią zagłosować wydając odpowiednią komendę. Jeżeli robimy to po raz pierwszy, będziemy poproszeni o wpisanie kodu autoryzującego wysyłanego na nasz adres e-mail.

$ bro thanks 2 
Bropages.org requires an email address verification to do this 
What's your email address? 
tomasz@karbownicki.com 
Great! We're sending an email to tomasz@karbownicki.com 
Please enter the verification code: xxxxx
Great! You're verified! FYI, your email and code are stored locally in ~/.bro 
You just gave thanks to an entry for zip! 
You rock!

Przykłady użycia danej komendy sortowane są według ilości głosów, dzięki czemu najczęstszej używane przypadki mamy na pierwszym planie.

Oczywiście jeżeli czegoś nam brakuje, obojętnie czy jest to kolejny przykład użycia na istniejącej stronie czy rozpoczęcie nowej strony manuala, możemy to zrobić w bardzo prosty sposób.

$ bro add zip

Po wydaniu tej komendy otworzy nam się domyślny edytor, wraz z szablonem przykładu użycia. Wystarczy uzupełnić i gotowe.

Więcej zastosowań bro możecie obejrzeć w samym bro :-]

$ bro bro

Warto też przejrzeć stronę projektu - bropages.org

TLDR

TLDR (too long didn't read) to kolejne, tym razem wieloplatformowe rozwiązanie problemu nieprzyjaznych manuali. Obecnie mamy do dyspozycji klienty dla:

Mi najwygodniej użyć Pythona.

$ pip install tldr

Po instalacji korzystamy analogicznie jak z bro.

$ tldr curl

# curl

 Transfers data from or to a server 
 Supports most protocols including HTTP, FTP, POP

- Download a URL to a file

 curl "{{URL}}" -o filename

- send form-encoded data

 curl --data {{name=bob}} {{http://localhost/form}}

- send JSON data

 curl -X POST -H "Content-Type: application/json" -d {{'{"name":"bob"}'}} {{http://localhost/login}}

- specify an HTTP method

 curl -X {{DELETE}} {{http://localhost/item/123}}

- head request

 curl --head {{http://localhost}}

- pass a user name and password for server authentication

 curl -u myusername:mypassword {{http://localhost}}

Współpraca nad treściami manuali odbywa się tu odmiennie niż w bro. Klient nie ma możliwości modyfikacji czy głosowania, jeżeli chcemy zaproponować jakieś zmiany należy klasyczną metodą stworzyć na GitHubie pull request, który następnie przejdzie przez review autorów projektu. Każda komendą w repozytorium to osobny plik w formacie Markdown, więc można szybko odnaleźć miejsce, które chcemy zmodyfikować. Sam klient pobiera manuale bezpośrednio z GitHuba, więc wszystkie dokonane zmiany są od razu po zatwierdzeniu dostępne dla użytkowników.

Strona projektu - github.com/tldr-pages/tldr

Dlaczego Django ssie

Kodowanie, Django 2 lipca 2015 22:15

Jeżeli ktoś jeszcze nie widział bardzo fajnej prezentacji Emila (e-mail'a) Stenströma na temat obecnego stanu rozwoju Django to polecam. Konstruktywny hate obecnych braków chyba najpopularniejszego pythonowego frameworka. W pełni się zgadzam.

11 bitów wojny

Internet 17 listopada 2014 19:44

Byłem w weekend na Hall of Games gdzie miałem okazję zobaczyć prelekcję Marka Ziemaka - Wojna, wojna się zmienia. Nawet nagrałem całe wystąpienie, IMHO nie było super porywające ale jak kogoś by interesowało to mogę wrzucić na YouTube. Ale nie o tym...

Dzisiaj 11 bitowcy znaleźli się na ustach gamerów z całego świata a to za sprawą jednego komentarza dodanego na The Pirate Bay.

Komentarz Karola

Czyżby 11 bitowcy zaatakowali pozycję CD Projekt RED, tak cenionych przez gamerów? W każdym razie giełda ich wynagrodziła :-)

3 dni: +61.12%

Warto też zwrócić uwagę na odzew:

komentarz: goldbr

komentarz: Mooe

Ludzie kupili grę nie dlatego, że jest ciekawa (chociaż jest), ale dlatego, że ktoś pozwolił im świadomie wybrać. I takie postawy warto promować.

Przy okazji gameplay:

A teraz przeciwwaga, jak to się robi w ministerstwie: Ripowanie na własny użytek powoduje straty - oto stanowisko ministerstwa! AWI

Mój kraj jest taki piękny

Dziękuję, dobranoc.

Strona 1 z 41 | Starsze »