phyks
/
flatisfy
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
65 Commits 8 Branches 0 Tags 15 MiB
Python 81.5%
Vue 11.6%
JavaScript 5.8%
HTML 0.4%
Shell 0.3%
Other 0.4%
Go to file
Lucas Verney 78b9ebf04e Better handling of phone links 
Some Weboob backends were returning multiple phone numbers
(comma-separated) or phone numbers in different formats (with or without
spaces, with or without separating dots, etc).

This commit harmonizes all of this so that all phone links will be
rendered correctly and be usable to call in a single click.

Related, https://git.weboob.org/weboob/devel/merge_requests/42.
 		2017-06-20 14:20:54 +02:00
.ci Styling update, fix some Pylint errors 2017-04-13 23:22:11 +02:00
doc Add some doc about CLI option and better informative message 2017-06-19 17:20:53 +02:00
flatisfy Better handling of phone links 2017-06-20 14:20:54 +02:00
hooks Switch to a Vue-based web app 2017-05-03 15:54:26 +02:00
.babelrc Switch to a Vue-based web app 2017-05-03 15:54:26 +02:00
.eslintrc Switch to a Vue-based web app 2017-05-03 15:54:26 +02:00
.gitignore Status of flats was not correctly set at first import 2017-05-04 15:33:20 +02:00
CONTRIBUTING.md Rewrite data files management, to make it more modular 2017-06-15 15:48:16 +02:00
LICENSE.md Initial commit 2017-04-13 20:03:59 +02:00
README.md Add a note about IRC channel 2017-06-20 11:04:05 +02:00
package.json Write some documentation 2017-05-03 15:54:59 +02:00
requirements.txt Fix typo in requirements.txt, should be request*s*. 2017-05-21 21:48:14 +02:00
webpack.config.js Write some documentation 2017-05-03 15:54:59 +02:00
wsgi.py Switch to a Vue-based web app 2017-05-03 15:54:26 +02:00

README.md

Flatisfy

Flatisfy is your new companion to ease your search of a new housing :)

Note: This software is under heavy development at the moment, and the database schema could change at any time. Do not consider it as being production ready. However, I am currently using it for my own housing search and it is working fine :)

It uses Weboob to get all the housing posts on most of the websites offering housings posts, and then offers a bunch of pipelines to filter and deduplicate the fetched housings.

It can be used as a command-line utility, but also exposes a web API and visualisation, to browse through the results.

Note: It is targeted at French users (due to the currently supported websites), and in particular at people living close to Paris, as I developped it for my personal use, and am currently living in Paris :) Any feedback and merge requests to better support other countries / cities are more than welcome!

Note: In this repository and across the code, I am using the name "flat". I use it as a placeholder for "housing" and consider both are interchangeable. This code is not restricted to handling flats only!

Getting started

See the getting started guide.

Documentation

See the dedicated folder.

Screenshots

Home page

Display available flats on a map:

And list them with the details in a sortable table:

Details page

Uniform display of the flat information in a dedicated page, with the contact etc:

Follow flats

Track interesting flats and store them with notes:

OpenData

I am using the following datasets, available under flatisfy/data_files, which covers Paris. If you want to run the script using some other location, you might have to change these files by matching datasets.

  • LaPoste Hexasmal for the list of cities and postal codes in France.
  • RATP (Paris) stations for the list of subway/tram/bus stations with their positions in Paris and nearby areas.
  • Tcl (Lyon) stations for the list of subway/tram/bus stations with their positions in Paris and nearby areas.

Both datasets are licensed under the Open Data Commons Open Database License (ODbL): https://opendatacommons.org/licenses/odbl/.

License

The content of this repository is licensed under an MIT license, unless explicitly mentionned otherwise.

Contributing

See the CONTRIBUTING.md file for more infos.

Support

Feel free to open issues. An IRC channel is available at irc://irc.freenode.net/flatisfy as well.

Thanks

  • Weboob
  • The OpenData providers listed above!
  • Navitia for their really cool public transportation API.
  • A lots of Python modules, required for this script (see requirements.txt).
  • Kresus which gave me part of the original idea (at least proved me such software based on scraping can achieve a high quality level :)
  • Current favicon is from Wikipedia