Newbies Pass Muster

    iowa

    0.8.1 • Public • Published

    tests deps

      __      ______    __   __  ___       __
     |" \    /    " \  |"  |/  \|  "|     /""\
     ||  |  // ____  \ |'  /    \:  |    /    \
     |:  | /  /    ) :)|: /'        |   /' /\  \
     |.  |(: (____/ //  \//  /\'    |  //  __'  \
     /\  |\\        /   /   /  \\   | /   /  \\  \
    (__\_|_)\"_____/   |___/    \___|(___/    \___)
    

    iowa is a library that exposes IO utility methods that return a Promise API; it is also known as “the land of corn”.

    About This Repository

    This repository is a part of the Byte-Sized JavaScript VideoCasts.

      _               __
     |_)   _|_  _ __ (_  o _   _   _|
     |_) \/ |_ (/_   __) | /_ (/__(_|
         /        |  _.     _. (_   _ ._ o ._ _|_
                \_| (_| \/ (_| __) (_ |  | |_) |_
                                           |
                »»  bytesized.tv  ««
    

    Byte-Sized What?!

    Byte-Sized JavaScript.

    It is a compilation of short (around ten minutes) monthly screencasts about JavaScript and related technologies.

    About iowa

    iowa is a library that exposes IO utility methods that return a Prmomise API.

    It’s currently used in the CI/CD deployment pipeline of bytesized.tv.web.

    I’m adding bits and pieces to it as I need them. Contributions are always welcome.

    Alpha-Stage Software Warning

    iowa is in its early stages; so anything in its implementation can change.

    Until it hits version 1.0, I’ll be liberally introducing breaking changes, please keep that in mind and fix your versions in your package.json if you depend on iowa in your apps.

    Once iowa hits version 1.0, its API will stabilize, and the changes will be more backwards-compatible, as I will follow the Semantic Versioning 2.0.0 standards.

    Installation

    Install via npm:

    npm install iowa

    You will need the current version of Node.JS with all the bells and whistles — You can install it from nodejs.org.

    Usage

    Here are a few usage examples:

    // TODO: add more examples including configuration options
    
    const { readFile, writeFile, missingFiles } from 'iowa';
    
    readFile( 'hello.json' ).then( ( data ) => console.log( data ) );
    
    readFile( 'world.json', { encoding: 'iso-8859-9' ).then( ( data ) => console.log( data ) );
    
    writeFile( 'hello.txt', 'baz' );
    
    missingFiles( [ 'hello.txt', 'world.txt', 'baz.txt' ] ).then( ( missing ) => {
    
        // Missing will be an array of missing files that do not exist in the file system.
        console.log( missing );
    } );
    
    

    Dependencies

    You will need the current version of Node.JS with all the bells and whistles — You can install it from nodejs.org.

    Older versions might work too; though, why stay in the past?

    Package Scripts

    Here are the helper npm scripts that you can run via npm:

    // TODO: update here when there are package scripts. // TODO: travis integration // TODO: create tests // TODO: add eslint.

    Important Files and Folders

    • index.js: The main entry point.
    • CHANGELOG.md: A log of what has been done since the last version.
    • CODE_OF_CONDUCT.md: Tells the collaborators to be nice to each other.
    • README.md: This very file.

    Wanna Help?

    Any help is more than appreciated.

    If you want to contribute to the source code, fork this repository and create a pull request.

    In lieu of a formal style guide, take care to maintain the existing coding style.

    Also, don’t forget to add unit tests for any new or changed functionality.

    If you want to report a bug; or share a comment or suggestion, file an issue.

    I’ve Found a Bug; I Have an Idea

    For bug reports and suggestions, please file an issue.

    Contact Information

    License

    MIT-licensed. — See the license file for details.

    Code of Conduct

    We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality.

    See the code of conduct for details.

    Install

    npm i iowa

    DownloadsWeekly Downloads

    0

    Version

    0.8.1

    License

    MIT

    Last publish

    Collaborators

    • volkan