https://github.com/molybdenum-99/reality
Comprehensive data proxy to knowledge about real world
https://github.com/molybdenum-99/reality
api experimental knowledge opendata wikipedia
Last synced: 6 months ago
JSON representation
Comprehensive data proxy to knowledge about real world
- Host: GitHub
- URL: https://github.com/molybdenum-99/reality
- Owner: molybdenum-99
- License: mit
- Created: 2015-12-06T20:32:52.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-01-21T03:08:52.000Z (almost 3 years ago)
- Last Synced: 2024-05-12T05:02:48.997Z (over 1 year ago)
- Topics: api, experimental, knowledge, opendata, wikipedia
- Language: Ruby
- Size: 5.59 MB
- Stars: 813
- Watchers: 26
- Forks: 43
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - molybdenum-99/reality - Comprehensive data proxy to knowledge about real world (Ruby)
README
Reality
=======
[](http://badge.fury.io/rb/reality)
[](https://gitter.im/molybdenum-99/reality?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
**Reality** is experimental Ruby library/set of libraries to provide uniform query access to heterogenous
web API, with accent on real-world knowledge ones. It emphasizes simplicity of data access and
interoperability of data from various sources.
The ultimate goal is to make the world inspectable and computable.
Some demos:
```ruby
require 'reality' # the core library
require 'reality/miracles' # some demo-friendly shortcuts
# wikipedia
# single entry
cm = Reality.wikipedia.get('Chiang Mai')
# => #
cm.describe
# => #
# meta.title: Chiang Mai
# meta.url: https://en.wikipedia.org/wiki/Chiang_Mai
# meta.image: https://upload.wikimedia.org/wikipedia/commons/7/76/Chiang_Mai_City.png
# ....
# native_name: เชียงใหม่
# ....
# subdivision_type: Country
# subdivision_name:
# subdivision_type1:
# subdivision_name1:
# subdivision_type2:
# subdivision_name2:
# leader_title: Mayor
# leader_name: Tatsanai Puranupakorn
# area_total_km2: 40.22km²
# area_metro_km2: 2,905km²
# population_as_of: 2017
# population_total: 131,091people
# ....
# utc_offset: +07:00
# coordinates: 18°47'43"N 98°59'55"E
# .....
# navigation through data
cm.subdivision_name.describe
# => #
# meta.title: Thailand
# meta.url: https://en.wikipedia.org/wiki/Thailand
# meta.image: https://upload.wikimedia.org/wikipedia/commons/a/a9/Flag_of_Thailand.svg
# native_name: {native name:th|ราชอาณาจักรไทย}, {lang:th-Latn|Ratcha-anachak Thai}
# image_flag:
# image_coat:
# national_anthem: , ({lang-en:"Thai National Anthem"}),
# royal_anthem: , ({lang-en:"Glorify His prestige"}),
# image_map:
# ....
# capital:
# coordinates: 13°45'0"N 100°29'0"E
# ....
# lists of entities
cities = Reality.wikipedia.query(category: 'Cities and towns in Thailand').all
# => [#, #, #, #, #, #, #, #, #, ...
cities.first.population_total
# => #
# Wikidata (structured Wikipedia-alike data storage)
cm2 = Reality.wikidata.query(label: 'Chiang Mai').first
# => #
cm2.describe
# => #
# meta.id: Q52028
# meta.label: Chiang Mai
# meta.description: city in Chiang Mai province, Thailand
# ...
# instance of: ,
# ...
# sister city: , , ,
# GeoNames ID: 1153671
# category for people born here:
# category for films shot at this location:
# category for people who died here:
# Encyclopædia Britannica Online ID: place/Chiang-Mai
# ...
# Interaction Wikipedia→Wikidata:
cm = Reality.wikipedia.get('Chiang Mai')
cm['meta.wikidata'].load.describe
# => #
# meta.id: Q52028
# meta.title: Q52028
# meta.label: Chiang Mai
# ...
# Wikipedia→OpenStreetMap
Reality.osm.query(around: cm, radius: 30_000, aerodrome: 'international').all
# => [#]
# Wikipedia→OpenWeatherMap
Reality.open_weather_map.query(at: cm).first.describe
# => #
# temp: 33°C
# pressure: 1,007hPa
# humidity: 55%
# temp_min: 33°C
# temp_max: 33°C
# visibility: 10000
# wind_speed: 4.6m/s
# wind_deg: 160°
# clouds_all: 40
# timestamp: 2018-05-27 13:00:00 +0300
# country: TH
# sunrise: 2018-05-27 01:46:48 +0300
# sunset: 2018-05-27 14:55:42 +0300
# name: Chiang Mai
# coord: 18°48'0"N 99°0'0"E
```
**!!!IMPORTANT!!!** This is **pre-release** of new, completely rewritten version. Previos version
turned to be a (nice-looking) dead end. It still can be found at [old-prototype](https://github.com/molybdenum-99/reality/tree/old-prototype-branch)
branch, and installed as a gem version 0.0.5.
Current state is very WIP subject to lot of changes
See also the explanatory [presentation](https://docs.google.com/presentation/d/1I4mznHUBhVVDxWfO2DRzxP4wNhs9Mmtx09SizLqIbaE/edit?usp=sharing)
and [video](https://www.youtube.com/watch?v=x9GePP3B0oE), made at RubyConfIndia 2018.
Stay tuned for large and important updates!
## Credits
* [Victor Shepelev](https://zverok.github.io) [@zverok](https://github.com/zverok);
* Sergii Mostovyi [@smostovoy](https://github.com/smostovoy);
* [Valentino Stoll](http://www.awesomevibe.com/) [@codenamev](https://github.com/codenamev);
* [Several great contributors](https://github.com/molybdenum-99/reality/graphs/contributors).
Development of first version was sponsored by
[2015 Ruby Association Grant](http://www.ruby.or.jp/en/news/20160406.html).
Initial idea is inspired by "integrated data" of
[Wolfram Language](http://reference.wolfram.com/language/).
## License
[MIT](https://github.com/molybdenum-99/reality/blob/master/LICENSE.txt)