Compare commits

..

3 commits

Author SHA1 Message Date
bec15aeb3d feat: fetch open issues 2024-09-20 09:50:18 +01:00
652b83b541 tests: add tests for main 2024-09-19 22:27:12 +01:00
b6de7831e5 tests: add tests for scanner module
All checks were successful
Test / test (push) Successful in 11s
2024-09-19 20:37:07 +01:00
20 changed files with 118 additions and 183 deletions

View file

@ -16,4 +16,3 @@ serde_json = "1.0"
[dev-dependencies] [dev-dependencies]
assert2 = "0.3" assert2 = "0.3"
pretty_assertions = "1.4"

View file

@ -1,6 +0,0 @@
{
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
"extends": [
"config:recommended"
]
}

View file

@ -1,5 +1,3 @@
use std::collections::HashSet;
// //
use crate::model::Config; use crate::model::Config;
@ -8,7 +6,7 @@ use kxio::network::{NetRequest, NetUrl};
use super::Issue; use super::Issue;
pub async fn fetch_open_issues(config: &Config) -> Result<HashSet<Issue>> { pub async fn fetch_open_issues(config: &Config) -> Result<Vec<Issue>> {
let server_url = config.server(); let server_url = config.server();
let repo = config.repo(); let repo = config.repo();
let url = format!("{server_url}/api/v1/repos/{repo}/issues?state=open"); let url = format!("{server_url}/api/v1/repos/{repo}/issues?state=open");
@ -20,14 +18,12 @@ pub async fn fetch_open_issues(config: &Config) -> Result<HashSet<Issue>> {
} }
.build(); .build();
let issues: HashSet<Issue> = config let issues = config
.net() .net()
.get::<Vec<Issue>>(request) .get::<Vec<Issue>>(request)
.await? .await?
.response_body() .response_body()
.unwrap_or_default() .unwrap_or_default();
.into_iter()
.collect();
Ok(issues) Ok(issues)
} }

View file

@ -7,29 +7,17 @@ mod tests;
pub use fetch::fetch_open_issues; pub use fetch::fetch_open_issues;
use serde::Deserialize; use serde::Deserialize;
#[derive(Debug, Deserialize, Hash, PartialEq, Eq)] #[derive(Debug, Deserialize, PartialEq, Eq)]
pub struct Issue { pub struct Issue {
number: u64, number: u64,
} }
impl Issue { impl Issue {
#[cfg(test)]
pub fn new(number: u64) -> Self { pub fn new(number: u64) -> Self {
Self { number } Self { number }
} }
// #[cfg(test)] #[cfg(test)]
// pub fn number(&self) -> u64 { pub fn number(&self) -> u64 {
// self.number self.number
// }
}
impl TryFrom<&str> for Issue {
type Error = <u64 as std::str::FromStr>::Err;
fn try_from(value: &str) -> Result<Self, Self::Error> {
let n: u64 = value.parse()?;
Ok(Issue::new(n))
}
}
impl std::fmt::Display for Issue {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
write!(f, "{}", self.number)
} }
} }

View file

@ -1,5 +1,3 @@
use std::collections::HashSet;
use crate::tests::a_config; use crate::tests::a_config;
// //
@ -23,10 +21,9 @@ async fn fetch_lists_issues() -> Result<()> {
let result = fetch_open_issues(&config).await?; let result = fetch_open_issues(&config).await?;
//then //then
assert_eq!( assert_eq!(result, vec![Issue::new(13), Issue::new(64)]);
result, assert_eq!(result[0].number(), 13);
HashSet::from_iter(vec![Issue::new(13), Issue::new(64)]) assert_eq!(result[1].number(), 64);
);
Ok(()) Ok(())
} }

View file

@ -1,5 +1,5 @@
// //
use anyhow::{bail, Result}; use anyhow::Result;
use init::init_config; use init::init_config;
use issues::fetch_open_issues; use issues::fetch_open_issues;
use scanner::find_markers; use scanner::find_markers;
@ -22,22 +22,17 @@ async fn run(net: kxio::network::Network) -> Result<()> {
println!("Forgejo TODO Checker!"); println!("Forgejo TODO Checker!");
let config = init_config(net)?; let config = init_config(net)?;
let issues = fetch_open_issues(&config).await?;
let markers = find_markers(&config, issues)?;
let mut errors = false; let markers = find_markers(&config)?;
for marker in (*markers).iter() { println!("{markers}");
match marker {
model::Marker::Closed(_, _) | model::Marker::Invalid(_) => { let _issues = fetch_open_issues(&config).await;
println!("{marker}");
errors = true; // TODO: loop over list of expected issues and drop any where they do exist and are open
} // TODO: if remaining list is not empty - add all to error list
model::Marker::Unmarked | model::Marker::Valid(_, _) => {} //
} // TODO: if error list is empty - exit okay
} // TODO: if error list is not empty - log erros and exit not okay
if errors {
bail!("Invalid or closed TODO/FIXMEs found")
}
Ok(()) Ok(())
} }

