Skip to main content

Get informations about (hacker)spaces from the Spacedirectory (or a Space API)

Project description

* Get infos about hackerspaces

Get some informations about hackerspaces, makerspaces, fablabs, etc,
by using the Spacedirectory.org and the Space API.

Provide 2 tools:
- A command line software, nammed =spacedirectory=
- A Python module, also nammed =spacedirectory=, that you can use in
your Python softwares

** Features

*** Command line

- Get the list of spaces from spacedirectory
- Get, in one time, infos of a given space name
- Get infos of a given Space API
- Infos you can get on the terminal (ony what space publish):
- Name
- Website URL
- Status
- If open
- Last time the status changed
- The person who lastly changed the state
- Status message
- Location
- Postal address
- Latitude
- Longitude
- Contact
- Phone number
- SIP URL
- IRC channel URL
- Public Jabber/XMPP multi-user chatroom
- Twitter account
- Identi.ca or StatusNet account
- Mailing list address
- E-mail address for contacting
- E-mail address for issue reports
- Get a dump of space data in JSON (as get from his Space API)

*** Python module

- Compatible with Space API V0.13
- Get the list of spaces, and their Space API URL, from
spacedirectory
- Get a Python object (spacedirectory.Space) with infos of a given
space name or a given JSON data (ony what space publish):
- Name
- Logo URL
- Website URL
- Status
- If open
- Last time the status changed
- The person who lastly changed the state
- Status message
- Open and close logo URL
- Location
- Postal address
- Latitude
- Longitude
- Contact
- Phone number
- SIP URL
- IRC channel URL
- Public Jabber/XMPP multi-user chatroom
- Twitter account
- Identi.ca or StatusNet account
- Mailing list address
- E-mail address for contacting
- E-mail address for issue reports
- Get a dump of spacedirectory.Space data in JSON


** Install

*** From the Python Package Index

#+BEGIN_SRC sh
pip3 install --user spacedirectory
#+END_SRC

Remove the =--user= flag from =pip3= command if you use a virtual
environement, or if you want to install on system side.

*** From source

#+BEGIN_SRC sh
git clone https://framagit.org/SebGen/spacedirectory.git
cd spacedirectory
pip3 install --user .
#+END_SRC

Remove the =--user= flag from =pip3= command if you use a virtual
environement, or if you want to install on system side.

You can also install directly from the source repo:
#+BEGIN_SRC sh
pip3 install --user git+https://framagit.org/SebGen/spacedirectory
#+END_SRC

** Usage

*** Command line

**** Get the list of spaces known by Space Directory

Simply call the program:
#+BEGIN_SRC sh
spacedirectory
#+END_SRC

Or call the program with the command =list=:
#+BEGIN_SRC sh
spacedirectory list
#+END_SRC

**** Get infos of a space

Simply call the program with the command =info= and the space name:
#+BEGIN_SRC sh
spacedirectory info "space name"
#+END_SRC

**** Get infos of a space api

Call the program with the command =info= and with option =-a= or =--api=:
#+BEGIN_SRC sh
spacedirectory info -a "api url"
#+END_SRC

**** Get a dump of an asked space infos in JSON

Call the program with the command =info= and with flag =-j= or =--json=:
#+BEGIN_SRC sh
spacedirectory info "space name" -j
#+END_SRC


*** Python module

See file [[file:doc/modules/usage.org][doc/modules/usage.org]]

** About

*** Space Directory

Space Directory project, or Spacedirectory.org, is a friendly fork
of the [[http://spaceapi.net/][Space API]] project that was started during [[https://en.wikipedia.org/wiki/Chaos_Communication_Congress][33c3]] by people
from [[https://www.coredump.ch/][Coredump]] and [[https://fixme.ch/][Fixme]].

You can find more informations, the Space API specification and
the directory at: https://spacedirectory.org/

*** Space API

The purpose of the Space API is to define a unified REST API
specification across the hackerspaces, makerspaces, fablabs,
chaostreffs and the like across the world that can be used to
expose information to web apps or any other application.

** Licence

GPLv3

** Author

Sébastien Gendre <seb@k-7.ch>



Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for spacedirectory, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size spacedirectory-0.0.5-py3-none-any.whl (17.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size spacedirectory-0.0.5.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page