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 flag =-l= or =--list-spaces=:
#+BEGIN_SRC sh
spacedirectory -l
#+END_SRC

**** Get infos of a space

Simply write the space name:
#+BEGIN_SRC sh
spacedirectory "space name"
#+END_SRC

**** Get infos of a space api

With option =-a= or =--api=:
#+BEGIN_SRC sh
spacedirectory -a "api url"
#+END_SRC

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

With flag =-j= or =--json=:
#+BEGIN_SRC sh
spacedirectory "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.

Source Distribution

spacedirectory-0.0.3.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

spacedirectory-0.0.3-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

Details for the file spacedirectory-0.0.3.tar.gz.

File metadata

File hashes

Hashes for spacedirectory-0.0.3.tar.gz
Algorithm Hash digest
SHA256 b2d2adf83bb07657370b8510762ed334442e9efa6e8658b2e5855432d97a1466
MD5 75ad55e1b36e002d4421fff35ffafa4d
BLAKE2b-256 f58d54ccc54280569ec70893a0638bc82e7f02da8db1e8af473324a0a4d8adc1

See more details on using hashes here.

File details

Details for the file spacedirectory-0.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for spacedirectory-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c01dbf59fe2e6eea454ab15fd0921be15bc6c3c7b1df7d3b5a5b833a3c7f1dd8
MD5 1b807b00ca27e91d673c8461aea80819
BLAKE2b-256 270128ec47caeb6c9eb0524e2fd2604c11de2ec7be1aa354b3d289e60678d83e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page