# Recommendations for how to browse source code

**URL:** <https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303>\
**Category:** Tooling\
**Created:** [May 17, 2019, 3:20am UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303 "2019-05-17T03:20:46Z")\
**Posts on this page:** 6\
**Page:** 2

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [May 28, 2019, 7:08am UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/21 "2019-05-28T07:08:25Z")

</div>

> [@Tamas\_Papp](#):
>
> But if you are not `using ProjectName` , what’s the benefit/purpose of having a `Project.toml` with `name = "ProjectName"` and an UUID?

It has no effect on Julia, but could be good to name your projects regardless if you forget what that environment was about etc.

> [@Tamas\_Papp](#):
>
> I also don’t quite understand what applications have to do with the package infrastructure. There is a single mention of the concept in the [glossary](https://julialang.github.io/Pkg.jl/dev/glossary/), but otherwise it is not used, and I have not seen any examples.

Application is basically just another name for environment; when you run some code in the REPL with the default `v1` environment you could call that your application.

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [May 28, 2019, 7:12am UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/22 "2019-05-28T07:12:28Z")

</div>

> [@fredrikekre](#):
>
> Application is basically just another name for environment; when you run some code in the REPL with the default `v1` environment you could call that your application.

Thanks. It would be great to clarify this in the docs.

Does it make sense to think of the `Project.toml` and, ideally, the `Manifest.toml`, as a mechanism to achieve a consistent and reproducible environment to run a script (the “application”)?

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [May 28, 2019, 7:15am UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/23 "2019-05-28T07:15:55Z")

</div>

> [@Tamas\_Papp](#):
>
> Does it make sense to think of the `Project.toml` and, ideally, the `Manifest.toml` , as a mechanism to achieve a consistent and reproducible environment to run a script (the “application”)?

Yea.

I group my applications as packages anyway, I think that is quite convenient, e.g. someting like

```bash
$ tree .
.
├── bin
│ └── run.jl
├── Manifest.toml
├── Project.toml
└── src
    └── Application.jl

2 directories, 4 files

```

where I can then `using Application` in `bin/run.jl`.

---

<div class="post-metadata">

**Author:** ![e3c6](https://avatars.discourse-cdn.com/v4/letter/e/e79b87/32.png) [@e3c6](https://discourse.julialang.org/u/e3c6)\
**Post date:** [May 28, 2019, 8:48am UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/24 "2019-05-28T08:48:24Z")

</div>

Are there paradigmatic examples (e.g. public Github repos) of Applications out there that one can take a look at? Just to see how this feature is being used in the real world.

---

<div class="post-metadata">

**Author:** ![StefanKarpinski](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/stefankarpinski/32/24_2.png) [@StefanKarpinski](https://discourse.julialang.org/u/StefanKarpinski)\
**Post date:** [May 28, 2019, 3:23pm UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/25 "2019-05-28T15:23:56Z")

</div>

> [@Tamas\_Papp](#):
>
> I also don’t quite understand what applications have to do with the package infrastructure. There is a single mention of the concept in the [glossary](https://julialang.github.io/Pkg.jl/dev/glossary/), but otherwise it is not used, and I have not seen any examples.

Even though explicit support for applications isn’t spelled out or developed, it needed to be thought through in advance to some extent: the project and manifest files are needed by both packages and applications. An application is essentially just something that has a project file and layout that Julia understands but which is not a package. It would be good to pick some conventions for applications like the ones that @fredrikekre has described, but it wasn’t necessary to do so in order to ship a new package manager. People will figure out good conventions themselves and then we can document those and converge on them as standards.

> [@Tamas\_Papp](#):
>
> But if you are not `using ProjectName` , what’s the benefit/purpose of having a `Project.toml` with `name = "ProjectName"` and an UUID?

It’s not necessary, but why not? Applications usually have names and if you generate a uuid then it’s clear when different copies with differences are versions of the same application.

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [May 28, 2019, 4:28pm UTC](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303/26 "2019-05-28T16:28:08Z")

</div>

> [@StefanKarpinski](#):
>
> It would be good to pick some conventions for applications like the ones that @fredrikekre has described, but it wasn’t necessary to do so in order to ship a new package manager. People will figure out good conventions themselves and then we can document those and converge on them as standards.

Thanks for the explanation. It would be great to have this mentioned somewhere in the Pkg manual where applications are described, eg as a note. I understand the context now, but I think that without it, the part about applications in the Pkg manual is somewhat confusing.

[Previous page](https://discourse.julialang.org/t/recommendations-for-how-to-browse-source-code/24303.md?page=1)
