Comments (2)
I've started to think about how to remove the test fixtures from ex_doc
. I could use some guidance on the best way to proceed. It's easy enough to put all the test fixtures into test_helper.exs
, though I'm not sure that's much of a win in terms of understandability. I could move individual modules into the specific test files (or even into the test functions in some cases), though I think there would be a fair amount of repeated code in those cases.
Any high-level guidance on which of these approaches makes more sense?
We will still need a small number of test fixtures to test the file and directory reading code (unless there is some advantage to auto-generating those as well).
from ex_doc.
@jwarwick I think we should have a mixture of both approaches. Some fixtures could be used throughout the whole codebase and therefore should be defined in test_helper.exs
but some other fixtures could be define in modules or, as you said, even in particular tests since one of the goals is to decouple the tests.
This is actually the general approach for using fixtures: a minimum global set of fixtures with variations being defined specifically for each test. :)
from ex_doc.
Related Issues (20)
- Using `filter_modules` doesn't produce warning referencing `hidden or private` docs HOT 6
- Building docs for Erlang fails since v0.30.0 HOT 1
- Keyboard navigation: missing or inconsistent focus styles, some elements cannot be focused at all HOT 2
- `:skip_undefined_reference_warnings_on` with modules in pages HOT 2
- Annotate modules visually when `@moduledoc since: "..."` is present HOT 8
- Screen reader accessibility HOT 2
- Internal linking from one extra to another HOT 14
- Can't find publicly defined type from another module HOT 5
- Refactor warning generation HOT 2
- Proposal: Narrow search results by type HOT 10
- failing in umbrella project on elixir 1.15 but not on elixir 1.14 HOT 3
- Add syntax for explicitly linking to modules and pages HOT 16
- Sidebar scroll regression introduced in #1760 (Firefox) HOT 4
- Should the sidebar still be dark with light theme enabled? HOT 1
- Proposal: link/hover-docs to mix tasks HOT 1
- [local](`config_runtime/2`) should warn if local function does not exist
- Sidebar CSS broken in v0.30.6 HOT 6
- JS error on search page and search results won't load HOT 1
- no match for empty list in `ExDoc.Language.Erlang.pop/0` HOT 10
- Proposal: Markdown formatter HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ex_doc.