View file

@ -6,10 +6,7 @@ use std::path::PathBuf;
use anyhow::{Context, Result}; use anyhow::{Context, Result};
use bon::Builder; use bon::Builder;
use crate::{ use crate::patterns::{issue_pattern, marker_pattern};
issues::Issue,
patterns::{issue_pattern, marker_pattern},
};
use super::Marker; use super::Marker;
@ -35,11 +32,11 @@ impl Line {
if marker_pattern()?.find(&self.value).is_some() { if marker_pattern()?.find(&self.value).is_some() {
match issue_pattern()?.captures(&self.value) { match issue_pattern()?.captures(&self.value) {
Some(capture) => { Some(capture) => {
let issue: Issue = capture let issue = capture
.name("ISSUE_NUMBER") .name("ISSUE_NUMBER")
.context("ISSUE_NUMBER")? .context("ISSUE_NUMBER")?
.as_str() .as_str()
.try_into()?; .to_owned();
Ok(Marker::Valid(self, issue)) Ok(Marker::Valid(self, issue))
} }
None => Ok(Marker::Invalid(self)), None => Ok(Marker::Invalid(self)),

View file

@ -0,0 +1,22 @@
use super::Marker;
//
#[derive(Debug, Default)]
pub struct FoundMarkers {
markers: Vec<Marker>,
}
impl FoundMarkers {
pub fn add_marker(&mut self, marker: Marker) {
self.markers.push(marker);
}
}
impl std::fmt::Display for FoundMarkers {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
for marker in self.markers.iter() {
// if !matches!(marker, Marker::Unmarked) {
write!(f, "{marker}")?;
// }
}
Ok(())
}
}

View file

@ -0,0 +1,15 @@
//
#![allow(dead_code)]
use super::Marker;
use bon::Builder;
#[derive(Debug, Builder)]
pub struct IssueMarker {
/// The marker
marker: Marker,
/// The issue number
issue: usize,
}

View file

@ -0,0 +1,20 @@
//
#![allow(dead_code)]
use crate::model::Line;
#[derive(Debug)]
pub enum Marker {
Unmarked,
Invalid(Line),
Valid(Line, String),
}
impl std::fmt::Display for Marker {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
match self {
Marker::Unmarked => Ok(()),
Marker::Invalid(line) => write!(f, "- Invalid: {line}"),
Marker::Valid(line, _) => write!(f, "- Valid : {line}"),
}
}
}

View file

@ -1,61 +1,10 @@
// //
mod found;
mod issue;
mod marker;
#[cfg(test)] #[cfg(test)]
mod tests; mod tests;
use std::ops::Deref; pub use found::FoundMarkers;
pub use marker::Marker;
use crate::{issues::Issue, model::Line};
#[derive(Debug)]
pub enum Marker {
Unmarked,
Invalid(Line),
#[allow(dead_code)]
Valid(Line, Issue),
Closed(Line, Issue),
}
impl Marker {
pub fn into_closed(self) -> Self {
match self {
Self::Valid(line, issue) => Self::Closed(line, issue),
_ => self,
}
}
}
impl std::fmt::Display for Marker {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
match self {
Self::Unmarked => Ok(()),
Self::Invalid(line) => write!(f, "- Invalid: {line}"),
Self::Valid(line, issue) => write!(f, "- Valid : ({issue}) {line}"),
Self::Closed(line, issue) => write!(f, "- Closed : ({issue}) {line}"),
}
}
}
#[derive(Debug, Default)]
pub struct Markers {
markers: Vec<Marker>,
}
impl Markers {
pub fn add_marker(&mut self, marker: Marker) {
self.markers.push(marker);
}
}
impl Deref for Markers {
type Target = Vec<Marker>;
fn deref(&self) -> &Self::Target {
&self.markers
}
}
impl std::fmt::Display for Markers {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
for marker in self.markers.iter() {
write!(f, "{marker}")?;
}
Ok(())
}
}

View file

@ -1,5 +1,7 @@
use crate::model::Line;
// //
use crate::model::{markers::Markers, Line}; use super::*;
#[test] #[test]
fn found_when_displayed() -> anyhow::Result<()> { fn found_when_displayed() -> anyhow::Result<()> {
@ -8,7 +10,7 @@ fn found_when_displayed() -> anyhow::Result<()> {
let file = fs.base().join("file-name"); let file = fs.base().join("file-name");
let relative = file.strip_prefix(fs.base())?.to_path_buf(); let relative = file.strip_prefix(fs.base())?.to_path_buf();
let mut found = Markers::default(); let mut found = FoundMarkers::default();
let marker_unmarked = Line::builder() let marker_unmarked = Line::builder()
.file(file.clone()) .file(file.clone())
@ -21,14 +23,14 @@ fn found_when_displayed() -> anyhow::Result<()> {
.file(file.clone()) .file(file.clone())
.relative_path(relative.clone()) .relative_path(relative.clone())
.num(10) .num(10)
.value(format!("line // {}: comment", "TODO")) .value("line // TODO: comment".to_owned())
.build() .build()
.into_marker()?; .into_marker()?;
let marker_valid = Line::builder() let marker_valid = Line::builder()
.file(file) .file(file)
.relative_path(relative) .relative_path(relative)
.num(11) .num(11)
.value(format!("line // {}: (#13) do this", "TODO")) .value("line // TODO: (#13) do this".to_owned())
.build() .build()
.into_marker()?; .into_marker()?;
@ -45,9 +47,9 @@ fn found_when_displayed() -> anyhow::Result<()> {
result, result,
vec![ vec![
"- Invalid: file-name#10:", "- Invalid: file-name#10:",
format!(" line // {}: comment", "TODO").as_str(), " line // TODO: comment",
"- Valid : (13) file-name#11:", "- Valid : file-name#11:",
format!(" line // {}: (#13) do this", "TODO").as_str() " line // TODO: (#13) do this"
] ]
); );

View file

View file

View file

@ -0,0 +1,6 @@
//
use super::*;
mod found;
mod issue;
mod marker;

View file

@ -8,5 +8,5 @@ mod tests;
pub use config::Config; pub use config::Config;
pub use line::Line; pub use line::Line;
pub use markers::FoundMarkers;
pub use markers::Marker; pub use markers::Marker;
pub use markers::Markers;

View file

@ -1,30 +1,22 @@
// //
use std::{collections::HashSet, path::Path}; use std::path::Path;
use crate::{ use crate::model::{Config, FoundMarkers, Line, Marker};
issues::Issue,
model::{Config, Line, Marker, Markers},
};
use anyhow::Result; use anyhow::Result;
use ignore::Walk; use ignore::Walk;
pub fn find_markers(config: &Config, issues: HashSet<Issue>) -> Result<Markers, anyhow::Error> { pub fn find_markers(config: &Config) -> Result<FoundMarkers, anyhow::Error> {
let mut markers = Markers::default(); let mut markers = FoundMarkers::default();
for file in Walk::new(config.fs().base()).flatten() { for file in Walk::new(config.fs().base()).flatten() {
let path = file.path(); let path = file.path();
if config.fs().path_is_file(path)? { if config.fs().path_is_file(path)? {
scan_file(path, config, &mut markers, &issues)?; scan_file(path, config, &mut markers)?;
} }
} }
Ok(markers) Ok(markers)
} }
fn scan_file( fn scan_file(file: &Path, config: &Config, found_markers: &mut FoundMarkers) -> Result<()> {
file: &Path,
config: &Config,
found_markers: &mut Markers,
issues: &HashSet<Issue>,
) -> Result<()> {
let relative_path = file.strip_prefix(config.fs().base())?.to_path_buf(); let relative_path = file.strip_prefix(config.fs().base())?.to_path_buf();
config config
.fs() .fs()
@ -35,27 +27,13 @@ fn scan_file(
Line::builder() Line::builder()
.file(file.to_path_buf()) .file(file.to_path_buf())
.relative_path(relative_path.clone()) .relative_path(relative_path.clone())
.num(n + 1) // line numbers are not 0-based, but enumerate is .num(n)
.value(line.to_owned()) .value(line.to_owned())
.build() .build()
}) })
.filter_map(|line| line.into_marker().ok()) .filter_map(|line| line.into_marker().ok())
.filter(|marker| !matches!(marker, Marker::Unmarked)) .filter(|marker| !matches!(marker, Marker::Unmarked))
.map(|marker| has_open_issue(marker, issues))
.for_each(|marker| found_markers.add_marker(marker)); .for_each(|marker| found_markers.add_marker(marker));
Ok(()) Ok(())
} }
fn has_open_issue(marker: Marker, issues: &HashSet<Issue>) -> Marker {
if let Marker::Valid(_, ref issue) = marker {
let has_open_issue = issues.contains(issue);
if has_open_issue {
marker
} else {
marker.into_closed()
}
} else {
marker
}
}

View file

@ -5,5 +5,3 @@ It contains a todo comment: // TODO: this is it
It also contains a fix-me comment: // FIXME: and this is it It also contains a fix-me comment: // FIXME: and this is it
Both of these are missing an issue identifier. Both of these are missing an issue identifier.
We also have a todo comment: // TODO: (#3) and it has an issue number, but it is closed

View file

@ -2,17 +2,10 @@
use super::*; use super::*;
use anyhow::Result; use anyhow::Result;
use kxio::network::StatusCode;
#[tokio::test] #[tokio::test]
async fn run_with_some_invalids() -> Result<()> { async fn run_with_some_invalids() -> Result<()> {
//given //given
let mut net = kxio::network::MockNetwork::new();
net.add_get_response(
"https://git.kemitix.net/api/v1/repos/kemitix/test/issues?state=open",
StatusCode::OK,
r#"[{"number": 13}]"#,
);
let _env = THE_ENVIRONMENT.lock(); let _env = THE_ENVIRONMENT.lock();
let fs = kxio::fs::temp()?; let fs = kxio::fs::temp()?;
fs.file_write( fs.file_write(
@ -28,7 +21,7 @@ async fn run_with_some_invalids() -> Result<()> {
std::env::set_var("GITHUB_SERVER_URL", "https://git.kemitix.net"); std::env::set_var("GITHUB_SERVER_URL", "https://git.kemitix.net");
//when //when
run(net.into()).await?; run(kxio::network::Network::new_mock()).await?;
//then //then
// TODO: add check that run fails because file_1.txt is invalid // TODO: add check that run fails because file_1.txt is invalid
@ -40,12 +33,6 @@ async fn run_with_some_invalids() -> Result<()> {
#[tokio::test] #[tokio::test]
async fn run_with_no_invalids() -> Result<()> { async fn run_with_no_invalids() -> Result<()> {
//given //given
let mut net = kxio::network::MockNetwork::new();
net.add_get_response(
"https://git.kemitix.net/api/v1/repos/kemitix/test/issues?state=open",
StatusCode::OK,
r#"[{"number": 13}]"#,
);
let _env = THE_ENVIRONMENT.lock(); let _env = THE_ENVIRONMENT.lock();
let fs = kxio::fs::temp()?; let fs = kxio::fs::temp()?;
fs.file_write( fs.file_write(
@ -57,8 +44,7 @@ async fn run_with_no_invalids() -> Result<()> {
std::env::set_var("GITHUB_SERVER_URL", "https://git.kemitix.net"); std::env::set_var("GITHUB_SERVER_URL", "https://git.kemitix.net");
//when //when
run(kxio::network::Network::new_mock()).await?;
run(net.into()).await?;
//then //then
// TODO: add check that run fails because file_1.txt is invalid // TODO: add check that run fails because file_1.txt is invalid

View file

@ -1,12 +1,8 @@
//
use super::*;
use std::collections::HashSet;
use issues::Issue;
use model::Config; use model::Config;
use patterns::{issue_pattern, marker_pattern}; use patterns::{issue_pattern, marker_pattern};
use pretty_assertions::assert_eq;
//
use super::*;
#[test] #[test]
fn find_markers_in_dir() -> anyhow::Result<()> { fn find_markers_in_dir() -> anyhow::Result<()> {
@ -29,10 +25,9 @@ fn find_markers_in_dir() -> anyhow::Result<()> {
.prefix_pattern(marker_pattern()?) .prefix_pattern(marker_pattern()?)
.issue_pattern(issue_pattern()?) .issue_pattern(issue_pattern()?)
.build(); .build();
let issues = HashSet::from_iter(vec![Issue::new(23), Issue::new(43)]);
//when //when
let markers = find_markers(&config, issues)?; let markers = find_markers(&config)?;
//then //then
assert_eq!( assert_eq!(
@ -42,11 +37,9 @@ fn find_markers_in_dir() -> anyhow::Result<()> {
" It contains a todo comment: // TODO: this is it", " It contains a todo comment: // TODO: this is it",
"- Invalid: file_with_invalids.txt#4:", "- Invalid: file_with_invalids.txt#4:",
" It also contains a fix-me comment: // FIXME: and this is it", " It also contains a fix-me comment: // FIXME: and this is it",
"- Closed : (3) file_with_invalids.txt#8:", "- Valid : file_with_valids.txt#2:",
" We also have a todo comment: // TODO: (#3) and it has an issue number, but it is closed",
"- Valid : (23) file_with_valids.txt#2:",
" It also has a todo comment: // TODO: (#23) and it has an issue number", " It also has a todo comment: // TODO: (#23) and it has an issue number",
"- Valid : (43) file_with_valids.txt#4:", "- Valid : file_with_valids.txt#4:",
" Here is a fix-me comment: // FIXME: (#43) and is also has an issue number" " Here is a fix-me comment: // FIXME: (#43) and is also has an issue number"
] ]
); );