thlorenz/learnuv

Stars
711
Rank 63,679 (Top 2 %)
Language
C
License
MIT License
Created about 10 years ago
Updated over 1 year ago

thlorenz/learnuv

thlorenz

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Learn uv for fun and profit, a self guided workshop to the library that powers Node.js.

learnuv

Learn uv for fun and profit, a self guided workshop to the library that powers Node.js.

Before You Start

Read the learnuv gitbook which explains some libuv and related C language concepts that will help you complete the exercises.

Installation

Requires Python 2.6 or 2.7 to be installed. If python is not in your path set the environment variable PYTHON to its location. For example on Windows: set PYTHON=C:\Python27\python.exe

git clone https://github.com/thlorenz/learnuv && cd learnuv
npm install

Getting Started

./learnuv help

Building

learnuv comes with build commands that you can use instead of the manual steps explained further below.

./learnuv ninja Compile your sources with ninja, stored inside ./out/Debug
./learnuv make Compile your sources with make, stored inside ./out/Debug
./learnuv xcode Generate a learnuv Xcode project, named ./learnuv.xcodeproj

Windows Caveats

Ninja and Make do not work on windows except via cygwin.

Ninja

Highly recommended since it builds faster than any of the other options, so get ninja and do:

./gyp_learnuv.py -f ninja
ninja -C out/Debug
./out/Debug/01_system_info

Make

Works on Linux and OSX.

./gyp_learnuv.py -f make
make -C out
./out/Debug/01_system_info

Xcode

Works on OSX only. Highly recommended to ease debugging and code navigation.

./gyp_learnuv.py -f xcode
open learnuv.xcodeproj

Visual Studio

Works on Windows only. TODO need to adapt vcbuild.bat.

Running

./learnuv

License

MIT

doctoc

📜 Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.

proxyquire

🔮 Proxies nodejs require in order to allow overriding dependencies during testing.

v8-perf

⏱️ Notes and resources related to v8 and thus Node.js performance

deoptigate

⏱️ Investigates v8/Node.js function deoptimizations.

brace

📔 browserify compatible version of the ace editor.

browserify-shim

📩 Makes CommonJS incompatible files browserifyable.

es6ify

browserify >=v2 transform to compile JavaScript.next (ES6) to JavaScript.current (ES5) on the fly.

visulator

A machine emulator that visualizes how each instruction is processed

exorcist

Externalizes the source map found inside a stream to an external .js.map file

parse-link-header

Parses a link header and returns paging information for each contained link.

libuv-dox

Documenting types and methods of libuv, mostly by reading 'uv.h'.

rid-examples

Examples showing how to use Rid in order to build Dart/Flutter apps integrated with Rust.

replpad

Pipes content of files to a node repl whenever they change to enable a highly interactive coding experience.

browserify-ftw

Converts an entire project that uses requirejs amd into on that uses nodejs common modules so it can be browserified.

cardinal

Syntax highlights JavaScript code with ANSI colors to be printed to the terminal.

turbolizer

Turbolizer tool from the v8 repository with added support to preload a profile

convert-source-map

Converts a source-map from/to different formats.

cpuprofilify

Converts output of various profiling/sampling tools to the .cpuprofile format so it can be loaded into Chrome DevTools.

flamegraph

Generates flamegraphs with Node.js or in the browser.

proxyquireify

browserify >= v2 version of proxyquire. Mocks out browserify's require to allow stubbing out dependencies while testing.

batufo

UFO mutli-player game using Flutter.

spok

Checks a given object against a given specification to keep you from writing boilerplate tests.

v8-flags

Configures v8 flags at runtime.

wasm2js

Compile WebAssembly .wasm files to a commonjs module.

browserify-markdown-editor

A demo showing how to build a markdown editor with browserify and marked.

combine-source-map

Add source maps of multiple files, offset them and then combine them into one source map.

nad

Node Addon Developer, a tool to inject your addon code into a copy of the node codebase in order to integrate with IDEs and debuggers easily.

irish-pub

Feel like npm is drunk or maybe you are and want to verify what gets published via `npm publish`? irish-pub has you covered.

rid

Rust integrated Dart framework providing an easy way to build Flutter apps with Rust.

hypernal

Renders terminal output as html to simplify reusing server side modules in the browser.

exposify

browserify transform that exposes globals added via a script tag as modules so they can be required.

nif

node --inspect a file and open devtool url in chrome via chrome-cli.

active-handles

Prints out information about the process's active handles, including function source and location

doctoc-web

This is the source of the DocToc web application.

traceviewify

Converts .cpuprofile format to trace viewer JSON object format to allow analysing the data in chrome://tracing.

readline-vim

Adds vim bindings to nodejs readline.

docme

Generates github compatible API documentation from your project's jsdocs and adds them to your Readme.

