Difference between revisions of "Activities/FileShare"

From Sugar Labs
Jump to navigation Jump to search
 
(34 intermediate revisions by 5 users not shown)
Line 8: Line 8:
  
 
==Project Status==
 
==Project Status==
The project is under active development.  I am currently looking for bug reports as well as suggestions for further improvement.  Check out the current Dev Release (Dec. 14, 2009) or source code.
+
{{:Activities/FileShare/status}}
  
If you have found a bug, please report it the google group page or email to our google group email address.
+
This activity has been released on activities.sugarlab.org.  At this time, development is pending community feedback and bug reports. I am not actively working on this project, but I am willing to pick it up anytime for bug reports or for feature requests.
 +
 
 +
Bug reports and as well as suggestions for further improvement will be appreciated.
 +
 
 +
If you have found a bug, please report it on sugar's [http://bugs.sugarlabs.org/newticket?component=FileShare&owner=jlew bug tracker] (competent: FileShare, owner: Jlew)
  
 
==Features==
 
==Features==
 
* Activity can be loaded up and files can be added and removed from the file list
 
* Activity can be loaded up and files can be added and removed from the file list
* It can be shared and users who join are able to download files from the file list.
+
* It can be shared and users who join are able to download files (journal entries) from the file list and have them installed into their own journal.
 +
* Activity is able to keep and resume
 +
** On closing, the system asks the user if they wish to keep the files with the activity.  If they do, the files and file list is stored in the activity entry and can be restored.
 +
** One advantage to this is an instance of this activity can be shared and the files remain with it.
 +
* The server is able to copy files back to the journal
 +
** Useful when restoring the activity and would like to get a file back that may have been deleted or modified.
 +
* If there is a server running on the jabber server the xo is connected to, it can upload and download files there
 +
