lda_gov 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -1
- data/README.md +30 -2
- data/lib/lda_gov/resources/filings.rb +0 -4
- data/lib/lda_gov/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ed2cf70ecaf8ddb41eec698771807f7597c8c4431983ead9d8f6b462c778d193
|
|
4
|
+
data.tar.gz: 077aa3815b86892ce05fc4eaf877030e228c99d8ba5e05da75ae52aa04825527
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ca320d1be947abfc1fda926c0b12b8c504cc348a28f09650be1612a25ae8197b8b31d2e7d4833c831082c882dd23eb4685c627744302323f61af7aace5e5efd5
|
|
7
|
+
data.tar.gz: fcd54bc8404a34aaf34b221674dd9f3f997307aa9bb445da56752fb29b00273b1e3367220e06a3df50e9bc2b592fbac0bbb6918b63e916ef0477c794055a35d5
|
data/CHANGELOG.md
CHANGED
|
@@ -1,10 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.2.0] - 2026-03-22
|
|
4
|
+
|
|
5
|
+
### Removed
|
|
6
|
+
- `Filings#by_issue` — the LDA.gov API does not support server-side filtering by lobbying issue code. The parameter was silently ignored, returning unfiltered results. Filter client-side via `lobbying_activities` on each filing instead. See README for example.
|
|
7
|
+
|
|
8
|
+
### Added
|
|
9
|
+
- API Limitations section in README documenting supported vs unsupported server-side filters
|
|
10
|
+
- `filing_type` filter example in README (`Q1`–`Q4`, `RR`, `RA`, etc.)
|
|
11
|
+
|
|
3
12
|
## [0.1.0] - 2025-03-13
|
|
4
13
|
|
|
5
14
|
### Added
|
|
6
15
|
- Initial release
|
|
7
|
-
- Filings resource (list, find, quarterly, by_registrant_and_client
|
|
16
|
+
- Filings resource (list, find, quarterly, by_registrant_and_client)
|
|
8
17
|
- Contributions resource (list, find)
|
|
9
18
|
- Registrants resource (list, find)
|
|
10
19
|
- Clients resource (list, find)
|
data/README.md
CHANGED
|
@@ -48,8 +48,8 @@ LDA.filings.by_registrant_and_client(
|
|
|
48
48
|
client_name: 'Big Corp'
|
|
49
49
|
)
|
|
50
50
|
|
|
51
|
-
# Filter by
|
|
52
|
-
LDA.filings.
|
|
51
|
+
# Filter by filing type (quarterly reports, registrations, etc.)
|
|
52
|
+
LDA.filings.list(filing_year: 2024, filing_type: 'Q1')
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
### Contributions
|
|
@@ -207,6 +207,30 @@ LDA::Error
|
|
|
207
207
|
|
|
208
208
|
All `ClientError` and `ServerError` subclasses expose `.status` and `.body`.
|
|
209
209
|
|
|
210
|
+
## API Limitations
|
|
211
|
+
|
|
212
|
+
The LDA.gov API does not support server-side filtering by lobbying issue code. Passing a `lobbying_issue` parameter to the filings endpoint has no effect — the API returns all filings regardless.
|
|
213
|
+
|
|
214
|
+
**Supported filters** (confirmed working server-side):
|
|
215
|
+
- `filing_year` — calendar year
|
|
216
|
+
- `filing_type` — filing type code (`Q1`–`Q4`, `RR`, `RA`, `1T`, `1TY`, etc.)
|
|
217
|
+
- `filing_period` — filing period (`first_quarter`, `second_quarter`, etc.)
|
|
218
|
+
- `registrant_name` — registrant name search
|
|
219
|
+
- `client_name` — client name search
|
|
220
|
+
|
|
221
|
+
To filter by issue code, iterate over filings and check `lobbying_activities` on each filing:
|
|
222
|
+
|
|
223
|
+
```ruby
|
|
224
|
+
LDA.filings.each_page(filing_year: 2024, filing_type: 'Q1') do |page|
|
|
225
|
+
page.each do |filing|
|
|
226
|
+
issues = filing['lobbying_activities']&.map { |a| a['general_issue_code'] } || []
|
|
227
|
+
next unless issues.include?('DEF')
|
|
228
|
+
|
|
229
|
+
process(filing)
|
|
230
|
+
end
|
|
231
|
+
end
|
|
232
|
+
```
|
|
233
|
+
|
|
210
234
|
## Development
|
|
211
235
|
|
|
212
236
|
```bash
|
|
@@ -223,6 +247,10 @@ bundle exec rubocop # Lint
|
|
|
223
247
|
- Ruby >= 3.1
|
|
224
248
|
- Faraday ~> 2.0
|
|
225
249
|
|
|
250
|
+
## Support
|
|
251
|
+
|
|
252
|
+
[](https://ko-fi.com/omgjack)
|
|
253
|
+
|
|
226
254
|
## License
|
|
227
255
|
|
|
228
256
|
MIT License. See [LICENSE.txt](LICENSE.txt).
|
|
@@ -26,10 +26,6 @@ module LDA
|
|
|
26
26
|
def by_registrant_and_client(registrant_name:, client_name:, **params)
|
|
27
27
|
get('filings/', params.merge(registrant_name: registrant_name, client_name: client_name))
|
|
28
28
|
end
|
|
29
|
-
|
|
30
|
-
def by_issue(issue_code:, **params)
|
|
31
|
-
get('filings/', params.merge(lobbying_issue: issue_code))
|
|
32
|
-
end
|
|
33
29
|
end
|
|
34
30
|
end
|
|
35
31
|
end
|
data/lib/lda_gov/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: lda_gov
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.2.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Jack Killilea
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-03-
|
|
11
|
+
date: 2026-03-22 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: faraday
|