bunyan-format

Writable stream that formats bunyan records that are piped into it

wicked

Generates github wiki compatible API documentation from your project's jsdocs and adds them to your wiki.

lldb-jbt

Adds JavaScript symbols to lldb stack traces

phe

Poker hand evaluator

d3-gauge

Gauge visualization built on top of d3.

dev-null

/dev/null for node streams

WebToInk

Downloads and converts a properly set up Html book or a blog into mobi format

docmac

Install docker on Mac including VirtualBox and boot2docker dependencies with one simple command.

stack-mapper

Initialize it with a source map, then feed it error stacks to have the trace locations mapped to the original files.

stream-viz

Visualizes streams in the browser.

dotfiles

My vim and bash related dotfiles.

iojs-inspect-entire-stack

Demonstrating how to inspect the entire io.js stack

hermit

Prints html in the terminal using colors and simple layout to reflect the document structure.

v8-map-processor

Processes and visualizes maps (aka hidden classes) created by v8 during execution.

mold-source-map

Mold a source map that is almost perfect for you into one that is.

bromote

Tool to setup and require remote scripts with browserify.

log.h

Minimal yet colorful logging lib.

inline-source-map

Adds source mappings and base64 encodes them, so they can be inlined in your generated file.

testlingify

Adds github hooks and browser config for testling.

browserify-swap

A transform that swaps out modules according to a config in your package.json selected via an environment variable.

v8-profiling

Exploring how to hook into the various v8 profilers

scriptie-talkie

Makes your code tell you what the intermediate results are when executing a script.

ee.c

EventEmitter in C.

resolve-bin

Resolves the full path to the bin file of a given package by inspecting the \"bin\" field in its package.json.

node-syntaxhighlighter

Node friendly version of Alex Gorbachev's great SyntaxHighlighter.

v8-runtime-functions

Exposing and documenting v8 runtime functions.

anchor-markdown-header

Generates an anchor for a markdown header.

hyperwatch

Streams server side log messages to the browser and renders them inside your page.

sass-resolve

Resolves all sass files in current project and all dependencies to create one sass file which includes them all.

ansicolors

Functions that surround a string with ansicolor codes so it prints in color.

dockerify

Prepares any tarball containing a project so that a docker image can be built from it.

spinup

Spins up multiple versions of your app, each in its own docker container

redeyed

Takes JavaScript code, along with a config and returns the original code with tokens wrapped and/or replaced as configured.

nasmx

The NASMX Project (manually maintained mirror) Documentation: https://thlorenz.github.io/nasmx

find-parent-dir

Finds the first parent directory that contains a given file or directory.

dox

Notes and cheat sheets on various topics

benchgraph

Runs {io,node}.js benchmarks and generates pretty graphs

kebab

Half queue half pubsub. Super small (< 30 loc) and simple queue that supports subscribers.

pong.asm

pong game written in assembly for i386 (32-bit) architecture.

peacock

JavaScript syntax highlighter that generates pygments compatible html and therefore supports pygments styles.

linuxasmtools

This package is part of AsmTools (a collection of programs for assembler development on Linux X86 cpu's.)

talks

Numerous talks I gave at meetups and conferences some based on reveal.js.

valiquire

Validates that all require statements in a project point to an existing path and are correctly cased.

chromium-remote-debugging-proxy

A proxy that sits in between a chromium devtools frontend and the remote chromium being debugged and logs requests, responses and websocket messages that are exchanged.

prange

Parses poker hand range short notation into a range array.

jsdoc-githubify

A transform that adapts html files generated with jsdoc to be rendered in a github wiki or readme.

ocat

Inspect an object various ways in order to easily generate test cases.

v8-sandbox

hhp

Poker HandHistory Parser

node-traceur

Mirror of experimental ES6 to ES5 compiler that is kept in sync with code on google.

v8-ic-processor

Processes and visualizes IC (inline cache) information collected for functions in your application

pec

Poker equity calculator. Compares two combos or one combo against a range to compute winning equity.

floodgate

Throttles a stream to pass one value per given interval.

level-dump

Dumps all values and/or keys of a level db or a sublevel to the console.

tap-stream

Taps a nodejs stream and logs the data that's coming through

parse-key

Parses strings into key objects of the same format as the ones emitted by nodejs readline.

nf-rated

Store and process Netflix movies including IMDB rating.

dockops

docker convenience functions on top of dockerode

lib.asm

Collection of assembly routines in one place to facilitate reuse.

sql-escape-string

Simple SQL string escape.

caching-coffeeify

A coffeeify version that caches previously compiled coffee-script to optimize the coffee-script compilation step.

cathode

Example for react server side rendering without the fluff

dog

Developer blOGgin Engine, markdown based, made to be simple and fast, yet feature rich.