windowserlangelixirelixir-mixranch

What are the steps to successfully run Ranch on windows?


Please what steps do we need to take to get Ranch working successfully on windows?

There is a very instructive set of examples in a great blog series which i am trying to follow here:

http://dbeck.github.io/Using-Ranch-From-Elixir/

http://dbeck.github.io/simple-TCP-message-performance-in-Elixir/

It however requires that we use the Ranch Erlang Lib.

Getting this to work on windows has been a pain so far:

mix.deps.compile fails

C:\Elixir\tcp_eval>mix deps.update --all
Running dependency resolution
Dependency resolution completed successfully
  ranch: v1.1.0

C:\Elixir\tcp_eval>mix deps.compile
==> ranch
Access denied - SRC
File not found - -TYPE
File not found - F
File not found - -NAME
Access denied - SRC
File not found - -TYPE
File not found - F
File not found - -NAME
Access denied - SRC
File not found - -TYPE
File not found - F
File not found - -NAME
Access denied - SRC
File not found - -TYPE
File not found - F
File not found - -NAME
File not found - SRC/
File not found - -TYPE
File not found - F
File not found - -NAME
Access denied - EBIN
File not found - -TYPE
File not found - F
File not found - -NAME
 APP    ranch.app.src

Solution

  • With some help from here:

    https://github.com/ninenines/erlang.mk/issues/294#issuecomment-147379818

    I was able to get Ranch working on windows.

    1) install the msys2 environment

    2) run mix from within the MSYS2 environment

    EDIT: Doing this via rebar

    D:\Elixir\tcp_eval>rebar
    'rebar' is not recognized as an internal or external command,
    operable program or batch file.
    
    D:\Elixir\tcp_eval>rebar3
    Rebar3 is a tool for working with Erlang projects.
    
    
    Usage: rebar [-h] [-v] [<task>]
    
      -h, --help     Print this help.
      -v, --version  Show version information.
      <task>         Task to run.
    
    
    Several tasks are available:
    
    as                Higher order provider for running multiple tasks in a sequence as a certain profiles.
    clean             Remove compiled beam files from apps.
    compile           Compile apps .app.src and .erl files.
    cover             Perform coverage analysis.
    ct                Run Common Tests.
    deps              List dependencies
    dialyzer          Run the Dialyzer analyzer on the project.
    do                Higher order provider for running multiple tasks in a sequence.
    edoc              Generate documentation using edoc.
    escriptize        Generate escript archive.
    eunit             Run EUnit Tests.
    help              Display a list of tasks or help for a given task or subtask.
    new               Create new project from templates.
    path              Print paths to build dirs in current profile.
    pkgs              List available packages.
    release           Build release of project.
    relup             Create relup of releases.
    report            Provide a crash report to be sent to the rebar3 issues page.
    shell             Run shell with project apps and deps in path.
    tar               Tar archive of release built of project.
    tree              Print dependency tree.
    unlock            Unlock dependencies.
    update            Update package index.
    upgrade           Upgrade dependencies.
    version           Print version for rebar and current Erlang.
    xref              Run cross reference analysis.
    
    plugins <task>:
      list           List local and global plugins for this project
      upgrade        Upgrade plugins
    
    unstable <task>:
      install        Extract libs from rebar3 escript along with a run script.
      upgrade        Download latest rebar3 escript and extract.
    
    Run 'rebar3 help <TASK>' for details.
    
    D:\Elixir\tcp_eval>
    

    Looking at Hex.pm, I decided to install rebar3, this works/integrates well with mix.

    following http://theburningmonk.com/2014/08/getting-started-with-rebar-on-windows/ we can get rebar3 working on windows

    but this still does not work:

    D:\Elixir\tcp_eval>mix deps.compile
    ==> ranch
    'make' is not recognized as an internal or external command,
    operable program or batch file.
    ==> tcp_eval
    ** (Mix) Could not compile dependency :ranch, "make" command failed. You can recompile this dependency with "mix deps.compile ranch",
    
    D:\Elixir\tcp_eval>