├── .eslintrc.js
├── .gitignore
├── .neutrinorc.js
├── LICENSE
├── README.md
├── package.json
├── src
├── ansiparse.js
├── components
│ ├── LazyLog
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── Line
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── LineContent
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── LineNumber
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── LinePart
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── Loading
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ ├── ScrollFollow
│ │ ├── README.md
│ │ └── index.jsx
│ ├── SearchBar
│ │ ├── FilterLinesIcon
│ │ │ ├── README.md
│ │ │ ├── index.jsx
│ │ │ └── index.module.css
│ │ ├── README.md
│ │ ├── index.jsx
│ │ └── index.module.css
│ └── index.js
├── encoding.js
├── request.js
├── search.js
├── stream.js
├── utils.js
└── websocket.js
└── yarn.lock
/.eslintrc.js:
--------------------------------------------------------------------------------
1 | const { Neutrino } = require('neutrino');
2 |
3 | module.exports = Neutrino({ root: __dirname })
4 | .use('.neutrinorc')
5 | .call('eslintrc');
6 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | # Logs
2 | logs
3 | *.log
4 | npm-debug.log*
5 | yarn-debug.log*
6 | yarn-error.log*
7 |
8 | # Runtime data
9 | pids
10 | *.pid
11 | *.seed
12 | *.pid.lock
13 |
14 | # Directory for instrumented libs generated by jscoverage/JSCover
15 | lib-cov
16 |
17 | # Coverage directory used by tools like istanbul
18 | coverage
19 |
20 | # nyc test coverage
21 | .nyc_output
22 |
23 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
24 | .grunt
25 |
26 | # Bower dependency directory (https://bower.io/)
27 | bower_components
28 |
29 | # node-waf configuration
30 | .lock-wscript
31 |
32 | # Compiled binary addons (http://nodejs.org/api/addons.html)
33 | build/Release
34 |
35 | # Dependency directories
36 | node_modules/
37 | jspm_packages/
38 |
39 | # Typescript v1 declaration files
40 | typings/
41 |
42 | # Optional npm cache directory
43 | .npm
44 |
45 | # Optional eslint cache
46 | .eslintcache
47 |
48 | # Optional REPL history
49 | .node_repl_history
50 |
51 | # Output of 'npm pack'
52 | *.tgz
53 |
54 | # Yarn Integrity file
55 | .yarn-integrity
56 |
57 | # dotenv environment variables file
58 | .env
59 |
60 | # build directory
61 | lib
62 | build
63 | styleguide
64 | es5
65 |
66 | # Webstorm project specific settings
67 | .idea/
68 |
--------------------------------------------------------------------------------
/.neutrinorc.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 | use: [
3 | 'neutrino-preset-mozilla-frontend-infra/styleguide',
4 | ['neutrino-preset-mozilla-frontend-infra/react-components', {
5 | targets: {
6 | browsers: 'ie 9',
7 | },
8 | style: {
9 | extract: false,
10 | }
11 | }],
12 | (neutrino) => {
13 | if (neutrino.options.command === 'styleguide:start') {
14 | neutrino.config.module.rules.delete('lint');
15 | }
16 | },
17 | ],
18 | };
19 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Mozilla Public License Version 2.0
2 | ==================================
3 |
4 | 1. Definitions
5 | --------------
6 |
7 | 1.1. "Contributor"
8 | means each individual or legal entity that creates, contributes to
9 | the creation of, or owns Covered Software.
10 |
11 | 1.2. "Contributor Version"
12 | means the combination of the Contributions of others (if any) used
13 | by a Contributor and that particular Contributor's Contribution.
14 |
15 | 1.3. "Contribution"
16 | means Covered Software of a particular Contributor.
17 |
18 | 1.4. "Covered Software"
19 | means Source Code Form to which the initial Contributor has attached
20 | the notice in Exhibit A, the Executable Form of such Source Code
21 | Form, and Modifications of such Source Code Form, in each case
22 | including portions thereof.
23 |
24 | 1.5. "Incompatible With Secondary Licenses"
25 | means
26 |
27 | (a) that the initial Contributor has attached the notice described
28 | in Exhibit B to the Covered Software; or
29 |
30 | (b) that the Covered Software was made available under the terms of
31 | version 1.1 or earlier of the License, but not also under the
32 | terms of a Secondary License.
33 |
34 | 1.6. "Executable Form"
35 | means any form of the work other than Source Code Form.
36 |
37 | 1.7. "Larger Work"
38 | means a work that combines Covered Software with other material, in
39 | a separate file or files, that is not Covered Software.
40 |
41 | 1.8. "License"
42 | means this document.
43 |
44 | 1.9. "Licensable"
45 | means having the right to grant, to the maximum extent possible,
46 | whether at the time of the initial grant or subsequently, any and
47 | all of the rights conveyed by this License.
48 |
49 | 1.10. "Modifications"
50 | means any of the following:
51 |
52 | (a) any file in Source Code Form that results from an addition to,
53 | deletion from, or modification of the contents of Covered
54 | Software; or
55 |
56 | (b) any new file in Source Code Form that contains any Covered
57 | Software.
58 |
59 | 1.11. "Patent Claims" of a Contributor
60 | means any patent claim(s), including without limitation, method,
61 | process, and apparatus claims, in any patent Licensable by such
62 | Contributor that would be infringed, but for the grant of the
63 | License, by the making, using, selling, offering for sale, having
64 | made, import, or transfer of either its Contributions or its
65 | Contributor Version.
66 |
67 | 1.12. "Secondary License"
68 | means either the GNU General Public License, Version 2.0, the GNU
69 | Lesser General Public License, Version 2.1, the GNU Affero General
70 | Public License, Version 3.0, or any later versions of those
71 | licenses.
72 |
73 | 1.13. "Source Code Form"
74 | means the form of the work preferred for making modifications.
75 |
76 | 1.14. "You" (or "Your")
77 | means an individual or a legal entity exercising rights under this
78 | License. For legal entities, "You" includes any entity that
79 | controls, is controlled by, or is under common control with You. For
80 | purposes of this definition, "control" means (a) the power, direct
81 | or indirect, to cause the direction or management of such entity,
82 | whether by contract or otherwise, or (b) ownership of more than
83 | fifty percent (50%) of the outstanding shares or beneficial
84 | ownership of such entity.
85 |
86 | 2. License Grants and Conditions
87 | --------------------------------
88 |
89 | 2.1. Grants
90 |
91 | Each Contributor hereby grants You a world-wide, royalty-free,
92 | non-exclusive license:
93 |
94 | (a) under intellectual property rights (other than patent or trademark)
95 | Licensable by such Contributor to use, reproduce, make available,
96 | modify, display, perform, distribute, and otherwise exploit its
97 | Contributions, either on an unmodified basis, with Modifications, or
98 | as part of a Larger Work; and
99 |
100 | (b) under Patent Claims of such Contributor to make, use, sell, offer
101 | for sale, have made, import, and otherwise transfer either its
102 | Contributions or its Contributor Version.
103 |
104 | 2.2. Effective Date
105 |
106 | The licenses granted in Section 2.1 with respect to any Contribution
107 | become effective for each Contribution on the date the Contributor first
108 | distributes such Contribution.
109 |
110 | 2.3. Limitations on Grant Scope
111 |
112 | The licenses granted in this Section 2 are the only rights granted under
113 | this License. No additional rights or licenses will be implied from the
114 | distribution or licensing of Covered Software under this License.
115 | Notwithstanding Section 2.1(b) above, no patent license is granted by a
116 | Contributor:
117 |
118 | (a) for any code that a Contributor has removed from Covered Software;
119 | or
120 |
121 | (b) for infringements caused by: (i) Your and any other third party's
122 | modifications of Covered Software, or (ii) the combination of its
123 | Contributions with other software (except as part of its Contributor
124 | Version); or
125 |
126 | (c) under Patent Claims infringed by Covered Software in the absence of
127 | its Contributions.
128 |
129 | This License does not grant any rights in the trademarks, service marks,
130 | or logos of any Contributor (except as may be necessary to comply with
131 | the notice requirements in Section 3.4).
132 |
133 | 2.4. Subsequent Licenses
134 |
135 | No Contributor makes additional grants as a result of Your choice to
136 | distribute the Covered Software under a subsequent version of this
137 | License (see Section 10.2) or under the terms of a Secondary License (if
138 | permitted under the terms of Section 3.3).
139 |
140 | 2.5. Representation
141 |
142 | Each Contributor represents that the Contributor believes its
143 | Contributions are its original creation(s) or it has sufficient rights
144 | to grant the rights to its Contributions conveyed by this License.
145 |
146 | 2.6. Fair Use
147 |
148 | This License is not intended to limit any rights You have under
149 | applicable copyright doctrines of fair use, fair dealing, or other
150 | equivalents.
151 |
152 | 2.7. Conditions
153 |
154 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
155 | in Section 2.1.
156 |
157 | 3. Responsibilities
158 | -------------------
159 |
160 | 3.1. Distribution of Source Form
161 |
162 | All distribution of Covered Software in Source Code Form, including any
163 | Modifications that You create or to which You contribute, must be under
164 | the terms of this License. You must inform recipients that the Source
165 | Code Form of the Covered Software is governed by the terms of this
166 | License, and how they can obtain a copy of this License. You may not
167 | attempt to alter or restrict the recipients' rights in the Source Code
168 | Form.
169 |
170 | 3.2. Distribution of Executable Form
171 |
172 | If You distribute Covered Software in Executable Form then:
173 |
174 | (a) such Covered Software must also be made available in Source Code
175 | Form, as described in Section 3.1, and You must inform recipients of
176 | the Executable Form how they can obtain a copy of such Source Code
177 | Form by reasonable means in a timely manner, at a charge no more
178 | than the cost of distribution to the recipient; and
179 |
180 | (b) You may distribute such Executable Form under the terms of this
181 | License, or sublicense it under different terms, provided that the
182 | license for the Executable Form does not attempt to limit or alter
183 | the recipients' rights in the Source Code Form under this License.
184 |
185 | 3.3. Distribution of a Larger Work
186 |
187 | You may create and distribute a Larger Work under terms of Your choice,
188 | provided that You also comply with the requirements of this License for
189 | the Covered Software. If the Larger Work is a combination of Covered
190 | Software with a work governed by one or more Secondary Licenses, and the
191 | Covered Software is not Incompatible With Secondary Licenses, this
192 | License permits You to additionally distribute such Covered Software
193 | under the terms of such Secondary License(s), so that the recipient of
194 | the Larger Work may, at their option, further distribute the Covered
195 | Software under the terms of either this License or such Secondary
196 | License(s).
197 |
198 | 3.4. Notices
199 |
200 | You may not remove or alter the substance of any license notices
201 | (including copyright notices, patent notices, disclaimers of warranty,
202 | or limitations of liability) contained within the Source Code Form of
203 | the Covered Software, except that You may alter any license notices to
204 | the extent required to remedy known factual inaccuracies.
205 |
206 | 3.5. Application of Additional Terms
207 |
208 | You may choose to offer, and to charge a fee for, warranty, support,
209 | indemnity or liability obligations to one or more recipients of Covered
210 | Software. However, You may do so only on Your own behalf, and not on
211 | behalf of any Contributor. You must make it absolutely clear that any
212 | such warranty, support, indemnity, or liability obligation is offered by
213 | You alone, and You hereby agree to indemnify every Contributor for any
214 | liability incurred by such Contributor as a result of warranty, support,
215 | indemnity or liability terms You offer. You may include additional
216 | disclaimers of warranty and limitations of liability specific to any
217 | jurisdiction.
218 |
219 | 4. Inability to Comply Due to Statute or Regulation
220 | ---------------------------------------------------
221 |
222 | If it is impossible for You to comply with any of the terms of this
223 | License with respect to some or all of the Covered Software due to
224 | statute, judicial order, or regulation then You must: (a) comply with
225 | the terms of this License to the maximum extent possible; and (b)
226 | describe the limitations and the code they affect. Such description must
227 | be placed in a text file included with all distributions of the Covered
228 | Software under this License. Except to the extent prohibited by statute
229 | or regulation, such description must be sufficiently detailed for a
230 | recipient of ordinary skill to be able to understand it.
231 |
232 | 5. Termination
233 | --------------
234 |
235 | 5.1. The rights granted under this License will terminate automatically
236 | if You fail to comply with any of its terms. However, if You become
237 | compliant, then the rights granted under this License from a particular
238 | Contributor are reinstated (a) provisionally, unless and until such
239 | Contributor explicitly and finally terminates Your grants, and (b) on an
240 | ongoing basis, if such Contributor fails to notify You of the
241 | non-compliance by some reasonable means prior to 60 days after You have
242 | come back into compliance. Moreover, Your grants from a particular
243 | Contributor are reinstated on an ongoing basis if such Contributor
244 | notifies You of the non-compliance by some reasonable means, this is the
245 | first time You have received notice of non-compliance with this License
246 | from such Contributor, and You become compliant prior to 30 days after
247 | Your receipt of the notice.
248 |
249 | 5.2. If You initiate litigation against any entity by asserting a patent
250 | infringement claim (excluding declaratory judgment actions,
251 | counter-claims, and cross-claims) alleging that a Contributor Version
252 | directly or indirectly infringes any patent, then the rights granted to
253 | You by any and all Contributors for the Covered Software under Section
254 | 2.1 of this License shall terminate.
255 |
256 | 5.3. In the event of termination under Sections 5.1 or 5.2 above, all
257 | end user license agreements (excluding distributors and resellers) which
258 | have been validly granted by You or Your distributors under this License
259 | prior to termination shall survive termination.
260 |
261 | ************************************************************************
262 | * *
263 | * 6. Disclaimer of Warranty *
264 | * ------------------------- *
265 | * *
266 | * Covered Software is provided under this License on an "as is" *
267 | * basis, without warranty of any kind, either expressed, implied, or *
268 | * statutory, including, without limitation, warranties that the *
269 | * Covered Software is free of defects, merchantable, fit for a *
270 | * particular purpose or non-infringing. The entire risk as to the *
271 | * quality and performance of the Covered Software is with You. *
272 | * Should any Covered Software prove defective in any respect, You *
273 | * (not any Contributor) assume the cost of any necessary servicing, *
274 | * repair, or correction. This disclaimer of warranty constitutes an *
275 | * essential part of this License. No use of any Covered Software is *
276 | * authorized under this License except under this disclaimer. *
277 | * *
278 | ************************************************************************
279 |
280 | ************************************************************************
281 | * *
282 | * 7. Limitation of Liability *
283 | * -------------------------- *
284 | * *
285 | * Under no circumstances and under no legal theory, whether tort *
286 | * (including negligence), contract, or otherwise, shall any *
287 | * Contributor, or anyone who distributes Covered Software as *
288 | * permitted above, be liable to You for any direct, indirect, *
289 | * special, incidental, or consequential damages of any character *
290 | * including, without limitation, damages for lost profits, loss of *
291 | * goodwill, work stoppage, computer failure or malfunction, or any *
292 | * and all other commercial damages or losses, even if such party *
293 | * shall have been informed of the possibility of such damages. This *
294 | * limitation of liability shall not apply to liability for death or *
295 | * personal injury resulting from such party's negligence to the *
296 | * extent applicable law prohibits such limitation. Some *
297 | * jurisdictions do not allow the exclusion or limitation of *
298 | * incidental or consequential damages, so this exclusion and *
299 | * limitation may not apply to You. *
300 | * *
301 | ************************************************************************
302 |
303 | 8. Litigation
304 | -------------
305 |
306 | Any litigation relating to this License may be brought only in the
307 | courts of a jurisdiction where the defendant maintains its principal
308 | place of business and such litigation shall be governed by laws of that
309 | jurisdiction, without reference to its conflict-of-law provisions.
310 | Nothing in this Section shall prevent a party's ability to bring
311 | cross-claims or counter-claims.
312 |
313 | 9. Miscellaneous
314 | ----------------
315 |
316 | This License represents the complete agreement concerning the subject
317 | matter hereof. If any provision of this License is held to be
318 | unenforceable, such provision shall be reformed only to the extent
319 | necessary to make it enforceable. Any law or regulation which provides
320 | that the language of a contract shall be construed against the drafter
321 | shall not be used to construe this License against a Contributor.
322 |
323 | 10. Versions of the License
324 | ---------------------------
325 |
326 | 10.1. New Versions
327 |
328 | Mozilla Foundation is the license steward. Except as provided in Section
329 | 10.3, no one other than the license steward has the right to modify or
330 | publish new versions of this License. Each version will be given a
331 | distinguishing version number.
332 |
333 | 10.2. Effect of New Versions
334 |
335 | You may distribute the Covered Software under the terms of the version
336 | of the License under which You originally received the Covered Software,
337 | or under the terms of any subsequent version published by the license
338 | steward.
339 |
340 | 10.3. Modified Versions
341 |
342 | If you create software not governed by this License, and you want to
343 | create a new license for such software, you may create and use a
344 | modified version of this License if you rename the license and remove
345 | any references to the name of the license steward (except to note that
346 | such modified license differs from this License).
347 |
348 | 10.4. Distributing Source Code Form that is Incompatible With Secondary
349 | Licenses
350 |
351 | If You choose to distribute Source Code Form that is Incompatible With
352 | Secondary Licenses under the terms of this version of the License, the
353 | notice described in Exhibit B of this License must be attached.
354 |
355 | Exhibit A - Source Code Form License Notice
356 | -------------------------------------------
357 |
358 | This Source Code Form is subject to the terms of the Mozilla Public
359 | License, v. 2.0. If a copy of the MPL was not distributed with this
360 | file, You can obtain one at http://mozilla.org/MPL/2.0/.
361 |
362 | If it is not possible or desirable to put the notice in a particular
363 | file, then You may include the notice in a location (such as a LICENSE
364 | file in a relevant directory) where a recipient would be likely to look
365 | for such a notice.
366 |
367 | You may add additional accurate notices of copyright ownership.
368 |
369 | Exhibit B - "Incompatible With Secondary Licenses" Notice
370 | ---------------------------------------------------------
371 |
372 | This Source Code Form is "Incompatible With Secondary Licenses", as
373 | defined by the Mozilla Public License, v. 2.0.
374 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # React Lazylog
2 |
3 | React component that loads and views remote text in the browser lazily and efficiently.
4 |
5 | See the demo on the styleguide at https://mozilla-frontend-infra.github.io/react-lazylog
6 |
7 | ## Features
8 |
9 | - Efficient scrolling performance thanks to [react-virtualized](https://github.com/bvaughn/react-virtualized)
10 | - Able to load large files upwards of 100MB without crashing the browser
11 | - Parses, colorizes, and styles ANSI escapes within content
12 | - Supports remote text files as well as chunked/streamed responses
13 | - Line highlighting
14 | - Customizable styling
15 | - Searching through log
16 | - Works in latest browser versions, including iOS Safari and Android Chrome
17 | - v3+ requires React 16.3+
18 |
19 | ## Getting started
20 |
21 | You can install `react-lazylog` via Yarn or npm:
22 |
23 | ```bash
24 | # If using Yarn:
25 | yarn add react-lazylog
26 |
27 | # If using npm:
28 | npm install --save react-lazylog
29 | ```
30 |
31 | The core component from react-lazylog is `LazyLog`. There is also a higher-order component (HOC) for
32 | following logs until scroll. This module can be required via ES imports, CommonJS require, or UMD.
33 |
34 | ```js
35 | import { LazyLog } from 'react-lazylog';
36 |
37 | // using require
38 | const { LazyLog } = require('react-lazylog');
39 | ```
40 |
41 | ## ``
42 |
43 | ### Usage
44 |
45 | After importing a component, it can be rendered with the required `url` prop:
46 |
47 | ```jsx
48 | import React from 'react';
49 | import { render } from 'react-dom';
50 | import { LazyLog } from 'react-lazylog';
51 |
52 | render((
53 |
54 | ), document.getElementById('root'));
55 | ```
56 |
57 | By default the `LazyLog` will expand to fill its container, so ensure this container has valid dimensions and layout.
58 | If you wish to have fixed dimensions, change the `height` and `width` props.
59 |
60 | If you are going to be rendering a complete file, or an endpoint which can be downloaded all at once, use the
61 | `` component as-is for better overall performance at the expense of slightly longer upfront load time.
62 |
63 | If you are going to be requesting a streaming or chunked response, use the `` component with the
64 | `stream` prop of `true` for quicker upfront rendering as content can be decoded as it arrives.
65 |
66 | [See the styleguide](https://mozilla-frontend-infra.github.io/react-lazylog) for a listing of complete props and a demo.
67 |
68 | In addition to the props listed for `LazyLog`, most of the properties available to
69 | [react-virtualized List](https://github.com/bvaughn/react-virtualized/blob/master/docs/List.md)
70 | can be provided and will be passed through to the component. _Here are a few useful props:_
71 |
72 | | Property | Type | Required? | Description |
73 | |:---|:---|:---:|:---|
74 | | `rowHeight` | Number | | A fixed row height in pixels. Controls how tall a line is, as well as the `lineHeight` style of the line's text. Defaults to `19`. |
75 | | `overscanRowCount` | Number | | Number of rows to render above/below the visible bounds of the list. This can help reduce flickering during scrolling on certain browsers/devices. Defaults to `100`. |
76 | | `scrollToAlignment` | String | | Controls the alignment of scrolled-to-rows. The default (`'auto'`) scrolls the least amount possible to ensure that the specified row is fully visible. Use `'start'` to always align rows to the top of the list and `'end'` to align them bottom. Use `'center'` to align them in the middle of container. |
77 | | `onScroll` | Function | | Callback invoked whenever the scroll offset changes within the inner scrollable region: `({ clientHeight: number, scrollHeight: number, scrollTop: number }): void` |
78 |
79 | ## ``
80 |
81 | `ScrollFollow` is a higher-order component (HOC) that aims to simplify toggling a `LazyLog`'s
82 | "follow" functionality based on user scrolling.
83 |
84 | ### Usage
85 |
86 | The `ScrollFollow` component accepts a render prop function which should return a component to render based on the
87 | function's arguments.
88 |
89 | ```jsx
90 | import React from 'react';
91 | import { render } from 'react-dom';
92 | import { LazyLog, ScrollFollow } from 'react-lazylog';
93 |
94 | render((
95 | (
98 |
99 | )}
100 | />
101 | ), document.getElementById('root'));
102 | ```
103 |
104 | ## Styling
105 |
106 | All of the components exposed from react-lazylog use CSS modules to contain its styles to each individual component. If
107 | you wish to override these styles, there are a few techniques you can use.
108 |
109 | ### `style` and `containerStyle`
110 |
111 | For the core container of ``, you can pass a `style` object prop to affect many styles.
112 | For affecting the look or behavior of the scrollable region of these components, use the `containerStyle` prop with a
113 | styling object.
114 |
115 | ### `defaultProps.style`
116 |
117 | For many react-logviewer components, continually passing varied styling objects is tedious. To make this simpler, you can
118 | override the `defaultProps.style` of any desired component to override styles of that component. For example:
119 |
120 | ```jsx
121 | import Line from 'react-lazylog/build/Line';
122 |
123 | // Use defaultProps.style to set the style for an internal component
124 | Line.defaultProps.style = {
125 | color: 'green'
126 | };
127 | ```
128 |
129 | **Note: overriding the ANSI colors and styles is currently undocumented, and will probably need some source-diving to
130 | figure out. I would gladly accept a pull request that could improve the styling API.**
131 |
132 | ### CSS stylesheets
133 |
134 | If you are using CSS stylesheets, you can target the main virtual `LazyList` component with the `react-lazylog`
135 | class name. From there you can target the individual `div` lines, `a` line numbers, or `span` line content.
136 |
137 | ## Sub-components
138 |
139 | react-lazylog uses a number of sub-components internally to render individual parts of the log-viewing component:
140 |
141 | ### ``
142 |
143 | A single row of content, containing both the line number and any text content within the line.
144 |
145 | ### ``
146 |
147 | The line number of a single line. The anchor contained within is interactive, and will highlight the entire line upon
148 | selection.
149 |
150 | ### ``
151 |
152 | The container of all the individual pieces of content that is on a single line. May contain one or more `LinePart`s
153 | depending on ANSI parsing.
154 |
155 | ### ``
156 |
157 | An individual segment of text within a line. When the text content is ANSI-parsed, each boundary is placed within its
158 | own `LinePart` and styled separately (colors, text formatting, etc.) from the rest of the line's content.
159 |
160 | ## Technology
161 |
162 | - [React Virtualized](https://github.com/bvaughn/react-virtualized) for efficiently rendering large lines of data
163 | - [Neutrino](https://neutrino.js.org) for building and developing using shared presets and Webpack
164 | - [@neutrinojs/react-components](https://neutrino.js.org/packages/react-components) for creating React components
165 | - [neutrino-middleware-styleguidist](https://github.com/eliperelman/neutrino-middleware-styleguidist) for component demos and documentation
166 | - `fetch` API for efficiently requesting data with array buffers and binary streams
167 | - [fetch-readablestream](https://github.com/jonnyreeves/fetch-readablestream/)
168 | - [web-streams-polyfill](https://www.npmjs.com/package/web-streams-polyfill)
169 | - [text-encoding-utf-8](https://www.npmjs.com/package/text-encoding-utf-8)
170 | - [ansiparse](https://www.npmjs.com/package/ansiparse) for nice log styling, like Travis
171 | - [mitt](https://www.npmjs.com/package/mitt) for dead-simple events to manage streaming lifecycle
172 | - [Immutable](https://www.npmjs.com/package/immutable) for efficiently storing and managing very large collections of lines and highlight ranges
173 | - `Uint8Array` for dealing with text content as binary, allows for conditionally rendering partial data and decoding everything without crashing your browser
174 |
175 | ## Development and Contributing
176 |
177 | This repository uses [Neutrino](https://neutrino.js.org),
178 | [@neutrinojs/react-components](https://neutrino.js.org/packages/react-components),
179 | and [neutrino-middleware-styleguidist](https://github.com/eliperelman/neutrino-middleware-styleguidist)
180 | for developing, previewing, and building React components. To get started:
181 |
182 | - Fork and clone this repo.
183 | - Install the dependencies with `yarn`.
184 | - Start the development server with `yarn start`. This will launch a styleguide instance.
185 | Open a browser to http://localhost:6060 to preview the React components.
186 | - Use CTRL-C to exit the styleguide.
187 | - Use `yarn build` to generate the compiled component for publishing to npm.
188 |
189 | Feel free to open an issue, submit a pull request, or contribute however you would like. Understand that this
190 | documentation is still a work in progress, so file an issue or submit a PR to ask questions or make improvements.
191 | Thanks!
192 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "react-lazylog",
3 | "version": "4.5.3",
4 | "description": "React Lazy Logviewer",
5 | "license": "MPL-2.0",
6 | "repository": "mozilla-frontend-infra/react-lazylog",
7 | "main": "build/index.js",
8 | "files": [
9 | "build",
10 | "src"
11 | ],
12 | "keywords": [
13 | "react",
14 | "log",
15 | "viewer",
16 | "logviewer",
17 | "lazy",
18 | "lazylog"
19 | ],
20 | "scripts": {
21 | "build": "neutrino build",
22 | "prepare": "neutrino build",
23 | "lint": "neutrino lint",
24 | "start": "neutrino styleguide:start",
25 | "precommit": "neutrino stage",
26 | "deploy": "neutrino styleguide:build && gh-pages --remote upstream -d styleguide"
27 | },
28 | "devDependencies": {
29 | "babel-polyfill": "^6.26.0",
30 | "gh-pages": "^1.1.0",
31 | "neutrino": "^8.2.1",
32 | "neutrino-preset-mozilla-frontend-infra": "^4.1.0",
33 | "react": "^16.3.1",
34 | "react-dom": "^16.3.1"
35 | },
36 | "dependencies": {
37 | "@mattiasbuelens/web-streams-polyfill": "^0.2.0",
38 | "fetch-readablestream": "^0.2.0",
39 | "immutable": "^3.8.2",
40 | "mitt": "^1.1.2",
41 | "prop-types": "^15.6.1",
42 | "react-string-replace": "^0.4.1",
43 | "react-virtualized": "^9.21.0",
44 | "text-encoding-utf-8": "^1.0.1",
45 | "whatwg-fetch": "^2.0.4"
46 | },
47 | "peerDependencies": {
48 | "react": ">=16.3.0"
49 | }
50 | }
51 |
--------------------------------------------------------------------------------
/src/ansiparse.js:
--------------------------------------------------------------------------------
1 | /* eslint-disable no-plusplus, no-continue */
2 | const foregroundColors = {
3 | '30': 'black',
4 | '31': 'red',
5 | '32': 'green',
6 | '33': 'yellow',
7 | '34': 'blue',
8 | '35': 'magenta',
9 | '36': 'cyan',
10 | '37': 'white',
11 | '90': 'grey',
12 | };
13 | const backgroundColors = {
14 | '40': 'black',
15 | '41': 'red',
16 | '42': 'green',
17 | '43': 'yellow',
18 | '44': 'blue',
19 | '45': 'magenta',
20 | '46': 'cyan',
21 | '47': 'white',
22 | };
23 | const styles = {
24 | '1': 'bold',
25 | '3': 'italic',
26 | '4': 'underline',
27 | };
28 | const eraseChar = (matchingText, result) => {
29 | if (matchingText.length) {
30 | return [matchingText.substr(0, matchingText.length - 1), result];
31 | } else if (result.length) {
32 | const index = result.length - 1;
33 | const { text } = result[index];
34 | const newResult =
35 | text.length === 1
36 | ? result.slice(0, result.length - 1)
37 | : result.map((item, i) =>
38 | index === i
39 | ? { ...item, text: text.substr(0, text.length - 1) }
40 | : item
41 | );
42 |
43 | return [matchingText, newResult];
44 | }
45 |
46 | return [matchingText, result];
47 | };
48 |
49 | const ansiparse = str => {
50 | let matchingControl = null;
51 | let matchingData = null;
52 | let matchingText = '';
53 | let ansiState = [];
54 | let result = [];
55 | let state = {};
56 |
57 | for (let i = 0; i < str.length; i++) {
58 | if (matchingControl !== null) {
59 | if (matchingControl === '\x1b' && str[i] === '[') {
60 | if (matchingText) {
61 | state.text = matchingText;
62 | result.push(state);
63 | state = {};
64 | matchingText = '';
65 | }
66 |
67 | matchingControl = null;
68 | matchingData = '';
69 | } else {
70 | matchingText += matchingControl + str[i];
71 | matchingControl = null;
72 | }
73 |
74 | continue;
75 | } else if (matchingData !== null) {
76 | if (str[i] === ';') {
77 | ansiState.push(matchingData);
78 | matchingData = '';
79 | } else if (str[i] === 'm') {
80 | ansiState.push(matchingData);
81 | matchingData = null;
82 | matchingText = '';
83 |
84 | for (let a = 0; a < ansiState.length; a++) {
85 | const ansiCode = ansiState[a];
86 |
87 | if (foregroundColors[ansiCode]) {
88 | state.foreground = foregroundColors[ansiCode];
89 | } else if (backgroundColors[ansiCode]) {
90 | state.background = backgroundColors[ansiCode];
91 | } else if (ansiCode === 39) {
92 | delete state.foreground;
93 | } else if (ansiCode === 49) {
94 | delete state.background;
95 | } else if (styles[ansiCode]) {
96 | state[styles[ansiCode]] = true;
97 | } else if (ansiCode === 22) {
98 | state.bold = false;
99 | } else if (ansiCode === 23) {
100 | state.italic = false;
101 | } else if (ansiCode === 24) {
102 | state.underline = false;
103 | }
104 | }
105 |
106 | ansiState = [];
107 | } else {
108 | matchingData += str[i];
109 | }
110 |
111 | continue;
112 | }
113 |
114 | if (str[i] === '\x1b') {
115 | matchingControl = str[i];
116 | } else if (str[i] === '\u0008') {
117 | [matchingText, result] = eraseChar(matchingText, result);
118 | } else {
119 | matchingText += str[i];
120 | }
121 | }
122 |
123 | if (matchingText) {
124 | state.text = matchingText + (matchingControl || '');
125 | result.push(state);
126 | }
127 |
128 | return result;
129 | };
130 |
131 | export default ansiparse;
132 |
--------------------------------------------------------------------------------
/src/components/LazyLog/README.md:
--------------------------------------------------------------------------------
1 | Normal log viewing using a `url`:
2 |
3 | ```js
4 | const url = 'https://gist.githubusercontent.com/helfi92/96d4444aa0ed46c5f9060a789d316100/raw/ba0d30a9877ea5cc23c7afcd44505dbc2bab1538/typical-live_backing.log';
5 |
6 |
7 |
8 |
9 | ```
10 |
11 | See [`ScrollFollow`](#scrollfollow) for an example of a streaming endpoint.
12 |
13 | Log viewing using `text` from a string :
14 |
15 | ```js
16 | const text = `
17 | Sed ut perspiciatis unde omnis iste natus error sit voluptatem
18 | accusantium doloremque laudantium, totam rem aperiam,
19 | eaque ipsa quae ab illo inventore veritatis et quasi architecto
20 | beatae vitae dicta sunt explicabo. Nemo enim ipsam
21 | voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed
22 | quia consequuntur magni dolores eos qui ratione
23 | voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem
24 | ipsum quia dolor sit amet, consectetur, adipisci
25 | velit, sed quia non numquam eius modi tempora incidunt ut labore
26 | et dolore magnam aliquam quaerat voluptatem.
27 |
28 | Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit
29 | laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure
30 | reprehenderit qui in ea voluptate velit esse quam nihil molestiae
31 | consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?
32 | `;
33 |
34 |