** Server script can be found here: [http://gitorious.org/jlew/xo-file-distro/trees/master/FileShare.server http://gitorious.org/jlew/xo-file-distro/trees/master/FileShare.server]
 +
 
  
 
==Bugs==
 
==Bugs==
* Sometimes user interface can become un-responsive during file transfers.
+
Please report bugs using sugars [http://bugs.sugarlabs.org/newticket?component=FileShare&owner=jlew bug tracker] Component: File Share, Owner: Jlew
 +
 
 +
* Sharing a file, remove it, then trying to re-add it states that the file is already shared.
 +
** This was intentional, when a file is removed, it is removed from lists, but the file still existing for anyone who is currently downloading the file. I plan on allowing the file to be re-added and then just have any clients who are downloading to ignore the file being added again.
 +
 
 +
[http://bugs.sugarlabs.org/query?component=FileShare View Reported Bugs on Bug Tracker]
  
 
==Future Plans==
 
==Future Plans==
Line 26: Line 43:
 
** Prevent/Notify user from closing the activity while users are downloading from them.
 
** Prevent/Notify user from closing the activity while users are downloading from them.
  
* Activity should be able to save its state
+
* Update server script
** Next time it loads up, the activity should be able to restore the file list and continue sharing.
+
** Keep list of who uploaded file
** This feature would be helpful for a teacher to save files related to the day's lesson and then be able to recall it at a later time.
+
** Maybe add a private upload option that does not show to all users
 
 
* Integration to the school server
 
** Current plans are to have a server running on the school server as well allowing authorized users to upload files to the school server as well.
 
  
 
===UI===
 
===UI===
* Download All Button
+
* Display icons for the journal entry type
* Download file in each row instead of selecting each file then clicking download
 
** Alternatively, support selecting multiple rows and then click download.
 
  
 
==Change Log==
 
==Change Log==
2009-12-14: FileShare-2.xo
+
[[Activities/FileShare/ChangeLog|Detailed Change Log]]
* Added Localization Support
+
*2009-12-11: Initial release
* Server notifies client when new file is added
+
*2009-12-14: FileShare-2.xo
* Server notifies client when file is removed
+
*2009-12-15: FileShare-3.xo
** Client ignores remove request when transfer is in progress or completed
+
*2009-12-18: FileShare-4.xo
* Server now deletes file bundle for removed files
+
*2009-12-26: FileShare-5.xo
* Files are now refered to by a sha1 hash instead of int count
+
*2010-01-08: FileShare-6.xo
* Server will attempt to prevent duplicate shared entries
+
*2010-01-12: FileShare-7.xo
** By activity id in datastore metadata
+
*2010-01-19: FileShare-8.xo
** If no activity id in metadata, sha1 file given by get_file_path
+
*2010-01-29: FileShare-9.xo
** If file path is empty, no check can be done, create random sha1 no duplicate check can be done at this time
+
*2010-05-18: FileShare-10.xo
 
 
 
2009-12-11: Initial release
 
  
 
==Links==
 
==Links==
 
* Project Leader: [[User:Jlew| Justin Lewis]]
 
* Project Leader: [[User:Jlew| Justin Lewis]]
* [http://gitorious.org/jlew/xo-file-distro Source code]
+
 
* [http://groups.google.com/group/fileshareactivity File Share Activity on Google Group]
+
===FileShare Activity===
** Group Email Address [mailto:fileshareactivity@googlegroups.com fileshareactivity@googlegroups.com]
+
* [http://activities.sugarlabs.org/en-US/sugar/addon/4266 File Share (activities.sugarlabs.org)]  
** [http://groups.google.com/group/fileshareactivity/files File Builds]
+
** Download
** Screenshots can be found in the google group file list as well
+
** Screenshots
* Current Release: [http://groups.google.com/group/fileshareactivity/web/FileShare-2.xo FileShare-2.xo]
+
* [http://gitorious.org/jlew/xo-file-distro Source Repo]
 +
 
 +
===FileShare Server===
 +
* [[FileShare/Server|FileShare Server Wiki Page]]
 +
* [http://gitorious.org/jlew/xo-file-distro/trees/master/FileShare.server Source code]
 +
 
 +
[[Category:Activities]]

Latest revision as of 10:09, 21 July 2010

Shared activity downloading files

FileShare is an activity that allows the user to share files from their journal.

The activity prompts the user for a list of files. When a user joins the shared activity, they are shown the file list where they can choose which files they would like to download.

The activity was based off a concept activity called Distribute

Project Status

Status: Published/Maintaining
Pending feature or bug requests
Group Members: Justin Lewis
FileShare is an activity that allows the user to share files from their journal.

The activity prompts the user for a list of files. When a user joins the shared activity, they are shown the file list where they can choose which files they would like to download. Files may also be uploaded to a central server if it is running a compatible script.

This activity has been released on activities.sugarlab.org. At this time, development is pending community feedback and bug reports. I am not actively working on this project, but I am willing to pick it up anytime for bug reports or for feature requests.

Bug reports and as well as suggestions for further improvement will be appreciated.

If you have found a bug, please report it on sugar's bug tracker (competent: FileShare, owner: Jlew)

Features

  • Activity can be loaded up and files can be added and removed from the file list
  • It can be shared and users who join are able to download files (journal entries) from the file list and have them installed into their own journal.
  • Activity is able to keep and resume
    • On closing, the system asks the user if they wish to keep the files with the activity. If they do, the files and file list is stored in the activity entry and can be restored.
    • One advantage to this is an instance of this activity can be shared and the files remain with it.
  • The server is able to copy files back to the journal
    • Useful when restoring the activity and would like to get a file back that may have been deleted or modified.
  • If there is a server running on the jabber server the xo is connected to, it can upload and download files there


Bugs

Please report bugs using sugars bug tracker Component: File Share, Owner: Jlew

  • Sharing a file, remove it, then trying to re-add it states that the file is already shared.
    • This was intentional, when a file is removed, it is removed from lists, but the file still existing for anyone who is currently downloading the file. I plan on allowing the file to be re-added and then just have any clients who are downloading to ignore the file being added again.

View Reported Bugs on Bug Tracker

Future Plans

Functionality

  • Clients needs to communicate more to the server. In the current state, the server is not aware of the number of clients currently downloading files.
    • Should show user who is currently downloading what files
    • Download count on each file
    • Prevent/Notify user from closing the activity while users are downloading from them.
  • Update server script
    • Keep list of who uploaded file
    • Maybe add a private upload option that does not show to all users

UI

  • Display icons for the journal entry type

Change Log

Detailed Change Log

  • 2009-12-11: Initial release
  • 2009-12-14: FileShare-2.xo
  • 2009-12-15: FileShare-3.xo
  • 2009-12-18: FileShare-4.xo
  • 2009-12-26: FileShare-5.xo
  • 2010-01-08: FileShare-6.xo
  • 2010-01-12: FileShare-7.xo
  • 2010-01-19: FileShare-8.xo
  • 2010-01-29: FileShare-9.xo
  • 2010-05-18: FileShare-10.xo

Links

FileShare Activity

FileShare Server