Home / News / Bounty - ICDevs.org - HTTPRequest Parser
Austin Fatheree, January 11 2022
This bounty gives the opportunity to
The developer will need to create a vessel package called HttpRequestParser that parses the HTTPRequest type into a more useable and extensible object. We suggest:
{
method: Text;
url: {
original: Text;
protocal: Text //http or https - may always be https?;
port: Nat16; //maybe always 443? What about local replica?
host: {
original: Text;
array: Array<Text>; // host split at the "."s
};
path: {
original: Text;
array: Array<Text>; // split path by "/" into an array that can be referenced;
};
query: {
original: Text; //everything after the ? and before an anchor
get: (Text) -> ?Text; //helper function: pass in a key and get value. null if not present
hashMap: HashMap<Text, Text>;
keys: [Text]; //list of query keys
};
anchor: Text; //an anchor if available(after the #;
};
headers: {
original: Array<(Text, Text)>;
get: (Text) -> ?[Text] //helper function: pass in a key and get values. null if not present
hashMap: HashMap<Text, [Text]>;
keys: [Text]; //list of header keys
};
body: ?{ //Get requests won't have a body
original: Blob
size: Nat; //size of the body
form: { //if the content-type is as specified at https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST, parse the form and populate the collection
get: (Text) -> ?[Text] //helper function: pass in a key and get value. null if not present
hashMap: HashMap<Text, [Text]>;
keys: [Text]; //list of form keys;
files: (Text) -> ?[Buffer<Nat8>]; //helper function returns the formdata as a byte array; null if the form entry does not exist
};
text: () -> Text; //converts the Blob to plain text
file: () -> ?Buffer<Nat8>; //if not formdata and only one file is provided it will be here.
bytes: (start, end) -> Buffer<Nat8>;//helper function: return the specified bytes from the blob.
};
};
This library is an opportunity to start a RegEx like library for motoko. RegEx is hard and big and complicated, so this is not a requirement, but if the bounty hunter wanted to dive into the basics of RegEx and explore how well/poorly motoko was going to be for RegEx it would be a bonus.
Prior art that may help in getting you started:
https://github.com/aramakme/aramakme_nft_auction/blob/f0ca7fb629814dc24a90ad84c7d024a49390e38b/main.mo#L2757 https://github.com/dfinity/motoko-base/blob/57c3bb724dfe36928d443f5a81446872bf646de9/src/Text.mo#L346
The ICDevs.org developer’s advisors will propose a vote to award the bounty and the Developer Advisors will vote.
Please keep your ongoing code in a public repository(fork or branch is ok). Please provide regular (at least weekly) updates. Code commits count as updates if you link to your branch/fork from the bounty thread. We just need to be able to see that you are making progress.
The balance of the bounty will be paid out at completion.
Once you have finished, please alert the dev forum thread that you have completed work and where we can find that work. We will review and award the bounty reward if the terms have been met. If there is any coordination work(like a pull request) or additional documentation needed we will inform you of what is needed before we can award the reward.
If you cease work on the bounty for a prolonged(at the Developer Advisory Board’s discretion) or if the quality of work degrades to the point that we think someone else should be working on the bounty we may re-award it. We will be transparent about this and try to work with you to push through and complete the project, but sometimes, it may be necessary to move on or to augment your contribution with another resource which would result in a split bounty.
The bounty was generously funded by the community and the DFINITY Foundation Grant. If you would like to turbocharge this bounty you can seed additional donations of ICP to 860bd56f4c8a9d40f26462e51e2a4dd4e27cf0e1463372a1179df089695bfd63. ICDevs will match the bounty 1:1 for the first 20 ICP and then 0.25:1 after that. All donations will be tax deductible for US Citizens and Corporations. If you send a donation and need a donation receipt, please email the hash of your donation transaction, physical address, and name to [email protected] More information about how you can contribute can be found at our donations page.
The draft bounty is posted to the DFINITY developer’s forum for discussion
The developer advisor’s board will propose a bounty be ratified and a vote will take place to ratify the bounty. Until a bounty is ratified by the Dev it hasn’t been officially adopted. Please take this into consideration if you are considering starting early.
Developers can submit applications to the Dev Forum post. The council will consider these as they come in and propose a vote to award the bounty to one of the applicants. If you would like to apply anonymously you can send an email to austin at icdevs dot org or sending a PM on the dev forum.
A developer is currently working on this bounty, you are free to contribute, but any splitting of the award will need to be discussed with the currently assigned developer.
The Dev Council is reviewing the submission
The award has be been given and the bounty is closed.
$2000 ICP - DFINITY Foundation Grant