hpi-swa-teaching / scamper Goto Github PK

View Code? Open in Web Editor NEW

16.0 8.0 4.0 11.4 MB

A Smalltalk Web Browser for Squeak/Smalltalk

License: MIT License

Shell 0.25% Smalltalk 59.12% HTML 40.63%

smalltalk squeak web-browser

scamper's Introduction

Scamper Web Browser

Scamper is a Web Browser for the Squeak enviroment.

Installation

Drag the SAR file scamper.sar into Squeak, choose "Install SAR".
Run Scamper install in the Workspace.

Using Scamper

There are several ways to open Scamper:

Open Scamper by running Scamper open in the Workspace. The default page will be shown.
Run Scamper openOnUrl: 'http://google.com' asUrl in the Workspace with any given URL, e.g. http://google.com.

or simply

Open Scamper via Apps. The default page will be shown.

scamper's People

Contributors

Stargazers

Watchers

Forkers

pavel-krivanek linqlover andrezeero0228 aleksrutins

scamper's Issues

Add line-height support

Text elements should support the line-height attribute.

Has to cooperate with font-size rendering, see #99

Notify user if anything cannot be displayed (correctly)

I would like to get a notification if a webpage contains anything Scamper cannot display (correctly). This requires Scamper to notice it cannot display something.

E.g. javascript currently:

Estimated effort: 85

Add CSS box model rendering

Contents in websites should have correct borders, margins and paddings as well as a correct size.

Contains support and tests for:

Estimated effort: 377

Make flash working again

As a user, I want to be able to watch flash videos and play flash games inside the browser.

Refactor threading for better testability

As of now, it is difficult for tests to detect when website content has been completely downloaded by Scamper. Using the step method to trigger processing the downloaded content also makes debugging hard.

My suggestion: Use the Promise class to encapsulate a background task that returns a result. Promises can be synchronously awaited (useful for tests) and chained. To update the UI after a download (on the correct thread), WorldState>>addDeferredUIMessage could be used.

Here's an example of how to use the Promise class:

printStatus := [ :value | 
    Transcript show: 'Value: ' , value ,
                     ' on process ' , Processor activeProcess name; 
               cr ].

printStatus value: 'Starting...'.

promise := Promise new.
finalPromise := promise then: [ :value |
    (Delay forMilliseconds: 500) wait.
    value := value + 1.
    printStatus value: value.
    value ].

[  "long running operation..."
   (Delay forMilliseconds: 500) wait.
   printStatus value: 1.
   promise resolveWith: 1] forkAt: Processor userBackgroundPriority.

result := finalPromise wait.
printStatus value: 'Finished with ' , result

Output:

Value: Starting... on process 10147
Value: 1 on process 25034
Value: 2 on process 25034
Value: Finished with 2 on process 10147

Add CSS support

Cascading style sheets should be loaded from style tags and referenced css files.

Contains support and tests for:

style attribute
basic css tokenization

Estimated effort: 490

Add list support

Ordered and unordered lists should be displayed with arabic numbers and bullets respectively.

Contains support and tests for:

Estimated effort: 164

Add download manager

As a user, I would like to use a download manager to manage my downloads.

The webClient library returns a MIME type. Use this information to select whether the file should be displayed or downloaded.

Add horizontal rule support

Horizontal rules that are used for content segmentation should be displayed as horizontal line.

Contains support and tests for:

Estimated effort: 74

Add Unicode support

