Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

The App Engine server, written in Python

branch: master
Octocat-spinner-32 js A couple of JS fixes for the stats dashboard. August 17, 2011
Octocat-spinner-32 .gitignore Updated README. Removed some junk files. Added a gitignore. Updated A… July 02, 2011
Octocat-spinner-32 LICENSE.md Updated README and moved LICENSE to have the Markdown extension. August 04, 2011
Octocat-spinner-32 README.md Updated links in README. August 04, 2011
Octocat-spinner-32 app.yaml Removed appstats. Fixes #20. August 17, 2011
Octocat-spinner-32 auth.py Applied PEP8 to all python files. July 08, 2011
Octocat-spinner-32 bulkloader.yaml Added a bulkloader file. Also updated the set quota page to stop erro… August 10, 2011
Octocat-spinner-32 channels.py Much smarter sending of links; will prevent the backlog overflow situ… September 05, 2011
Octocat-spinner-32 cron.yaml Added a cron job to set stats to 0 for the hour/day, so we get datapo… July 09, 2011
Octocat-spinner-32 dashboard.html Fixed a bug that would increment totals twice on the stats page. August 17, 2011
Octocat-spinner-32 devlinks.py Added new API endpoint for Android to check its time against. September 08, 2011
Octocat-spinner-32 devlinks_index.html Updated devlinks_index.html to allow links to be marked as read. Conf… July 08, 2011
Octocat-spinner-32 error.html Added custom templates for errors. Will allow clients to respond to e… July 10, 2011
Octocat-spinner-32 hard_quota.html Added custom templates for errors. Will allow clients to respond to e… July 10, 2011
Octocat-spinner-32 index.yaml Limited the number of results shown on the stats dashboard. July 10, 2011
Octocat-spinner-32 models.py Finally worked out the bugs in active users. Fixes #40. August 17, 2011
Octocat-spinner-32 queue.yaml Added a stats system in the background that will silently collect usa… July 07, 2011
Octocat-spinner-32 quota.html Added a datastore model for the quota, along with some convenience me… July 10, 2011
Octocat-spinner-32 stats.py Created a timestamp library to convert everything to Pacific time, so… July 10, 2011
Octocat-spinner-32 subscribe.html Added a stats system in the background that will silently collect usa… July 07, 2011
Octocat-spinner-32 timestamp.py Created a timestamp library to convert everything to Pacific time, so… July 10, 2011
README.md

2cloud App Engine Server

About

2cloud is a free, decentralised, open source project to try and make sharing content between browsers and devices as seamless and effortless as possible. An up-to-date list of devices and browsers supported by the project is available at http://www.2cloudproject.com/clients

This is the App Engine software that powers our public server at https://2cloudapp.appspot.com. We provide it here as a reference for implementing your own server software for the project and as a plug and play package for users who want to host their own servers, but don't necessarily want to write their own server.

Installation Instructions

We tried to make installation as streamlined as possible. You just need to download the source (use git, or the download button) and change the identifier in app.yaml. Then use the App Engine SDK to sync it just like you normally would.

Where to Get Help

We try to maintain a presence with our users. To wit, we have:

If you don't use any of those... you're kind of out of luck.

Contribution Guidelines

The quickest, easiest, and most assured way to contribute is to be a beta tester. Simply join the mailing list and wait for a new beta to be released. Try and break it. Submit feedback. Wash, rinse, repeat.

If you're interested in contributing code, we use different guidelines for each part of our app. This is driven by necessity; you can't use PEP-8 on Java, for example. Our App Engine guidelines are simple:

  • If possible, have unit tests written for what you're patching
  • Explain clearly in your pull request what you're patching and why
  • Make sure your code follows the style laid out in PEP-8

That's pretty much it. We're laid back. The best way to figure out what's on our to-do list is to look at the issue tracker or ask on the dev mailing list. Whatever you work on should be something you want to see implemented, though.

Contributors

2cloud is an open source application. It is technically "owned" by Second Bit LLC, but all that really means is they take care of the mundane administrative and financial stuff. The team behind 2cloud is separate from the Second Bit team (despite some overlap). The 2cloud team is as follows:

They're pretty friendly. Please do get in touch!

Credits and Alternatives

One of the great parts about being an open source project is how often we get to stand on the shoulders of giants. Without these people and projects, we couldn't do what we do.

  • blog.notdot.net (basis of stats system)
  • docs.python.org (basis of timestamp.py)
  • jQuery (Stats dashboard)
  • Chrome to Phone (Inspiration)

There are some alternatives to 2cloud out there, and we encourage you to try them out. Use what works best for you. You can find an up-to-date list on our website.

Something went wrong with that request. Please try again.