Lady’s Gitweb - Pisces/blob - README.markdown

   1 # ♓🧩 Piscēs
   2
   3 <b>Ecmascript building blocks.</b>
   4
   5 <dfn>♓🧩 Piscēs</dfn> is a Javascript (handcoded Ecmascript) library
   6 providing various building blocks for developing complex,
   7 precisely‐defined Javascript libraries. It provides implementations of
   8 fundamental Ecmascript Specification functions for use in Javascript
   9 code, plus other helpful prototypes and utilities.
  10
  11 This library is **targeted at “low‐level” Javascript development**, i·e
  12 the kind of development undertaken with the Ecmascript specification
  13 open as reference. Taking full advantage of it requires familiarity
  14 with things like `Reflect` and a willingness to access properties and
  15 methods from one prototype on an unrelated object.
  16
  17 **♓🧩 Piscēs was written to serve the interests of
  18 [♓🌟 الرشآء](https://git.ladys.computer/Alrescha) development, and not
  19 as a general‐use library.** This means that it is not extensively
  20 documented beyond its source code, it is not rigidly versioned, and it
  21 offers no guarantees regarding stability between versions. However, it
  22 is written in a generic manner, such that if you find it useful, you
  23 _can_ integrate it into your project—using ordinary Ecmascript imports
  24 from `https://git.ladys.computer/Pisces/blob_plain/❲HASH❳:/mod.js`.
  25 Always use a specific hash, and not a branch name like `current`, when
  26 importing ♓🧩 Piscēs into your project.
  27
  28 Piscēs is broken up into multiple files, which is perfectly acceptable
  29 for use with [Deno](https://deno.land), but generally not considered
  30 ideal for usage on the web. You can use the `deno bundle` command to
  31 stitch the various source files together into a single script.
  32
  33 ## License
  34
  35 Source files are licensed under the terms of the <cite>Mozilla Public
  36 License, version 2.0</cite>. For more information, see
  37 [LICENSE](./LICENSE).