Unicode characters should be displayed correctly (e.g.: http://google.de/intl/de/about.html)

Estimated effort: 224

Remove Flash support

Since the classes FlashFileReader and FlashMorphReader used for flash support are no longer included in the Squeak image, flash support should be removed.

Estimated effort: 15

Add CSS selector support

CSS selectors should apply to their corresponding elements.

Contains support and tests for:

id
tag name
class
hierarchy

Estimated effort: 250

Add image tag support

Scamper should display images in Websites correctly.

Contains support and tests for:

image
alt
height
width

Estimated effort: 159

Improve HTML parsing

The browser shouldn't display content it didn't properly recognize as text. Displaying this text disrupts the reading of the website.

Estimated effort: 120

Fix MIME-type recognition

Visiting http://acid2.acidtests.org will generate an application/octet-stream failure. Scamper should recognize this as a valid webpage (e.g. text/html).

Estimated effort: 40

Add table support

Tables in a website should be displayed and have distinguishable head cells and content cells.

Contains support and tests for:

Estimated effort: 281

Bug: Error for embedded HTTPS

Scamper will show an error when visiting an HTTP website with an embedded HTTPS document or image.

(e.g.: http://www.heute.de)

Add font-family support

Text elements should support the font-family attribute.
Basic fonts such as Times, Verdana or Arial/Helvetica should be supported.

Add link target _blank support

Links (a tag) should support the _self and _blank target attributes.

_self
_blank

Remove worker count

The browser should not provide the possibility to edit the number of workers and should in fact not display the number at all, because I do not understand the meaning and effect of this property. The browser should therefore provide a good default value and work correctly without me having to adjust this value.

Estimated effort: 10

Add link support

When a website contains a link, it should be displayed clickable and should be recognizable as link by being blue, underlined and changing the cursor into a pointer on mouseover. When the user clicks the link, Scamper should navigate to the referenced Webpage or initiate a download if the referenced document is not a html document.

Contains support and tests for:

Estimated effort: 50

View videos

As a user, I would like to watch videos in the web browser

Add HTTPS support

In order to communicate securely using Scamper, I'd like to have HTTPS capabilities.

Estimated effort: 272

Remove editable start page

As a user, I don't need to have a personal start page, and I don't need to edit its HTML source code.

Contains Todos:

"Home"-Button should redirect to home page (browser:about instead of browser:start)
Remove browser:start alias
Remove context menu entries: edit start page, go to start page

Possible followup task: add ability to change the start page url

Add settings window

Browser settings (such as worker count, start page) should be set in a central settings window.

Should we extend the Squeak Preference browser (Tools -> Preferences) or have our own window?

Estimated effort: 150

Add text-align support

Text elements should support the text-align attribute.

Add text-decoration support

Text elements should support the text-decoration attribute and render underline and line-through correctly

Bug: HTML codes should be displayed correctly

Basic HTML characters such as or german umlaute (e.g. Ä = Ä, ...) are not rendered to the correct characters but displayed directly.

Add CSS color support

Text-, border- and background-colors should be displayed correctly

Contains support and tests for:

Estimated effort: 212

Add HTML-entity support

HTML-entities (such as or umlaute) should be displayed correctly

Add CSS background-image support

Background images should be displayed correctly.

Contains support and tests for:

background-image
background-repeat
background-position

Estimated effort: 229

Issue POST requests correctly

As a user in order to use search engines I want to submit a search query.

Google's search box doesn't work - is this a problem of POSTs in general or with the specific website?

Estimated effort: 85

Access relative URLs

Scamper should be able resolve all correct links embedded in an html document (e.g. those from http://de.selfhtml.org/html/verweise/anzeige/index.htm) without any NameLookupFailure.

Estimated effort: 30

Add CSS Text formatting

CSS-formatted text should be displayed correctly, including font and text styles.

Contains support and tests for:

font-size
font-style
font-weight

Estimated effort: 150

Change style of browser buttons

The browser's gui should look like all other Squeak system windows as it should integrate well in the Sqeak image. Therefor the buttons in Scamper should have the same appearance as buttons in other system windows.

Add form support

Forms should be correctly parsed and be completionable and sendable.

Contains support and tests for:

Estimated effort: 382

Add frame support

Frames should be supported to show sub-webpages inside a webpage

Contains support and tests for:

frameset
frame
iframe

Don't display HTML comments

HTML comments shouldn't be displayed.

Example can be seen at http://msn.com/

Refactor existing code

In order to have an exciting browsing experience as a user, I want to use a browser that is sufficiently tested.

Todos in detail:

Write unit tests for the HTML-Package
Write unit tests for the Scamper-Package
Remove unused code and refactor if necessary for testing

Add text and headline support

Text content of web pages should be displayed in paragraphes, headlines as larger and bolder text. Special text contents that do not have a clear visual representation (such as quotes) or do represent additional special HTML-based formatting (such as font, tt, kbd, ...) may be rendered as standard text instead.

Contains support and tests for:

p
br
h1-h6

May contain support for:

Estimated effort: 286

Add tabs

As a user, I am used to being able to open different web pages on several tabs.

See #58

Replace HTML and CSS parser with HTMCSSValidatingParser

The browser's functionality should not be limited by a incomplete parser, therefore the existing HTML parser should be replaced by one that supports HTML fully and also parses CSS correctly.

Contains support and tests for:

Integrate the HTMCSSValidatingParser from http://smalltalkhub.com/#!/~ToddBlanchard/HTMCSSValidatingParser/ and add required String trimming functions
Reconnect the rendering pipeline to the parser

Estimated Effort: 200

Make tests independent from external websites

Instead of referencing external websites in tests, host and configure these websites directly in Squeak (using WebServer from the WebClient package).

Bug: Additional information in HTTP Request are not evaluated

The WebClient library supports a lot of features such as an userAgent or other attentional request informations. However, these informations are not being submitted so that webpages look bad (because Scamper doesn't get a light version and cannot display all HTML and CSS elements)

Bug: HtmlInputNode>>alt - messageNotUnderstood

Visiting www.hpi.de will throw a messageNotUnterstood error because 'alt' is sent to HtmlInputNode. This happens in HtmlInputNode>>addImageButtonToFormatter:

Estimated effort: 7