How to use ex_doc in Opensuse Leap when Elixir lang is installed through zyapper or system wide?

Questions / Help
1

I have installed Elixir on my Opensuse Leap system using the docs from elixir-lang. And was learnig use of ex_doc but it isn’t installing the way mix deps.get should have . Installed through package manager but its not working. Kindly help

2

You can certainly install ex_doc via mix, via something like

{:ex_doc, "~> 0.19", only: :dev, runtime: false}

It may be installed as an archive. You can check installed archives with mix archive. If you wish to uninstall it you can use mix archive.uninstall <archive>

3

I actually did that before trying to install from package manager. Exdoc. 0.19 version requires Elixir 1.17 version. Zyapper installs elixir 1.6.

4

Then you want an earlier version. From the changelog there is a notice: “This release requires Elixir v1.7 and later. For earlier Elixir versions, use ExDoc ~> 0.18.0.”

Therefore you should use this in your deps:

def deps
  [
    ...other deps
    {:ex_doc, "~> 0.18.0", only: :dev, runtime: false},
  ]
end
5

I actually did that giving multiple different version(0.12, 0.18.0, 0.18.4) of ex_doc before installing it from the system software using this Opensuse ex_doc

Now I removed ex_doc from the system software and reinstalled mix. But getting the same issue as before.

>mix deps.get
Resolving Hex dependencies...
Dependency resolution completed:
Unchanged:
  earmark 1.2.5
New:
  ex_doc 0.18.4
* Updating ex_doc (Hex package)
Request failed (:timeout)
If this happens consistently, adjust your concurrency and timeout settings:

    HEX_HTTP_CONCURRENCY=1 HEX_HTTP_TIMEOUT=120 mix deps.get
** (Mix) Package fetch failed and no cached copy available (https://repo.hex.pm/tarballs/ex_doc-0.18.4.tar)

I even tried to give github specific path so that it picks up the right version, but it’s not accepting and giving the above error. Or doesn’t connect.

6

This seems to indicate some type of firewall issue. Perhaps you are behind a restrictive corporate firewall? Can you directly download https://repo.hex.pm/tarballs/ex_doc-0.18.4.tar from this computer?

8

I actually did download the ex_doc and wasn’t sure how to use that. Tried to check on elixir-lang IRC but couldn’t get much help. So thought to reach here. I still do have ex_doc-0.18.4.tar file with me. How to use that for my project than.

9

Untar it into deps of your application.

It then should have roughly the following structure:

.
|-lib
|-deps
|  |-earmark
|  \-ex_doc
|-priv
\-tests

Perhaps I’m missing some of the default folders, perhaps I misspelled them, but the important bits are in deps anyway.

10 
ex_docfil> tree
.
├── CHECKSUM
├── contents.tar.gz
├── metadata.config
└── VERSION

0 directories, 4 files

and when extracted the content tar file. I got this

ex_docfil> tree

.
├── CHANGELOG.md
├── CHECKSUM
├── contents.tar.gz
├── formatters
│ ├── epub
│ │ ├── dist
│ │ │ ├── app-bbb6f0765d.js
│ │ │ └── epub-612b95d9a4.css
│ │ └── metainfo
│ │ ├── com.apple.ibooks.display-options.xml
│ │ └── container.xml
│ └── html
│ ├── dist
│ │ ├── app-480ffdc169.css
│ │ ├── app-9bd040e5e5.js
│ │ └── app-9bd040e5e5.js.map
│ └── fonts
│ ├── icomoon.eot
│ ├── icomoon.svg
│ ├── icomoon.ttf
│ └── icomoon.woff
├── lib
│ ├── ex_doc
│ │ ├── cli.ex
│ │ ├── formatter
│ │ │ ├── epub
│ │ │ │ ├── assets.ex
│ │ │ │ ├── templates
│ │ │ │ │ ├── content_template.eex
│ │ │ │ │ ├── extra_template.eex
│ │ │ │ │ ├── head_template.eex
│ │ │ │ │ ├── media-types.txt
│ │ │ │ │ ├── module_template.eex
│ │ │ │ │ ├── nav_item_template.eex
│ │ │ │ │ ├── nav_template.eex
│ │ │ │ │ ├── title_template.eex
│ │ │ │ │ └── toc_item_template.eex
│ │ │ │ └── templates.ex
│ │ │ ├── epub.ex
│ │ │ ├── html
│ │ │ │ ├── assets.ex
│ │ │ │ ├── autolink.ex
│ │ │ │ ├── templates
│ │ │ │ │ ├── api_reference_entry_template.eex
│ │ │ │ │ ├── api_reference_template.eex
│ │ │ │ │ ├── detail_template.eex
│ │ │ │ │ ├── extra_template.eex
│ │ │ │ │ ├── footer_template.eex
│ │ │ │ │ ├── head_template.eex
│ │ │ │ │ ├── module_template.eex
│ │ │ │ │ ├── not_found_template.eex
│ │ │ │ │ ├── redirect_template.eex
│ │ │ │ │ ├── search_template.eex
│ │ │ │ │ ├── sidebar_template.eex
│ │ │ │ │ ├── summary_item_template.eex
│ │ │ │ │ └── summary_template.eex
│ │ │ │ └── templates.ex
│ │ │ └── html.ex
│ │ ├── group_matcher.ex
│ │ ├── markdown
│ │ │ ├── cmark.ex
│ │ │ └── earmark.ex
│ │ ├── markdown.ex
│ │ └── retriever.ex
│ ├── ex_doc.ex
│ └── mix
│ └── tasks
│ └── docs.ex
├── LICENSE
├── metadata.config
├── mix.exs
├── README.md
└── VERSION

Those were the files inside ex_doc-0.18.4.tar

11

Ah, okay, then I previously misunderstood how the tarbal is built. The content of contents.tar.gz has to be in deps/ex_doc.

I’m still wondering why you were able to download earmark, but not ex_doc… Both are served via hex…

1 Like